architecture-review

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation,workflow

アーキテクチャレビュー

アーキテクチャレビューでは、アーキテクチャ上の決定事項全体がゲームデザインの要件をすべて網羅していること、内部で一貫していること、プロジェクトで固定されたエンジンバージョンを正しく対象としていることを検証します。Technical Setup と Pre-Production の間の品質ゲートです。

引数モード：

• 引数なし／full：フルレビュー — すべてのフェーズ
• coverage：トレーサビリティのみ — ADR がない GDD 要件を確認
• consistency：ADR 間の競合検出のみ
• engine：エンジン互換性の監査のみ
• single-gdd [path]：特定の GDD 1 件についてアーキテクチャの網羅性をレビュー
• rtm：要件トレーサビリティマトリクス — 標準のマトリクスを拡張し、ストーリーファイルとテストファイルのパスを含めます。GDD 要件 → ADR → ストーリー → テストの全チェーンを含む docs/architecture/requirements-traceability.md を出力します。ストーリーとテストが存在する Production フェーズで使用してください。

---

すべての AskUserQuestion 呼び出しは .claude/docs/automation-modes.md に従います（collaborative は常に質問し、guided は主要な項目のみ質問し、autonomous は記録して続行します。automation_always_ask カテゴリは常に質問します）。

workflow（.claude/docs/workflow-modes.md を参照）：

• full — すべての GDD とすべての ADR を網羅する完全なトレーサビリティマトリクス。
• standard — 範囲を縮小：アーキテクチャドキュメントと重要な ADR のみ。
• minimal — 該当しません（アーキテクチャドキュメントは不要です）。

フェーズ 1：すべてを読み込む

今すぐ references/1-load.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 2：すべての GDD から技術要件を抽出する

今すぐ references/2-extract-requirements.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 3：トレーサビリティマトリクスを作成する

今すぐ references/3-traceability.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 4：ADR 間の競合を検出する

今すぐ references/4-conflicts.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 5：エンジン互換性を相互確認する

今すぐ references/5-engine.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 6：アーキテクチャドキュメントの網羅性

今すぐ references/6-document-coverage.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 7：レビューレポートを出力する

今すぐ references/7-report.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 8：トレーサビリティインデックスを作成・更新する

今すぐ references/8-write.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

フェーズ 9：引き継ぎ

今すぐ references/9-handoff.md を読み、手順に従ってください — このフェーズの手順はここではなく、そのファイルに記載されています。このフェーズ中に会話が圧縮または再開された場合は、もう一度読み直してください。

エラー回復プロトコル

まず、成果物を確認してください。 戻り値の契約でパスが指定されている場合は、フェーズが完了したと判断する前に、そのパスが存在するか確認してください。指定された成果物がディスク上にない場合、応答がどれほど流暢でも、そのフェーズは失敗です。 エージェントがフェーズを丸ごと費やし、何も書き込まずにもっともらしい前置きを返すことがあります。これは BLOCKED でもエラーでも「完了できなかった」でもないため、以下のトリガーは作動しません。満たされていない契約を明示して再開してください。通常、コンテキストはまだ残っています。

起動したエージェントのいずれかが BLOCKED を返す、エラーになる、または完了しない場合は、すぐにその状況を伝え、依存関係の妨げになる処理を先に進めず、必ず部分的なレポートを作成してください（ここでの再試行範囲＝GDD の数を減らす／単一システム）。手順の全文は .claude/docs/error-recovery-protocol.md を参照してください。

---

コラボレーションプロトコル

collaborative モード（デフォルト）に適用されます。 guided モードと autonomous モードについては、.claude/docs/automation-modes.md を参照してください。以下のルールは collaborative モードで必要な動作を説明するものであり、すべてのモードに共通するものではありません。

1. 黙って読む — 読んだファイルをいちいち説明しないでください
2. マトリクスを示す — 書き込みの承認を求める前に、トレーサビリティマトリクス全体を提示してください。ユーザーが状況を把握できるようにします
3. 推測しない — 要件が曖昧な場合は、「[X] は技術要件ですか、それとも設計上の好みですか？」と尋ねてください
4. 承認前にドラフトを提示する — 書き込む内容（レポート、更新する ADR セクション、systems-index の行）を、承認を求める前に必ず会話内に提示してください。ユーザーがまだ見ていない内容の書き込みを求めてはいけません
5. 書き込みの承認には AskUserQuestion を使用する — テキストだけで「よろしいですか？」と尋ねても不十分です。ラベル付きの選択肢 [A]/[B]/[C] がある構造化ツールを使用し、ユーザーが「今すぐ書き込む」「最初にドラフト全体を表示する」「まだ行わない」から選べるようにしてください。複数ファイルに変更を加える場合は、変更するファイルと内容をすべて列挙したうえで、ファイルごとにテキストだけで質問するのではなく、選択肢をまとめて一度だけ尋ねてください。
6. 進行を妨げない — 判定は助言です。CONCERNS や FAIL の指摘があっても、続行するかどうかはユーザーが決めます