helenkwok

Gsd Status Mod — Development skill for Claude Code

Development community

Claude Code mod: resume hints for GSD projects (stopped-at line, handoff next action, Tab suggestion, STATE.md drift warning).

How to install Gsd Status Mod

This entry records only its repository, not the path inside it, so there is no exact command to give. Open helenkwok/gsd-status-mod and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Gsd Status Mod does

Claude Code mod: resume hints for GSD projects (stopped-at line, handoff next action, Tab suggestion, STATE.md drift warning).

Alternatives in Development

README

gsd-status-mod

A Claude Code **mod** (needs Claude Code 2.1.287+) for a GSD project. It adds a live pane and four smaller things, each showing what the GSD statusline does not:

GSD · stopped: PAUSED 2026-09-09 after the schema review · 9/14 phases  ⚠ ~124 commits since STATE.md   <- above the prompt
❯ /gsd-execute-phase 2                                                                                          <- dim suggestion, Tab to take
⏵⏵ auto mode on (shift+tab to cycle) · next: Run /gsd-execute-phase 2 · handoff 5d ago                          <- end of the line under the prompt
  • GSD · line (above the prompt): shown only for a GSD project (a .planning/STATE.md whose frontmatter has gsd_state_version). stopped_at cut to its first sentence, plus phases done. It never repeats status or the plan counts, which the GSD statusline already shows, and it shows no age: STATE.md's last_updated is touched without the content changing.
  • ⚠ ~N commits since STATE.md: on that line, when the commit in state_head is 5 or more commits behind this clone's HEAD, so you know STATE.md is stale. Counted from the git reflog, so approximate (it undercounts: 124 against 217 from git rev-list on one repo); hidden when state_head is absent or not in the reflog.
  • next: hint (end of the line under the prompt): next_action from .planning/HANDOFF.json, with the handoff's own age. It is added as a dim tail, so the engine's line and its pills stay, and it is hidden while you type or while a turn runs. GSD deletes the file after a resume, so it goes away when it is no longer needed.
  • Tab suggestion (the empty prompt box, once at session start): only when the text shown in the next: hint names a command. It offers that command, plus a phase number or version if one follows (/gsd-execute-phase 2), so it always matches the hint beside it. Prose-only actions (Nothing is pending) and actions that say to go elsewher