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

docs(graceful-handoff): align README with marketplace standard

Browse source 
Plugin README rewritten from 187 to 354 lines in the same shape as
ai-psychosis, llm-security, config-audit, and ms-ai-architect:

- English (other plugin READMEs are English)
- Standard solo-project + AI-generated disclaimers
- Badges row (version, platform, skill/hooks/pipeline counts, tests, license)
- Table of Contents
- Mermaid architecture diagram (detection / pipeline / resumption / manual)
- 4-step context resolution table (v2.1)
- Components section (skill, pipeline, hooks)
- Workflow examples + safety guarantees + limitations
- Inline version history + Feedback & Contributing

Root README graceful-handoff card updated to reflect v2.1 model-aware
detection and 57-test count (was 36).
This commit is contained in:
Kjell Tore Guttormsen 2026-05-01 09:14:10 +02:00
commit 1d12231748
2 changed files with 279 additions and 110 deletions
Download patch file Download diff file Expand all files Collapse all files

5
README.md
View file

@ -150,9 +150,10 @@ Research-informed thresholds. Alerts are progressive and never blocking. Privacy
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. v2.0 removes all three from the user's hands.
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 removed all three from the user's hands; v2.1 makes context detection model-aware so auto-trigger fires at the right moment on Opus 4.7's 1M window.
- **Auto-trigger via Stop hook** — at estimated ≥70% context, writes artifact + commits (push remains user-triggered: irreversible operations stay manual)
- **Model-aware context detection (v2.1)** — 4-step fallback chain (`used_percentage` → `payload-size` → `model-map` → 1M default), so Opus 4.7 no longer fires 5–7× too early
- **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
@ -162,7 +163,7 @@ When you hit 60-70% context and have to start a new session, three things usuall
Key command: `/graceful-handoff [topic-slug] [--no-commit] [--no-push] [--dry-run]`
3 hooks · 1 skill · 1 pipeline · 36 tests · BREAKING from v1.0
3 hooks · 1 skill · 1 pipeline · 57 tests · BREAKING from v1.0
→ [Full documentation](plugins/graceful-handoff/README.md)