create-architecture

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

上記で解決済みです。そのまま使用してください。--review は review_mode を上書きします。ブロックがない場合のデフォルトは .claude/docs/config-resolution.md にあります。

アーキテクチャの作成

このスキルは docs/architecture/architecture.md を作成します。これは、承認済みのすべての GDD を具体的な技術設計図に落とし込む、アーキテクチャのマスタードキュメントです。設計と実装の間に位置し、スプリント計画を開始する前に作成しておく必要があります。

/architecture-decision との違い：ADR は個々の特定の決定を記録します。このスキルは、ADR に文脈を与えるシステム全体の設計図を作成します。

完全なチェックパターンについては .claude/docs/director-gates.md を参照してください。個々のゲート定義は .claude/docs/director-gates/[gate-id].md にあります。起動されたエージェントが自身のゲートファイルを読み取ります。親セッションでは読み取らないでください。

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

docs.density — セクションごとの詳細度を制御します。どのセクションを含めるかは workflow が制御します。modes.rigor は両方をまとめて設定します。詳細度だけを変えるには、docs.density を明示的に設定します。terse（デフォルト。rigor: minimal による）ではレイヤー図と判断事項の箇条書きのみで、解説文は含めません。balanced では図と、レイヤーの選択理由の段落による説明を含めます（rigor: standard）。thorough では、各レイヤーについて根拠、トレードオフ、検討した代替案を含む詳細な文章を記述します。作成するすべてのセクションに適用してください。

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

• full — 完全なアーキテクチャ：すべてのレイヤー、モジュールの所有権、データフロー、API 境界、完全な ADR 監査。
• standard — 簡易版：システムレイヤーマップと重要な ADR のリストのみ。
• minimal — 必須ではありません。任意で実行できます。

引数モード：

• 引数なし / full：すべてのセクションを最初から最後まで進める、完全なガイド付きウォークスルー
• layers：システムレイヤー図のみを対象とします
• data-flow：モジュール間のデータフローのみを対象とします
• api-boundaries：API 境界の定義のみを対象とします
• adr-audit：既存の ADR におけるエンジン互換性の不足のみを監査します

---

フェーズ 0：すべてのコンテキストを読み込む

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

フェーズ 1：システムレイヤーのマッピング

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

フェーズ 2：モジュール所有権マップ

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

フェーズ 3：データフロー

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

フェーズ 4：API 境界

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

フェーズ 5：ADR 監査 + トレーサビリティチェック

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

フェーズ 6：不足している ADR の一覧

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

Phase 7: マスターアーキテクチャドキュメントの作成

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

Phase 8: 引き継ぎ

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

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

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

このスキルでは、すべてのフェーズで共同設計の原則に従います。

1. コンテキストを黙って読み込む — ファイルを読んだことを逐一説明しないでください
2. 調査結果を提示する — ナレッジギャップの一覧とレイヤーの提案を示します
3. 決定前に尋ねる — アーキテクチャ上の選択肢ごとにオプションを提示します
4. 承認前に草案を作成する — 書き込む前に、内容をインラインで提示します。 ユーザーがまだ見ていないセクションについて、承認を求めてはいけません。
5. 書き込みの承認には AskUserQuestion を使用する — 「よろしいですか？」という通常のテキストだけでは不十分です。ラベル付きオプション [A]/[B]/[C]（今すぐ書き込む／先に草案全体を表示する／まだ書き込まない）を使って、構造化ツールを使用してください。複数ファイルの変更では、各ファイルと変更内容をすべて列挙してから、ファイルごとに個別のテキストで尋ねるのではなく、まとめて一度に尋ねてください。
6. すべてのセクションの承認後に一度だけ書き込む — ドキュメントの書き込みは Phase 7 で一度だけ行います。Phase 7b の Step 4 では、個別に確認を求めた後に Document Status のみを更新します。承認された各セクションの決定事項は、その都度 production/session-state/active.md に記録し、クラッシュしても決定事項が失われないようにしてください。Phase 7b で必要になった改訂も同様に、再作成したセクションの承認後に一度だけ書き込みます。また、更新（Phase 0e）では、選択したセクションのみを書き込みます。

ユーザーの入力なしに、拘束力のあるアーキテクチャ上の決定をしてはいけません。ユーザーが迷っている場合は、決定を求める前に、長所と短所を添えて2～4個の選択肢を提示してください。

---

推奨される次のステップ

• Phase 6 に記載された必須の ADR ごとに /architecture-decision [title] を実行します — まず Foundation レイヤーの ADR から始めます
• /architecture-review を実行します — 作成した ADR をもとに Requirements Traceability Matrix と TR レジストリを初期化し、各暫定 TR-ID に正式な ID を割り当てます。Pre-Production ゲートの前に必ず実施してください。
• /test-setup を実行して、tests/unit/、tests/integration/、CI ワークフロー、テスト例をひな形として作成します（gate-check に必須）
• /ux-design を実行して、design/ux/interaction-patterns.md と design/accessibility-requirements.md を初期化します（gate-check に必須）
• 必須の ADR を作成したら /create-control-manifest を実行し、レイヤールールのマニフェストを作成します
• 必須の ADR、/test-setup、/ux-design がすべて完了したら /gate-check pre-production を実行します