update

templates/Prompt/Baustein-Frage-Kritik.md

@@ -9,13 +9,16 @@ KOMPAKTE FASSUNG (Merksätze, falls vorhanden):
 BISHERIGER PRÜFUNGS-VERLAUF (nur frühere Fragen und Antworten):
 {transcript}
 
+BEREITS GESTELLT / SCHON VORGEMERKT (Frage darf keiner davon gleichen):
+{vermeide_block}
+
 ZU PRÜFENDE FRAGE:
 {frage}
 
 PRÜFE GEGEN DIESE KRITERIEN:
 - Stil: GENAU EINE Frage, ein einziges Fragezeichen, eine einzige Sache. Kein Mehrteiler ("und"/"sowie", "sowohl … als auch …", "nenne drei …").
 - Kürze: maximal 1–2 Sätze, kein Szenario-Aufbau über mehrere Sätze, keine lange Vorrede.
-- Keine Wiederholung einer Frage aus dem Verlauf.
+- KEINE Wiederholung — beanstande, wenn die Frage einer aus Verlauf ODER Vermeide-Liste SINNGEMÄSS zu ähnlich ist (gleiche Kernsache, nur umformuliert).
 - Fachlich korrekt: Die Frage muss aus dem Material oben beantwortbar sein und darf der Referenz NICHT widersprechen. Keine erfundenen Zusatzannahmen.
 
 Beanstande NUR echte Verstöße. Ist die Frage knapp, einzeln und korrekt, ist sie in Ordnung — verlange nichts darüber hinaus.

templates/Prompt/Baustein-Frage.md

@@ -9,6 +9,9 @@ KOMPAKTE FASSUNG (Merksätze, falls vorhanden):
 BISHERIGER PRÜFUNGS-VERLAUF (nur frühere Fragen und Antworten):
 {transcript}
 
+BEREITS GESTELLT / SCHON VORGEMERKT — auch SINNGEMÄSS NICHT wiederholen:
+{vermeide_block}
+
 HARTE REGELN FÜR DIE FRAGE — wichtiger als alles andere:
 - GENAU EINE Frage. Ein einziges Fragezeichen. Eine einzige Sache.
 - Maximal 1–2 Sätze. Kein Szenario-Aufbau, keine Vorrede, kein "Angenommen … und außerdem …".
@@ -17,7 +20,7 @@ HARTE REGELN FÜR DIE FRAGE — wichtiger als alles andere:
 - KEIN Faktenabruf ("welche Daten…", "wie viele…", "was enthält…"): das prüft Auswendiglernen, nicht Verständnis.
 - Frag nur zu dem, was der Abschnitt wirklich erklärt — nicht zu am Rand Erwähntem (ein Stichwort), das er nicht ausführt.
 - Passt eine Transferfrage nicht in einen Satz, wähle eine einfachere Frage.
-- Wiederhole keine Frage aus dem Verlauf.
+- Wiederhole KEINE Frage aus Verlauf oder Vermeide-Liste — auch nicht sinngemäß/umformuliert. Frag eine ANDERE Sache (anderer Aspekt, anderer Subbaustein).
 
 FACHLICHE REFERENZ — WICHTIG:
 - Die Guide-Fassung und die Vertiefung oben sind die Referenz. Deine Frage darf ihr NIE widersprechen.

templates/Prompt/Guide-Inhalt.md

@@ -7,6 +7,8 @@ Dir zugeteilt sind folgende Kapitel und Bausteine — verbindlich: jeder zugetei
 
 Sammle pro Baustein:
 - Kernpunkte / Lernziele: was muss der Leser begreifen? Decke JEDEN gelisteten Subbaustein mit mindestens einem Kernpunkt ab. Hat ein Baustein keine Subbausteine, sammle 3–7 knappe Punkte.
