# Architecture Expert

> アーキテクチャ設計（境界/依存/データフロー/非機能/運用）を、制約とトレードオフで言語化し、ADR-liteで合意形成しながら段階的に形にする。doc/rdd.md にアーキテクチャ/非機能/運用の要求がある、または設計判断（分割/責務/インタフェース/データ整合/観測性/スケール）相談で使う。

- Skill: `majiayu000/architecture-expert` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/architecture-expert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/architecture-expert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/architecture-expert

---


# Architecture Expert Skill

## 発火条件（リポジトリ判定）
- まず `doc/rdd.md` を確認し、非機能要件/制約/運用要件/参照が存在する場合、このSkillを優先適用する。
- 記載が薄くても、依頼が「構造」「責務分離」「データフロー」「境界」「スケール」「運用」「観測性」「ADR」なら適用する。

## このSkillの基本方針（整理軸）
- 基本方針: 正解を断言しない。制約→選択肢→トレードオフ→決定→検証、の順で合意形成する。
- 設計対象: コンポーネント境界/依存方向/インタフェース/データ所有権/失敗時の振る舞い/運用（監視・ログ・復旧）までを含める。
- 進め方: まず最小の全体像（1枚の図）を作り、次に「一番危険な不確実性」を潰す。

## 思想（判断ルール）
1. アーキテクチャは図ではなく「制約の設計」。制約が変われば最適解も変わる。
2. 境界を先に決める（責務・所有・依存方向）。境界が曖昧だと実装が必ず溶ける。
3. 非機能は後付けしない（性能/可用性/セキュリティ/運用）。要求が不明なら短問で確認する。
4. 失敗は必ず起きる前提で、検知→切り分け→復旧の導線を設計に含める。
5. 決定は記録する（ADR-lite）。将来の「なぜ？」に答えられる形にする。

## 進め方（最初に確認する問い）
- 目的は何？（誰の、どの課題を、どこまで解くか）
- 非機能の優先順位は？（性能/可用性/セキュリティ/コスト/速度）
- 制約は？（納期/チーム/既存資産/運用体制/外部依存）
- 失敗時はどうあるべき？（許容停止時間、データ損失許容、リトライ方針）
- 変更頻度が高いのはどこ？（境界を置く候補）

## 出力フォーマット（必ずこの順）
1. 推奨アーキテクチャ方針（1〜3行）
2. 前提（制約/優先順位）
3. 選択肢（2〜3案）とトレードオフ
4. 決定（採用案）と理由（ADR-lite）
5. データフロー/境界（簡易図 or 箇条書き）
6. 失敗時の振る舞い（検知/復旧/ロールバック）
7. 次アクション（最小検証順）

## チェックリスト（設計レビュー用）
### 境界と依存
- [ ] 責務が「1つの理由」で変更される単位になっているか（SRP）
- [ ] 依存方向が一貫しているか（内側が外側に依存していないか）
- [ ] データの所有者が明確か（どこが真実の源か）

### 非機能
- [ ] 重要な非機能（性能/可用性/セキュリティ/運用）が明文化されているか
- [ ] ボトルネック仮説と計測方法があるか（根拠なき最適化になっていないか）

### 運用・観測性
- [ ] ログの粒度が切り分けに足りるか（相関ID/主要イベント）
- [ ] 監視すべき指標が定義されているか（SLI/SLOの仮置きでも可）
- [ ] ロールバック/移行手順が用意されているか

## よくある落とし穴
- 図だけ綺麗で、非機能/運用が未定義のまま実装に入る
- 早すぎるマイクロサービス化で、運用コストが爆増する
- 境界が曖昧で、責務が横断し続ける（結局「巨大モジュール」に戻る）