grill

grill

Loop

1. If the upstream skill grill-me or grilling is installed (source id mattpocock), follow its loop. Else use steps 2 to 5. To install it, add mattpocock to upstream in .agents/compass.json, then run ac sync.
2. Read the plan, {{OPENSPEC_DIR}} and the code that the plan touches. Answer from them first.
3. Ask one question at a time. Give your recommended answer with each question.
4. Ask the question that unblocks the most other questions first.
5. Stop when no open question blocks the plan, or when the user says stop.

Harvest

Also scan {{OPENSPEC_DIR}} for findings:

1. A [NEEDS CLARIFICATION] marker.
2. A ## Clarifications session. Each - Q: <question> → A: <answer> line is one finding.
3. Hedged prose such as "TBD", "to be confirmed", "we assume", "subject to". Match the language of the specs.
4. An unstated premise behind an estimate in {{COSTING_DIR}}. Set kind: assumption.

Quote the source line for each finding. Never invent a finding. Stop at 20 findings for each run.

RAID files

Write one file for each finding: {{DELIVERY_DIR}}/questions/Q-NNN.md.

---
id: Q-014
kind: question
status: open
raisedAt: <YYYY-MM-DD>
raisedBy: assistant
owner:
specRef: <spec path>#<heading>
taskRef:
ticket:
---
## Question

<one sentence>

## Answer

## Consequence

• Write all nine keys. Keep an empty key bare.
• kind is question, risk, assumption, issue or dependency.
• status is open, assigned, answered or folded.
• Take the highest Q-NNN of all file names and all id keys. Add one. Pad to three digits. An empty register starts at Q-001.
• A reworded question keeps its id.
• List the register first. Read the target path again just before each write. If it has content, take the next id.
• Never overwrite a file. Skip a clarification when a file holds it for the same specRef.
• Never delete a file. Set status: folded instead.
• Put an answer under ## Answer. Set status: answered. A clarification pair without an answer is open.
• Do not edit a spec. The user folds an answer into the spec as a separate change.