From 39e19e7f0f6ded6ab8ef56ec62c40ef3c96006ef Mon Sep 17 00:00:00 2001 From: Christoph Emsenhuber Date: Tue, 22 Sep 2026 14:22:31 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20Handoff=20=E2=80=94=20Umbau-Vorschlag?= =?UTF-8?q?=20f=C3=BCr=20Doku-/TP-Verwaltung=20(Analyse-Basis)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/handoff-20260922-doku-umbau-vorschlag.md | 45 +++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/handoff-20260922-doku-umbau-vorschlag.md diff --git a/docs/handoff-20260922-doku-umbau-vorschlag.md b/docs/handoff-20260922-doku-umbau-vorschlag.md new file mode 100644 index 0000000..1e6b44c --- /dev/null +++ b/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.