design_architecture
Create a cloud architecture from a natural-language description. Specify provider, region, budget, and compliance to get components, connections, tier assignments, and cost estimate.
Instructions
Design a cloud architecture from a natural-language description.
Primary entry point for greenfield architecture design. Returns a complete ArchSpec (YAML-serializable dict) with components, connections, tier assignments, and a cost estimate.
When to use: You have a requirement (prose) and need a concrete architecture
with services, wiring, and cost. Use modify_architecture to iterate on
an existing spec, or chat_create_session + chat_send for multi-turn
refinement.
Behavior: Calls an LLM provider (Anthropic or OpenAI depending on configured keys) — incurs API costs per invocation. Deterministic post-processing layers (cost engine, catalog lookup) apply safe defaults like encryption-at-rest, multi-AZ on databases, and auto-scaling. Does not deploy or modify any cloud resources.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | Plain-English description of the system to design. Include workload type (e.g. 'HIPAA-compliant 3-tier healthcare API'), traffic expectations, and any stack preferences. The LLM uses this to select services, tiers, and connections. | |
| provider | No | Target cloud provider for the generated architecture. Values: 'aws', 'gcp', 'azure', 'databricks'. Default 'aws'. | aws |
| region | No | Cloud region for the generated architecture (e.g. 'us-east-1' for AWS, 'us-central1' for GCP, 'eastus' for Azure). Used to set region-aware pricing and compliance constraints (e.g. FedRAMP requires US regions). | us-east-1 |
| budget_monthly | No | Optional monthly budget cap in USD. When set, the architect biases toward instance tiers and managed services that fit under this cap. | |
| compliance | No | Optional list of compliance frameworks the architecture must satisfy. Values from: 'hipaa', 'pci-dss', 'soc2', 'fedramp', 'gdpr'. Influences service selection (e.g. BAA-eligible services for HIPAA, FIPS-compliant services for FedRAMP) and encryption defaults. |