Kjell Tore Guttormsen b9269f853d feat(graceful-handoff): initial plugin with /graceful-handoff command

New plugin that produces a complete session handoff in under 60s:
NEXT-SESSION artifact, commit+push, and copy-paste prompt for next
session. Built for context-constrained models like Opus 4.7 where
sessions fill fast.

- Single declarative command, no hooks/agents/skills
- Detects handoff type: multi-session / plugin-work / single-task
- Default filename NEXT-SESSION-PROMPT.local.md; slug-override
- Flags: --no-commit, --dry-run
- Auto-generated Conventional Commits message from git diff --stat
- Respects pre-commit hooks (secrets, pathguard) — never bypasses

Also: add *.local.md to root .gitignore (existing NEXT-SESSION files
were untracked but not ignored) and list plugin in marketplace
README + CLAUDE.md per docs-convention.

2026-04-19 22:54:10 +02:00

2 KiB

Raw Blame History

graceful-handoff

Én kommando (/graceful-handoff) som produserer en komplett sesjonsoverlevering i ett steg: NEXT-SESSION-artefakt, commit+push, og copy-paste-prompt for neste sesjon.

Når brukes den

Når du nærmer deg kontekst-trøskelen (typisk 60-70% på Opus 4.7) og må starte en ny sesjon. Kommandoen tar jobben med å oppsummere state og pushe ferdig arbeid fra minutter ned til sekunder.

Hva den skriver

Fil	Når
`NEXT-SESSION-PROMPT.local.md` (eller `NEXT-SESSION-<slug>.local.md`)	Alltid — hovedartefakt med 7 seksjoner (Hvorfor / Status / Fortsett / Push-policy / Verifisering / Husk)
`REMEMBER.md`	Hvis den finnes — oppdaterer "Sist oppdatert" og PÅGÅENDE-seksjon
`TODO.md`	Hvis den finnes — flytter ferdige items, legger til neste-økt-items
Commit + push	Hvis ucommittede endringer finnes OG `--no-commit` ikke er gitt

Alle handoff-filer er *.local.md-mønster → gitignored, ikke sporet i git.

Arkitektur

Helt deklarativ — ingen hooks, ingen agents, ingen subprocess. Main-sesjonen utfører alle seks faser inline med Bash + Read/Write/Edit:

Detekter arbeidsmappe og prosjekt (pwd, git, find)
Identifiser handoff-type (multi-sesjon / plugin-arbeid / enkelt-oppgave)
Skriv NEXT-SESSION-artefakt til riktig lokasjon
Oppdater REMEMBER.md og TODO.md
Commit + push med Conventional Commits-melding (auto-generert)
Print copy-paste-prompt til terminal

Tidsbudsjett

< 60 sekunder totalt. Ingen Agent-delegering, ingen WebSearch. Hvis den drar ut: bruker er allerede på kontekst-trøskelen og trenger output raskt.

Begrensninger (v1.0.0)

Ingen auto-invokasjon ved kontekst-terskel — bruker triggrer manuelt
Ingen backup av eksisterende NEXT-SESSION-filer (overskrives, men merger fra innhold)
Ingen integrasjon mot ultraplan-local progress.json (lesing, ikke skriving)
Commit-meldingen er auto-generert uten bekreftelse — bruk --no-commit hvis du vil håndtere commit manuelt

2 KiB Raw Blame History