init2

2026-09-02 00:10:23 +02:00
parent e2903b96dc
commit 315da73575
41 changed files with 811 additions and 2053 deletions
@@ -60,6 +60,18 @@ delegieren. Standards stehen in `AGENTS.md`, wiederkehrende Einzelaufgaben in de
  an den richtigen Lead weiter.
 - Oder einen Lead direkt ansprechen, z. B. `@dnd-session-lead Verarbeite die Notizen vom 18.08.2026`.

+## Robustheit: kleine Schritte
+
+Um Timeouts bei großen Aufgaben zu vermeiden, gilt überall:
+
+- **Große Aufgaben in kleine Schritte zerlegen** (eine Datei / ein Abschnitt / eine Ebene) und
+  mit `todowrite` tracken.
+- **Pro Worker-Aufruf nur eine fokussierte Teilaufgabe.**
+- **Große Quell-Dateien nicht wiederholt komplett einlesen** — gezielt lesen oder Inhalte inline
+  an den Worker weiterreichen.
+- **Editierungen derselben Datei sequenziell**, nicht parallel.
+- Bei Timeout/Fehlschlag den **Scope verkleinern** statt denselben großen Schritt zu wiederholen.
+
 ## Sprache & Verlinkung (verbindlich)

 - Interaktion mit dem Nutzer: Deutsch oder Englisch.
@@ -80,6 +80,22 @@ Gib dem Nutzer eine kurze deutsche Zusammenfassung: was wurde erschaffen, welche
 - Struktur/Timeline-Pflege → `dnd-worker-organizer`
 - Kreative Rohideen → `dnd-creative` (nur Ideen, ein Aufruf)

+## Scope & Timeout (verbindlich)
+
+Große Aufgaben laufen sonst in Timeouts. Beachte:
+
+1. **In kleine Schritte zerlegen.** Eine große Aufgabe in klar abgegrenzte Teilaufgaben aufteilen
+   (eine Datei / ein Abschnitt / eine Ebene). Plan mit `todowrite` tracken.
+2. **Pro Worker-Aufruf nur EINE fokussierte Teilaufgabe.** Nicht mehrere Dateien oder große
+   Abschnitte in einem einzigen `task`-Aufruf bündeln.
+3. **Große Quell-Dateien nicht wiederholt komplett einlesen.** Gezielt lesen (`grep`, `read` mit
+   `offset`/`limit`) oder den Inhalt einmal extrahieren und **inline** an den Worker weiterreichen.
+4. **Inhalt inline übergeben statt erneut lesen lassen.** Hast du den Inhalt bereits, gib ihn dem
+   Worker direkt mit — der Worker muss ihn nicht nochmal aus der Datei ziehen.
+5. **Editierungen derselben Datei SEQUENZIELL** ausführen (nicht parallel), um Konflikte zu vermeiden.
+6. **Bei Timeout/Fehlschlag: Scope verkleinern** und erneut versuchen — nicht denselben großen
+   Schritt unverändert wiederholen.
+
 ## Wichtige Hinweise

 - Mindestens eine Idee aus `05-Ideas/` verwenden, wenn der Nutzer nichts anderes sagt.
@@ -82,6 +82,22 @@ Zeitstrahl pflegen.
 - Struktur, Links, Timeline, Ereignisse → `dnd-worker-organizer`
 - Kreative Rohideen (nur wenn nötig) → `dnd-creative`

+## Scope & Timeout (verbindlich)
+
+Große Aufgaben laufen sonst in Timeouts. Beachte:
+
+1. **In kleine Schritte zerlegen.** Eine große Aufgabe in klar abgegrenzte Teilaufgaben aufteilen
+   (eine Datei / ein Abschnitt / eine Ebene). Plan mit `todowrite` tracken.
+2. **Pro Worker-Aufruf nur EINE fokussierte Teilaufgabe.** Nicht mehrere Dateien oder große
+   Abschnitte in einem einzigen `task`-Aufruf bündeln.
+3. **Große Quell-Dateien nicht wiederholt komplett einlesen.** Gezielt lesen (`grep`, `read` mit
+   `offset`/`limit`) oder den Inhalt einmal extrahieren und **inline** an den Worker weiterreichen.
+4. **Inhalt inline übergeben statt erneut lesen lassen.** Hast du den Inhalt bereits, gib ihn dem
+   Worker direkt mit — der Worker muss ihn nicht nochmal aus der Datei ziehen.
+5. **Editierungen derselben Datei SEQUENZIELL** ausführen (nicht parallel), um Konflikte zu vermeiden.
+6. **Bei Timeout/Fehlschlag: Scope verkleinern** und erneut versuchen — nicht denselben großen
+   Schritt unverändert wiederholen.
+
 ## Wichtige Hinweise

 - Bestehende Inhalte nur anreichern, nicht umschreiben.
@@ -69,6 +69,17 @@ verständlich zurückzugeben. Du erledigst **keine** konkrete Vault-Arbeit selbs
 - **Mehrere Use Cases gleichzeitig** → die Leads nacheinander anstoßen und Ergebnisse bündeln.
 - Gib dem Lead **genug Kontext** (Dateipfade, Datum, Ziel), damit er eigenständig arbeiten kann.

