msd-core/skills/gsd-progress/SKILL.md at f7df920681f233ae0fe064ee659550bdf41ff708

Files

Tom Boucher b9adedbc86 fix(#3151 ): stop emitting effort: into skill frontmatter (cache invalidation) (#3425 )

Claude Code applies SKILL.md effort: as output_config.effort; any change from
the session baseline invalidates the prompt cache at BOTH scope boundaries
(entry + exit, the latter often machine-fired via subagent-completion
notification). The reporter's owned measurement confirms it: /gsd-progress
(effort:low) in a medium session → cache_creation 63,404 (entry) + 18,589
(exit), while a no-effort skill shows none. ~76% of invocations paid in full.

Fix (trek-e AC#2/AC#4): convertClaudeCommandToClaudeSkill no longer emits
effort: into Claude-runtime skill frontmatter (src/runtime-artifact-conversion.cts
+ duplicated bin/install.js). normalizeClaudeSkillEffort removed (dead). The six
declaring skills (plan-phase/execute-phase/autonomous/next/progress/stats) no
longer carry effort. Source command files keep effort (input, used elsewhere);
the separate agent-effort surface (#3160) is untouched.

Tests: install-runtime-artifacts #769 block flipped to assert effort is ABSENT
from installed SKILL.md + converter output (the AC#4 behavioral coverage).

Co-authored-by: sim <sim@local>

2026-08-13 22:00:26 -04:00

2.9 KiB

Raw Blame History

name, description, argument-hint, allowed-tools

name

description

argument-hint

allowed-tools

gsd-progress

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

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

Read

Bash

Grep

Glob

SlashCommand

AskUserQuestion

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.

2.9 KiB Raw Blame History

2.9 KiB

Raw Blame History