creator3/LEKTIONEN.md

# Lektionen-Herkunft creator3

Basis: `../creator2/LEKTIONEN.md` (83 bezahlte Lektionen aus creator/creator2).
Übernommen als Anforderungen: 1-6, 10, 12-37, 40, 42-49, 52-83 + die vier
Meta-Regeln. Entfallen (CLI-/PDF-/uni-spezifisch): 7-9, 11, 38-39, 41, 51.
Lektion 50 (API statt CLI) ist die Gründungsentscheidung von creator3.

## Neue Lektionen aus der creator2-Analyse (2026-07-22)

84. **Budget default AN** — creator2s „hartes" Budget war per Default 0=aus und
    in allen Echtläufen abgeschaltet. creator3: `RUN_BUDGET_TOKENS=10M` Default
    (config.py), Prüfung VOR und NACH jedem Call (llm.py).
85. **Gates überall hart, nicht nur beim Korpus** — creator2 gatete nur E0;
    E1-E4 stiegen bei Stillstand trotzdem auf. creator3: jede Stufe hat ein
    Gate-Knoten, rot ohne Fortschritt (Fingerprint 2× identisch) → PAUSE
    (engine.py `_gate_abschluss`).
86. **Dopplung inhaltlich prüfen, nicht nur Marker** — creator2 garantierte nur
    Marker-Einmaligkeit. creator3: Satzpaar-Jaccard über Section-Grenzen +
    Panel „redundant vs. didaktisch gewollt" (redundanz.py), Fix ersetzt durch
    Ein-Satz-Refresher + Anker-Link.
87. **Akronym↔Langform explizit als Dedup-Kanal** — Lektion 28 war in creator2
    nie umgesetzt; Cosinus/Jaccard sehen „HTTP"↔„Hypertext Transfer Protocol"
    nicht (dedup.py `_kanal`, textkit.py `ist_akronym_von`).
88. **Nach der Soll-Zuordnung einmal nachdeduplizieren** — der
    Gleicher-Soll-Punkt-Kanal kann erst feuern, wenn soll_ids gesetzt sind;
    Dedup vor Zuordnung allein übersieht Synonym-Paare (inventar.gate).
89. **Engine denkt in Topics, nicht in Runs** — Tasks/Gates sind topic-scoped;
    ein neuer Run auf fertigem Topic ist ein No-Op (Resume-Test: 0 Events).

## Lektionen aus Echtlauf 1 (Pomodoro, 2026-07-22: 353 Soll-Punkte, 2789 Atome,
## 5,4M Tokens für ein Mini-Thema)

90. **Soll-Band ist Pflicht, nicht Deko** — ohne Ziel ≈ √Kandidaten bestätigt
    der Konsens jeden Mikro-Punkt mit 2 Blog-Belegen; alles danach skaliert mit
    (korpus.soll_konsens: Band + 2. Faltungs-Pass).
91. **Websuche braucht Deckel UND Relevanz-Urteil** — 36 Queries × 8 Treffer
    luden 195 Quellen inkl. App-Werbelisten (128 Atome!). Jetzt: QUELLEN_MAX=24,
    Wikipedia zuerst, Kurz-Judge filtert Listen/Shops (suche._relevanz_filter).
92. **Extraktion belegnah, nicht flächendeckend** — ganze Quellen × 2 Reader
    ergab 1135 Atome ohne Soll-Bezug. Jetzt: nur ±4k-Fenster um Soll-Belege;
    Quellen ohne Beleg liefern keine Atome (korpus.gate).
