initial: claude code workflow bundle (plan-start, status, handoff, adr)

2026-04-17 07:28:49 +02:00
commit 20a0ab38f2
16 changed files with 978 additions and 0 deletions
@@ -0,0 +1,45 @@
+# {{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
+-->