cloudwright

Cloudwright

设计云架构或规划迁移。获取成本、控制措施、代码和经过检查的证据。

pip install 'cloudwright-ai[cli]'
export ANTHROPIC_API_KEY=sk-ant-...
cloudwright design "HIPAA healthcare API on AWS with Postgres and Redis"

Cloudwright 将一句英文转化为类型化规范、成本明细、映射到控制项的合规报告和基础设施代码。它将源环境和目标环境转化为有序的迁移波次、明确的成本和证据关卡。它支持 AWS、GCP、Azure 和 Databricks，涵盖 114 个服务键。只有 design、modify、chat 和 adr 会调用模型。其他所有命令均可离线运行，无需 API 密钥。

快速入门 · 迁移 · 合规 · Agent · 文档 · 更新日志

一条提示词即可生成规范、成本、映射到控制项的报告和 Terraform

• 规范。 可提交、比较差异并审查的类型化 YAML。以下所有内容均从中读取。
• 成本。 按组件列出并考虑区域差异，每项都标有置信度。
• 合规。 HIPAA、SOC 2、PCI-DSS、FedRAMP、GDPR、ISO 27001 和 NIST 800-53 控制项 ID。
• 基础设施代码。 Terraform、OpenTofu、Pulumi（TypeScript 或 Python）和 CloudFormation。
• 图表。 ASCII、Mermaid、D2，以及可手动编辑的 Web 画布。
• MCP 服务，让任何编码 Agent 都能在自己的工作循环中运行相同的检查。

导出的内容包含安全默认设置。S3 会启用公共访问阻止、SSE 和版本控制。RDS 会启用加密、多可用区和删除保护。EC2 会启用 IMDSv2。合规框架会覆盖工作负载配置，并始终强制启用加密和高可用性。

快速入门

cloudwright design "HIPAA healthcare API on AWS with Postgres and Redis"
cloudwright cost spec.yaml --workload-profile medium
cloudwright compliance spec.yaml --frameworks hipaa,soc2
cloudwright export spec.yaml --format terraform -o ./infra
cloudwright plan spec.yaml --target terraform          # proves it deploys, never applies
cloudwright migrate demo                               # packaged migration proof, fully offline
cloudwright chat --web                                 # canvas at http://localhost:8765

在任何子命令前添加 --json，即可获取机器可读的输出；添加 --stream，即可实时查看令牌输出。对于需要模型的四个命令，请设置 ANTHROPIC_API_KEY 或 OPENAI_API_KEY。

缺少证据时，迁移计划会停止

迁移模型在一张依赖关系图中涵盖基础设施、应用程序、数据、平台、网络、设施和业务服务。它适用于本地部署、云、跨云、混合云、数据中心和应用迁移。它负责规划和检查工作，但绝不会复制数据、部署基础设施、切换流量或执行切换。

cloudwright migrate plan examples/migrations/ph-telco-project.yaml -o assessment.yaml
cloudwright migrate verify examples/migrations/ph-telco-project.yaml examples/migrations/ph-telco-evidence.yaml

核心没有电信行业专用字段。首个验证项目会选择外部 ph_telco 包，用于订阅者、计费、使用记录、号码携转、隐私、恢复和源系统关闭门槛。制造业 ERP 示例证明，即使没有该包，同一规划器也能正常工作。缺少阻塞性证据时，结果会变为 closed: false，且 migrate verify 会以代码 2 退出。每个证据文件都包含确定性的评估 ID，因此，来自旧目标或切换计划的观察结果无法关闭修订后的评估。

MCP 客户端通过 migration 工具组中的 plan_migration 和 verify_migration，使用同一引擎。

有关文件约定、Python API、HTTP 路由、领域包格式、限制和记录命令，请参阅迁移规划与证据。

每条发现都带有其违反的控制项 ID

其他工具会在基础设施部署后进行扫描。Cloudwright 会在任何资源创建前，将每条发现映射到对应控制项。这样，修复只需编辑规范，而不必提交变更工单。HIPAA 164.312(a)(2)(iv)、SOC 2 CC6.1 和 FedRAMP SC-28 均由内置扫描器提供，无需额外工具。如果 Checkov 位于 PATH 上，它也会纳入同一份报告。

