ki-praxis/templates/handoff-template.md

Handoff-Template

Kopieren, ausfüllen, in der Session ablegen (z. B. HANDOFF.md oder docs/handoffs/<ticket>.md).
Ziel: Eine neue Session kann ohne den alten Chat-Verlauf produktiv weiterarbeiten.
Minimal, wenn Zeit brennt; sonst die Vollform. Lieber ein hartes Mini als keins.

Minimal-Handoff (wenn Zeit brennt)

## Ziel
…

## DoD
- [ ] …
- [ ] `…tests…` exit 0

## Stand
- …

## Nächster Schritt
1. …

## Nicht anfassen
- …
- Secrets, Prod-Zugänge, `.env`

## Branch / Scope / Verify
- Branch: …
- Commit-SHA: …
- Scope / Package: …
- Nächster Verify-Command: `…`

Erweitertes Handoff

# Handoff: [Kurztitel der Aufgabe]

## Meta

| Feld | Wert |
|------|------|
| Datum | YYYY-MM-DD |
| Autor / Agent-Session | |
| Branch | |
| Commit-SHA | |
| Scope / Package | |
| Ticket / Issue | |
| Status | in progress / blocked / ready for review |

## Ziel (Outcome)

Was am Ende **fertig** sein soll — in einem Satz, messbar:

- …

## Definition of Done (agent-ermittelbar)

- [ ] …
- [ ] …
- [ ] Tests: `…` → exit 0
- [ ] …

## Ausschlüsse

- …
- …

## Stand (was bereits erledigt ist)

- …
- …

## Entscheidungen (mit Begründung)

| Entscheidung | Begründung | Alternativen verworfen |
|--------------|------------|------------------------|
| … | … | … |

## Offene Punkte / Blocker

| Punkt | Warum blockiert | Nächster Schritt |
|-------|-----------------|------------------|
| … | … | … |

## Relevante Dateien

| Pfad | Rolle | Anmerkung |
|------|-------|-----------|
| `…` | entry / changed / reference / package | … |

## Wichtige Befehle

- Nächster Verify-Command (Tight-Loop): `…`
- Setup / Lint: `…`

## Nächste Schritte (konkret, in Reihenfolge)

1. …
2. …
3. …

## Verbote / Guardrails

- Nicht anfassen: …
- Keine Breaking Changes an: …
- Keine Secrets committen; keine destruktiven Git-Operationen ohne Freigabe

## Kontext-Quellen (lesen vor dem Start)

- [ ] Dieses Handoff
- [ ] `AGENTS.md` / Projekt-Skills
- [ ] …
- [ ] Progress-Log: siehe `progress-template.md` bzw. `PROGRESS.md`

## Kurzfazit für die neue Session

> In 3–5 Sätzen: wo wir stehen, was als Nächstes zählt, woran man scheitern kann.
>
> …