Grilling

計画・設計のあらゆる側面をユーザーにインタビューし、設計ツリーの各分岐を1つずつ解決しながら、共有理解（shared understanding）に至るまでストレステストする。

出典: mattpocock/skillsのgrilling を既存規約にフル適合させたもの。

用語注記: 本スキルの「AskUserQuestion」はユーザーへの選択肢提示質問を指す。Claude CodeではAskUserQuestionツール（1回最大4問）を使い、無い環境（Codex等）では番号付き選択肢のテキスト質問で代替する（1回4問の上限も同様に扱う）。

原則

• 独立枝はまとめる、依存枝は1つずつ: 互いに前提を変えない独立した枝は、1回の AskUserQuestion に最大4問までまとめてよい。まとめるときは、各 question の文に背景と推奨の理由を1文ずつ入れて自己完結させる（2問目以降を読む時点で、地の文の説明は画面外にあるため）。回答が後続の質問の前提を変える枝は1問ずつ降りる
• 推奨回答を必ず添える: 各質問に自分の推奨案と根拠を提示する
• 設計ツリーを枝ごとに降りる: 決定間の依存関係を意識し、前の回答が後の質問の前提を変える箇所ではまとめず順に解決する
• 調査で答えが出る質問はユーザーに聞かない: コードベース・公式ドキュメントの調査で確定できる事項は自分で調べて確定し、事実として提示する
• 共有理解に至るまで実行しない: ユーザーが「共有理解に達した」と確認するまで、計画の実行・実装に着手しない

ワークフロー

1. 対象の把握

• グリル対象（計画・設計・アイデア）を特定する。会話中に提示済みならそれを使い、ファイル（30_plan.md等）が指定されたら読む
• 対象に関連する既存コードがあれば先に調査し、事実ベースの質問を組み立てる

2. 尋問ループ

• AskUserQuestionで質問する（まとめ方は「原則」の1つ目）。推奨案は先頭オプションに置き、ラベル末尾に「（推奨）」を付ける。選択肢化が不自然な自由回答型の質問のみテキストで聞く
• 質問の観点例: 目的・成功条件 / スコープ境界 / エッジケース / 依存関係と順序 / 技術選定の根拠 / 運用・移行・ロールバック / 非機能（性能・セキュリティ）
• 回答によって前提が変わったら、影響を受ける未解決の枝に戻って質問し直す
• ユーザーの回答が既存コード・事実と矛盾する場合は、調査結果を添えて指摘する

3. 収束

• 未解決の枝がなくなったら、合意事項・却下した代替案・残リスクをサマリとして提示し、共有理解に達したかユーザーに確認する
• サマリ提示時に、ADR条件（下記）を満たす決定があればADRとして記録する
• 確認が取れるまで実装・実行には移らない
• Phase 0-5 の計画（30_plan.md）をグリルした場合は、合意事項を 30_plan.md に反映し、経緯を 05_log.md に、却下した代替案を 99_history.md に書く（形式は書く前に context/memory-file-formats.md を Read する）

決定の記録（ADR等 → .local/docs/）

グリル中に確定した決定のうち、以下の3条件をすべて満たすものは、ADRとして ${MEMORY_DIR}/docs/adr/NNNN-<slug>.md（MEMORY_DIR未定義時は .local/docs/adr/）に保存する:

1. 覆しにくい: 後から方針転換するコストが大きい
2. 文脈なしでは不可解: 将来の読者がコードだけを見て「なぜこうした？」と不思議に思う
3. 実在したトレードオフの結果: 本物の代替案があり、特定の理由で選んだ

3条件を満たさない決定は記録しない（覆しやすい決定は覆せばよく、自明な決定は誰も理由を問わない）。

• 形式: タイトル＋1〜3文（文脈・決定・理由）で足りる。セクションを埋めること自体に価値はない。決定が再訪されそうな場合のみStatus（proposed / accepted / deprecated / superseded by ADR-NNNN）を、却下理由が非自明な場合のみ「考慮した選択肢」を追加する
• 連番: docs/adr/ 内の最大番号+1。ディレクトリは最初のADRが必要になった時に遅延作成する
• 用語集: グリル中に用語の揺れ（同じ概念への複数の呼び名）が問題になったら、.local/docs/context.md に推奨語と回避語（Avoid）を記録する
• 境界: タスク限りの「やらない判断」は99_history.md。タスクを超えて残すべき設計決定のみADRにする
• worktree内での実行時: メモリファイルと同じく、元 repo の絶対パスに書く（worktree 内に .local/ は無いため。AGENTS.md「メモリ・issue ディレクトリ」）