• --oscal 会生成带有确定性 UUID 的 OSCAL 1.1.2 组件定义。
• --traceability 会打印从组件到资源、再到控制项和状态的追溯链。
• cloudwright plan 会对导出内容运行 terraform validate，绝不会执行 apply。

审查无需 API 密钥，也无需联网

cloudwright review 会对规范运行评分器、代码检查器和验证器，并返回一份按严重程度排序的报告。同样的三个审查器也会在 cloudwright design 中运行。如果生成后仍存在阻塞性发现，架构师会修复一次规范，并将变更记录在 spec.metadata.critique 中。传入 Architect(repair=False) 可关闭此功能。

画布编辑不会调用模型，因此即时完成且免费

添加、拖动、连接、编辑和删除都是确定性的前端变更。目录抽屉会按提供商提供资源 列表，以及五个经批准的多资源模块。标准检查会标记孤立连接、 不完整模块和缺失标签。完整模块会导出为单个 Terraform module 块，并使用目录中固定的源和版本。

一个 MCP 服务可连接 11 种编码 Agent

cloudwright integrate --harness claude-code       # exact wiring, in that client's format
cloudwright integrate --harness cursor --write    # merge it into the right file
cloudwright integrate --rules --agent-file claude # a gate block for CLAUDE.md

不要手动编写配置。cloudwright integrate 会为 Claude Code、Cursor、Cline、Windsurf、GitHub Copilot、Zed、Codex CLI、Junie、Kiro 和 Antigravity 生成配置。Aider 则使用 CLI 管道方案，因为它不支持 MCP。每个客户端需要的格式都不同：Zed 使用 context_servers，Copilot 使用 servers，而 Codex 使用 TOML 表格。

该服务提供 10 组共 24 个工具：设计、成本、验证、分析、导出、会话、审查、合规、 计划和迁移。完整矩阵见 docs/integrations.md。

离线命令可评分、扫描、比较和规划

lint 运行 10 项反模式检查。score 对 5 个维度评分。analyze 报告影响范围和单点 故障。policy 使用 9 条内置规则实施策略即代码。security 扫描规范和 导出的 HCL。drift 将设计与 tfstate 比较，--remediate 则将差异转化为成本、 合规性和计划预览。

review、compliance 和 plan 如上所述。请参阅 docs/cli-reference.md。

Python API

from cloudwright import ArchSpec
from cloudwright.cost import CostEngine
from cloudwright.validator import Validator
from cloudwright.exporter import export_spec

spec = ArchSpec.from_file("spec.yaml")
priced = CostEngine().estimate(spec, workload_profile="medium")
findings = Validator().validate(spec, compliance=["hipaa", "pci-dss"])
hcl = export_spec(spec, "terraform", output_dir="./infra")

v1.10.0 新增基于证据的迁移规划闭环

• 一个模型覆盖完整资产。 基础设施、数据、应用、平台、网络、 设施和业务服务共用一个依赖图。
• 依赖关系决定迁移波次。 规划器会先安排前置条件、拒绝循环、 检查回滚路径，并报告未解决的映射。
• 闭环需要证据。 缺失或失败的阻断性观测会阻止闭环，并使 migrate verify 返回退出代码 2。
• 行业规则独立于引擎。 可选的 YAML 包可添加验收关卡，而无需向核心添加 行业字段。
• 菲律宾电信行业是首个验证案例。 产品仍保持行业中立。制造业 ERP 夹具 无需领域包即可使用同一规划器运行。

更早的版本添加了控制 ID 映射和 plan（v1.5.0）、自我纠正架构师和 OSCAL （v1.6.0）、cloudwright integrate（v1.7.0）、响应式深色主题画布（v1.8.0），以及经过测量的 画布交互修复（v1.9.0）。完整历史记录见 CHANGELOG.md。

兼容性

• Python 3.12+
• 模型：Anthropic（Claude Sonnet、Haiku）和 OpenAI（GPT-5+ 系列），根据环境变量自动检测。
• 云平台：AWS、GCP、Azure、Databricks。共 114 个服务键。
• 安装变体：cloudwright-ai[cli]、cloudwright-ai[web]、cloudwright-ai-mcp。

贡献、许可证和更新日志

• 贡献指南：CONTRIBUTING.md
• 许可证：MIT，详见 LICENSE
• 完整发布历史：CHANGELOG.md