Claude Code – Session-Workflow

Wie eine typische Session in einem Kicktemp-Projekt abläuft, und wo das kicktemp-playbook eingreift.

1. Projekt hat eine CLAUDE.md

Jedes Projekt-Repo hat eine eigene CLAUDE.md im Root — Kontext, den Claude Code bei jedem Sessionstart automatisch lädt: Stack, Konventionen, Verweise auf relevante Playbook-Learnings (siehe Projekt-Setup).

## Playbook
Build-Pipeline: `.claude/skills/joomla-build/SKILL.md`
Bekannte Joomla-Fallstricke: `~/Development/kicktemp-playbook/learnings/joomla.md`

2. Skills sind Symlinks, nicht Kopien

.claude/skills/joomla-build zeigt per Symlink auf ~/Development/kicktemp-playbook/skills/joomla-build — ein Fix im Playbook wirkt sofort in jedem Projekt, ohne manuell synchronisiert zu werden.

3. Während der Session

• Lange, verzweigte Recherche → /compact statt bei 80 %+ Kontext blind weiterzumachen.
• Ein Thema ist fertig, nächstes ist komplett unabhängig → /clear.
• Riskante Aktion (Migration, Massenänderung) → erst mit --permission-mode plan bzw. explizit nachfragen lassen, dann bestätigen.
• Verifikation vor "fertig" (siehe patterns/docs-and-verification.md): Syntax-Check, Build, bei datenwirksamen Änderungen read-only gegen die Dev-DB gegenrechnen — nicht nur behaupten.

4. Session-Ende: Learnings destillieren

/playbook-learnings am Ende einer Session mit echten Findings laufen lassen. Der Command filtert selbst (nur root-gecausete Überraschungen, keine Trivialitäten, keine Projekt-ADRs), schreibt in die passende learnings/<technologie>.md im Playbook-Repo und committet nur diese Datei.

Definition liegt im Playbook-Repo selbst (nicht pro Projekt duplizieren, sonst driftet die Filter-Logik auseinander).

5. Wann NICHT ins Playbook

• Projektspezifische Entscheidungen (z. B. "ProMed nutzt Secondary-DB- Connection") → Projekt-eigene CLAUDE.md oder Projekt-ADR, nicht kicktemp-playbook/decisions/.
• Vermutungen/Hypothesen ohne verifizierten Root Cause → gar nicht aufschreiben, bis geklärt.
• Ein Skript/Pattern, das erst einmal gebraucht wurde → Rule of Two abwarten (siehe Playbook-README.md).