clarify
Installation
SKILL.md
/specforge:clarify — resolve unknowns before planning
Convert the spec's [NEEDS CLARIFICATION] markers into concrete decisions using a questions-in-a-file
flow (from AI-DLC): more reviewable and diffable than chatting, and it keeps a record. Run this
between /specforge:specify and /specforge:plan.
When to use
- A spec still contains
[NEEDS CLARIFICATION]markers or Open Questions. - The user wants to answer outstanding questions to firm up requirements.
Steps
- Read the active feature's
spec.md(the active feature is inspecforge/state.md's<!-- active: … -->marker). Collect every[NEEDS CLARIFICATION]and Open Question. - Write
specforge/specs/NNN-slug/clarifications.mdlisting each question with multiple-choice options A–E plus an[Answer]:line the human fills in. Example: