Refine

Goal

Take an existing crank artifact — a brainstorm brief, a spec, or a plan — and grill it until nothing consequential is left undecided at its altitude. This is a standalone pass: it sharpens the artifact in place without advancing the pipeline.

Hard Rules

• Grill at the artifact's altitude — never below it. The altitude table (References → Grilling altitude by phase) sets what each artifact's questions may reach for; everything below it is recorded as a deferred item for the next phase, never grilled and never quietly answered yourself.
• Sharpen in place. Edit the input artifact file directly as decisions land. Handed a legacy flat artifact (.crank/<phase>-<slug>.md), move it to its per-plan home (.crank/<slug>/<artifact>.md) first, state the new path, then sharpen it there. Only if the artifact was pasted inline with no file of its own, write the sharpened version to a new temp file (e.g. ${TMPDIR:-/tmp}/crank-<slug>/<artifact>.md) and tell the user the path once. Never start a parallel rewrite — the user's file is the single source of truth.
• Grill in rounds, every question informed. Follow the shared interview discipline in GRILLING.md.

References

Grilling altitude by phase