open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity Actions

docs(graceful-handoff): 2.0 — sync README, CLAUDE.md, root README

Browse source
This commit is contained in:
Kjell Tore Guttormsen 2026-05-01 06:06:16 +02:00
commit 1f0b03b1e5
3 changed files with 155 additions and 166 deletions
Download patch file Download diff file Expand all files Collapse all files

22
README.md
View file

@ -144,21 +144,23 @@ Research-informed thresholds. Alerts are progressive and never blocking. Privacy
---
### [Graceful Handoff](plugins/graceful-handoff/) `v1.0.0`
### [Graceful Handoff](plugins/graceful-handoff/) `v2.0.0`
Session handoff in under 60 seconds. Built for context-constrained models like Opus 4.7 where sessions fill fast.
Auto-trigger session handoff at context threshold. Manual `/graceful-handoff` always works as backup. Built for Opus 4.7.
When you hit 60-70% context and have to start a new session, three things usually get rushed or forgotten: summarizing state, committing finished work, and writing a continuation prompt. `/graceful-handoff` does all three in one step.
When you hit 60-70% context and have to start a new session, three things usually get rushed or forgotten: summarizing state, committing finished work, and writing a continuation prompt. v2.0 removes all three from the user's hands.
- **Auto-detect handoff type** — multi-session (active ultraplan project), plugin-work (inside a marketplace plugin), or single-task (fallback)
- **Writes `NEXT-SESSION-PROMPT.local.md`** — 7-section artifact (why, status, how to continue, push-policy, verification, gotchas) matching the established pattern in llm-security and config-audit
- **Auto-commit + push** — generates Conventional Commits message from `git diff --stat`, respects pre-commit hooks (secrets, pathguard), pushes to Forgejo. `--no-commit` skips
- **Copy-paste prompt for next session** — the critical output, always printed even if everything else fails
- **No subagents, no web** — entirely inline in the main session, under 60 seconds budget
- **Auto-trigger via Stop hook** — at estimated ≥70% context, writes artifact + commits (push remains user-triggered: irreversible operations stay manual)
- **statusLine hint** — display-only warning at 60% and urgent reminder at 70% (never runs git, safe per research)
- **SessionStart auto-load** — on `--resume` / `compact`, handoff content is injected into the new session via `additionalContext`; no manual `cat` needed
- **Skill-architecture** — `disable-model-invocation: true` so Claude can't autonomously invoke the side-effect-bearing flow; user triggers manually or hooks call the pipeline directly
- **Deterministic JSON pipeline** — `scripts/handoff-pipeline.mjs` returns structured JSON; tests run without LLM involvement
- **Explicit staging** — pipeline stages ONLY the artifact (never `git add -A`, regression-tested)
- **No subagents, no web** — under 60s budget; pinned to Sonnet 4.6 to free Opus for the next session
Key command: `/graceful-handoff [topic-slug] [--no-commit] [--dry-run]`
Key command: `/graceful-handoff [topic-slug] [--no-commit] [--no-push] [--dry-run]`
1 command · 0 hooks · 0 agents · declarative markdown
3 hooks · 1 skill · 1 pipeline · 36 tests · BREAKING from v1.0
→ [Full documentation](plugins/graceful-handoff/README.md)