msd-core/commands/gsd/progress.md at 4f9e5cf2ed4061a45df923a29ea1f3becbc679c2

Files

Tom Boucher 0b3a2e5f9c feat(#1190 ): wire --converge primary surface into /gsd:progress --next (ADR-15) (#1237 )

* feat(#1190): wire --converge primary surface into /gsd:progress --next (ADR-15)

ADR-15 designates /gsd-progress --next --auto --converge as the PRIMARY plan-convergence surface, but only the secondary surface (autonomous.md) was wired. next.md now parses --converge/--cross-ai into a plan strategy, gates on workflow.plan_review_convergence, forwards reviewer flags + --max-cycles, and routes Route-3 planning through /gsd:plan-review-convergence (mirroring autonomous.md); --auto chaining preserves converge mode. Adds argument-hint + help/full.md + COMMANDS.md + how-to parity and a structural regression test.

Closes #1190

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* chore(#1190): add changeset for progress --converge surface (#1237)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* fix(#1190): keep progress --converge docs skill-dep-clean + regen workflow size baseline

CI surfaced two ripples from the ADR-15 workflow edits: (1) lint-skill-deps + profile-closure flagged /gsd:plan-phase and /gsd:plan-review-convergence SlashCommand tokens in progress.md's flag docs as undeclared deps — reworded to plain prose since progress.md only advertises the flag (the real invocation lives in next.md); (2) the per-file workflow size baseline needed regenerating after the next.md/help edits.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-14 15:52:22 -04:00

3.0 KiB

Raw Blame History

name, description, argument-hint, effort, allowed-tools, requires

name

description

argument-hint

effort

allowed-tools

requires

gsd:progress

Check progress, advance workflow, or dispatch freeform intent — the unified GSD situational command

[--forensic | --next [--auto] [--converge] | --do "task description"]

low

Read

Bash

Grep

Glob

SlashCommand

AskUserQuestion

phase

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. - **--next --auto**: Like `--next`, but after the determined step completes, automatically re-invokes `/gsd:progress --next --auto` to continue chaining steps until completion or a blocking decision. Enables hands-free plan→execute→verify→complete progression. - **--next --converge**: When the next action is planning (Route 3), route it through the plan-review **convergence** loop instead of the standard planner. Requires `workflow.plan_review_convergence=true` (enable with `gsd config-set workflow.plan_review_convergence true`). `--cross-ai` is an alias. Reviewer flags (`--codex`, `--gemini`, `--claude`, `--opencode`, `--ollama`, `--lm-studio`, `--llama-cpp`, `--all`) and `--max-cycles N` are forwarded to the convergence loop. - **--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> @~~/.claude/gsd-core/workflows/progress.md @~~/.claude/gsd-core/workflows/next.md @~~/.claude/gsd-core/workflows/do.md @~~/.claude/gsd-core/references/ui-brand.md </execution_context>

Arguments provided: "$ARGUMENTS" Parse the first token from the provided arguments: - If it is `--next`: strip the flag, execute the next workflow (passing remaining args e.g. --force, --auto). - 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.

3.0 KiB Raw Blame History

3.0 KiB

Raw Blame History