0b3a2e5f9c
* 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>
50 lines
3.0 KiB
Markdown
50 lines
3.0 KiB
Markdown
---
|
|
name: gsd:progress
|
|
description: Check progress, advance workflow, or dispatch freeform intent — the unified GSD situational command
|
|
argument-hint: "[--forensic | --next [--auto] [--converge] | --do \"task description\"]"
|
|
effort: low
|
|
allowed-tools:
|
|
- Read
|
|
- Bash
|
|
- Grep
|
|
- Glob
|
|
- SlashCommand
|
|
- AskUserQuestion
|
|
requires: [phase]
|
|
---
|
|
<objective>
|
|
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.
|
|
</objective>
|
|
|
|
<flags>
|
|
- **--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).
|
|
</flags>
|
|
|
|
<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>
|
|
|
|
<process>
|
|
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.
|
|
</process>
|