grill

grill — 仕様の前にアイデアを磨く

一度に質問は1つ。回答はすべて§に反映するか、?として保留します。制約を勝手に作り出してはいけません。

計画してから実行する方法では、曖昧な部分を推測して、間違ったものを作ってしまいます。 Grillでは、§Tの行を1つも作る前に、曖昧さを§G/§Cへ引き出します。 ここで誤った前提を見つければ質問1つで済みます。§Bで見つけるとバグになります。

GRILLを使うタイミング

• アイデアが一文で、抜けがあると感じられるとき。
• 目標に複数の解釈があり、どれかを黙って選ぼうとしているとき。
• 複雑なものについて/spec newを実行する前。
• ユーザーが異議を唱えてほしい、またはストレステストしてほしいと頼んだとき。

誤字や一行の修正には使いません。Grillの強度は不確実性に合わせ、⊥自尊心に合わせません。

まず調整する

冒頭で一度読み取ります。質問攻めにはしません。

1. ユーザーはこの分野をどれくらい知っていますか？（質問の深さを決めます）
2. アイデアはどれくらい固まっていますか？（検討中か、確定済みか）
3. どの程度の強さを望んでいますか？軽め／標準／容赦なし。

それに合わせます。固まっていないアイデアを容赦なく問い詰めると、意欲をくじくだけです。確定済みの計画を軽く問い詰めても、根幹を揺るがす欠陥を見逃します。

質問の段階

順番に進みます。各段階で質問は1つ、回答を提案して、返答を待ちます。

1. 目標 — コードが何をしなければならないかを一行で示すと？（→ §G）
2. 完了条件 — どうなれば動作したと分かりますか？観測可能な指標を挙げてください。（→ §C／将来の§V）
3. 境界 — 明示的に対象外とするものは何ですか？（→ §C）
4. 固定条件 — 絶対に変えられない技術／ライブラリ／パターンは何ですか？禁止事項はありますか？（→ §C）
5. インターフェース — 外部から触れるものは何ですか？コマンド、API、ファイル、環境変数のどれですか？（→ §I）
6. エッジケース — 正常系から外れる原因となる入力を1つ挙げると？（→ 将来の§V）
7. 未知事項 — まだ分かっていないことは何ですか？（§Cの箇条書きに?として保留）

仕様に曖昧さがなくなった時点で、段階を進めるのを止めます。反射的に7つすべてを尋ねてはいけません。

回答形式

各質問には回答の提案を添え、ユーザーが「はい」と答えるだけで進められるようにします。

Q: 認証 — セッションCookieとJWTのどちらですか？ rec: JWT — ステートレスで、§Cで水平スケーリングを挙げています。 (a) JWT (b) cookie (c) その他？

引き継ぎ

完了したら、目標の一行、制約の箇条書き、?として表面化した未知事項をまとめた簡潔なブロックを出力し、§G/§Cを書くspecスキルに引き継ぎます。Grillは提案します。変更を加えるのはspecだけです。SPEC.mdを直接書いてはいけません。

停止条件

以下をすべて満たしたら完了です。

• §Gが一行で、解釈が1つに定まり、「あるいは」といった曖昧さがない。
• §Cが、ユーザーが明示または暗示した譲れない条件をすべて網羅している。
• 進行を妨げる未知事項がすべて回答済みか、明示的な?として保留されている。

外部情報が必要な未解決の阻害要因があれば、推測せずに/researchを勧めます。

境界

• ⊥ ユーザーに代わってプロダクトの決定をすること。提案はしますが、決めません。
• ⊥ SPEC.mdを書くこと。整理した回答をspecに引き継ぎます。
• ⊥ 質問をまとめて投げること。質問は1つ、提案は1つ、返答を待ちます。
• ⊥ 些細な変更を問い詰めること。規模に合わせるか、省略します。