Skip to main content

SpecWeave Command Decision Tree

Quick guide: Find the right command for your situation.

Quick Reference Card​

I want to...Command
Start new feature/specweave:increment "feature name"
Implement current feature/specweave:do
See what's in progress/specweave:progress
Complete an increment/specweave:done 0001
Pause for other work/specweave:pause 0001
Resume paused work/specweave:resume 0001
Validate before closing/specweave:validate 0001
Sync to GitHub/JIRA/specweave:sync-progress
Save and push changes/specweave:save

Decision Flowcharts​

"What should I do next?"​

"I finished my task"​

By Scenario​

Starting Work​

ScenarioCommandNotes
New feature/specweave:increment "feature name"Creates spec, plan, tasks
New bug fix/specweave:increment "fix: bug description"Use fix: prefix
New experiment/specweave:increment "experiment: idea"Use experiment: prefix
Resume from backlog/specweave:resume 0001Picks up where you left off

During Implementation​

ScenarioCommandNotes
Implement tasks/specweave:doAutonomous implementation
Check progress/specweave:progressShows task completion
View current status/specweave:statusShows all increments
Run quality check/specweave:qaAI quality assessment

Pausing Work​

ScenarioCommandNotes
Temporarily blocked/specweave:pause 0001External dependency, will resume
Deprioritized/specweave:backlog 0001Not abandoned, just later
Feature canceled/specweave:abandon 0001Won't continue this work

Completing Work​

ScenarioCommandNotes
Validate before closing/specweave:validate 0001Checks tasks, tests, docs
Close with PM review/specweave:done 00013-gate validation
Move to next increment/specweave:nextAuto-close current, suggest next

Syncing & Saving​

ScenarioCommandNotes
Sync to external tools/specweave:sync-progressGitHub/JIRA/ADO
Update living docs/specweave:sync-docsBidirectional sync
Save and push to git/specweave:saveCommits and pushes

Command Categories​

Lifecycle Commands​

Start     →  /specweave:increment
Implement →  /specweave:do
Validate  →  /specweave:validate
Complete  →  /specweave:done

Status Management​

Pause      →  /specweave:pause    (temporary block)
Backlog    →  /specweave:backlog  (deprioritized)
Resume     →  /specweave:resume   (continue work)
Abandon    →  /specweave:abandon  (cancel)
Reopen     →  /specweave:reopen   (needs more work)

Visibility​

Progress   →  /specweave:progress   (task completion)
Status     →  /specweave:status     (all increments)
Workflow   →  /specweave:workflow   (next steps)

Synchronization​

Sync All       →  /specweave:sync-progress   (tasks → docs → external)
Sync Docs      →  /specweave:sync-docs       (living docs)
Sync Tasks     →  /specweave:sync-tasks      (external → tasks.md)
Sync ACs       →  /specweave:sync-acs        (acceptance criteria)

Quality​

Validate   →  /specweave:validate   (rule-based)
QA         →  /specweave:qa         (AI assessment)
Check Tests →  /specweave:check-tests (test coverage)

Common Workflows​

Basic Feature Workflow​

# 1. Plan the feature
/specweave:increment "User authentication"

# 2. Implement it
/specweave:do

# 3. Check progress periodically
/specweave:progress

# 4. Validate when tasks complete
/specweave:validate 0001

# 5. Close when ready
/specweave:done 0001

Handling Interruptions​

# Working on feature A
/specweave:do

# Urgent bug comes in
/specweave:pause 0001

# Fix the bug
/specweave:increment "fix: critical login bug"
/specweave:do
/specweave:done 0002

# Resume feature A
/specweave:resume 0001
/specweave:do

Team Handoff​

# Before handoff: validate and sync
/specweave:validate 0001
/specweave:sync-progress

# Handoff to teammate with clean state
# They can see progress in GitHub/JIRA

End of Day​

# Sync all progress
/specweave:sync-progress

# Save and push
/specweave:save

When Things Go Wrong​

Increment Needs More Work (Closed Too Early)​

/specweave:reopen 0001
# Continue work
/specweave:do
/specweave:done 0001

Wrong Increment Active​

# Check what's active
/specweave:status

# Switch to correct one
/specweave:pause 0001    # Pause wrong one
/specweave:resume 0002   # Resume correct one

Sync Failed​

# Check sync status
/specweave-github:specweave-github-status

# Force sync
/specweave:sync-progress

Validation Fails​

# See what failed
/specweave:validate 0001

# Common issues:
# - Tasks not complete → mark tasks done
# - Tests not passing → fix tests
# - Docs not updated → run /specweave:sync-docs

Platform-Specific Commands​

GitHub​

/specweave-github:specweave-github-sync       # Sync increment
/specweave-github:specweave-github-create-issue  # Create issue
/specweave-github:specweave-github-close-issue   # Close issue
/specweave-github:specweave-github-status        # Check status

JIRA​

/specweave-jira:specweave-jira-sync    # Sync increment
/specweave-jira:import-projects        # Import JIRA projects

Azure DevOps​

/specweave-ado:specweave-ado-sync           # Sync increment
/specweave-ado:specweave-ado-create-workitem  # Create work item
/specweave-ado:specweave-ado-status           # Check status

Command Cheat Sheet​

Most Used (Daily)​

CommandShortcutPurpose
/specweave:increment-Start new work
/specweave:do-Implement tasks
/specweave:progress-Check completion
/specweave:done-Complete increment
/specweave:save-Commit and push

Frequent (Weekly)​

CommandPurpose
/specweave:pauseTemporarily stop
/specweave:resumeContinue paused
/specweave:validatePre-close check
/specweave:sync-progressSync external tools

Occasional (As Needed)​

CommandPurpose
/specweave:backlogDeprioritize
/specweave:abandonCancel work
/specweave:reopenNeeds more work
/specweave:qaQuality assessment

Tips​

  1. Start with /specweave:increment — Always plan before coding
  2. Use /specweave:progress often — Stay aware of status
  3. Validate before closing — /specweave:validate catches issues
  4. Sync at end of day — /specweave:sync-progress keeps everyone informed
  5. Save frequently — /specweave:save protects your work