发版时自动刷新架构图
CI regenerates architecture diagrams
要点
- 别让模型直接画图:规则写 conventions.md,资源关系写 structure.yaml,再抽结构。
- Claude Code 从代码抽出结构,D2 负责布局,GitHub Actions 在发版时自动重绘。
- 原来要一小时以上的图,微调后大约十分钟;人审中间 YAML,不审最终像素。
- 同一套路可套到设计书、运维手册和数据流图:先生成可审结构,再渲染成品。
原帖开头
「システム構成図、もう手で描くのやめました」 ZOZOのClaude Code活用が面白い。 ソースコードから直接“絵”を描かせるのではなく、 ・conventions.md → 描画ルール ・structure.yaml → リソースと接続関係 ・Claude Code → コードから構造を抽出 ・D2 → レイアウトを描画 ・GitHub Actions → リリース時に自動更新 という形で、構成図を「構造・規約・レイアウト」に分離。 結果、1時間以上かかっていた作業が、微調整込み約10分に。 個人的に重要だと思ったのはここ。 「AIに成果物を …







