feat(quick-260427-rat): add /gsd:resume-at skill + README "Added features" section; bump 2.38.7 → 2.38.8

New skill `/gsd:resume-at <time>` schedules a future Claude Code session that
auto-runs `/gsd:resume-work` (or any GSD command via `--cmd`) at a specific
time. Thin wrapper over Claude Code's built-in `/schedule` / `CronCreate` —
durability is owned by the host CLI; the skill translates GSD-flavored time
input (`HH:MM`, ISO 8601, `+<duration>`) into the form `/schedule` accepts.

Use case: hitting a usage cap, pausing for the day, or queuing a phase to run
during off-peak quota windows. Default scheduled command is `/gsd:resume-work`
so HANDOFF.json restores context automatically when the future session opens.

Also adds a new top-level README "Added features beyond upstream" section
between "Session continuity + drift resilience" and "Installation". Single
scannable table catalogs 9 plugin-only headliners (scheduled resume, auto-
resume across `/compact`, mid-session checkpoints, plugin-version churn
fallback, drift detection, 92% token reduction, plugin-local workflow bodies,
standardized continuation prompts, cross-session memory).

Drift check green: 122/122/0 (file-layout) · 19/19 (HANDOFF schema) · 82
skills · 0 dash-style refs.

Version 2.38.7 → 2.38.8 in package.json, .claude-plugin/plugin.json,
.claude-plugin/marketplace.json, README. README slash-command count 81 → 82.

Author: jnuyens

.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "gsd",
       "source": "./",
       "description": "Get Shit Done -- structured workflow plugin for Claude Code with planning, execution, verification, and MCP-backed project state",
