grill-me reference

grill-me は、実装や Issue 化の前に設計判断をユーザーと確定するための opt-in interview skill である。

ユーザーが深掘りの interview を求めた時に使う。呼び出し元 skill の inventory interview からは自動起動しない。

github-issue-breakdown と implement-from-plan の inventory interview は起票前または plan draft 前の最小確認である。grill-me はユーザーが明示して起動する深掘り interview であり、inventory から自動発動しない。

コード変更、commit、push、Issue 作成、PR 作成、下流 skill の実行は行わない。

質問進行は /grilling に委譲し、grill-me は入力準備、10 問ごとの checkpoint、artifact 生成と検証を担当する。

まず何が起きるか

テーマ文または既存 research packet から対象、既知の事実、判断候補を整理して /grilling に渡す。 一次情報の確認と、残った判断を 1 問ずつ聞く処理は /grilling が担当する。

回答は interview-log.md に残し、確定判断は grill-packet.json の decisions[] に入れる。 ユーザー回答で確定した判断は chosen_by: "user" として保存する。

代表的な起動方法は次の 2 つである。

/grill-me <テーマ>
/grill-me research-packet=<path>

停止と再開

high-impact な未確定事項は unresolved_questions[] に残して終了する。追加情報がそろったら、作成済み packet を research-packet= で渡して interview を再開する。

validator の question_audit_failed は、high-impact な判断を推測で埋めなかったことを表す場合がある。この場合は期待される停止として扱い、残った質問を報告する。schema、path、required field の欠陥なら artifact を直して validator を再実行する。

input

既存 packet を読む場合は、interview 前に次を実行する。

review-orchestrator task-research validate --packet <path>

research-packet=<path> の入力を扱う際の判断は次の通り。

• research-packet=<path> の入力では、packet の unresolved_questions[] と、scope / UX / data format / public API / config format / review coverage に影響する chosen_by: "agent" decision を最優先で interview 候補にする。
• chosen_by: "user" の decision は凍結済みとして扱い、ユーザーが明示的に変更しない限り上書きしない。
• chosen_by: "source_text" の decision は evidence を確認し、追加のユーザー判断が必要な場合だけ質問に戻す。

出力する grill-packet.json の source_facts[] には入力 packet の path / id を追跡できる evidence を残す。

question flow

質問の形式、提示順、1 問ずつ進める規則は /grilling の契約に従う。

個別の状況ごとの扱いは次の通り。

• プロトタイプ、画像、実機確認などがないと答えられない論点は質問を続けず、unresolved_questions[] に残す。
• 一次情報や既存設計から判断できる場合は chosen_by: "source_text" と evidence を残す。
• chosen_by: "agent" は high-impact category ではない軽微な整理判断に限定する。
• max-questions に到達した場合は、残りを推測で確定せず、「未確定論点と validation」の規定に従って成果物へ残す。

10 問ごとに次の checkpoint を挟む。

/grilling が未確認の共通理解または high-impact な残質問を返した場合は、unresolved_questions[] と question_adequacy_audit.required_before_handoff に反映し、question_adequacy_audit.passed: false にする。下流へ渡せる完了状態にはしない。

artifacts

grill-packet.json は schema_version: "task-research-packet.v1" のままにし、新規 schema は作らない。

packet の検証には次を使う。

review-orchestrator task-research validate --packet <out>/grill-packet.json

interview-log.md には、入力、調査した一次情報、質問、選択肢、推奨案、ユーザー回答、checkpoint、decisions[] への対応、未解決質問を残す。

未確定論点と validation

プロトタイプ、画像、実機確認、追加 interview などが必要で high-impact な未確定論点が残る場合は、unresolved_questions[] と question_adequacy_audit.required_before_handoff に残し、question_adequacy_audit.passed: false を必ず設定する。 この状態で review-orchestrator task-research validate --packet <out>/grill-packet.json が question_audit_failed を返す場合は、期待される終了状態として扱う。推測で passed: true に戻さず、packet 欠陥ではなく high-impact 未確定として報告して終了する。

packet shape

grill-packet.json は task-research contract の task-research-packet.v1 に合わせる。field-level schema は内部 contract を正本とする。

interview で確定した判断は decisions[] に入れ、ユーザー回答は chosen_by: "user" にする。入力 packet の chosen_by: "source_text" は根拠を確認し、chosen_by: "agent" は high-impact category ではない軽微な整理判断に限定する。

downstream handoff

grill-me は下流 skill を直接実行しない。 grill-packet.json は task-research-packet.v1 互換なので、task-research へ戻す場合も下流 skill へ渡す場合も research-packet= の入力として扱う。

下流に渡す場合は、ユーザーが明示してから次のように呼ぶ。

/task-research research-packet=tmp/grill-me/<id>/grill-packet.json
/github-issue-breakdown research-packet=tmp/grill-me/<id>/grill-packet.json
/fix-github-issue <issue> research-packet=tmp/grill-me/<id>/grill-packet.json
/implement-from-plan research-packet=tmp/grill-me/<id>/grill-packet.json

packet は下流の validation、readiness、capability preflight、checkpoint、PR 前 simplify、multi-review の代替ではない。

stop conditions

• 一次情報が足りず、受け入れ条件や high-impact decision を確定できない。
• ユーザー回答が矛盾し、追加確認なしに解決できない。
• task-research-packet.v1 互換では必要な情報を表現できない。
• review-orchestrator task-research validate --packet <out>/grill-packet.json が schema / path / required field の欠陥で失敗する。

停止時は、作成済み artifact、止めた理由、次に必要な入力を報告する。