update

templates/Format/Section.md

@@ -5,6 +5,8 @@ Jeder Baustein wird GENAU eine Section mit:
 2. Beschreibung — was es ist und wozu: MAXIMAL 1–2 Sätze
 3. Beispiele — KURZ und SIMPEL: wenige Zeilen Code, das Minimalbeispiel, keine Realwelt-Komplexität. Höchstens 1 knapper Satz Einordnung dazu. Ein Beispiel pro relevanter Variante: simple Bausteine eines, variantenreiche mehrere. Geordnet vom Üblichen zum Speziellen. Weglassen, wenn ohne Mehrwert.
 
+Jede Section ist ATOMAR: allein verständlich, ohne dass der Leser eine andere Section gelesen hat. Test: Ergibt der Text Sinn, wenn man NUR diese Section liest? Verweise auf andere Bausteine sind erlaubt, ihr Inhalt darf aber nie vorausgesetzt werden — benutzte Begriffe in einem Halbsatz auflösen.
+
 Umfang: kurz. Die Länge einer Section kommt aus der ZAHL der Beispiele (Varianten), nie aus langen Texten.
 
 Tonalität: klares Deutsch, direkt, praxisorientiert. Fachbegriffe beim ersten Auftreten kurz erklären. Keine Füllsätze, keine Einleitungsfloskeln.

templates/Prompt/Bausteine-Auswahl.md

@@ -5,6 +5,7 @@ Drei Recherche-Agenten haben unabhängig voneinander die Bausteine des Themas "{
 Regeln:
 - Vereinige die Listen: erkenne gleiche Konzepte unter verschiedenen Titeln und führe sie zu einem Baustein zusammen.
 - Ein Baustein löst GENAU EIN PROBLEM. Einträge, die Varianten derselben Lösung sind, werden zu EINEM Baustein zusammengefasst (richtig: ein Baustein `<input>` für alle Typen; falsch: je ein Eintrag pro input-Typ, aber auch Sammeleinträge, die mehrere Probleme mischen).
+- Ein Baustein ist ATOMAR: genau eine Idee, vollständig in sich. Test: Man kann nichts entfernen, ohne ihn unvollständig zu machen — und es fehlt nichts, um ihn zu verstehen.
 - Verwirf Bausteine ohne Quelle oder die erfunden wirken. Behalte im Zweifel, was mindestens eine Recherche belegt.
 - KEINE Kategorien, KEINE Bewertung — eine flache, durchnummerierte Liste.
 - Lass die Quellen weg. Titel und Kurzbeschreibung (max. ~12 Wörter) auf DEUTSCH (Code-Bezeichner bleiben original). Jeder Titel muss EINDEUTIG sein.

templates/Prompt/Bausteine-Recherche.md

@@ -4,6 +4,7 @@ Ermittle ALLE Bausteine (Konzepte/Funktionen/Features) des Themas "{topic}" für
 
 Regeln:
 - Ein Baustein löst GENAU EIN PROBLEM. Varianten derselben Lösung gehören in den einen Baustein, nicht als eigene Einträge (richtig: `<p>` ist ein Baustein, `<input>` mit allen Typen ist ein Baustein; falsch: 21 Einträge für jeden input-Typ, aber auch Sammeleinträge, die mehrere Probleme mischen).
+- Ein Baustein ist ATOMAR: genau eine Idee, vollständig in sich. Test: Man kann nichts entfernen, ohne ihn unvollständig zu machen — und es fehlt nichts, um ihn zu verstehen.
 - KEINE Kategorien, KEINE Bewertung, KEINE Reihenfolge nach Wichtigkeit — nur eine flache, durchnummerierte Liste.
 - Es gibt KEINE Ziel-Anzahl. Höre erst auf, wenn die Recherche nichts Neues mehr hergibt.
 - Erfinde nichts: nimm nur Bausteine auf, die du in der Recherche belegt hast. Notiere pro Baustein die Quelle (URL bzw. Dateipfad).

