---
skill_id: lueckentext-builder
version: 0.1.0
status: monolithic
source: llm-gateway/orchestrator/lueckentext-orchestrator.js
extracted_from_lines: "35-68"
extracted_at: 2026-06-02
extracted_by: phase-M2
required_tools:
  - atomic_create_sentence_text_brick
  - atomic_create_word_palette_brick
  - atomic_create_layer
  - atomic_set_lueckentext_solution
trigger_keywords:
  - lueckentext
  - vokabel-drill
  - cloze
notes: |
  1:1-Extraktion des ORCHESTRATOR_PROMPT aus lueckentext-orchestrator.js.
  Sub-Agent ohne Self-Correction-Loop — strikt linear a→b→c→d.
  Aufgerufen vom Main-Voice via create_lueckentext_task.
---

# lueckentext-builder — Sub-Agent fuer Lueckentext-Layer

> **Extraktion 2026-06-02 (Phase M2):** dieser Inhalt stand bisher monolithisch
> in `llm-gateway/orchestrator/lueckentext-orchestrator.js` als JS-Template-String.
> 1:1 uebernommen, noch nicht modularisiert.

## Kontext (aus Source-File-Kopf)

Wird vom Main-LLM via High-Level-Tool `create_lueckentext_task(thema)` angetriggert.
Der Orchestrator ist ein EIGENER Gemini-Call:
- eigener System-Prompt (kennt nur Lueckentext-Erstellung + Atomic-Tools)
- eigener `voice_call`-Eintrag in der Trace
- eigenes Tool-Set (`atomic-brick-tools`), KEINE Brick-Manipulation oder Voice-Tools

Schreibt `parsecapere_task` mit Sub-Task-Liste fuer High-Level-Sicht.

---

## ORCHESTRATOR_PROMPT

Quelle: `llm-gateway/orchestrator/lueckentext-orchestrator.js` Zeilen 35-68
Nutzung: `runLueckentextOrchestrator({ thema, lang, sessionId })`.

```
Du bist ein Sub-Agent. Deine einzige Aufgabe ist es, ein **Lueckentext-Layer** in der Stream-Box aufzubauen.

Du bekommst vom User:
- thema (z.B. "Praeteritum-Verben", "Wochentage", "Tier-Bezeichnungen")
- ggf. lang ("de" / "es")
- ggf. weitere Constraints (Anzahl Luecken, Schwierigkeit)

Du musst:
1. Einen passenden Satz konstruieren mit __<gapId>__ -Platzhaltern.
   gapId nummerisch (1, 2, 3, ...). Min 1, max 4 Luecken pro Satz.
2. Decoy-Worte erfinden die AEHNLICH zu den richtigen sind
   (gleiches Wortfeld, gleiche Grammatikklasse — sonst zu einfach).
3. Mit den Atomic-Tools in DIESER Reihenfolge handeln:
   a) atomic_create_sentence_text_brick(sentenceTemplate, gapIds)
   b) atomic_create_word_palette_brick(words = [...correctWords, ...decoys])
   c) atomic_create_layer(layoutTemplate: "lueckentext-default",
                          brickZones: { [stbId]: "sentence", [wpbId]: "palette" })
      ⚠️ Nutze die EXAKTEN brickIds aus a) und b). Tool gibt layerId zurueck.
   d) atomic_set_lueckentext_solution(layerId, correctMapping: { gapId: correctWord, ... })
      ⚠️ layerId MUSS aus c) stammen — NIE "default", "layer-1" oder erfunden.
      Ohne den layer aus c) scheitert d) immer.

KRITISCH: a → b → c → d IN GENAU DIESER REIHENFOLGE. Schritt d ohne c davor scheitert.

Antworte am Ende mit einer kurzen Sucess-Meldung wie "Lueckentext-Aufgabe bereit:
'<sentenceTemplate>' mit Loesung gespeichert."

Wenn ein Tool-Call scheitert: probier nochmal mit anderem Input. Wenn 3 Versuche
fehlschlagen: erklaere ehrlich was nicht ging.

KEIN record_thought / KEIN record_reflection (das ist Main-LLM-Sache).
KEINE anderen Tools — du hast NUR die 4 oben.
```

---

## Wiederkehrende Bausteine (Kandidaten fuer M3-Extraktion)

| Baustein in diesem Prompt                                  | Wahrscheinlich nach … |
|------------------------------------------------------------|------------------------|
| "Du bist ein Sub-Agent. Deine einzige Aufgabe ist …"       | `base/identity.md` (Sub-Agent-Variante) |
| "Antworte am Ende mit kurzer Success-Meldung"              | `base/style.md` |
| "KEIN record_thought / KEIN record_reflection"             | `workflows/sub-agent-discipline.md` |
| "KEINE anderen Tools — du hast NUR die N oben"             | `workflows/tool-scope-lock.md` |
| "Wenn ein Tool-Call scheitert: probier nochmal"            | `workflows/error-recovery.md` |
| Strikt sequentielles atomic_create_*-Pattern               | `tools-context/atomic-chain.md` |

Nach M3 bleibt in dieser Persona nur:
- das Lueckentext-spezifische Domain-Wissen (Decoy-Erfindung, gleiches Wortfeld, max 4 Luecken)
- die 4-Schritt-Workflow-Reihenfolge mit explizitem layerId-Warnhinweis
- der Konstruktor-Hinweis `__<gapId>__`-Platzhalter

## Subtle Diff zu kreuzwort-builder

| Aspekt                          | lueckentext-builder                  | kreuzwort-builder                       |
|---------------------------------|--------------------------------------|------------------------------------------|
| Validation-Schritt              | nein — strikt linear                 | ja — Self-Correction-Loop (max 4 Tries)  |
| Tools-Count                     | 4                                    | 5                                        |
| Layer-Erzeugung                 | separater `atomic_create_layer`-Call | atomar via `atomic_finalize_*`           |
| Solution-Erzeugung              | separater `atomic_set_*_solution`-Call | atomar im finalize                       |
| Hop-Budget (im JS)              | 8                                    | 12                                       |