Christoph Emsenhuber
39e19e7f0f
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>
46 lines
2.5 KiB
Markdown
46 lines
2.5 KiB
Markdown
# 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.
|