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.
This commit is contained in:
parent
f2080adf35
commit
b9269f853d
9 changed files with 676 additions and 0 deletions
40
plugins/graceful-handoff/CLAUDE.md
Normal file
40
plugins/graceful-handoff/CLAUDE.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
# 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:
|
||||
|
||||
1. Detekter arbeidsmappe og prosjekt (pwd, git, find)
|
||||
2. Identifiser handoff-type (multi-sesjon / plugin-arbeid / enkelt-oppgave)
|
||||
3. Skriv NEXT-SESSION-artefakt til riktig lokasjon
|
||||
4. Oppdater REMEMBER.md og TODO.md
|
||||
5. Commit + push med Conventional Commits-melding (auto-generert)
|
||||
6. 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
|
||||
Loading…
Add table
Add a link
Reference in a new issue