progress

Overview

The progress command checks project progress, summarizes recent work and upcoming tasks, then intelligently routes you to the next action—either executing an existing plan or creating the next one. It provides situational awareness before continuing work.

Syntax

/gsd:progress

How It Works

Loads project state from STATE.md and ROADMAP.md
Analyzes recent work - Last completed phases, quick tasks, commits
Checks current position - Active phase, checkpoints, incomplete plans
Evaluates next steps - What work is ready or needed
Routes intelligently - Executes plan, creates plan, or offers options
Preserves routing logic - Implements Routes A-F from workflow

Routing Logic

The progress command uses six intelligent routing paths:

Route A: Execute Existing Plan

Condition: Phase has PLAN.md but no SUMMARY.md

✓ Plan exists and ready
→ /gsd:execute {N}

Route B: Resume from Checkpoint

Condition: .continue-here.md exists

✓ Checkpoint detected
→ Resume from saved state

Route C: Plan Next Phase

Condition: Current phase complete, next phase in roadmap

✓ Phase N complete, Phase N+1 in roadmap
→ /gsd:plan-phase

Route D: Create Next Milestone

Condition: All roadmap phases complete

✓ Milestone complete
→ /gsd:plan-milestone

Route E: Offer Options

Condition: Ambiguous state or multiple valid paths

? Multiple options available
→ Present user with choices

Route F: Project Complete

Condition: All work done, no todos, clean state

✓ Project complete
→ Celebrate and suggest next project

Usage Examples

Mid-project with ready plan

/gsd:progress

Output:

📊 Project Progress: E-commerce Platform
════════════════════════════════════════

**Overall Status**
✅ Completed: 4/12 phases (33%)
🎯 Current: Phase 5 - Shopping Cart
📅 Started: 2 weeks ago

**Recent Work**
✓ Phase 4: Product Catalog (completed 2 days ago)
  - Search and filtering
  - Category navigation  
  - Image optimization
  Commit: feat: complete product catalog with search (a1b2c3d)

✓ Quick task: Add loading states (completed yesterday)
  Commit: feat: add loading spinners to product pages (d4e5f6g)

**Current Phase: Shopping Cart**
📋 Status: Planned, ready to execute
📄 PLAN.md created: 2 days ago
✓ All prerequisites met

**Next Action**
Route A: Execute existing plan

Ready to implement Phase 5. Run:

  /gsd:execute 5

Estimated: 3-4 hours based on plan scope

Phase complete, plan next

/gsd:progress

Output:

📊 Project Progress: Task Management API
═══════════════════════════════════════

**Overall Status**
✅ Completed: 6/8 phases (75%)
🎯 Current: Milestone 2 (75% complete)
📅 Started: 3 weeks ago

**Recent Work**
✓ Phase 6: Notification System (completed 1 hour ago)
  - Email notifications
  - Push notification service
  - Notification preferences
  - Event-driven architecture
  Commit: feat: complete notification system (g7h8i9j)
  Verified: All tests passing ✓

**Upcoming Work**
Next in roadmap:
- Phase 7: Real-time Updates (websockets)
- Phase 8: Performance Optimization

**Next Action**
Route C: Plan next phase

Phase 6 complete! Plan Phase 7:

  /gsd:plan-phase

Or review context first:

  /gsd:discuss

Resume from checkpoint

/gsd:progress

Output:

📊 Project Progress: Analytics Dashboard
════════════════════════════════════════

**Overall Status**
✅ Completed: 2/10 phases (20%)
🎯 Current: Phase 3 - Data Visualization
📅 Started: 1 week ago

**Recent Work**
✓ Phase 2: Database Schema (completed 3 days ago)

**Current Phase: Data Visualization**
⏸️  Status: Paused mid-execution
📄 Checkpoint: .continue-here.md (created 2 days ago)
📊 Progress: 60% complete

**Checkpoint Details**
Position: Finishing chart components
Completed:
- Line and bar charts
- Data aggregation logic
- Chart configuration

Remaining:
- Pie and scatter charts
- Interactive tooltips
- Export functionality

Blockers: None

**Next Action**
Route B: Resume from checkpoint

Continue where you left off:

  /gsd:resume-work

Or start fresh:

  /gsd:execute 3

Multiple options available

/gsd:progress

Output:

📊 Project Progress: Mobile App
═══════════════════════════════

**Overall Status**
✅ Completed: 5/8 phases (62%)
📋 Pending todos: 4
🎯 Current: Between phases

**Recent Work**
✓ Phase 5: User Settings (completed 1 day ago)
✓ Quick task: Fix navigation bug (completed today)

**Available Options**
Route E: Multiple paths available

1. 📋 Plan Phase 6: Push Notifications
   Next in roadmap, prerequisites met
   → /gsd:plan-phase

2. ✅ Work on todos (4 pending)
   - High priority: Add offline support (api)
   - High priority: Fix image caching (performance)
   - Medium priority: Add haptic feedback (frontend)
   - Low priority: Update documentation (docs)
   → /gsd:check-todos

3. 🐛 Review debug sessions (1 active)
   - Intermittent crash on profile page
   - Status: hypothesis formed
   → /gsd:debug

4. 💬 Discuss next milestone
   Milestone 1 is 62% complete
   → /gsd:discuss

What would you like to do?

Project complete

/gsd:progress

Output:

📊 Project Progress: Blog Platform
══════════════════════════════════

**Overall Status**
✅ Completed: 8/8 phases (100%)
✅ All milestones complete
✅ No pending todos
✅ No active debug sessions
📅 Duration: 6 weeks

**Recent Work**
✓ Phase 8: Deployment & Monitoring (completed today)
  - CI/CD pipeline
  - Production deployment
  - Error monitoring
  - Performance tracking
  Commit: feat: complete deployment and monitoring (x1y2z3a)
  
