Clarify

The Clarify phase removes ambiguity from the spec.
Here, the AI:

• Asks targeted questions

• Identifies edge cases and unclear requirements

• Refines assumptions into explicit statements

The goal is to ensure that the spec is complete, unambiguous, and ready to be translated into a concrete plan.

✏️ Steps

• Run:

  • /speckit.clarify

    • Open

      

• What happens:

  • Spec Kit runs a structured clarification workflow to surface missing details and record answers in a Clarifications section (so you don’t lose decisions in chat history).

• How to handle questions:

  • Answer directly in chat; if answering requires more context (Jira/Figma), let your MCP setup fetch it and then respond.

Open

• About “requirements” and checklists:

  • In Spec Kit, the spec artifact already contains functional requirements. The Agent should also generate a checklist of “tests” that validate the spec in checklists/requirements.md

  • Practical tip: ask the agent to read the checklist and check items it can confirm from the current spec, leaving the rest unchecked (then iterate).

Next Steps

Now that you’ve clarified the spec, it’s time to create an implementation plan. In the next step you’ll work with the Agent to build a plan that can eventually be executed to build the feature.

PlanPreview