Files

Christoph Emsenhuber 39e19e7f0f 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>

2026-09-22 14:22:31 +02:00

2.5 KiB

Raw Blame History

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:

Gitea-Issue (Index + Label status:*/thema:*)
docs/teilprojekte.md (Prosa, kuratiert, ### TPnn-Abschnitte)
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)

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.
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.
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.

2.5 KiB Raw Blame History Unescape Escape