**Project Summary**
Milestone 1: Core Features
- ✓ User authentication
- ✓ Post creation and editing
- ✓ Comment system
- ✓ Search functionality

Milestone 2: Enhancement
- ✓ Image upload and optimization
- ✓ Draft management
- ✓ SEO optimization
- ✓ Analytics integration

**Next Action**
Route F: Project complete! 🎉

All planned work finished. Consider:

1. 🚀 Deploy and launch
   → Review deployment checklist

2. 📊 Post-launch monitoring
   → /gsd:add-todo Post-launch tasks

3. 🔄 Plan next iteration
   → /gsd:new-project (new milestone)

4. 📝 Document learnings
   → Update CONTEXT.md with insights

Congratulations on completing Blog Platform!

What Gets Analyzed

Project Metrics

Total phases vs completed
Milestone progress
Project start date and duration
Commit frequency

Recent Activity

Last 3 completed phases
Last 5 quick tasks
Recent commits with messages
Last discussion or planning session

Current State

Active phase identification
Checkpoint detection
Incomplete plans (PLAN without SUMMARY)
Health issues (via implicit health check)

Upcoming Work

Next phase in roadmap
Pending todos count by area
Active debug sessions
Blockers or dependencies

Edge Case Handling

No STATE.md

No project state found.

Initialize project:
  /gsd:new-project

Or resume existing project:
  /gsd:resume-work

Corrupted STATE.md

State file corrupted. Running health check...
[Attempts repair]

If repair fails:
  /gsd:health --repair

Ambiguous next phase

Multiple incomplete phases detected:
- Phase 4: Has PLAN, no SUMMARY
- Phase 6: Has PLAN, no SUMMARY

Which phase to execute?

Integration with Other Commands

Before planning

# Check progress first
/gsd:progress

# Then plan based on what's needed
/gsd:plan-phase

After resuming

# Resume loads basic state  
/gsd:resume-work

# Progress gives detailed status
/gsd:progress

During active work

# Quick status check
/gsd:progress

# Continue working
[Returns to phase execution]

Files Read

.planning/STATE.md - Project state
.planning/ROADMAP.md - Phase definitions
.planning/CONTEXT.md - Decisions and context
.planning/phases/**/PLAN.md - Phase plans
.planning/phases/**/SUMMARY.md - Completion records
.planning/phases/**/.continue-here.md - Checkpoints
.planning/quick/*.md - Quick tasks
.planning/todos/**/*.md - Pending todos
.planning/debug/*.md - Debug sessions
.git/logs/HEAD - Recent commits

When to Use

Perfect for

Starting your work session
After completing a phase
When unsure what to do next
Before planning sessions
After long breaks
Sprint planning
Status check-ins

Pairs well with

/gsd:resume-work → /gsd:progress (detailed status)
/gsd:progress → /gsd:execute (ready to work)
/gsd:progress → /gsd:plan-phase (plan next)
/gsd:progress → /gsd:check-todos (review todos)

Success Criteria

✅ Project state loaded
✅ Recent work summarized
✅ Current position identified
✅ Next steps evaluated
✅ Intelligent routing applied (Routes A-F)
✅ User knows exactly what to do next

resume-work - High-level restoration
health - Validate project state
execute - Execute phase plan
plan-phase - Plan next phase
check-todos - Review pending todos

Core Workflow

Milestone Management

Phase Management

Session Management

Utilities

Overview

Syntax

How It Works

Routing Logic

Route A: Execute Existing Plan

Route B: Resume from Checkpoint

Route C: Plan Next Phase

Route D: Create Next Milestone

Route E: Offer Options

Route F: Project Complete

Usage Examples

Mid-project with ready plan

Phase complete, plan next

Resume from checkpoint

Multiple options available

Project complete

What Gets Analyzed

Project Metrics

Recent Activity

Current State

Upcoming Work

Edge Case Handling

No STATE.md

Corrupted STATE.md

Ambiguous next phase

Integration with Other Commands

Before planning

After resuming

During active work

Files Read

When to Use

Perfect for

Pairs well with

Success Criteria

Core Workflow

Milestone Management

Phase Management

Session Management

Utilities

​Overview

​Syntax

​How It Works

​Routing Logic

​Route A: Execute Existing Plan

​Route B: Resume from Checkpoint

​Route C: Plan Next Phase

​Route D: Create Next Milestone

​Route E: Offer Options

​Route F: Project Complete

​Usage Examples

​Mid-project with ready plan

​Phase complete, plan next

​Resume from checkpoint

​Multiple options available

​Project complete

​What Gets Analyzed

​Project Metrics

​Recent Activity

​Current State

​Upcoming Work

​Edge Case Handling

​No STATE.md

​Corrupted STATE.md

​Ambiguous next phase

​Integration with Other Commands

​Before planning

​After resuming

​During active work

​Files Read

​When to Use

Perfect for

Pairs well with

​Success Criteria

​Related Commands

Overview

Syntax

How It Works

Routing Logic

Route A: Execute Existing Plan

Route B: Resume from Checkpoint

Route C: Plan Next Phase

Route D: Create Next Milestone

Route E: Offer Options

Route F: Project Complete

Usage Examples

Mid-project with ready plan

Phase complete, plan next

Resume from checkpoint

Multiple options available

Project complete

What Gets Analyzed

Project Metrics

Recent Activity

Current State

Upcoming Work

Edge Case Handling

No STATE.md

Corrupted STATE.md

Ambiguous next phase

Integration with Other Commands

Before planning

After resuming

During active work

Files Read

When to Use

Success Criteria

Related Commands