+## Scope-Management (wichtig gegen Timeouts)
+
+Große Aufträge laufen sonst in Timeouts. Deshalb:
+
+1. **Zerlege große Aufträge in Schritte** und lege sie mit `todowrite` an, bevor du delegierst.
+2. **Delegiere kleine, begrenzte Teilziele** — nicht einen riesigen Gesamt-Auftrag an einen Lead.
+3. **Sammle selbst Kontext ein** (gezielte `read`/`glob`/`grep`) und **reiche Inhalte inline** an
+   den Lead/Worker weiter, statt ihn große Dateien selbst lesen zu lassen.
+4. **Wenn ein Lead wiederholt in Timeout läuft:** Scope verkleinern ODER die passenden Worker
+   gezielt nacheinander ansteuern (mit inline bereitgestelltem Inhalt).
+
 ## Beispiel

 **Nutzer**: „Ich habe neue Notizen vom 18.08.2026 in der Inbox — mach daraus den Bericht und
@@ -88,6 +88,22 @@ welche Dateien erstellt/geändert.
 - Kreative Ideen → `dnd-creative` (nur Ideen, ein Aufruf).
 - Du darfst selbst kleine Reads/Edits machen, aber **große Arbeiten delegieren**.

+## Scope & Timeout (verbindlich)
+
+Große Aufgaben laufen sonst in Timeouts. Beachte:
+
+1. **In kleine Schritte zerlegen.** Eine große Aufgabe in klar abgegrenzte Teilaufgaben aufteilen
+   (eine Datei / ein Abschnitt / eine Ebene). Plan mit `todowrite` tracken.
+2. **Pro Worker-Aufruf nur EINE fokussierte Teilaufgabe.** Nicht mehrere Dateien oder große
+   Abschnitte in einem einzigen `task`-Aufruf bündeln.
+3. **Große Quell-Dateien nicht wiederholt komplett einlesen.** Gezielt lesen (`grep`, `read` mit
+   `offset`/`limit`) oder den Inhalt einmal extrahieren und **inline** an den Worker weiterreichen.
+4. **Inhalt inline übergeben statt erneut lesen lassen.** Hast du den Inhalt bereits, gib ihn dem
+   Worker direkt mit — der Worker muss ihn nicht nochmal aus der Datei ziehen.
+5. **Editierungen derselben Datei SEQUENZIELL** ausführen (nicht parallel), um Konflikte zu vermeiden.
+6. **Bei Timeout/Fehlschlag: Scope verkleinern** und erneut versuchen — nicht denselben großen
+   Schritt unverändert wiederholen.
+
 ## Wichtige Hinweise

 - Originale Session-Notizen **nie** zerstören; vor dem Verschieben/Archivieren den Nutzer fragen.
@@ -57,6 +57,11 @@ Struktur, Links, Ereignis-Stream und Zeitstrahl des Vaults gesund. Du folgst [[A
 3. **Vorgenommene Änderungen**
 4. **Empfehlungen**

+## Scope & Timeout
+
+- Bulk-Operationen **Datei für Datei** abarbeiten und inkrementell berichten.
+- Pro Aufruf den Scope begrenzen (eine Datei / ein Reparatur-Typ), um Timeouts zu vermeiden.
+
 ## Regeln

 - **Nie Dateien löschen ohne Nutzer-Rückfrage.**
@@ -53,6 +53,12 @@ Gefunden: 3 aktive Arcs
 Lücken: 03-Story/Events/ ist leer; keine Ereignis-Dateien vorhanden.
 ```

+## Scope & Timeout
+
+- Bei großen Dateien gezielt lesen (`grep`, `read` mit `offset`/`limit`) und **nur die relevanten
+  Auszüge** zurückgeben — keine ganzen Dateien dumpen.
+- Kurze, strukturierte Antworten mit exakten Pfaden + `[[Links]]`.
+
 ## Regeln

 - Nur lesen — niemals `write`/`edit`/`bash`.
@@ -61,6 +61,14 @@ Vault-Dateien nach Vorgabe eines Leads. Du folgst exakt den Standards aus [[AGEN
 3. **Gesetzte Links** (neu erstellte `[[...]]`-Verbindungen)
 4. **Hinweise/Blocker**

+## Scope & Timeout
+
+- Bearbeite nur die vorgegebene Datei/Sektion — nicht die ganze Datei umschreiben.
+- Wenn der Lead/Orchestrator Inhalt inline liefert, verwende ihn **direkt**; lies keine großen
+  Quell-Dateien erneut komplett ein.
+- Große Dateien gezielt lesen (`read` mit `offset`/`limit`, `grep`).
+- Pro Aufruf eine fokussierte Änderung.
+
 ## Regeln

 - Nur gemäß Vorgabe des Leads arbeiten — nichts Eigenes erfinden, was nicht beauftragt wurde.