gsd-progress

name	gsd-progress
description	Check progress, advance workflow, or dispatch freeform intent — the unified GSD situational command

<augment_skill_adapter>

A. Skill Invocation

• This skill is invoked when the user mentions gsd-progress or describes a task matching this skill.
• Treat all user text after the skill mention as {{GSD_ARGS}}.
• If no arguments are present, treat {{GSD_ARGS}} as empty.

B. User Prompting

When the workflow needs user input, prompt the user conversationally:

• Present options as a numbered list in your response text
• Ask the user to reply with their choice
• For multi-select, ask for comma-separated numbers

C. Tool Usage

Use these Augment tools when executing GSD workflows:

• launch-process for running commands (terminal operations)
• str-replace-editor for editing existing files
• view for reading files and listing directories
• save-file for creating new files
• grep for searching code (or use MCP servers for advanced search)
• web-search, web-fetch for web queries
• add_tasks, view_tasklist, update_tasks for task management

D. Subagent Spawning

When the workflow needs to spawn a subagent:

• Use the built-in subagent spawning capability
• Define agent prompts in .augment/agents/ directory </augment_skill_adapter>

Check project progress, summarize recent work and what's ahead, then intelligently route to the next action.

Three modes:

• default: Show progress report + intelligently route to the next action (execute or plan). Provides situational awareness before continuing work.
• --next: Automatically advance to the next logical step without manual route selection. Reads STATE.md, ROADMAP.md, and phase directories. Supports --force to bypass safety gates.
• --do "task description": Analyze freeform natural language and dispatch to the most appropriate GSD command. Never does the work itself — matches intent, confirms, hands off.
• --forensic: Append a 6-check integrity audit after the standard progress report.

- **--next**: Detect current project state and automatically invoke the next logical GSD workflow step. Scans all prior phases for incomplete work before routing. `--next --force` bypasses safety gates. - **--do "..."**: Smart dispatcher — match freeform intent to the best GSD command using routing rules, confirm the match, then hand off. - **--forensic**: Run 6-check integrity audit after the standard progress report. - **(no flag)**: Standard progress check + intelligent routing (Routes A through F).

<execution_context> @/home/delorenj/code/bhappy/.augment/get-shit-done/workflows/progress.md @/home/delorenj/code/bhappy/.augment/get-shit-done/workflows/next.md @/home/delorenj/code/bhappy/.augment/get-shit-done/workflows/do.md @/home/delorenj/code/bhappy/.augment/get-shit-done/references/ui-brand.md </execution_context>

Parse the first token of {{GSD_ARGS}}: - If it is `--next`: strip the flag, execute the next workflow (passing remaining args e.g. --force). - If it is `--do`: strip the flag, pass remainder as freeform intent to the do workflow. - Otherwise: execute the progress workflow end-to-end (pass --forensic through if present).

Preserve all routing logic from the target workflow.