From d9e5b10f49ad74e33f317382103cbeea1a1d9bf0 Mon Sep 17 00:00:00 2001 From: Christoph Emsenhuber Date: Sun, 23 Aug 2026 06:42:52 +0200 Subject: [PATCH] Doku-Session Punkt F: Vorschlag zum Aufteilen der teilprojekte.md Christophs Anstoss vom 2026-08-23 festgehalten, damit er die separate Doku-Session erreicht statt im Sitzungskontext zu verfallen. Empfehlung mit Zahlen: nach ZUSTAND splitten (offen / Archiv), nicht 1 MD pro TP. 1071 der 2205 Zeilen sind abgeschlossene TPs, TP25 allein 393. Ein Schnitt pro TP waeren ~35 Dateien und wuerde das Versprechen aus CLAUDE.md brechen ("kein anderer Kontext noetig") -- er zerstoert die teuerste Eigenschaft der Datei, um ihr billigstes Problem zu loesen. Co-Authored-By: Claude Opus 5 --- docs/doku-cleanup-session.md | 46 ++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) diff --git a/docs/doku-cleanup-session.md b/docs/doku-cleanup-session.md index 6c7eb5c..128faa0 100644 --- a/docs/doku-cleanup-session.md +++ b/docs/doku-cleanup-session.md @@ -137,3 +137,49 @@ Grobschätzung: A+B+C ≈ eine Session, D+E ≈ eine halbe. 3. Der ⚠️-Provisorium-Vorspann über Zeile 21 ist **weg** (weil überflüssig geworden). 4. Statusbaum (`/projektstatus`) unverändert plausibel — die Aufräumaktion darf **keinen** TP-Status ändern; sie ändert nur, wie präzise er begründet ist. + +--- + +## Punkt F — Aufteilen der `teilprojekte.md` (offen, User-Anstoss 2026-08-23) + +**Christophs Beobachtung:** „die teilprojekte.md beginnt zu explodieren. sollten wir sie nicht +besser aufsplitten in übersicht + 1 MD / teilprojekt“ + +**Zahlen zum Zeitpunkt der Frage** (`wc -l` = 2205): + +| | Zeilen | Anteil | +|---|---|---| +| abgeschlossene TPs (✅/📜/❌ im Kopf) | **1071** | 49 % | +| offene TPs | 981 | 44 % | +| Rahmen (VLAN-Modell, Ist-Stand, Reihenfolge) | ~150 | 7 % | + +Groesster Einzelposten: **TP25 mit 393 Zeilen** (18 % der Datei allein). + +### Empfehlung: nach ZUSTAND splitten, nicht nach TP + +🔴 **Gegen „1 MD pro Teilprojekt“** — es waeren ~35 Dateien, und `CLAUDE.md` verspricht +ausdruecklich *„Kein anderer Kontext noetig“*. Beim Schnitt pro TP muesste eine frische Session +**vorher raten**, welche Dateien sie braucht — und genau die Querbezuege, die dieses Dokument +wertvoll machen (Reihenfolge, Abhaengigkeiten, „TP23 haengt an TP5 in *beide* Richtungen“), +leben von der Naehe im selben Text. Der Schnitt wuerde die teuerste Eigenschaft der Datei +zerstoeren, um ihr billigstes Problem zu loesen. + +✅ **Stattdessen:** +- `docs/teilprojekte.md` — Rahmen + kritischer Pfad + **offene** TPs in voller Tiefe +- `docs/teilprojekte-archiv.md` — abgeschlossene TPs, aus der Uebersicht verlinkt + +**Begruendung:** das Wachstum kommt nicht aus der *Zahl* der TPs, sondern aus der **Historie +erledigter**. Deren bleibender Wert sind die Gotchas — und die stehen ohnehin destilliert in +`CLAUDE.md` und den Memories. Ein abgeschlossenes TP wird gelesen, wenn jemand *gezielt* danach +sucht; dafuer reicht eine verlinkte Archivdatei. + +**Zweiter Hebel im selben Zug:** TP25 kondensieren — Funde A–D sind erledigt und brauchen keine +Vollausfuehrung mehr, nur Ergebnis + Merkregel. Zusammen landet die Hauptdatei bei ~700 Zeilen. + +⚠️ **Abnahme wie bei Punkt A:** eine frische Session liest **nur** die neue `teilprojekte.md` +und kann daraus den kritischen Pfad und den Ist-Stand korrekt wiedergeben. Kann sie das nicht, +ist zu viel ins Archiv gewandert. + +📌 **Hinweis zur Herkunft:** der Vorschlag stammt aus der TP6/TP6.1-Sitzung vom 2026-08-23. +Dieselbe Sitzung hat der Datei ~150 Zeilen hinzugefuegt (TP6-Abschluss, TP6.1) — der Split +sollte deshalb **nicht** von der Sitzung gemacht werden, die gerade Inhalt beigesteuert hat.