gsd-progress

Report GSD project progress and route next workflow steps.

4|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/lgwanai/openforce --skill gsd-progress-lgwanai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-progress
Source: https://github.com/lgwanai/openforce/tree/main/skills/gsd-progress
Command: npx skills add https://github.com/lgwanai/openforce --skill gsd-progress-lgwanai

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about gsd-progress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track project progress and route to the next workflow step automatically?

Project progress tracking and routing resolves uncertainty about completed work by summarizing recent activity, then intelligently routing you to the next execute or plan workflow step to maintain momentum.

How does state-aware workflow advancement work with phase directories?

State-aware advancement detects the current project phase by reading STATE.md, ROADMAP.md, and phase directories, then advances automatically to the next step using the --next flag, with an optional --force bypass for safety gates.

Can I dispatch freeform user intent to a matching workflow command?

Yes, intent-based dispatch via the --do flag translates freeform user intent into the best-matching workflow command, confirms the match, and hands off execution instead of performing the work directly.

What is the best way to audit project state integrity before proceeding?

A 6-check integrity audit via the --forensic flag runs after the standard progress report to catch inconsistencies in project state, ensuring data integrity before advancing to the next workflow phase.

Do I need specific files to use deterministic routing for task handoffs?

Deterministic routing requires STATE.md, ROADMAP.md, and phase directories to exist in your GSD project, as these files provide the necessary state context for task handoffs and iterative planning cycles.

Why is my workflow routing not advancing past the current phase?

Workflow routing may halt due to safety gates blocking automatic advancement; use the --force flag with --next to bypass these gates, or run a --forensic audit to identify state inconsistencies preventing progression.