What problem does it solve?
gsd-progress removes uncertainty about project status by summarizing recent work, identifying what remains, and routing you to the next appropriate workflow step so you can keep momentum.
Core Features & Use Cases
- Unified progress + routing: Produces a clear progress report and then intelligently routes to the next action (execute or plan) to avoid manual triage.
- State-aware advancement (
--next): Detects the current project phase by reading STATE.md, ROADMAP.md, and phase directories, then advances automatically (optionally with --force to bypass safety gates).
- Intent-based dispatch (
--do): Translates freeform user intent into the best-matching GSD command, confirms the match, and hands off instead of doing the work directly.
- Integrity assurance (
--forensic): Adds a 6-check audit after the standard progress report to catch inconsistencies before proceeding.
Quick Start
Run gsd-progress in default mode to get a progress summary and an intelligent recommendation for what to do next.