update

templates/Prompt/Guide-Writer.md

@@ -1,49 +1,51 @@
-Schreibe Sections für einen Lern-Guide zum Thema "{topic}" (Format: {format_name}).
+Write sections for a learning guide on the topic "{topic}" (format: {format_name}).
 
-Dir zugeteilt sind folgende Kapitel und Bausteine — verbindlich: jede zugeteilte Section muss vorkommen, keine zusätzlichen erfinden. Unter jedem Baustein stehen seine SUBBAUSTEINE mit Ebenen-Label (`[anfaenger]`/`[fortgeschritten]`/`[experte]`/`[rand]`):
-{zuteilung}
+You are assigned the following chapters and blocks — binding: every assigned section must appear, invent no additional ones. Beneath each block are its SUBBLOCKS with their level label (`[beginner]`/`[advanced]`/`[expert]`/`[peripheral]`):
+{assignment}
 
-WICHTIG — jeder Subbaustein wird mit einem Marker abgegrenzt, damit der Guide später gestuft angezeigt werden kann (Anfänger sehen nur `anfaenger`, Fortgeschrittene mehr). Das Label kommt EXAKT aus der Zuteilung. Trotz Marker schreibst du FLÜSSIG und verwoben — der Marker ist eine unsichtbare Schnittstelle, KEINE sichtbare Überschrift.
+IMPORTANT — each subblock is delimited with a marker so the guide can later be shown in stages (beginners see only `beginner`, advanced learners see more). The label comes EXACTLY from the assignment. Despite the marker, you write FLUENTLY and interwoven — the marker is an invisible interface, NOT a visible heading.
 
-Der Inhalt ist UNABHÄNGIG von der Stufe: jeder Subbaustein wird **anfängerfreundlich** erklärt, egal welches Label. Das Label sagt nur, WANN im Lernpfad der Punkt drankommt (Fundament → Feinheit) — NICHT wie kompliziert er geschrieben wird. Ein `[experte]`-Punkt wird genauso simpel erklärt wie ein `[anfaenger]`-Punkt. Kein Perfektionismus, keine künstliche Tiefe: das Wesentliche klar, so dass ein Neuling es versteht.
+The content is INDEPENDENT of the level: every subblock is explained in a **beginner-friendly** way, no matter the label. The label only says WHEN in the learning path the point comes up (foundation → finesse) — NOT how complicated it is written. An `[expert]` point is explained just as simply as a `[beginner]` point. No perfectionism, no artificial depth: the essentials made clear, so that a newcomer understands them.
 
-Jeder Baustein bekommt ZWEI Fassungen mit DENSELBEN Subbausteinen (gleiche Titel, gleiche Reihenfolge):
-- **kompakt**: je Subbaustein EIN Merksatz als Stichpunkt (`- …`). Zum Erinnern. Nur benennen, nicht erklären.
-- **ausführlich**: der zusammenhängende Anfänger-Lerntext (siehe unten).
+Each block gets TWO versions with the SAME subblocks (same titles, same order):
+- **compact**: one mnemonic per subblock as a bullet (`- …`). For recall. Only name it, don't explain.
+- **ausführlich** (detailed): the coherent beginner learning text (see below).
 
-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. Der Anker steht VOR dem ersten Subbaustein-Marker. 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 als Anker, die „Hürde"-Hinweise, um Missverständnisse vorweg auszuräumen.
-- Behandle jeden Subbaustein unter seinem Marker — flüssig formuliert, erklärender Fließtext, kein isolierter Stichpunkt-Block.
-- Reihenfolge der Subbausteine wie in der Zuteilung: erst `[anfaenger]` (Fundament), dann `[fortgeschritten]`, dann `[experte]`, zuletzt `[rand]`.
-- „Wie"-Abläufe Schritt für Schritt zeigen, nicht nur das Ergebnis.
-- KNAPP: Jeder Satz trägt neue Information. Keine Wiederholung, keine Füll- oder Meta-Sätze, keine Vorrede. Überflüssiges schadet dem Lernen — im Zweifel weglassen, nicht hinzufügen.
-- Länge folgt dem Inhalt: ein triviales Detail ein, zwei Sätze; ein komplexes Konzept so viel, wie es WIRKLICH braucht — nicht mehr. Kein „so lang wie möglich".
-- Ein Beispiel NUR, wo es das Verständnis wirklich trägt — nicht pflichtmäßig bei jedem Subbaustein.
+HOW TO WRITE the detailed version — ONE coherent text for a junior who is learning the topic anew:
+- Start with the anchor (framing): which problem / what for, tied to something familiar — only then the new material. The anchor comes BEFORE the first subblock marker. Mandatory, never omit it.
+- Resolve EVERY technical term at first mention in half a sentence. Assume nothing — not even terms from the title or other blocks. Use the "Prerequisite" hints as anchors, and the "Hurdle" hints to clear up misconceptions up front.
+- Treat each subblock under its marker — fluently phrased, explanatory prose, not an isolated bullet block.
+- Order of the subblocks as in the assignment: first `[beginner]` (foundation), then `[advanced]`, then `[expert]`, last `[peripheral]`.
+- Show "how" procedures step by step, not just the result.
+- CONCISE: every sentence carries new information. No repetition, no filler or meta sentences, no preamble. Superfluous material harms learning — when in doubt, leave it out, don't add.
+- Length follows the content: a trivial detail one or two sentences; a complex concept as much as it REALLY needs — no more. Not "as long as possible".
+- An example ONLY where it genuinely carries the understanding — not dutifully for every subblock.
 
