get-shit-done/commands/gsd/progress.md

description, allowed-tools

description	allowed-tools
Check project progress, show context, and route to next action (execute or plan)	Read Bash Grep Glob SlashCommand

Check project progress, summarize recent work and what's ahead, then intelligently route to the next action - either executing an existing plan or creating the next one.

Provides situational awareness before continuing work.

Planning structure: !`ls -la .planning/ 2>/dev/null || echo "NO_PLANNING_STRUCTURE"` Phases: !`ls .planning/phases/ 2>/dev/null || echo "NO_PHASES"` State exists: !`[ -f .planning/STATE.md ] && echo "EXISTS" || echo "MISSING"` Roadmap exists: !`[ -f .planning/ROADMAP.md ] && echo "EXISTS" || echo "MISSING"` Recent summaries: !`find .planning/phases -name "*-SUMMARY.md" -type f 2>/dev/null | sort | tail -3` All plans: !`find .planning/phases -name "*-PLAN.md" -type f 2>/dev/null | sort` All summaries: !`find .planning/phases -name "*-SUMMARY.md" -type f 2>/dev/null | sort` **Verify planning structure exists:**

If no .planning/ directory:

No planning structure found.

Run /gsd:new-project to start a new project.

Exit.

If missing STATE.md or ROADMAP.md: inform what's missing, suggest running /gsd:new-project.

**Load full project context:**

• Read .planning/STATE.md for living memory (position, decisions, issues)
• Read .planning/ROADMAP.md for phase structure and objectives
• Read .planning/PROJECT.md for project vision (brief summary only)

**Gather recent work context:**

• Find the 2-3 most recent SUMMARY.md files
• Extract from each: what was accomplished, key decisions, any issues logged
• This shows "what we've been working on"

**Parse current position:**

• From STATE.md: current phase, plan number, status
• Calculate: total plans, completed plans, remaining plans
• Note any blockers, concerns, or deferred issues
• Check for CONTEXT.md: For phases without PLAN.md files, check if {phase}-CONTEXT.md exists in phase directory

**Present rich status report:**

# [Project Name]

**Progress:** [████████░░] 8/10 plans complete

## Recent Work
- [Phase X, Plan Y]: [what was accomplished - 1 line]
- [Phase X, Plan Z]: [what was accomplished - 1 line]

## Current Position
Phase [N] of [total]: [phase-name]
Plan [M] of [phase-total]: [status]
CONTEXT: [✓ if CONTEXT.md exists | - if not]

## Key Decisions Made
- [decision 1 from STATE.md]
- [decision 2]

## Open Issues
- [any deferred issues or blockers]

## What's Next
[Next phase/plan objective from ROADMAP]

**Determine next action:**

Find the next plan number that needs work. Check if {phase}-{plan}-PLAN.md exists for that number.

If PLAN.md exists (unexecuted):

• Read its <objective> section
• Show: "Ready to execute: [path] - [objective summary]"
• Ask: "Execute? (y/n)"
• CRITICAL: If user responds "y", "yes", or affirmatively, immediately invoke:

  SlashCommand("/gsd:execute-plan [full-path-to-PLAN.md]")
  

  Do NOT describe what you would do. INVOKE THE TOOL.

If PLAN.md does NOT exist:

• Check if {phase}-CONTEXT.md exists in phase directory
• Show: "Next plan not yet created: [expected path]"
• Show phase objective from ROADMAP

If CONTEXT.md exists:

• Display: "✓ Context gathered, ready to plan"
• Ask: "Create this plan? (y/n)"
• CRITICAL: If user responds "y", "yes", or affirmatively, immediately invoke:

  SlashCommand("/gsd:plan-phase [phase-number]")
  

  Do NOT describe what you would do. INVOKE THE TOOL.

If CONTEXT.md does NOT exist:

• Display options:

  Options for Phase [N]:
  1. See assumptions (/gsd:list-phase-assumptions [phase]) - What Claude thinks about this phase
  2. Discuss context (/gsd:discuss-phase [phase]) - Gather your context through questions
  3. Plan directly (/gsd:plan-phase [phase]) - Skip to planning
  

• Ask: "Which approach? (assumptions/discuss/plan)"
• If user responds "assumptions":

  SlashCommand("/gsd:list-phase-assumptions [phase-number]")
  

• If user responds "discuss":

  SlashCommand("/gsd:discuss-phase [phase-number]")
  

• If user responds "plan":

  SlashCommand("/gsd:plan-phase [phase-number]")
  

If all plans complete for current phase:

• Check if more phases exist in ROADMAP
• If yes: Offer to plan next phase with /gsd:plan-phase [next-phase]
• If no (milestone 100% complete): Offer to complete milestone

**Handle edge cases:**

• Phase complete but next phase not planned → offer /gsd:plan-phase [next]
• All work complete → offer milestone completion
• Blockers present → highlight before offering to continue
• Handoff file exists → mention it, offer /gsd:resume-work

<success_criteria>

• Rich context provided (recent work, decisions, issues)
• Current position clear with visual progress
• What's next clearly explained
• Smart routing: /gsd:execute-plan if plan exists, /gsd:plan-phase if not
• User confirms before any action
• Seamless handoff to appropriate gsd command </success_criteria>