93. **Vollständigkeit braucht einen Gegenspieler: Verdichtung** — Ziel ist das
    minimale Abdeckungs-Set („Entfernen eines Atoms erzeugt eine Lücke").
    Sammeln allein produziert Splitter (582 Atome, 51k-Wörter-Guide). Jetzt:
    Verdichtungs-Knoten je Soll-Punkt (Panel-Schnitt, Fusion vererbt Anker —
    Abdeckung bleibt), Granularitäts-Regel im Extraktor, Beleg-Abdeckung als
    Kennzahl. Writer-Input als Prosa statt Feldern (TITEL:-Leak, 41 Sections).
94. **Befunde brauchen Identität über Runden** — llm_pruefung fügte denselben
    Befund jede Runde als neue Zeile ein; die Eskalations-Kette (geklaert-Flag)
    startete endlos von vorn. Jetzt: Dedupe über (art, item, detail-Kern),
    finale Zustände (freispruch/eskaliert) blocken Wiedereintrag UND Live-Checks
    (guide.befund_merken). Und: Beifang-Atome ohne Soll-Bezug werden nach der
    Zuordnung verworfen — sonst 90 Ballast-Atome → 8 Sammelziele → 32 Bausteine.
95. **Verweis heißt Prosa, nicht Link** — „Verweis statt Wiederholung" mit
    Anker-Links erzeugte Sprung-Zwang und Link-Flut (Gutachten: Leser will
    linear lesen). Jetzt: Rückbezug = Halbsatz ohne Link; det-Checks
    link_im_text/atom_echo/h_ebene erzwingen es; Fettzeilen-Echo (Atom-Input
    wörtlich + Paraphrase) war die Haupt-Dopplungsquelle.
96. **Abdeckung heißt Beleg-Stellen, nicht Punkte** — ein Atom je Soll-Punkt
    genügte formal, ließ aber Facetten aus (Namensherkunft fehlte trotz 7
    Belegen). Jetzt: Facetten-Gate — jede Beleg-Stelle braucht ein Atom im
    ±4k-Umkreis, sonst gezielte Fenster-Nachextraktion (Cap 2, dann
    eskaliert). Wikipedia läuft über die Action-API statt robots-blockierter
    HTML-Seiten.
97. **Redundanz braucht Phrasen- und Zahlen-Kanäle** — Satz-Jaccard 0,6 übersah
    identische Phrasen in längeren Sätzen („Ich melde mich in 20 Minuten" 3×)
    und dieselbe Studie in Paraphrase (a20≈a78). Jetzt: 5-Wort-Shingle-Kanal
    (redundanz.py), Zahlen+Eigennamen-Signatur als Dedup-Kanal (dedup.py),
    Urteil „enthalten" merged Teilmengen-Atome, Ziel-Dedup fängt synonyme
    Lernziele („einordnen"/„verorten" → Doppel-Bausteine → Writer-Echos).
98. **Kuratierte Quelle = 1 Beleg genügt** — das ≥2-Belege-Band schützte vor
    Blog-Halluzination, warf aber Einzelquellen-Facetten weg (Overflow-
    Pomodoros nur in Wikipedia). Jetzt: Wikipedia-Beleg bestätigt allein
    (SOLL_MIN_BELEGE_WIKI); Wikipedia wird geseedet statt ersucht und läuft
    MIT durch den Relevanz-Judge („Pasta"/„Xinjiang" wurden geladen).
99. **Takt statt Breite** — die Parallel-Drossel (12 gleichzeitig) begrenzte
    das Falsche: Rate-Limits zählen Starts pro Minute, nicht offene
    Verbindungen (0×429 in 5k Calls). Jetzt: 1 Call-Start je TAKT_SEKUNDEN
    (llm._slot), Knoten-Klassen bündeln kurze Aufgaben (lang=1, mittel=3,
    kurz=10 Tasks je Call, engine._buendel_claimen + Ergebnis.teil_status).
100. **Bündel-Item-Retry statt Verwerfen** — fehlt ein Item in einer
    Bündel-Antwort, geht NUR sein Task auf „neu" (versuch+1, dann sichtbar
    „fehler"); Skills erzwingen je Item einen Block (OK/LEER/NICHTS als
    explizites Nichts). Dedup: fehlende Paar-Urteile → EIN Nach-Call, danach
    parse-Befund statt stiller „verwandt"-Kante. Stille None-Pfade
    (kapitel_intro, lernziele, bausteine, anker_fix, luecke) sind jetzt
    Raise → Task-Retry. Stille Fehler sind NIE erlaubt.
101. **robots.txt raus für privates Lesen** — der höfliche Bot-Check kostete
    AlpineJS 10/21 Quellen inkl. offizieller Doku; ein Browser fragt auch
    nicht. Privat, ~20 Seiten/Lauf, Domain-Bremse bleibt; Browser-UA
    (laden.py), Wikipedia weiter über die Action-API.
102. **Inhalt beurteilen, nicht Titel** — der Titel-Judge behielt Udemy-Kurse
    („klingt lehrend") und konnte Paywalls nicht sehen. Jetzt: viele Quellen
    laden, DANN ein Kurz-Urteil auf dem echten Text (quellen-urteil,
    status=aussortiert). Einfacher UND treffsicherer.
103. **Vollständigkeit stoppt hart** — sie ist DAS Kernziel; ohne sie ist der
    Rest wertlos. Läufe pausieren mit sprechendem Grund statt Mini-Guide:
    kein Wikipedia geladen, < QUELLEN_MIN nützliche Quellen, > 50 % Atome
    als Beifang verworfen (korpus.gate/inventar.gate, LaufPause).
104. **Messlatte darf nicht aus dem eigenen Korpus schrumpfen** — „100 %
    Abdeckung" maß nur das bestätigte Soll; die ≥2-Quellen-Regel hatte es
    vorher auf 6 Punkte geschrumpft (34 echte Facetten verworfen). Regel
    raus: 1 wörtlicher Beleg bestätigt (Zitat-Gate schützt), Dedup/
    Verdichtung/Prüfungen fangen Überschuss hinten ab.
105. **Struktur-Splitter deterministisch verhindern** — das MIN-Band stand
    nur im Prompt; 30/32 Sections hatten <4 Atome, ein Ziel wurde zu 8
    „Teil"-Sections. Jetzt erzwingt _min_erzwingen das Band, der Ziel-Dedup
    vergleicht Inhaltswort-Kerne (Floskeln raus — Ganz-Satz-Jaccard kam nie
    über 0.36), der Redundanz-Vorfilter hat einen Zahlen+Namen-Kanal
    (Ariga 3×, Wort-Jaccard 0.21), wortgleiche Paare sind nie „didaktisch
    gewollt", und ein Lektorat-Knoten liest einmal den GANZEN Guide.
106. **Sonderregeln sind Schulden** — 5-Agenten-Audit fand 40+ Spezialfälle:
    Wikipedia übersprang das Inhalts-Urteil (lud „Kosovo" ungeprüft), Deutsch
    steckte in Stemmer/Regexes/Floskel-Listen/Output-Literalen, Knoten-Namen
    klebten in config/engine, vier Leere-Marker-Erfindungen, Fakes hingen an
    Prompt-Prosa. Jetzt: JEDE Quelle wird beurteilt (Seed = nur
    Deckel-Umgehung); Sprache = config.SPRACHE (Stemmer, Negationen, Locale,
    TEXTE); pipeline.yaml ist die einzige Wahrheit für Skills/Timeouts/
    Runden-Caps; backend/arten.py bündelt Status-Listen; EIN Leere-Marker
    (LEER), EIN Nichts-Wert (KEINER), skills/README.md ist der Vertrag.
    Boilerplate wird gemessen (Ziel-Floskeln), nicht gelistet.