# Handoff 2026-09-22 — Doku-/TP-Verwaltung: Umbau-Vorschlag (Basis für eigene Session)

**Anlass:** Christoph will eine separate Session, die die Doku-/TP-Verwaltung strafft und die
Vorschläge selbstständig umsetzt. Diese Notiz ist die Analyse-Basis aus der Ausdünnen-Session
(2026-09-22), in der die Drift-Kosten konkret sichtbar wurden. **Vorschläge, kein Mandat.**

## Diagnose (woran es hakt)

Drei parallele Wahrheitsquellen driften gegeneinander:

1. **Gitea-Issue** (Index + Label `status:*`/`thema:*`)
2. **`docs/teilprojekte.md`** (Prosa, kuratiert, `### TPnn`-Abschnitte)
3. **CLAUDE.md** (Quick-Index/Fokus — bis zur Ausdünnen-Session ein Ist-Stand-Block)

Jede Status-/Fakten-Änderung muss an 2–3 Stellen nachgezogen werden. Die komplette
Ausdünnen-Session plus der TP25-Roll-up (507 Zeilen verschieben, Index-Zeile, zwei
„nicht abgeschlossen"-Notizen, Pointer in `teilprojekte.md`) war reine Drift-Bekämpfung —
Arbeit, die ein Gitea-Issue-Kommentar gratis ersetzt.

## Standard vs. Eigenbau (kurz)

Der Claude-Code-Standard ist schmal: **CLAUDE.md** (kurz, statisch, nur das Nicht-Offensichtliche)
+ **git** + **Auto-Memory** + ein Issue-Tracker (Gitea/GitHub/Linear). Ein „TP-System" ist **kein**
Standard — die TP-Verwaltung hier ist Eigenbau auf Gitea. Der Teil „Gitea-Issue als Index + Label
als Status" ist der richtige, standardnahe Kern.

## Drei Vorschläge (Reihenfolge = Wert)

1. **CLAUDE.md = nur statische Konventionen.** Nach der Ausdünnen-Session 28 KB und gut so.
   Nie wieder „aktueller Stand"/Ist-Stand reinschreiben — der gehört nach Gitea.
2. **Status → nur Gitea, Prosa → nur eine Stelle.** Der Kuratier-Aufwand (Index-Tabellen,
   „Dazu am Ende"-Notizen, Archiv-Roll-ups) kostet pro geschlossenem TP mehr als er wert ist.
   Kandidat: Prosa/Detail in den Gitea-Issue-Body/Kommentar verlagern, `teilprojekte.md`
   auf ein append-only Log reduzieren oder ganz durch Issues ersetzen.
3. **Mehr git, weniger kuratieren.** `handoff-*.md` pro Session ist gut. Archiv/Roll-up liefert
   wenig über `git log` + geschlossenes Issue hinaus.

## Abgrenzung / Tradeoffs

- Das System hat echten Wert: auf Christoph zugeschnitten, die Drift-Warnungen haben real etwas
  gefangen. **Nicht ersatzlos streichen.**
- Teuerster Teil ist die **zweite, kuratierte Prosa-Ebene** (`teilprojekte.md` + Archiv) — nicht die
  Gitea-Ebene und nicht CLAUDE.md.
- Die separate Session sucht selbstständig Vorschläge UND setzt um; diese Notiz ist die Ausgangslage,
  kein Plan.