Skip to main content

/specweave:done Command

The /specweave:done command closes an increment after validating that all quality gates pass.

What It Does​

Key actions:

  • Validates all tasks in tasks.md are complete
  • Runs /specweave:qa with --gate flag
  • PM Agent validates completion
  • Creates completion report
  • Closes external tool issues (GitHub, JIRA, ADO)
  • Updates living docs

Usage​

# Close specific increment
/specweave:done 0007

# Close active increment
/specweave:done

Three-Gate Validation​

Gate 1: Tasks Complete​

All tasks in tasks.md must be marked [x]:

### T-001: Implement AuthService
**Status**: [x] completed  ← Required

### T-002: Add JWT validation
**Status**: [x] completed  ← Required

Gate 2: Tests Pass​

Minimum test coverage:

  • Unit tests: 90%
  • Integration tests: 85%
  • E2E tests: 100% critical paths

Gate 3: Docs Updated​

Living documentation synchronized:

  • ADRs updated (Proposed → Accepted)
  • API docs current
  • Feature lists updated

Output​

$ /specweave:done 0007

📊 Validating increment 0007-user-authentication...

✅ Gate 1: Tasks Complete (42/42)
✅ Gate 2: Tests Pass (92% coverage)
✅ Gate 3: Docs Updated

🎉 Increment 0007-user-authentication COMPLETED!

📝 Completion Report:
  - Duration: 2.1 weeks
  - Tasks: 42 completed
  - Coverage: 92%
  - ADRs: 3 accepted

🔗 GitHub Issue #123 closed

PM Agent Review​

The PM Agent validates:

  • All acceptance criteria satisfied
  • No scope creep detected
  • Business objectives met
  • Documentation complete