---
skill_id: lueckentext-builder
version: 0.1.0
description: Sub-Agent fuer Lueckentext-Layer-Aufbau (strikt linear, kein Self-Correction).
activation: keyword
trigger_keywords:
  - lueckentext
  - lueckentexte
  - vokabel-drill
  - cloze

persona: personas/lueckentext-builder

required_prompt_modules:
  # base/ — immer dabei
  - base/identity
  - base/style
  - base/constraints
  # workflows/ — Sub-Agent-spezifisch
  - workflows/sub-agent-discipline   # KEIN record_*, keine Voice-Tools
  - workflows/tool-scope-lock        # nur die 4 unten erlaubt
  - workflows/error-recovery         # max 3 Versuche pro Tool (unstrukturierte Fehler)
  # tools-context/ — atomic-chain statt atomic-finalize
  - tools-context/atomic-chain
  # persona zuletzt
  - personas/lueckentext-builder

required_tools:
  - atomic_create_sentence_text_brick
  - atomic_create_word_palette_brick
  - atomic_create_layer
  - atomic_set_lueckentext_solution

max_tokens_estimate: 1300
hop_budget: 8

source_orchestrator: llm-gateway/orchestrator/lueckentext-orchestrator.js
spawned_by_tool: create_lueckentext_task (Main-Voice)
---

# Skill: lueckentext-builder

Sub-Agent der vom Main-LLM via `create_lueckentext_task({thema, lang})` gespawned wird.

## Workflow auf einen Blick

```
a) atomic_create_sentence_text_brick(sentenceTemplate, gapIds)   → stbId
b) atomic_create_word_palette_brick(words)                       → wpbId
c) atomic_create_layer({ layoutTemplate, brickZones })           → layerId
d) atomic_set_lueckentext_solution(layerId, correctMapping)
```

Details: `personas/lueckentext-builder` + `tools-context/atomic-chain`.

## Subtle Diff zum kreuzwort-builder

| Aspekt                | lueckentext-builder        | kreuzwort-builder              |
|-----------------------|----------------------------|--------------------------------|
| Validation-Schritt    | nein — strikt linear       | ja — Self-Correction-Loop      |
| Atomic-Pattern        | `atomic-chain` (a→b→c→d)   | `atomic-finalize` (atomar)     |
| Recovery-Workflow     | `error-recovery` (3 Tries) | `self-correction` (4 Validates)|
| Hop-Budget            | 8                          | 12                             |
| Tool-Count            | 4                          | 5                              |

## Erfolgsmeldung

```
"Lueckentext-Aufgabe bereit: '<sentenceTemplate>' mit Loesung gespeichert."
```

## Was bewusst NICHT im Tool-Set ist

- Alle Voice-Tools (Main-Voice-Sache).
- `record_thought` / `record_reflection` (Main-LLM-Sache, Trace-Layer macht den Rest).
- Brick-Loesch-Tools — Orphan-Cleanup macht der Orchestrator-Wrapper
  (`cleanupOrphanLueckentextBricks()` vor jedem Run), nicht der Sub-Agent selber.

## Migrations-Hinweis

Wenn das Backend kuenftig ein `atomic_finalize_lueckentext_layer`-Tool bekommt
(All-in-One Layer + Solution), kann dieser Skill auf das `atomic-finalize`-
Pattern umgestellt werden — siehe Vergleich in `tools-context/atomic-chain.md`.
Heute (2026-06-02) gibt's das Tool noch nicht.