| name | clarification |
| description | Software factory clarification — use when gathering requirements before planning. Runs structured Q&A to produce a confirmed clarification summary. |
| version | 0.1.0 |
Clarification
Purpose
Gather everything needed before any planning begins. One organized batch of questions — not a back-and-forth interrogation.
Question Categories (cover all that apply)
- Scope: What is in scope? What is explicitly out of scope?
- Success criteria: What does done look like? How will we know it works?
- Tech stack: Language, framework, runtime constraints. Existing conventions to follow?
- CI/CD assumption: Assume in place unless user says otherwise. Confirm only if the request touches deployment.
- Manual validation: Does this touch a UI? Major API surface changes? External integration impact? These will require manual review.
- Existing codebase: Is this greenfield or modifying existing code? If existing, where does it live?
- Constraints: Timeline, performance, security, compliance requirements?
Output: Clarification Summary
After getting answers, produce a structured summary:
## Clarification Summary
**Request:** <one-sentence restatement>
**Scope:** <what's in, what's out>
**Success criteria:** <observable outcomes>
**Tech stack:** <languages, frameworks, versions>
**Manual validation required:** <yes/no, what triggers it>
**Assumptions confirmed:** <list of things user explicitly confirmed>
**Out of scope confirmed:** <list of things user explicitly excluded>
Ask the user: "Does this summary accurately capture your request? Confirm to proceed to planning."
Do not proceed until user explicitly confirms. Write the confirmed summary to memory under key clarification_summary.
Rules
- Ask all questions in one message, organized by category
- Do not ask about things already stated in the initial request
- Every item in the summary must have been stated or confirmed by the user — no inferences
