# {{PROJECT_NAME}}

{{PROJECT_PURPOSE}}

**Aktuelle Phase:** {{PROJECT_PHASE}}
**Stack (grob):** {{PROJECT_STACK}}

---

## Wegweiser für Claude Code

Der Projektstatus lebt in `docs/`, **nicht** in dieser Datei. Diese `CLAUDE.md`
ist bewusst kurz und dient nur der Navigation.

**Bevor du arbeitest, lies in dieser Reihenfolge:**

1. `docs/90-status.md` — wo wir gerade stehen. Single Source of Truth.
2. `docs/10-plan.md` — aktueller Plan, Phasen, offene Milestones.
3. Den neuesten Eintrag in `docs/sessions/` — was in der letzten Session
   passiert ist und was als Nächstes dran war.
4. Bei Architektur-Fragen: die relevanten ADRs in `docs/30-decisions/`.

## Workflow-Skills (global installiert)

- `status` — Wiedereinstieg nach Pause: liest 90-status + letztes Session-Log.
- `handoff` — am Sessionende: Session-Log schreiben, Status aktualisieren.
- `adr <titel>` — neue Architektur-Entscheidung festhalten.
- `plan-start` — wurde bereits ausgeführt, um dieses Projekt zu scaffolden.

## Wichtigste Konventionen

- **Prosa auf Deutsch, Code / Kommandos auf Englisch.**
- **ADRs sind append-only.** Ersetzt werden sie durch neue ADRs mit
  `Supersedes: <nummer>`, nicht durch Umschreiben der alten.
- **`docs/90-status.md` ist die einzige Datei, die den aktuellen Stand
  beschreibt.** Wenn es widersprüchliche Angaben gibt, gewinnt 90-status.
- **Session-Logs sind verpflichtend.** Wer `handoff` überspringt, hat nach drei
  Sessions wieder keinen Überblick — nur mit mehr Dateien drumherum.

<!-- TODO: Die drei bis fünf wichtigsten projektspezifischen Kommandos hier
     ergänzen, sobald der Stack steht. Beispiele:
     - `make dev` — lokale Entwicklung starten
     - `pytest -x` — Tests bis zum ersten Fehler
     - `docker compose up` — Infrastruktur lokal hochfahren
-->