grill-me

grill-me

計画や設計についてユーザーに徹底的に質問し、双方の認識が一致し、未解決の判断事項がすべて解決するまで続けます。

実行方法

• まず、トピックを理解するために必要な計画、リンクされたドキュメント、コード、ローカルファイルを読みます。
• 質問は一度に 1つ だけにします。次の質問に進む前に、回答を待ちます。
• 質問ごとに、推奨する回答と、その理由を一行で伝えます。
• 判断ツリーの各分岐をたどります。回答によって新たな質問が生じたら、それに続いて質問します。あちこち飛び回らず、判断間の依存関係を順に解決します。
• コードベースを調べれば回答できる質問は、尋ねるのではなく調査します。
• 曖昧な言葉、隠れた前提、エッジケース、判断間の依存関係、可逆性について掘り下げます。
• 未解決の分岐がなくなるまで続けます。その後、合意した計画を要約します。

質問のパターン

• 「この変更が成功したと判断できる成果は何ですか？」
• 「この動作は既存のどの概念が担うべきですか？」
• 「設計が機能することを証明できる最小のシナリオは何ですか？」
• 「この前提が誤っていた場合、何が壊れますか？」
• 「将来のメンテナーは、何を元に戻したくなるでしょうか？」
• 「どの用語を正式なものとし、どの別名を避けるべきですか？」

判断事項の記録

リポジトリがすでに CONTEXT.md、CONTEXT-MAP.md、または docs/adr/ を保持している場合、あるいはインタビューで用語や会話後も残す価値のある判断が確定した場合に限ります。新しいファイルを提案する前に、これらのファイルがあるか確認します。

• 用語が確定したら、適切な CONTEXT.md をすぐに更新します。これはプロジェクト固有の用語と関連性を示す用語集であり、仕様書や作業メモではありません。
• CONTEXT-MAP.md は、リポジトリに複数の境界づけられたコンテキストがある場合にのみ使用します。
• ADRを提案するのは、覆すのが難しく、背景なしでは意外で、実際のトレードオフに基づく判断に限ります。
• ドキュメントは必要になるまで作成しません。確定した内容がないうちは CONTEXT.md や docs/adr/ を作成せず、将来のエージェントが実際に読むよう、短く保ちます。

用語集の形式については CONTEXT-FORMAT.md を、ADRの形式と基準については ADR-FORMAT.md を読んでください。

注意事項

• 「効率化」のために質問を和らげたり、まとめたりしないでください。価値は徹底的に問い続けることにあります。一度に一つ質問し、繰り返します。
• ユーザーが明示的に中止を指示するか、残りの推奨事項すべてを一度に受け入れた場合に限り、早めに終了します。
• mattpocock/skills（MIT）から移植し、このリポジトリの規約と文体に合わせて調整しました。