# 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