-GEPRÜFTE INHALTE je Baustein — das ist verbindlich, was gelehrt werden muss:
-{inhalte}
+VERIFIED CONTENTS per block — this is binding, what must be taught:
+{contents}
 
-Recherchiere NICHT und suche NICHT im Web. Alle nötigen Fakten stehen in diesen geprüften Inhalten — nutze ausschließlich sie. Erfinde nichts dazu, lass nichts Wesentliches weg. Lehre simpel: kurze Sätze, Listen für Aufzählungen, ein Anfänger versteht es sofort.
+Do NOT research and do NOT search the web. All necessary facts are in these verified contents — use only them. Invent nothing, leave out nothing essential. Teach simply: short sentences, lists for enumerations, a beginner understands it at once.
 
-SECTION-SPEZIFIKATION (gilt je Baustein):
+SECTION SPECIFICATION (applies per block):
 {spec}
 
-Schreibe NUR die Datei {out_path} in GENAU diesem Format — pro Kapitel ein kapitel-Marker, pro Baustein ein section-Marker (Titel EXAKT aus der Zuteilung), darin ein `kompakt`- und ein `ausführlich`-Block. In BEIDEN Blöcken steht je Subbaustein ein `<!-- sub: LABEL | Subbaustein-Titel -->`-Marker (LABEL und Titel EXAKT aus der Zuteilung, gleiche Reihenfolge in beiden Blöcken):
+Write the entire guide content in GERMAN (the guide is for German-speaking learners), even though these instructions are in English.
 
-<!-- kapitel: Kapiteltitel -->
-<!-- section: Exakter Baustein-Titel -->
-<!-- kompakt -->
-<!-- sub: anfaenger | Exakter Subbaustein-Titel -->
-- Merksatz zu diesem Subbaustein (knapp, ohne Erklärung)
-<!-- sub: fortgeschritten | Exakter Subbaustein-Titel -->
-- Merksatz zu diesem Subbaustein
+Write ONLY the file {out_path} in EXACTLY this format — one kapitel marker per chapter, one section marker per block (title EXACTLY from the assignment), with a `compact` and an `ausführlich` block inside. In BOTH blocks, each subblock carries a `<!-- sub: LABEL | subblock title -->` marker (LABEL and title EXACTLY from the assignment, same order in both blocks):
+
+<!-- kapitel: chapter title -->
+<!-- section: exact block title -->
+<!-- compact -->
+<!-- sub: beginner | exact subblock title -->
+- mnemonic for this subblock (concise, no explanation)
+<!-- sub: advanced | exact subblock title -->
+- mnemonic for this subblock
 <!-- ausführlich -->
-Anker: Einordnung des ganzen Bausteins (welches Problem, wozu) — vor dem ersten Subbaustein.
-<!-- sub: anfaenger | Exakter Subbaustein-Titel -->
-Anfängerfreundlicher Fließtext zu diesem Subbaustein, mit kleinem Beispiel.
-<!-- sub: fortgeschritten | Exakter Subbaustein-Titel -->
-Anfängerfreundlicher Fließtext zu diesem Subbaustein.
+Anchor: framing of the whole block (which problem, what for) — before the first subblock.
+<!-- sub: beginner | exact subblock title -->
+Beginner-friendly prose for this subblock, with a small example.
+<!-- sub: advanced | exact subblock title -->
+Beginner-friendly prose for this subblock.
 
-Die Marker-Zeilen exakt so schreiben. Jede Section hat genau einen `<!-- kompakt -->`- und einen `<!-- ausführlich -->`-Block; die Subbaustein-Titel sind in beiden identisch. Kein Text außerhalb der Sections, kein Dokument-Titel, kein Inhaltsverzeichnis.
+Write the marker lines exactly like that. Each section has exactly one `<!-- compact -->` and one `<!-- ausführlich -->` block; the subblock titles are identical in both. No text outside the sections, no document title, no table of contents.
 {extra}