Read and clarify feature specifications
clarifycommandsetup L1★0
lgulliver/derrick ↗What it does
Surface and resolve open questions in feature specification
Best for
Quick clarification before moving to planning; filters out avoidable ambiguity without heavyweight refinement meetings.
Inputs
- · Reads .specify/feature.json for feature directory
- · Reads spec.md from that directory
Outputs
- · 1–3 clarifying questions to user (most important first)
- · Updated spec.md with answers, resolved questions removed
- · Exit message: 'no open questions — spec ready for planning' if none
Requires
- · None (pure dialogue + file read/write)
Preconditions
- · .specify/feature.json exists with feature directory path
- · spec.md exists in that directory
Failure modes
- · .specify/feature.json missing — cannot locate spec.md (error)
- · spec.md missing open questions section — assumes complete, exits with 'ready for planning'
- · User answer is still vague — follow-up question asked (but counted within 1–3 limit)
Trust signals
- · Limits surface to 1–3 questions (doesn't overwhelm)
- · Ranks by importance (highest impact first)
- · Silent no-op if spec already clear (no artificial questioning)