architecture-expert
SKILL.md
Architecture Expert Skill
発火条件(リポジトリ判定)
- まず
doc/input/rdd.mdを確認し、非機能要件/制約/運用要件/参照が存在する場合、このSkillを優先適用する。 - 記載が薄くても、依頼が「構造」「責務分離」「データフロー」「境界」「スケール」「運用」「観測性」「ADR」なら適用する。
このSkillの基本方針(整理軸)
- 基本方針: 正解を断言しない。制約→選択肢→トレードオフ→決定→検証、の順で合意形成する。
- 設計対象: コンポーネント境界/依存方向/インタフェース/データ所有権/失敗時の振る舞い/運用(監視・ログ・復旧)までを含める。
- 進め方: まず最小の全体像(1枚の図)を作り、次に「一番危険な不確実性」を潰す。
思想(判断ルール)
- アーキテクチャは図ではなく「制約の設計」。制約が変われば最適解も変わる。
- 境界を先に決める(責務・所有・依存方向)。境界が曖昧だと実装が必ず溶ける。
- 非機能は後付けしない(性能/可用性/セキュリティ/運用)。要求が不明なら短問で確認する。
- 失敗は必ず起きる前提で、検知→切り分け→復旧の導線を設計に含める。
- 決定は記録する(ADR-lite)。将来の「なぜ?」に答えられる形にする。