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 <noreply@anthropic.com>
This commit is contained in:
2026-08-23 06:42:52 +02:00
parent 890c9f4869
commit d9e5b10f49

View File

@@ -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). 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; 4. Statusbaum (`/projektstatus`) unverändert plausibel — die Aufräumaktion darf **keinen** TP-Status ändern;
sie ändert nur, wie präzise er begründet ist. 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.