Grill Me — 系統的な尋問による相互理解
哲学
グリルの目的は、エージェントとユーザーの間で相互理解を構築することです。すべての計画には暗黙の前提、未表明の制約、曖昧な決定が含まれています。グリルは決定木のすべての枝を一つずつ歩き、両者が完全に一致するまで進めます。
目標は、実装開始前にゼロの未検討前提を実現することです。
基本指示
- すべての質問に AskUserQuestion を使用する。 すべての尋問質問は
AskUserQuestionツールを介して行います。質問をプレーンテキストとして出力してはいけません。 - ドメイン内でバッチ処理する。 同じ尋問ドメイン内の関連質問を最大4つまで1回の
AskUserQuestion呼び出しにまとめます。異なるドメインの質問を1回の呼び出しに混ぜてはいけません。 - 推奨を先頭に置く。 推奨する回答は常に最初のオプションとし、ラベルに
(Recommended)を追加します。 - 質問の前に調査する。 質問の答えがコードベースの読み取り、ドキュメントの確認、既存パターンのチェックで得られる場合は、質問する代わりにそれを行います。ユーザーの判断が必要な決定についてのみ質問します。
- 依存関係を順に解決する。 一部の決定は他の決定に依存します。依存チェーンを特定し、上流の決定から先に解決します。
- すべてを構造化レコードで追跡する。 決定ログを構造化テーブルとして維持します。解決済みの質問ごとに、ドメイン、トピック(ヘッダー)、選択されたオプションラベル、および「その他」が選択された場合のカスタムテキストを記録します。ログは会話コンテキスト内で提示します。ファイルI/Oは行いません。
- 前提は残さない。 暗黙的に示されていても明示されていないものがあれば表面化させます。明白に見えることも確認します。相互理解とは明示的な合意であり、気まずい沈黙ではありません。
- 具体的に留める。 質問は具体的な動作、データフロー、ユーザーから見える成果に基づいて構成します。抽象的な概念ではありません。
尋問前のセットアップ
質問を始める前に、黙ってコンテキストを構築します。
- ユーザーがグリルしてほしい計画または設計文書を読む
- コードベースを探索し、既存のパターン、制約、関連コードを確認する
- 最近のgit履歴をチェックして、現在の作業のコンテキストを得る
- project.md と CLAUDE.md を読み、プロジェクトの規約を確認する
次に、現在の理解を尋問ドメインごとに整理した簡単な要約を提示します。これにより、ユーザーは枝ごとの質問に入る前に大きな誤解を修正できます。
尋問ドメイン
references/interrogation-domains.md で定義されたドメインを処理します。順序は計画に合わせて調整します。構築するものに最も中心的なドメインから始め、外側に向かって進めます。明らかに関係のないドメインはスキップします。
尋問プロセス
1. 計画の理解を読み取り、要約する
2. ユーザーが要約を確認または修正する
3. 各尋問ドメインについて(関連性順に):
a. このドメイン内のすべての決定点と前提を特定する
b. 関連する決定点を最大4つの質問のバッチにグループ化する
c. 各バッチに対して、1回の AskUserQuestion 呼び出しを実行する
(各質問の最初に推奨を置く)。選択されたすべてのオプションを記録する。
d. ドメイン内のすべての点を解決した後、行われた決定を要約する
ドメインの決定を構造化テーブル形式の行として提示する。
4. すべてのドメインをカバーした後:
- 完全な決定ログを構造化テーブルとして提示する:
| # | ドメイン | トピック | 決定 | 備考 |
|---|----------|----------|------|------|
| 1 | 意図 | 目標 | その他 | 社内向け運用チーム用ダッシュボード、顧客向けではない |
- 未解決または延期された項目があればフラグを立てる
- 再検討が必要なドメインがないか尋ねる
質問形式
すべての質問は AskUserQuestion ツールを介して行う必要があります。各呼び出しは次のように構成します。
{
"question": "Oura API が429を返した場合、レート制限をどのように処理すべきですか?",
"header": "レート制限",
"options": [
{
"label": "指数バックオフ(推奨)",
"description": "指数バックオフ(1秒、2秒、4秒)で再試行します。一時的な制限を適切に処理し、src/api_client.py ですでに使用されている再試行パターンと一致します。"
},
{
"label": "次回実行にキューイング",
"description": "リクエストをスキップし、次のスケジュール実行に追加します。より簡単ですが、データが1サイクル遅れます。"
}
],
"multiSelect": false
}
依存関係: この質問が基づく先行決定がある場合は question テキスト内に記載するか、スタンドアロンの場合は「依存関係なし」と記します。
バッチ処理質問の例
{
"questions": [
{
"question": "主要なデプロイ先は何ですか?",
"header": "デプロイ",
"options": [
{
"label": "Docker + ECS(推奨)",
"description": "既存のインフラと一致します。デプロイパイプラインはすでに存在します。"
},
{
"label": "Kubernetes",
"description": "より柔軟ですが、新しいインフラのセットアップが必要です。"
},
{
"label": "サーバーレス",
"description": "運用負荷は低いですが、コールドスタートレイテンシの懸念があります。"
}
],
"multiSelect": false
},
{
"question": "どのモニタリングアプローチを含めるべきですか?",
"header": "モニタリング",
"options": [
{
"label": "構造化ログ(推奨)",
"description": "CloudWatch へのJSONログ。検索可能でアラート設定可能。"
},
{
"label": "APMトレース",
"description": "リクエストフロー可視化のための分散トレーシング。"
},
{
"label": "カスタムメトリクス",
"description": "Datadog でのビジネス固有のカウンターとゲージ。"
}
],
"multiSelect": true
}
]
}
プレビューの使用
ユーザーがコードスニペット、アーキテクチャ図、スキーマ形状、構成例など具体的な成果物を視覚的に比較する必要がある場合、オプションの preview フィールドを使用します。プレビューコンテンツは等幅ボックス内のマークダウンとしてレンダリングされ、横並びで比較できます。
プレビューを使用するタイミング:
- 2つのコードパターンや実装を比較する場合
- 異なるスキーマ形状やデータ構造を示す場合
- ASCII図を使用したアーキテクチャの代替案を提示する場合
制約: プレビューはシングルセレクトのみです(multiSelect: false)。マルチセレクトが必要な場合は、プレビューを省略し、代わりに説明を使用します。
プレビュー付きの例:
{
"question": "データパイプラインにはどのパターンを使用すべきですか?",
"header": "パイプライン",
"options": [
{
"label": "ジェネレータパイプライン(推奨)",
"description": "遅延評価、大規模データセットでメモリ効率が良い。",
"preview": "def pipeline(source):\n for record in source:\n cleaned = clean(record)\n validated = validate(cleaned)\n yield validated"
},
{
"label": "バッチパイプライン",
"description": "すべてのレコードを一度に処理します。よりシンプルですがメモリ使用量が増加します。",
"preview": "def pipeline(source):\n records = list(source)\n cleaned = [clean(r) for r in records]\n validated = [validate(r) for r in cleaned]\n return validated"
}
],
"multiSelect": false
}
質問に関するルール
- すべての質問に AskUserQuestion を使用する。 絶対に。
- 最初のオプション = 推奨。 最初のオプションには常にラベルに
(Recommended)を付けます。 - 関連質問はバッチ処理する。 同じドメインの関連質問を最大4つまで1回の AskUserQuestion 呼び出しにまとめます。異なるドメインの質問は別々の呼び出しにする必要があります。
- ツールの制約を尊重する。 質問あたり2〜4オプション。ヘッダーは最大12文字。オプションが相互排他的でない場合(例:「どのテストアプローチを使用すべきか?」や「どのドメインをカバーする必要があるか?」)は
multiSelect: trueを使用します。 - オプションをフィルタリングする。 有効な選択肢が4つ以上ある場合は、コードベースのコンテキストに基づいて最も関連性の高い3つを提示します。ユーザーはリストにないものに対して「その他」を選択します。
- 具体的にする。 「エラーをどのように処理すべきか?」は漠然としすぎています。「Oura API が429を返した場合、バックオフで再試行するか、次回実行にキューイングすべきか?」は具体的です。
- 根拠を示す。 推奨がコードベースで見つけたものに基づいている場合は、ファイルと行を参照します。
- 回答を受け入れる。 ユーザーが決定したら、それを記録して次に進みます。後続の決定が以前の決定と矛盾を生じない限り、再議論しないでください。
フォールバック(AskUserQuestion が利用できない場合)
実行環境で AskUserQuestion が利用できない場合は、次のテキスト形式にフォールバックします。
[ヘッダー] — [トピック]
[質問の明確な記述]
推奨: [推奨内容とその理由]
代替案:
- (A) [オプション] — [トレードオフ]
- (B) [オプション] — [トレードオフ]
いつ停止するか
グリルは次の場合に完了します。
- 関連するすべての尋問ドメインがカバーされた場合
- すべての決定枝が解決されるか、明示的に延期された場合
- ユーザーが相互理解を確認した場合