Development Workflow using LLM

We can generate the topology (topology.yml) using natural language, it’s entities (functions etc) or IAC using LLMs.

Usage:

tc scaffold --topology [--model <model-id> --skills skills/topology.md]
tc scaffold --iac tf|boto|rust|aws-cli [--model <model-id> --skills skills/iac.md]
tc scaffold --entity functions  [--model <model-id> --skills skills/functions.md]

Scaffold topology.yml

tc scaffold -e AWS_PROFILE --topology
> Architecture Description: Generate a topology to compute sum of two numbers. Notify result via channel

This generates a topology.yml, in the current directory, with a high-level abstract structured representation of the topology without leaking any of the infrastructure-specific components in it.

We can also specify a skills file for the topology. It defaults to ./skills/topology.md. This skill or spec could contain a more elaborate description of the topology.

Scaffold IaC

One of tc’s goals is to delegate deployments to IAC-based tools. We can use tc’s canonical topology specification, it’s compositional and entity abstractions to generate IAC that can be audited and have a lifecycle of it’s own. tc does best effort to instruct LLMs to conform to the Topology spec and honor it’s boundaries. In doing so, LLMs are able to generate meaningful infrastructure code that can be rendered in any sandbox, account or region. This facilitates agents and humans to collaborate on structured representation of the system - the Topology spec. This spec could drive deployments, orchestration (transducers) and sophisticated CI workflows.

To generate Terraform code:

tc scaffold -e dev --iac tf --out-dir tf [--skills skills/iac.md]

Example:

tc scaffold -e dev --iac tf
Using bedrock model us.anthropic.claude-sonnet-4-5-20250929-v1:0

Writing file iac/README.md
Writing file iac/main.tf
Writing file iac/terraform.tfvars.example
Writing file iac/providers.tf
Writing file iac/outputs.tf
Writing file iac/iam.tf
Writing file iac/lambda.tf
Writing file iac/apigateway.tf
Writing file iac/eventbridge.tf
Writing file iac/variables.tf

We can override the skills required to generate IAC using the ./skills/iac.md file.

To generate CDK

tc scaffold -e dev --iac cdk --out-dir cdk

Other available iac options: boto, go, rust, aws-cli

Scaffold entities

tc scaffold --entity functions

This scaffolds the function directories and function specs.