Skip to main content

/specweave:progress Command

The /specweave:progress command shows detailed progress for active increments.

What It Does​

Key information:

  • Task completion status (X/Y tasks, Z%)
  • Time tracking (elapsed, estimated remaining)
  • Current phase and next phase
  • Recent completions
  • Upcoming tasks

Usage​

# Show all active increments
/specweave:progress

# Show specific increment
/specweave:progress 0007

Output Example​

$ /specweave:progress 0007

📊 Progress: 0007-user-authentication

📈 Overall: 60% complete (25/42 tasks)

⏱️ Time:
  - Elapsed: 1.2 weeks
  - Remaining: 0.8 weeks (estimated)

📍 Current Phase: Implementation (Phase 3/5)
  └── Next: Testing (Phase 4/5)

✅ Recent Completions:
  - T-020: Add password hashing (2h ago)
  - T-019: Create login endpoint (4h ago)
  - T-018: Set up JWT tokens (yesterday)

📝 Upcoming Tasks:
  - T-021: Add rate limiting [next]
  - T-022: Implement refresh tokens
  - T-023: Add session management

💡 Estimate: Complete in ~3 days at current pace

Progress Calculation​

Progress is calculated from tasks.md:

// Count completed tasks: [x] or [X]
const completed = tasks.filter(t => t.status === 'completed');

// Calculate percentage
const progress = (completed.length / total.length) * 100;

Phases​

Typical increment phases:

PhaseTasksDescription
1. SetupT-001 to T-005Project scaffolding
2. CoreT-006 to T-015Main functionality
3. ImplementationT-016 to T-030Full features
4. TestingT-031 to T-038Test coverage
5. PolishT-039 to T-042Documentation, cleanup