3.5 KiB
Write ONE section of a learning guide on the topic "{topic}" (format: {format_name}) — the block below, nothing else.
CHAPTER: {chapter}
BLOCK with its SUBBLOCKS and level labels ([beginner]/[advanced]/[expert]/[peripheral]):
{assignment}
LEARNING OBJECTIVES — after reading, a beginner must be able to do exactly this (a coverage gate checks the text against these objectives): {ziele}
VERIFIED FACTS per subblock — binding basis. Quote cited facts (FACT[Source]) VERBATIM, invent nothing extra, do NOT re-research (a fact gate checks every claim against this list): {facts} {examples} {gaps} IMPORTANT — each subblock is delimited with a marker so the guide can later be shown in stages. 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.
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.
The 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.
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 — BEFORE the first subblock marker. Mandatory.
- Resolve EVERY technical term at first mention in half a sentence. Use "Prerequisite" hints as anchors, "Hurdle" hints to clear misconceptions up front.
- Order of the subblocks as in the assignment: first
[beginner], then[advanced], then[expert], last[peripheral]. - The NUMBER of subblocks is the depth signal: many subblocks → the block deserves length; few → keep it short. Never pad.
- LENGTH TARGET for the detailed version: about {budget} characters total (guideline, not a hard limit — covering ALL learning objectives always beats brevity). Unguided sections came out 2–4× too long and had to be rewritten.
- CONCISE: every sentence carries new information. No repetition, no filler, no preamble. When in doubt, leave it out.
- Show "how" procedures step by step. An example ONLY where it genuinely carries the understanding.
- If VERIFIED WORKED EXAMPLES are provided above, weave each into its subblock as instructed there; do NOT invent additional worked examples for subblocks that already have one.
SECTION SPECIFICATION: {spec}
Write the entire guide content in GERMAN (the guide is for German-speaking learners), even though these instructions are in English.
Write ONLY the file {out_path} in EXACTLY this format — one kapitel marker, one section marker (title EXACTLY as in the assignment), a compact and an ausführlich block, each subblock with its <!-- sub: LABEL | subblock title --> marker (LABEL and title EXACTLY from the assignment, same order in both blocks):
- mnemonic for this subblock (concise, no explanation)
Anchor: framing of the whole block — before the first subblock.
Beginner-friendly prose for this subblock.
No text outside the section, no document title, no table of contents. {extra}