templates/Prompt/Bausteine-Sortierung.md

@@ -1,23 +0,0 @@
-Sortiere die Bausteine des Themas "{topic}" in EINE Gesamtreihenfolge für einen Lern-Guide.
-
-BAUSTEINE:
-{bausteine}
-
-Kriterium — bewerte jeden Baustein mit zwei Fragen: Ist er WICHTIG (braucht ihn fast jeder Anwender)? Ist er EINFACH (ohne viel Vorwissen verständlich)? Daraus folgt die Reihenfolge:
-1. wichtig + einfach
-2. wichtig + komplex
-3. unwichtig + einfach
-4. unwichtig + komplex
-
-Querregeln:
-- Voraussetzungen stehen vor dem, was auf ihnen aufbaut.
-- Sortiere NICHT nach Dokument- oder Themenstruktur. Ein seltener Baustein gehört nach hinten, auch wenn er thematisch zu frühen Bausteinen gehört (Beispiel HTML: `<base>` ist ein head-Element wie `<title>`, aber unwichtig → weit hinten).
-
-Regeln:
-- ALLE Bausteine genau einmal, keine neuen erfinden.
-- Verwende NUR den Titel, EXAKT wie in der Liste (ohne Beschreibung).
-
-Schreibe NUR die JSON-Datei nach: {out_path}
-
-Format:
-{{"reihenfolge": ["Titel", "Titel", "Titel"]}}

templates/Prompt/Guide-Plan.md

@@ -1,19 +1,28 @@
 Plane die Gliederung eines Lern-Guides zum Thema "{topic}" (Format: {format_name}).
 
-BAUSTEINE (jeder wird genau eine Section des Guides):
+BAUSTEINE (unsortiertes Inventar):
 {bausteine}
 
-Aufgabe: Gruppiere ALLE Bausteine in Kapitel und bringe sie in eine sinnvolle Lernreihenfolge — vom Fundament zum Speziellen.
+{auswahl_auftrag}
+
+AUSWAHL — denke vom Ziel her: Was soll der Leser am Ende KÖNNEN?
+- Wähle, was der Leser dafür praktisch braucht und wirklich benutzt.
+- Lass weg: Interna (was das Werkzeug intern tut, ohne dass man es anfasst), Spezialfälle und Alternativen zum selben Problem — ein Weg reicht.
+- "Klingt fundamental" ist kein Kriterium. Frage stattdessen: Fasst der Leser das selbst an?
+
+REIHENFOLGE — vom Bekannten zum Unbekannten:
+- Kapitel 1 führt zum schnellsten sichtbaren Ergebnis (erster Erfolg), nicht zur Theorie.
+- Konkretes vor Abstraktem, Einfaches vor Komplexem, Voraussetzungen vor dem, was auf ihnen aufbaut.
+- Jedes Kapitel baut auf den vorigen auf — ein roter Faden, keine Themensammlung.
 
 Regeln:
-- Jeder Baustein landet in GENAU einem Kapitel. Keinen weglassen, keinen erfinden.
+- Jeder gewählte Baustein landet in GENAU einem Kapitel. Keine neuen erfinden.
 - Verwende die Titel EXAKT so, wie sie in der Liste stehen.
-- Die Reihenfolge innerhalb der Kapitel ist die Lese-Reihenfolge.
-- 3–10 Bausteine pro Kapitel sind ein guter Rahmen; die Kapitelzahl folgt aus dem Thema.
+- 3–7 Bausteine pro Kapitel; die Kapitelzahl folgt aus dem Thema.
 - Kapiteltitel kurz und konkret.
 
 Schreibe NUR die JSON-Datei nach: {out_path}
 
 Format:
 {{"kapitel": [{{"titel": "Grundlagen", "bausteine": ["Exakter Titel", "Exakter Titel"]}}]}}
-{extra}
+{extra}