Grill Me: コードを書く前に AI に 50 の質問をさせます

失敗モード: 「AI は私が望むことをしてくれませんでした」

Matt がスピーチで話した最初の失敗モードは、頭の中で要件が非常に明確であると考え、AI にそれを書き出してもらうことです。それはまったく当てはまりません。

"I would run it, and I would try not to look at the code, but I would look at the code, and I realized I would get worse code. I did it again, I got even worse code... I did it again, kept running the compiler, and I would just end up with garbage."

多くの人がこの感覚をよく知っています。「ログインを追加してください」と言った場合、AI は「デバイスを覚えておきますか?」と尋ねることはありません。 「何回アカウントロックに失敗しましたか？」 「セッションが期限切れになるまでどれくらい時間がかかりますか?」合理的であると思われる計画を直接提示します。レビューするまでに 500 行が書かれており、やり直しに 2 時間かかります。

なぜこのようなことが起こるのか: 設計コンセプトの逸脱

マットは、フレデリック・P・ブルックスのデザインコンセプト（デザインコンセプト）を『デザインのデザイン』で引用しています。

複数の人々が協力して何かをデザインするとき、あなたたちの間で何かが生み出されます - それは目に見えない「これについての理論」としてあなたの心の中に浮かんでいます。それは資産ではなく、マークダウン ファイルに詰め込まれた資産でもありません。それは目に見えない合意です。

AI はコードを思いつくとすぐに書きます。つまり、AI は同じ設計コンセプトをまったく共有していません。コードを書くときに問題があるのは構文ではなく前提です。

この問題を解決するには、開始する前に、まず設計コンセプトの調整を行う必要があります。 Brooks が提供したツールは デザイン ツリー と呼ばれるもので、決定を複数のブランチに分割し、各ブランチを分割します。上流の決定をスキップして下流の決定を直接行うことはできません。そうしないと、上流から下流に変更されたときにすべてをやり直す必要があります。

マットのスキル全文

Matt による mattpocock/skills でのこの理論の実装は productivity/grill-me/SKILL.md であり、ファイル全体と前付け部分を合わせた合計は 15 行未満です。

---
name: grill-me
description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
---

Interview me relentlessly about every aspect of this plan until we reach
a shared understanding. Walk down each branch of the design tree,
resolving dependencies between decisions one-by-one. For each question,
provide your recommended answer.

Ask the questions one at a time.

If a question can be answered by exploring the codebase, explore the
codebase instead.

文ごとに解釈します。

• 「執拗に面接してください」 - キーワードは 執拗 (手放さない) です。デフォルトでは、LLM は 1 つまたは 2 つの質問をした後、「ほぼ」と感じて行動を開始する傾向があります。この言葉はその傾向を強引に抑え込んでいる。
• 「デザイン ツリーの各枝を下っていく」 —— Brooks のデザイン ツリーの概念。クロードに要件をツリーとして扱い、最初に上流を解決し、次に下流を解決するように強制します。 「ログイン」と言うと、最初に「認証方法」(ツリールート)を尋ねられ、答えに基づいて「セッションの管理方法」/「トークンの保存方法」(サブノード)が展開されます。
• 「決定間の依存関係を 1 つずつ解決する」 - パッケージ化された質問を明示的に禁止します。多くの場合、決定の間には依存関係があります (SSO を選択した場合、ダウンストリームはパスワード ポリシーの問題を必要としません)。まず、アップストリームがダウンストリームの問題の多くを排除できることを確認してください。
• 「質問ごとに、推奨される回答を入力してください」 - 主要なボーナス ポイント。 AIは質問するだけでなく、回答も推奨します。うなずいたり「いいえ」するだけで、入力時間を 80% 節約できます。
• 「一度に 1 つずつ質問する」 - AI が一度に 10 個の質問をするのを防ぎます。
• 「コードベースを調べることで質問に答えられる場合は、代わりにコードベースを調べてください。」 - それがプロジェクトにすでに存在する事実 (「プロジェクトでどのテスト フレームワークが使用されているか」など) である場合は、質問せずにクロードに自分で見てもらいます。

7 行ですが、各文は特定の LLM 行動バイアスに対応しています。

インストールと使用方法

インストール:

npx skills@latest add mattpocock/skills

grill-me と setup-matt-pocock-skills を確認します (グリルミーは後者に依存しませんが、他のスキルが依存するため、一緒にインストールすることをお勧めします)。

呼び出し: [クロード コード] ダイアログに /grill-me と入力します。

一般的なプロセス:

1. やりたいことを説明しますが、非常に漠然としたものになる可能性があります (「ブログにコメント機能を追加したい」) 2.「/grill-me」と入力します。
2. クロードは 1 つずつ質問を開始し、それぞれの質問に対して推奨される回答を示しました。
3. 各質問に 1 つずつ答えます (うなずく/いいえ/正解)
4. 通常、20 ～ 50 問の質問で合意に達し、クロードが要約を教えてくれます。
5. 概要を /to-prd に直接渡して PRD にすることも、/tdd に直接渡して書き込みを開始することもできます。

