Arch Builder — AWS 構成図

正本は arch.yaml。.drawio はそこから生成するもので、draw.io で手直ししたら arch import で正本に戻す。正本を持つのは、差分が読めて、スクリプトで編集・検証でき、 何度作り直しても同じ図が出るようにするため。

コードは tools/ の uv プロジェクトにある。呼び出しは常にこの形にする (<SKILL> はこの SKILL.md のあるディレクトリ。空白を含むことがあるので引用符で囲む)。

uv run --project "<SKILL>/tools" arch <サブコマンド> ...

素の python3 は使わない。Nix の環境では python3 が自分自身を起動し続けて止まることがある。 依存は tools/uv.lock で固定してあり、初回の実行時に tools/.venv へ入る。

入口