docs: Handoff — Umbau-Vorschlag für Doku-/TP-Verwaltung (Analyse-Basis)

Drei driftende Wahrheitsquellen (Gitea-Issue, teilprojekte.md, CLAUDE.md),
Standard-vs-Eigenbau, drei Vorschläge. Basis für eine separate Session,
die die Umstellung selbstständig sucht und umsetzt.

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

docs/handoff-20260922-doku-umbau-vorschlag.md

@@ -0,0 +1,45 @@
+# 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.