b9269f853d
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.
40 lines
2 KiB
Markdown
40 lines
2 KiB
Markdown
# 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
|