/specweave:increment Command
The /specweave:increment command is SpecWeave's primary planning command that creates a new increment with full PM-led workflow.
What It Does
Key actions:
- Creates new increment folder (
0XXX-feature-name/) - Generates spec.md with user stories and acceptance criteria
- Generates plan.md with architecture and ADRs
- Generates tasks.md with embedded BDD tests
- Runs strategic agent review (Architect, QA Lead, Tech Lead)
Usage
# Create feature increment
/specweave:increment "User authentication with JWT"
# Create specific type
/specweave:increment "Payment processing" --type=feature
/specweave:increment "Critical login bug" --type=hotfix
/specweave:increment "Try GraphQL" --type=experiment
Increment Types
| Type | Purpose | WIP Limit |
|---|---|---|
| feature | New functionality | 1 (default) |
| hotfix | Critical fix | 1 (emergency slot) |
| bug | Non-critical bug fix | Shares feature limit |
| refactor | Code improvement | Shares feature limit |
| experiment | Spike/POC | Auto-abandons after 14 days |
Output Structure
.specweave/increments/0007-user-authentication/
├── spec.md ← Requirements & user stories
├── plan.md ← Architecture & technical design
├── tasks.md ← Implementation tasks with tests
└── metadata.json ← Status tracking
PM-Led Workflow
- Market Research - Analyze requirements
- Specification - Write user stories with ACs
- Architecture - Design technical approach
- Planning - Break into tasks with test cases
- Review - Strategic agent validation
Related
- Increments - Work units
- spec.md - Specification format
- plan.md - Plan format
- tasks.md - Task format
- PM Agent - Planning agent