-      "version": "2.38.7",
+      "version": "2.38.8",
       "author": {
         "name": "Jasper Nuyens"
       },

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd",
-  "version": "2.38.7",
+  "version": "2.38.8",
   "description": "Get Shit Done -- a structured workflow plugin for Claude Code that adds planning, execution, and verification commands with MCP-backed project state",
   "author": {
     "name": "Jasper Nuyens"

.planning/STATE.md

@@ -107,6 +107,7 @@ None.
 | 260425-wfd | Ship plugin-local `workflows/` dir (78 files) + rewrite all `@~/.claude/get-shit-done/*` refs to `@${CLAUDE_PLUGIN_ROOT}/*` form — closes Category B drift (genuinely-missing now 0; baseline 122/122/0) | 2026-04-25 | 8d3fbf9 | [260425-wfd-ship-workflows-dir](./quick/260425-wfd-ship-workflows-dir/) |
 | 260425-rgw | Broaden PostToolUse matcher to also include Read/Grep/Glob/WebFetch/WebSearch (closes 18-min research-read checkpoint gap from sftp-manager incident) | 2026-04-25 | 7497cc6 | [260425-rgw-postool-read-tools](./quick/260425-rgw-postool-read-tools/) |
 | 260421-rnu | Reorganize README — new-user flow (install/use/update) first; upstream-user migration content consolidated at end | 2026-04-21 | 5b5efd5 | [260421-rnu-readme-new-user-reorg](./quick/260421-rnu-readme-new-user-reorg/) |
+| 260427-rat | Add `/gsd:resume-at` skill (wraps `/schedule` for future-resume) + new README "Added features beyond upstream" section; bump 2.38.7→2.38.8 | 2026-04-27 | — | [260427-rat-resume-at-skill](./quick/260427-rat-resume-at-skill/) |
 
 ## Session Continuity
 

.planning/quick/260427-rat-resume-at-skill/PLAN.md

@@ -0,0 +1,107 @@
+---
+slug: 260427-rat-resume-at-skill
+type: quick
+created: 2026-04-27
+status: in-progress
+---
+
+# Quick: Add `/gsd:resume-at` skill + README "Added features beyond upstream" section
+
+## Problem / Goal
+
+Two related asks from the user:
+
+1. **A scheduled-resume command.** When Claude hits a token / usage cap, the user wants
+   to ask Claude to **come back at a specific time** and resume the project. Claude
+   Code already ships a `/schedule` skill (cron-style scheduling via `CronCreate`)
+   and a `/loop` skill (interval re-firing). We just need a **GSD-flavored thin
+   wrapper** that says "schedule `/gsd:resume-work` at time T" so the workflow
+   feels native to the plugin's command surface.
+
+2. **Visibility for plugin-only commands.** The README has tables comparing the
+   plugin to upstream GSD, but plugin-only headline features get buried inside
+   them. The user wants an **"Added features beyond upstream"** section near the
+   top so a fresh visitor immediately sees what the plugin adds.
+
+## Approach
+
+### A. New skill: `skills/resume-at/SKILL.md`
+
+Frontmatter:
+- `name: gsd:resume-at`
+- `description: Schedule a future resume of work — wraps Claude Code's /schedule for GSD continuity.`
+- `argument-hint: "<HH:MM | ISO 8601 | +<duration>> [--cmd <command>]"`
+- `allowed-tools: [Skill, AskUserQuestion]`
+
+Process body (what Claude does when invoked):
+
+1. **Parse the time argument.** Accept three forms:
+   - `HH:MM` — today at that local time (or tomorrow if already past)
+   - ISO 8601 (`2026-04-28T08:00`) — absolute timestamp
+   - `+<duration>` (`+2h`, `+45m`, `+90m`) — relative offset
+2. **Resolve the command to schedule.** Default is `/gsd:resume-work`. If the user
+   passed `--cmd "<command>"`, use that instead — lets you schedule any GSD
+   command (e.g. `/gsd:next`, `/gsd:execute-phase 9`).
+3. **Hand off to Claude Code's `/schedule` skill** via the `Skill` tool with args
+   that translate the GSD-friendly time form into the cron expression `/schedule`
+   expects.
+4. **Confirm what was scheduled.** Print the absolute UTC + local time and the
+   command that will fire.
+
+The skill is intentionally thin — it does NOT reimplement scheduling. All the
+durability (cron persistence, replay-after-restart, etc.) is owned by Claude
+Code's built-in `/schedule`. Resume-at just translates `+2h` and `/gsd:resume-work`
+into the form `/schedule` accepts.
+
+### B. README "Added features beyond upstream" section
+
+Insert a new top-level section directly after `## Session continuity + drift resilience` (existing line 21–27 area) and before `## Installation`. Catalog the
+plugin-only commands and behaviors a fresh user benefits from immediately:
+
+- `/gsd:resume-at <time>` — scheduled resume (NEW in this task)
+- Auto-resume across `/compact` (PreCompact + SessionStart hooks)
+- Periodic mid-session checkpoints (PostToolUse, ≤1/min)
+- Plugin-version churn fallback (newest-cached resolver)
+- File-layout / HANDOFF / namespace drift detectors
+- 92% per-turn token reduction vs upstream's CLAUDE.md form
+
+Keep it scannable — bullet list with one-liner each, link to the deeper "For
+users of upstream GSD" tables for details.
+
+### C. Bookkeeping
+
+- README "What GSD Plugin provides" — bump `81 slash commands` → `82 slash commands`
+- CHANGELOG.md — `## [2.38.8] - 2026-04-27` entry: `Added: /gsd:resume-at skill (wraps /schedule for GSD-flavored future-resume).`
+- Version bump 2.38.7 → 2.38.8 in:
+  - `package.json`
+  - `.claude-plugin/plugin.json`
+  - `.claude-plugin/marketplace.json`
+  - `README.md` "Plugin version" line
+- Run `node bin/maintenance/check-drift.cjs` — must stay green
+- Verify skill discovery: `ls skills/resume-at/SKILL.md` exists, frontmatter
+  parses (no `\n` issues), and the plugin's command count machinery picks it up
+
+## Files affected
+
+- `skills/resume-at/SKILL.md` (new)
+- `README.md` (new section + version bump + slash-command count)
+- `CHANGELOG.md` (new entry)
+- `package.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` (version)
+
+## Out of scope
+
+- **Reimplementing `/schedule`.** The user's own scheduler suggestion ("queue a
+  message with a delay") is already what `/schedule` does. We wrap, we don't
+  rebuild.
+- **Persisting GSD-specific state on the scheduled run.** When the cron fires,
+  the new session opens fresh and runs `/gsd:resume-work` — which already loads
+  HANDOFF.json. No new persistence layer needed.
+- **A `/gsd:resume-when-quota-resets` command.** Different problem (quota-window
+  detection, not absolute time). Note for future work, not this task.
+
+## Smoke tests
+
+1. `node bin/maintenance/check-drift.cjs` — all 3 detectors PASS
+2. Skill file parses (frontmatter loads cleanly)
+3. README "Added features beyond upstream" section renders before "Installation"
+4. Version refs aligned across package.json / plugin.json / marketplace.json / README

.planning/quick/260427-rat-resume-at-skill/SUMMARY.md

@@ -0,0 +1,69 @@
+---
+slug: 260427-rat-resume-at-skill
+type: quick
+created: 2026-04-27
+completed: 2026-04-27
+status: complete
+---
+
+# Summary: `/gsd:resume-at` skill + README "Added features beyond upstream" section
+
+## What changed
+
+### New skill: `skills/resume-at/SKILL.md`
+
+Added `/gsd:resume-at <time>` — schedules a future Claude Code session to auto-run `/gsd:resume-work` (or any GSD command via `--cmd`) at a specific time. Thin wrapper over Claude Code's built-in `/schedule` / `CronCreate` primitive.
+
+Time formats accepted:
+- `HH:MM` — today (or tomorrow if past)
+- ISO 8601 — absolute timestamp
+- `+<duration>` — relative offset (`+30m`, `+2h`, `+1d`)
+
+Default scheduled command is `/gsd:resume-work`. Override with `--cmd "<any GSD command>"`.
+
+### README "Added features beyond upstream" section
+
+New top-level section inserted between "Session continuity + drift resilience" and "Installation". Single scannable table catalogs 9 plugin-only headliners with one-liner each:
+
+1. Scheduled resume (`/gsd:resume-at`)
+2. Auto-resume across `/compact`
+3. Mid-session checkpoints (PostToolUse, ≤1/min)
+4. Plugin-version-churn fallback
+5. CI-enforced drift detection
+6. 92% per-turn token reduction
+7. Plugin-local workflow bodies
+8. Standardized continuation prompts
+9. Cross-session memory
+
+Replaces the previous structure where these features were buried inside the deep-dive comparison tables. Fresh visitors now see plugin value immediately.
+
+### Bookkeeping
+
+- README slash-command count: 81 → 82
+- README plugin version: 2.38.7 → 2.38.8
+- `package.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`: 2.38.7 → 2.38.8
+- `CHANGELOG.md`: new `## [2.38.8] - 2026-04-27` entry under Added (skill + README section) and Changed (slash count bump)
+
+## Why
+
+Two related asks:
+1. User wanted a way to resume work at a future time when hitting token caps. CC already has `/schedule` and `/loop` for this — we just needed a GSD-flavored on-ramp that defaults to `/gsd:resume-work`.
+2. User noted that plugin-only features were buried inside comparison tables; wanted them surfaced near the top for visibility. New section near `## Installation` accomplishes that.
+
+## Verification
+
+- `node bin/maintenance/check-drift.cjs` — all 3 detectors PASS
+  - File-layout: clean (baseline 122/122/0)
+  - HANDOFF schema: 19/19 fields valid
+  - Namespace: skill registry shows **82 entries** (was 81), 0 stale dash-style refs
+- `ls skills/*/SKILL.md | wc -l` → 82 ✓
+- New skill frontmatter parses (`name: gsd:resume-at`, argument-hint with three time formats, allowed-tools includes Skill / AskUserQuestion / Bash)
+
+## Out of scope (noted for future)
+
+- A `/gsd:resume-when-quota-resets` command — different problem (quota-window detection vs absolute time).
+- Reimplementing `/schedule` — CC already does this correctly. Resume-at is a wrapper, not a rebuild.
+
+## Next step
+
+Commit all changes, tag `v2.38.8`, push, create GitHub release.

CHANGELOG.md

@@ -8,6 +8,17 @@ History before 2.38.2 lives in git + the per-milestone archive (see `.planning/m
 
 ## [Unreleased]
 
+## [2.38.8] - 2026-04-27  (based on upstream GSD 1.38.3)
+
+Plugin-only feature release — adds scheduled-resume support and surfaces plugin-only features more prominently in the README.
+
+### Added
+- **`/gsd:resume-at <time>` skill** — schedule a future Claude Code session to auto-run `/gsd:resume-work` (or any GSD command via `--cmd`) at a specific time. Accepts `HH:MM` (today/tomorrow), ISO 8601, or `+<duration>` (`+30m`, `+2h`, `+1d`). Thin wrapper over Claude Code's built-in `/schedule` / `CronCreate` primitive — durability is owned by the host CLI; the skill translates GSD-flavored input. Default scheduled command is `/gsd:resume-work` so HANDOFF.json restores context automatically when the future session opens. Use case: hitting a usage cap, pausing for the day, or queuing a phase to run during off-peak quota windows (quick task `260427-rat`).
+- **README "Added features beyond upstream" section** — surfaces plugin-only features above the fold in a single scannable table: scheduled resume, auto-resume across `/compact`, mid-session checkpoints, plugin-version churn fallback, drift detection, 92% token reduction, plugin-local workflow bodies, standardized continuation prompts, and cross-session memory. Replaces buried context in the deep-dive comparison tables for fresh visitors.
+
+### Changed
+- **README slash-command count**: 81 → 82 (added `resume-at`).
+
 ## [2.38.7] - 2026-04-25  (based on upstream GSD 1.38.3)
 
 Plugin-only patch — closes a real read-heavy-session checkpoint gap surfaced by a usage-cap incident, plus a fuller README comparison vs upstream.

README.md

@@ -2,13 +2,13 @@
 
 **Based on:** [GSD 1.38.3](https://github.com/gsd-build/get-shit-done/releases/tag/v1.38.3) base tree by **TACHES** (Lex Christopherson)
 
-**Plugin version:** `2.38.7`
+**Plugin version:** `2.38.8`
 
 A performance-optimized plugin packaging of [GSD](https://github.com/gsd-build/get-shit-done) for Claude Code. Reduces per-turn token overhead by ~92%, adds MCP-backed project state, auto-resumes across `/compact`, and bundles everything into a single-install plugin.
 
 ## What GSD Plugin provides
 
-- **81 slash commands** (`/gsd:*`) for project planning, execution, debugging, and verification
+- **82 slash commands** (`/gsd:*`) for project planning, execution, debugging, and verification
 - **21 agent definitions** for specialized workflow roles (planner, executor, researcher, verifier, etc.)
 - **78 workflow bodies** in `workflows/` — operational logic that skills delegate to via `@${CLAUDE_PLUGIN_ROOT}/workflows/<name>.md`
 - **MCP server** exposing project state as queryable resources and mutation tools
@@ -26,6 +26,24 @@ A PostToolUse hook also writes a fresh checkpoint after most tool calls — `Bas
 
 **Drift resilience.** The plugin sits downstream of [upstream GSD](https://github.com/gsd-build/get-shit-done), which ships frequent feature releases. To catch structural drift before it reaches users, three detectors run in CI on every push: a **file-layout drift detector** flags dangling `@~/.claude/get-shit-done/*` references (e.g. skill files delegating to workflow bodies that don't exist in the plugin); a **HANDOFF schema validator** confirms `checkpoint.cjs` output matches the committed JSON Schema; and a **namespace drift check** fires if any `/gsd-<skill>` dash-style command refs have been reintroduced. Each detector has a committed ratchet baseline; regressions hard-fail. After each upstream sync, an additional **upstream schema drift detector** (`check-upstream-schema.cjs`) compares upstream's `/gsd:pause-work` output against our schema to catch format divergence early.
 
+## Added features beyond upstream
+
+This plugin starts from upstream GSD's source tree but adds Claude-Code-native capabilities that aren't possible in upstream's CLI-only design. If you're scanning for "what does this give me that upstream doesn't" — these are the headliners:
+
+| Feature | What it does | Command / hook |
+|---------|--------------|----------------|
+| **Scheduled resume** | Schedule a future Claude Code session to auto-run `/gsd:resume-work` (or any GSD command) at a specific time. Useful when hitting a usage cap, pausing for the day, or queuing a phase to run during off-peak quota windows. Accepts `HH:MM`, ISO 8601, or `+<duration>` (e.g. `+2h`). | `/gsd:resume-at <time>` |
+| **Auto-resume across `/compact`** | When Claude Code compacts a conversation, a 19-field `HANDOFF.json` is written automatically. The next session detects it via SessionStart and invokes `/gsd:resume-work` with **zero manual input**. | PreCompact + SessionStart hooks |
+| **Mid-session checkpoints** | A PostToolUse hook writes a fresh checkpoint after most tool calls (`Bash`, `Edit`, `Write`, `MultiEdit`, `NotebookEdit`, `Read`, `Grep`, `Glob`, `WebFetch`, `WebSearch`), throttled to ≤1/min. Closes the gap when Claude Code's silent *microcompact* path strips tool outputs without firing PreCompact, AND covers read-heavy research phases that don't write files. | PostToolUse hook |
+| **Plugin-version-churn fallback** | If another session upgrades the plugin mid-run and prunes the baked `${CLAUDE_PLUGIN_ROOT}` path, hooks resolve through a Node inline resolver that falls back to the newest cached plugin version. Long sessions survive plugin updates. | Hook command resolver |
+| **CI-enforced drift detection** | Three detectors run on every push: file-layout drift, HANDOFF schema integrity, and namespace normalization. Each has a ratchet baseline; regressions hard-fail. An upstream-schema detector runs post-sync to catch upstream format divergence early. | `bin/maintenance/check-drift.cjs` |
+| **92% per-turn token reduction** | Skill bodies are isolated in `context: fork` sub-agents; orchestration runs in clean child contexts instead of polluting the parent CLAUDE.md. State access uses MCP resources/tools instead of BashTool roundtrips to a CLI. | Plugin architecture |
+| **Plugin-local workflow bodies** | All 78 workflow bodies ship inside the plugin (`workflows/<name>.md`) and resolve via `${CLAUDE_PLUGIN_ROOT}/workflows/<name>.md`. Upstream's setup relies on a global `~/.claude/get-shit-done/` install dir that fails silently when missing. | `workflows/` dir |
+| **Standardized continuation prompts** | 6 terminal skills (`execute-phase`, `complete-milestone`, `verify-work`, `quick`, `plan-phase`, `ship`) emit "Next Up" blocks per `references/continuation-format.md` — `/clear`-then-[next] suggestions with a "/clear is safe (resume restores from HANDOFF)" footer. | All terminal skills |
+| **Memory across sessions** | Phase outcomes persist via Claude Code's memdir and are auto-recalled at session start. Upstream has no persistence — each session starts cold. | Built-in |
+
+For implementation details, see the deep-dive tables in [For users of upstream GSD](#for-users-of-upstream-gsd) below.
+
 ## Installation
 
 GSD Plugin installs *inside* a Claude Code session, not from your host shell. If you have never used Claude Code plugins before, follow these steps in order.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gsd-plugin",
-  "version": "2.38.7",
+  "version": "2.38.8",
   "description": "Performance-optimized plugin packaging of GSD (Get Shit Done) for Claude Code",
   "private": true,
   "scripts": {