実際のケース: ビデオ編集機能の費用はいくらですか?

Matt は、「私が毎日使用する 5 つのエージェント スキル」 でいくつかの具体的な数字を示しました。

• 新しいビデオエディター機能 - 合意に達するための 16 の質問
• 複雑な関数 - 30~50問
• 非常に複雑 - 100 の質問、セッションは最大 45 分

質問の例 (Matt のビデオ/ブログ投稿から復元):

• "Should video clips be reorderable, or only added/removed in sequence?"
• "When a clip is deleted, do we keep its source file, or delete the file too?"
• "Does the editor need undo/redo? How many steps deep?"
• "Should we render previews in the browser, or rely on a backend service?"

これらの問題はいずれも技術的なものではなく、すべて製品に関する決定でした。しかし、すべての決定が、数百行のコードの形状を決定します。これらの質問をスキップして、AI に直接質問を書かせた場合、AI は自動的に一連の答えを考え出し、書いた後に戻ってきて 1 つずつ拒否することになります。

プラン モードとクロード コードの組み込みプラン モードの違い

クロード コードには plan mode が付属しています (Shift+Tab を押して入力します)。表面的には、グリルミーに似ています。行動を起こす前に、まず話し合ってください。しかし、マットはスピーチの中で、グリルミーの方が好きだと直接言いました。

具体的な違い:

実際的な最大の違いは、「緊急かどうか」です。プランモードは急いで始めますが、グリルミーは急いでいません。「明確に考える」ことをプロローグではなく主要なタスクとして捉えます。

高度な使用法

1. プログラミング以外のシナリオ

grill-me はコードをバインドしないため、純粋な製品に関する意思決定の会話にも使用できます。マット自身もそれを使用しています:

• コースのシラバスの設計
• 記事執筆
• 社内コミュニケーション文書

頭の中に漠然としたアイデアがあり、それをじっくり考えさせたい場合に使用できます。

2. /to-prd に協力する

グリルミー セッションが終了したら、/to-prd と言うだけで、クロードが会話全体を構造化された PRD (ユーザー ストーリー、モジュール分割、テスト戦略を含む) に凝縮し、問題トラッカーに送信します。 重要なポイント: 途中でコンテキストをクリアしないでください - to-prd は会話コンテキストから直接抽出され、再度尋ねられることはありません。

3. /grill-with-docs に協力する

プロジェクトにすでに CONTEXT.md (ドメイン言語) と docs/adr/ (アーキテクチャ上の決定) がある場合は、/grill-me の代わりに /grill-with-docs を使用します。拷問中、同期的に CONTEXT.md を更新します。ドキュメントが更新されている間に意思決定が行われるため、「ドキュメントが永久に古い」という問題はもうありません。

4. 質問の深さをカスタマイズする

時間がない場合は、/grill-me の直後に「質問は 10 個に制限し、アーキテクチャに関する決定のみに焦点を当ててください。」という文を追加できます。制限に応じて収束します。しかし、マットはそれをお勧めしません。彼は「もっと質問する」ことがまさにこのスキルの価値であり、それをカットすることは計画モードとほぼ同じであると信じています。

注意事項

初めて実行するときはイライラするでしょう。 「一文で500行を生成する」ことに慣れている人は、初めてAIに30回も質問されるのは時間の無駄に感じるでしょう。マットのアドバイスは、最初の 5 つの質問を保留することです。最初の 5 つの質問によって、考えもしなかったことが明らかになることがよくあります。その閾値を超えると、中毒になります。

非常に小さなタスクには適していません。タイプミスを変更し、console.log を追加します。grill-me は使用しないでください。 「新しいものを作る」場合や「副作用を伴う古いものを変更する」場合に適しています。

AI は技術的な詳細を尋ねることがあります。気にせず、判断させたい場合は、「あなたの呼びかけ」「あなたが決めます」と答えるだけで、それは受け入れて続行されます。

なぜこのスキルが人気があるのでしょうか?

/grill-me は、Matt のスキルの中で最も頻繁にスクリーンショットされ、転送されるスキルです。理由は複雑ではありません。

1. 非常にミニマリスト: 7 行のマークダウン、コピーして貼り付けるだけ
2. 即時効果: 最初の実行時に AI の「問題密度」の変化を感じることができます。
3. ポータブル: Claude Code に依存せず、Codex、Cursor、Aider をすべて使用可能
4. 反 LLM のデフォルト動作が付属しています: 各単語は反 LLM 逸脱であり、高度なエンジニアリングの美学を備えています。

その成功は、「スキルは必ずしも長い必要はない」ということを裏付ける最良の論拠にもなりました。

参考リソース

次の記事: Grill With Docs: プロジェクト言語と ADR のメンテナンス - ドメインが複雑なプロジェクト向けの Grille-me の高度なバージョン。