+- Voraussetzungen: welche Begriffe/Ideen muss man vorher kennen, um das hier zu verstehen? Jede in einem Halbsatz erklärbar — das sind die Ankerpunkte für Neulinge.
+- Typische Hürden: wo verstehen Anfänger es erfahrungsgemäß falsch oder stolpern?
 - Belegte Fakten (Versionen, Namen, Werte) — nichts Unbelegtes; Unsicheres per Websuche prüfen.
 - Eine konkrete Beispiel-Idee: was soll das Beispiel zeigen?
 - Scope: nur was DIESER Baustein hergibt. Nicht mehr, nicht weniger. Am Rand Erwähntes nicht zum Thema aufblasen.
@@ -16,6 +18,8 @@ Schreibe NUR die Datei {out_path} — pro Baustein ein section-Marker (Titel EXA
 <!-- section: Exakter Baustein-Titel -->
 - Kernpunkt …
 - Kernpunkt …
+Voraussetzung: was vorher kurz erklärt werden muss (Anker)
+Hürde: typischer Anfänger-Irrtum
 Beispiel: kurze Idee, was das Beispiel zeigt
 
 Die Marker-Zeile exakt so schreiben. Kein Text außerhalb der Sections, kein Fließtext-Guide.

templates/Prompt/Guide-Writer.md

@@ -12,13 +12,14 @@ Jeder Baustein bekommt ZWEI Fassungen mit DENSELBEN Inhalten (dieselben Subbaust
 - **ausführlich**: der zusammenhängende Anfänger-Lerntext (siehe unten).
 Beide MÜSSEN dieselben Subbausteine abdecken. Nichts, das nur in einer Fassung steht.
 
-SO SCHREIBST DU die ausführliche Fassung — EIN zusammenhängender Text, kein Stichwort-Stakkato:
-- Schreibe pro Baustein EINEN fließenden Lern-Text laut SECTION-SPEZIFIKATION (Einordnung → Erklärung → Beispiel). Ein roter Faden, mit Übergängen.
+SO SCHREIBST DU die ausführliche Fassung — EIN zusammenhängender Text für einen Junior, der das Thema NEU lernt:
+- Beginne mit dem Anker (Einordnung): welches Problem/wozu, angeknüpft an etwas Bekanntes — erst dann das Neue. Pflicht, nie weglassen.
+- Löse JEDEN Fachbegriff bei Erstnennung in einem Halbsatz auf. Setze nichts voraus — auch keine Begriffe aus dem Titel oder anderen Bausteinen. Nutze die „Voraussetzung"-Hinweise aus den Inhalten als Anker, die „Hürde"-Hinweise, um Missverständnisse vorweg auszuräumen.
 - Die Subbausteine sind deine INHALTS-CHECKLISTE, keine Überschriften: webe sie in den Fließtext ein. Behandle jeden, aber als Teil eines Ganzen — nicht als isolierten Mini-Absatz.
 - Reihenfolge: erst die `[einfach]`-Punkte (das Fundament), dann `[mittel]` (Details/Varianten), zuletzt `[schwer]` (Sonderfälle/Tücken — knapp, als fortgeschrittener Hinweis).
-- Tiefe folgt der Zahl der Subbausteine: ein Baustein mit vielen Subbausteinen wird ein langer, gehaltvoller Text; einer mit wenigen bleibt kurz. Das ist gewollt.
-- KEIN festes Längen-Limit. So lang wie nötig, damit ein Anfänger es ohne Vorwissen versteht. Lieber ein Satz mehr und klar.
-- Beispiel großzügig einsetzen, wo es hilft — bei Code-/Tool-Themen fast immer ein kurzes Code-Snippet (Format laut Spezifikation).
+- Diese Fassung trägt die volle Tiefe selbst — es gibt keine zweite Ausbaustufe. „Wie"-Abläufe Schritt für Schritt zeigen, nicht nur das Ergebnis.
+- KEIN festes Längen-Limit. So lang wie nötig, damit ein Neuling es OHNE Vorwissen versteht. Im Zweifel ein Satz mehr und klar.
+- Beispiele großzügig — auch kleine Mini-Beispiele mitten im Text, wo sie einen Punkt sofort greifbar machen, zusätzlich zum `### Beispiel` am Ende (Format laut Spezifikation).
 
 GEPRÜFTE INHALTE je Baustein — das ist verbindlich, was gelehrt werden muss:
 {inhalte}