| name | speckit-specify |
| description | Write or refine a feature specification using Spec Kit. Use when the user says "specify", "write a spec", "$speckit-specify", or wants to define a new feature before implementing it. |
Speckit Specify
Write a feature specification (spec.md) for a new feature or refine an existing one.
When to Use
- User says "specify", "write a spec", "$speckit-specify", or "define a feature"
- Starting any non-trivial new feature
- Refining an existing spec before planning
Workflow
1. Gather Context
Read these before writing anything:
wow-viewer/.specify/memory/constitution.md — project principles and constraintsAGENTS.md — workspace guardrails and rules- Any existing architecture docs in
wow-viewer/docs/architecture/ related to the feature area
2. Get Feature Description
Ask the user (if not already provided):
- What should this feature do?
- Who is the primary user?
- What problem does it solve?
3. Create Feature Directory
$featureNum = "NNN" # next sequential number from wow-viewer/specs/
$branchName = "$featureNum-<short-name>"
$featureDir = "wow-viewer/specs/$branchName"
New-Item -ItemType Directory -Path $featureDir -Force
Or run the setup script:
pwsh wow-viewer/.specify/scripts/powershell/create-new-feature.ps1 -ShortName "<short-name>" "<feature description>"
4. Write spec.md
Use the template at wow-viewer/.specify/templates/spec-template.md as the structure. Fill in:
- User Stories with priorities (P1, P2, P3) — each independently testable
- Acceptance Scenarios — Given/When/Then format
- Functional Requirements — FR-001, FR-002, etc.
- Success Criteria — measurable outcomes
- Assumptions — what we're taking for granted
Write the file to $featureDir/spec.md.
5. Validate
Output
wow-viewer/specs/<NNN>-<feature>/spec.md — the feature specification- Report the feature number and path to the user
