drawio-aws

Draw.io AWS

draw.io で正確な AWS アーキテクチャ図を作成します。このスキルは薄いフロントエンドです。決定論的なエンジン、バリデーター、ルールは drawio-ai CLI 経由で利用する drawio-ai-kit パッケージにあります。

0. 事前確認 — CLI がインストールされている必要があります

command -v drawio-ai >/dev/null 2>&1 || echo "Install the Kit first:  npm i -g github:sparklabx/drawio-ai-kit"

drawio-ai が PATH にない場合は、そこで停止し、npm i -g github:sparklabx/drawio-ai-kit を実行するようユーザーに伝えてください。決して自分で npm i -g を実行しないでください — ユーザーの許可なく、ユーザーのグローバル環境に変更を加えてはいけません。

1. 作成を委任する（ハーネスが対応している場合は推奨）

ハーネスがシェルコマンドを実行し、画像も読み取れる自律型サブエージェントを起動できる場合（例：Claude Code の Task ツール、汎用エージェント）は、作成の一連の作業をサブエージェントで行ってください。ルール、アイコン検索、レンダリングと修正の反復に、この会話のリソースを使わずに済みます。対応していない場合（またはサブエージェントが画像を読み取れない場合）は、以下のインライン手順に進んでください。同じループ、同じルールです。

起動する前に、サブエージェントが確認できない情報を確定してください。図の範囲、出力ディレクトリ（ユーザーのプロジェクト内の絶対パス）、ファイル名を決めます。上記の事前確認は自分で実行してください。複数の図を依頼された場合は、異なるファイル名を指定して、図ごとにサブエージェントを並列で1つ起動してください。

モデルの割り当て — ハーネスでサブエージェントのモデルを選べる場合は、タスクの重さに応じて割り当ててください。ルールの Templates 表にあるテンプレートに一致する依頼（再現は機械的で、バリデーターのアドバイス文が修正方法を示します）には高速・低コストのモデル層（Claude Haiku クラス — ビジョン対応が必須）を、自由形式または新規のアーキテクチャには標準の高性能モデルを使用してください。低コストのサブエージェントが VALIDATE を ok にできなかった場合、または ITERATIONS > 3 の場合は、インラインで引き継ぐ前に高性能モデルで1回再起動してください。複数の図を依頼された場合は、それぞれの図に個別にモデルを割り当ててください。

サブエージェントへのプロンプト（すべての <...> を置き換えてください）：

Build an AWS architecture .drawio diagram with the drawio-ai CLI.
Request: <user's request + clarifications, verbatim>
Output: <ABS_PROJECT_DIR>/<NAME>.drawio — never write inside the Kit, never into cwd.
Follow exactly:
1. Set ROOT="$(drawio-ai root)". Read $ROOT/docs/api-cheatsheet.md — the full layout-engine
   API in one file; never read library source.
2. Run `drawio-ai workflow` and `drawio-ai principles --mode aws` — the source of
   truth. (Fallback if a command is blocked: read $ROOT/rules/*.md directly.)
3. Look up every icon with ONE batched `drawio-ai search "a, b, c"`; never recolor icons.
4. Scaffold, don't write: `drawio-ai scaffold --list`, pick the closest template, then
   `drawio-ai scaffold <name>.mjs -o <dir>/build.mjs` — the script arrives runnable
   (absolute imports, self-validating, self-rendering with an issues list). Edit only the
   deltas. If no template is close AND you'd change more than half of it, Write a new
   script instead (keep the scaffold's self-check tail). Layout engine only
   (group/frame/grid/icon/box + renderTree), NO hand-written coordinates.
5. Each `node build.mjs` run prints validate JSON AND the render's machine-readable
   `issues` list. Fix from THAT checklist — all issues in one Edit round — then re-run.
   Loop until issues is empty.
6. Only when issues is empty: Read the PNG once as final visual confirmation (list any
   remaining visual problems, fix ALL in one round). Target <= 2 PNG reads total. Then
   render once WITHOUT --check for the final deliverable PNG.
Do NOT invoke any drawio skill — this prompt already contains the full procedure.
Do not ask questions — make the standard choice and record it under ASSUMPTIONS.
Return EXACTLY this block, nothing else:
DRAWIO: <absolute path to .drawio>
PNG: <absolute path to .png>
VALIDATE: <verbatim final validate JSON>
ICONS: <comma-separated icon names used>
ITERATIONS: <number of render/fix cycles>
SUMMARY: <one sentence describing the diagram>
ASSUMPTIONS: <choices made without asking, or "none">

DRAWIO、PNG、SUMMARY をそのままユーザーに伝えてください。この会話で .drawio または PNG を再読込しないでください — サブエージェントがすでにビジョンのセルフチェックを実施しています。VALIDATE が ok でない場合は、インライン手順で引き継いでください（build .mjs と .drawio は返されたパスにあります）。

インライン手順（サブエージェントに対応していない場合）

1. 共通ワークフロー

drawio-ai workflow

すべての図で実行する、作成 → 検証 → レンダリング → プロジェクトのパスへの書き込みのループを出力します。読み込んでください。これは手順の基準となる情報です。

2. ドメインルール

drawio-ai principles --mode aws

AWS のルール、共通原則、カタログのカテゴリを返します。

3. エンジンで作成し、検証してレンダリングする

Kit のインストールディレクトリを確認し、エンジンを絶対パスで import してください（正確なパターンは共通ワークフローに記載されています）。

ROOT="$(drawio-ai root)"     # absolute path to the installed Kit

宣言型レイアウトエンジンで作成してください（座標を手書きしないでください）。その後、drawio-ai validate <file> → drawio-ai render <file> -o <file>.png（ビジョンのセルフチェックのため PNG を Read します）→ .drawio をユーザーのプロジェクト内の絶対パスに書き込みます（Kit や cwd には書き込まないでください）。

ドメインに関する注意

コンテナーのネスト順：AWS Cloud → Region → VPC → AZ → Subnet → SG。 マネージド／グローバルサービス（CloudFront、Route 53、S3、DynamoDB、SQS/SNS）は VPC の外部に配置します。サブネット内には配置しません。カタログに記載されたカテゴリの色が正式なものです。AWS アイコンの色は絶対に変更しないでください。

セルフチェック（納品前）

• レイアウトエンジンで作成している — 座標を手書きしていない。
• drawio-ai validate → ok、警告なし、アドバイスなし。
• drawio-ai suggest-layout → 推奨されるアーキタイプがレイアウトに一致し、疎性（one-icon-frame）警告がない。
• すべてのアイコンを drawio-ai search で取得している（カテゴリの色を保持している）。
• drawio-ai render によるビジョンのセルフチェックに合格している。
• 出力先が Kit ではなく、ユーザーのプロジェクト内である。