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 は、1 行の英語を、型付きスペック、コスト内訳、統制にマッピングされたコンプライアンスレポート、 およびインフラストラクチャコードに変換します。ソース環境とターゲットは、順序付けられた移行ウェーブ、明示的なコスト、 およびエビデンスゲートになります。114 のサービスキーにわたって AWS、GCP、Azure、Databricks をカバーします。モデルを呼び出すのは design、 modify、chat、adr のみです。その他のすべてのコマンドはオフラインで実行され、API キーは不要です。

クイックスタート · 移行 · コンプライアンス · エージェント · ドキュメント · 変更履歴

プロンプトからスペック、コスト、統制にマッピングされたレポート、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 サーバー。これにより、あらゆるコーディングエージェントが自身のループ内で同じチェックを実行できます。

エクスポートには安全なデフォルト設定が含まれます。S3 にはパブリックアクセスブロック、SSE、バージョニングが設定されます。RDS には暗号化、マルチ AZ、 削除保護が設定されます。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 を追加します。モデルを必要とする 4 つのコマンドでは、ANTHROPIC_API_KEY または OPENAI_API_KEY を設定してください。

証拠が欠けていると移行計画は停止します

移行モデルは、インフラストラクチャ、アプリケーション、データ、プラットフォーム、ネットワーク、設備、およびビジネスサービスを 1 つの依存関係グラフでカバーします。オンプレミス、クラウド、クロスクラウド、ハイブリッド、データセンター、およびアプリケーションの移行に対応します。作業を計画し、チェックします。データのコピー、インフラストラクチャの適用、トラフィックの切り替え、カットオーバーの実行は決して行いません。

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 を実行し、決して適用しません。

レビューには API キーもネットワークも不要です

cloudwright review は、仕様に対してスコアラー、リンター、およびバリデータを実行し、1 つの重要度順レポートを返します。同じ 3 つのクリティックは cloudwright design 内でも実行されます。ブロッキング検出結果が生成後も残る場合、アーキテクトは仕様を 1 回修復し、変更を spec.metadata.critique に記録します。これを無効にするには Architect(repair=False) を渡します。

キャンバスでの編集はモデルを呼び出さないため、即時かつ無料です

追加、ドラッグ、接続、編集、削除は決定的なフロントエンドの変更です。カタログドロワーはプロバイダーごとのリソース リストと、5 つの承認済みマルチリソースモジュールを提供します。その標準チェックは、孤立した接続、 不完全なモジュール、欠落したタグを検出します。無傷のモジュールは、カタログに固定されたソースとバージョンを持つ 単一の Terraform module ブロックとしてエクスポートされます。

1 つの MCP サーバーが 11 のコーディングエージェントに到達します

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 は MCP を扱えないため、 代わりに CLI パイプのレシピを取得します。各クライアントは異なる形式を求めます。Zed は context_servers を、 Copilot は servers を、Codex は TOML テーブルを求めます。

このサーバーは 10 のグループにわたる 24 のツールを公開します。design、cost、validate、analyze、export、session、review、compliance、 plan、migration です。完全なマトリクスは 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 ではエビデンスに基づくクローズを伴う移行計画が追加されます

• 1 つのモデルが資産全体をカバーします。 インフラストラクチャ、データ、アプリケーション、プラットフォーム、ネットワーク、 ファシリティ、ビジネスサービスが 1 つの依存関係グラフを共有します。
• 依存関係がウェーブを決定します。 プランナーは前提条件を最初にスケジュールし、循環を拒否し、 ロールバックパスを確認し、未解決のマッピングを報告します。
• クローズにはエビデンスが必要です。 欠落または失敗したブロッキング観測はクローズを妨げ、 migrate verify が終了コード 2 を返すようにします。
• 業界ルールはエンジンの外に留まります。 オプションの YAML パックは、コアに業界固有の フィールドを追加することなく、受け入れゲートを追加します。
• PH telco が最初の証明です。 製品は業界中立のままです。製造業の 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