open/ktg-plugin-marketplace
1
0
Fork 0
Code Issues Releases Activity

docs(catalog): graceful-handoff block describes v3.x, not the v2 it replaced

Browse source 
The stat line was fixed in 950c7a9, but it sat above four bullets that
still sold the architecture the plugin removed in v3.0 (BREAKING). The
catalog advertised a Stop hook at ~70% context, model-aware context
detection, a statusLine hint with SessionStart auto-load, and a
"handoff artifact" -- none of which exist. The version label v3.1.0 was
correct all along; only the prose was a major version behind.

The flags were wrong too: the catalog documented
`[topic-slug] [--no-push]`, neither of which the skill accepts. Measured
contract is `argument-hint: "[--no-commit] [--dry-run]"`.

Rewritten from the plugin's own README and SKILL.md: one user-initiated
skill (`disable-model-invocation: true`), overwrites the nearest
STATE.md with a mandatory NESTE block, remote-aware commit that stages
only STATE.md, push left to the operator.

The removal reason is worth stating rather than hiding -- a hook has no
session context, so it could only ever write a poor snapshot, and would
overwrite a good model-written STATE.md. That is a design argument for
the plugin, not an omission to paper over.

check-versions 11 OK / 0 WARN / 0 ERROR; tests 28 pass.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JoD3K9WDXSZNACArc7zTwn
This commit is contained in:
Kjell Tore Guttormsen 2026-07-31 20:49:51 +02:00
commit 999223508b
1 changed files with 8 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

14
README.md
View file

@ -85,14 +85,16 @@ Research-informed thresholds. Alerts are progressive and never blocking. Privacy
### [Graceful Handoff](https://git.fromaitochitta.com/open/graceful-handoff) `v3.1.0`
Auto-trigger session handoff at context threshold, so summarizing state, committing work, and writing a continuation prompt don't get rushed when you run low. Manual `/graceful-handoff` always works as backup. Built for Opus 4.7.
One deliberate command to end a session cleanly and hand it to the next. `/graceful-handoff` reaches a natural stopping point and overwrites the nearest `STATE.md` — the continuity artifact the following session reads at startup.
- **Auto-trigger via Stop hook** — at ~70% context, writes the handoff artifact and commits (push stays manual; irreversible operations remain user-triggered)
- **Model-aware context detection** — a 4-step fallback chain so Opus 4.7's 1M window fires at the right moment, not 5–7× too early
- **statusLine hint + SessionStart auto-load** — display-only warnings at 60%/70%, then injects the handoff into the resumed session
- **Deterministic JSON pipeline** — runs without an LLM, stages only the artifact (never `git add -A`), under a 60s budget
- **Stopping point first** — finishes the current logical unit and leaves the code working before it writes anything
- **Overwrites the nearest `STATE.md`** — a complete state-of-play in a fixed format, headed by a mandatory `👉 NESTE — START HER` block: where you are, the next concrete step, what to read
- **Remote-aware commit** — classifies the remote (private → tracked and committed, public → local-only), stages *only* `STATE.md`, never `git add -A`; push stays yours
- **User-initiated only** — `disable-model-invocation: true`, so the model cannot hand off on its own. A slim deterministic helper does the mechanical parts under a 60-second budget
Key command: `/graceful-handoff [topic-slug] [--no-commit] [--no-push] [--dry-run]`
v3.0 removed the auto-trigger hooks on purpose: a hook has no session context, so it could only ever write a poor snapshot — and would overwrite a good, model-written `STATE.md`.
Key command: `/graceful-handoff [--no-commit] [--dry-run]`
1 skill · 1 pipeline · 30 tests · [Full documentation →](https://git.fromaitochitta.com/open/graceful-handoff)