diff --git a/README.md b/README.md index 2b78f546..0c1b0aa8 100644 --- a/README.md +++ b/README.md @@ -206,6 +206,7 @@ A `terravision.yml` next to the Terraform adds the title, numbered flows and con |---|---|---|---|---|---| | Draw from a plain-English description | ✅ inside the assistant you already use (Claude, ChatGPT, Copilot) | Partly only if your organisation approves third-party models | ✅ | No| No | | Draw from Terraform | ✅ built from `terraform plan`, client side | No | Partly AI interprets the files you paste (potentially exposes code & secrets) | No | No | +| Draw an environment you have no access to, or one not built yet | ✅ from the code and a variables file: `--varfile prod.tfvars` draws prod, `--varfile dev.tfvars` draws dev, with no access to the target account or its state | Partly drawn by hand from documents | Partly from code you paste | Partly written by hand | No draws only an account it can connect to | | Write the Terraform for a design | ✅ by your assistant, checked by redrawing the code AI writes | Partly Lucidchart beta, AWS only, paid add-on | No | No | No | | Official icons and VPC, subnet, zone grouping conventions | ✅ built in | Partly icon libraries; correct grouping is up to you | Partly icons, generic groups | No | No | | Stays current automatically | ✅ redrawn from the code in CI | No | Partly repository sync | No | ✅ follows the live account | diff --git a/docs/alternatives.md b/docs/alternatives.md index 323a0225..07a460ac 100644 --- a/docs/alternatives.md +++ b/docs/alternatives.md @@ -12,6 +12,7 @@ Tools for cloud architecture diagrams fall into five groups: manual drawing tool | How you make a diagram | Describe it to Claude or ChatGPT, or point at Terraform | Drag, drop and connect by hand | Prompt, pasted code or image | Write a text DSL | Write Python code | Connect a cloud account | | Diagram from a text prompt | Yes, through your AI assistant | Only if your organisation approves third-party models | Yes, built-in AI | Assistant writes Mermaid or D2 | No | No | | Diagram from Terraform | Built from `terraform plan`, so modules, `count`, `for_each` and conditionals are resolved | No | AI interprets the files you paste | No | No | Deployed state, not code | +| Draw an environment you cannot log in to, or one not built yet | Yes, from the code and a variables file: `--varfile prod.tfvars` draws prod, `--varfile dev.tfvars` draws dev | Drawn by hand | From pasted code | Drawn by hand | Written by hand | No, draws the account it is connected to | | Terraform from the design | Yes, written by your AI assistant and checked by redrawing the code | Lucidchart beta, AWS only, paid add-on | No | No | No | Varies | | Official AWS, Azure, GCP icons | Yes | Yes, shape libraries | Yes | Not built in | Yes | Yes | | VPC, subnet, zone grouping | Built in, per provider | Drawn by hand | Generic groups | Generic groups | Manual clusters | Built in |