artefakt-arbeitsblatt

AB-Konzept-Pre-Read-Pflicht (R57-Iteration Track-Q Phase-3)

Pflicht-Pre-Bedingung: AB-Konzept-File <sequenz>/<ue>/ab_konzept.yaml (Schema ab_konzept_v1.json v1.0.0) MUSS vor AB-Generation existieren mit:

• ab_typ aus 5-Typ-Enum (identifikationsfigur/schaubild/quellenanalyse/textbasiert/tabellen)
• bilder_pflicht_severity Auto-Derived (BLOCK vs WARN)
• ue_phasen_anker[] Cross-Reference zu TUV-Phasen
• niveau_pool[] (mind. 1 aus n1/n2/n3)

Template-Pre-Read pro ab_typ: templates/ab_typen/<ab_typ>.md als Layout-Vorlage.

BLOCK-Severity-Konsequenz: Bei bilder_pflicht_severity=BLOCK und 0 medien_anker[] im Material_Geruest → AB-Generation BLOCKED bis Material_Geruest erweitert wird.

Cross-Reference Track-V Acceptance-Kriterium-7: Medien-Anker-Fallback-Hierarchie wird im AB-Output reflektiert.

Arbeitsblatt-Generator artefakt-arbeitsblatt (Phase-1 / Phase-3-Cowork)

Schritt 0: Hybrid-Adapter-Check (Track-Δ-Migration)

Pre-Render-Check (vor allen anderen Schritten):

1. Falls <sequenz>/<ue>/didactic_entwurf_v1.json existiert → Track-Δ-Pfad:

   • Dispatch: python3 -m core.lib.material_compiler.parser <path> → Parser-Output (DidacticEntwurfModel)
   • Dispatch: compose_paper_plan(model, niveau=<n>) → CompositionPlan
   • K4a-Confirmation: render_k4a_preview(plan) → Markdown-Tabelle im Chat → Lehrkraft-Approve
   • Dispatch: render_paper(model, output_root, kw, when, slug) → 6 docx-Files (n1+n2+n3 × AB+LSG)
   • K4b-Final-Approve: atomic-rename in Final-Output-Folder

2. Falls nur Legacy-TUV.md existiert → Legacy-Pfad (existing lib/layout.py):

   • Bestehender Render-Pfad unverändert.

3. Falls beide existieren → Track-Δ-Pfad bevorzugen. Legacy-Pfad als Fallback bei FAIL.

→ Bei erfolgreichem Track-Δ-Pfad: ENDE des SKILLs (Workflow §1-8 SKIP). → Nur bei Track-Δ-FAIL ODER fehlendem didactic_entwurf_v1.json: weiter mit Workflow §1-8 (Legacy-Pfad).

F1-Style Error-Handling (Track-Δ-Pfad):

• FAIL (exit 1): Schema-Validate-Fehler, Pydantic-Validation-Error, Renderer-Crash → Fallback Legacy-Workflow §1-8
• ABSTAIN (exit 2): didactic_entwurf_v1.json fehlt oder ist leer → Legacy-Workflow §1-8
• PASS (exit 0): 6 docx-Files erzeugt + _manifest.md → ENDE
• Retry-Limit: Bei FAIL maximal 1 Re-Try (Track-Δ-Pfad) bevor Legacy-Fallback greift

Trigger-Phrase unverändert: Lehrkraft sagt weiterhin "AB für UE " — sie merkt die Migration nicht.

(Track-Δ ADR_0081 proposed. Δ-5 Empirie-Pilot validiert vor Schema-Lock.)

Reasoning-Anleitung (Cowork-Mode, ADR 0032 Phase-3)

Pipeline-Skill: orchestriert atomare Skills für AB-Generation. Im Cowork-Mode ruft Claude die Atomar-Skills direkt + persistiert Output ins Project.

Eingabe: TUV-Pfad + Niveau (n1/n2/n3) + Modus (alltag/lehrprobe/buv).

Reasoning-Schritte:

1. Pflicht-Kontext laden (siehe unten)
2. Pre-Flight: phase-prerequisites-check-Skill für Phase=ARTEFAKT-AB
3. Recherche-Briefing laden (_recherche.yaml neben TUV)
4. Pro Teilziel-Niveau-Match:
   • methode_mapping.resolve_methode → format-Hint + bewertungs_pattern
   • aufgabe.formulieren → LLM-Aufgabe + Erwartungshorizont (Cowork: Claude reasont selbst)
   • mager.konjugieren → S-Perspektive auf aufgabe.text
5. Layout rendern: lib/layout.py:render_ab mit AbSchauseite-Datenmodell
6. Lösungsblatt mit Erwartungshorizont pro Aufgabe (nicht konstant pro UE)
7. Pre-Commit-Audit: cowork.audit_pre_commit (Phase-3e)
8. Persist: KW##_DDMMYY_<slug>_AB_n<i>.docx + _lsg.docx

Output: persistierte Files + Manifest mit Provenance-Trail

Anti-Pattern:

• AFB-Tags / Mager-Notation im AB-Schauseite (ADR 0008-Verstoß)
• Lösungsblatt-Erwartungshorizont konstant statt pro Aufgabe
• Differenzierungs-Marker fehlt (DaZ/LRS für n1, Leistungsstark für n3)
• 60a-Footer fehlt

Du erzeugst ein niveau-differenziertes Arbeitsblatt für eine WiB-UE.

Pflicht-Kontextdateien (READ FIRST)

1. Das geparste TUV (vom Orchestrator übergeben)
2. _recherche.yaml neben dem TUV
3. core/config/operatoren.yaml
4. core/config/niveaustufen.json
5. specs/04-niveaustufen-deskriptoren.md (5-Achsen-Heuristik kanonisch)
6. specs/02-artefakt-typen-matrix.md (Phase × Artefakt-Mapping)
7. Gold-Standard-Referenz für Pilot-UE: samples/gold-standard/KW18_Kinderarbeit/AB_n*.md (sofern vorhanden)

Eingabeparameter

tuv: <Pfad zum TUV>
niveau: n1 | n2 | n3
phase_fokus: phase_6                  # Default: Phase 6 (Lösung)
recherche_briefing: <Pfad>
modus: alltag | lehrprobe | buv

Workflow

1. Niveau-Konfig laden

Aus niveaustufen.json für gegebenes Niveau:

• AFB-Pool
• Operatoren-Pool (über operatoren_pool → operatoren.yaml)
• Satzlängen-Limit
• Hilfen-Liste
• Antwortformate
• Bildanteil-Minimum

2. Lernziele auf Niveau zuschneiden

Aus den Teilzielen des TUV das Teilziel mit passendem AFB wählen:

• n1 → Teilziel mit AFB I (oder Stundenziel auf AFB I reduziert)
• n2 → Teilziel mit AFB II
• n3 → Teilziel mit AFB III (oder II–III)

Lernzielzeile im AB-Kopf im Mager-Schema:

Du {Operator} {Inhalt}, indem du {Methode}, was daran erkennbar wird, dass {Indikator}.

3. Aufgaben konstruieren

Pro AB 3–5 Aufgaben, abgestimmt auf:

• Phasen-Fokus (Default: Phase 6 Lösung; bei Override: passende Phase)
• AFB-Pool des Niveaus
• Prozessbezogene Kompetenz (Operator-Präferenz aus operatoren.yaml)
• Material aus Recherche-Briefing einbinden (Bilder, Textauszüge)

Aufgabenformate je Niveau:

• n1: MC, Lückentext, Zuordnung, Verbinden, Markieren, Kurzantwort
• n2: strukturierte Freiformulierung, Tabelle, kurze Begründung, Fall-Analyse
• n3: Freitext, Argumentation, Stellungnahme, Entwurf, Problemlösung

Pflicht: mindestens eine Aufgabe, die die deklarierte prozessbezogene Kompetenz konkret anwendet (Beurteilen → Wertungs-/Begründungspflicht; Analysieren → Strukturierung; Handeln → Entscheidung; Kommunizieren → Sprach-/Adressatenformat).

4. Differenzierungs-Hilfen integrieren

Aus TUV-Differenzierungs-Tabelle die für Niveau passenden Maßnahmen übernehmen:

• DaZ → Wortspeicher als Tabelle/Liste am AB-Kopf (für n1) oder als optionale Hilfe (n2)
• LRS → Vorlese-Hinweis, Tandempartner-Option
• Leistungsstarke → Zusatzaufgabe mit Sternchen-Markierung (für n3 ohnehin Niveau)

Maßnahmen wortgleich aus TUV übernehmen, nicht umformulieren.

5. AB-Kopf

• Klasse, Datum, Stunde
• Name-Feld
• Stundenfrage (aus thema)
• Lernzielzeile (Mager)
• Bei n1: Wortspeicher mit ≥ 5 Schlüsselbegriffen

6. AB-Footer

• Lehrplan-Bezug: Wortlaut Kompetenzerwartung + IK
• Quellen mit Attribution (aus Recherche-Briefing)
• Querverbindung zu anderen Fächern (falls im TUV deklariert)
• § 60a UrhG-Footer (aus lib/lizenz.get_60a_footer())
• Plugin-Version, Erstell-Datum

7. Lösungsblatt

Separat als _lsg-Suffix-Datei. Pro Aufgabe:

• Erwartungshorizont aus dem Indikator-Teil des Lernziels
• Akzeptierte Variationen
• Mögliche Schüler-Verwechslungen (für Lehrkraft-Hinweis)
• Bewertungs-Hinweis (was reicht zur Erfüllung des Niveauziels?)

8. Datei schreiben

• Format: docx
• Pfad: <UE-Verzeichnis>/KW##_DDMMYY_<Slug>_AB_n<i>.docx
• Lösungsblatt: ..._AB_n<i>_lsg.docx
• Slug: aus TUV-Dateinamen extrahieren

Im Pilot Phase 1 darf zuerst Markdown-Draft (AB_n<i>.md) geschrieben werden, docx-Konversion folgt mit docx-Skill.

Validierung vor Auslieferung

• Alle verwendeten Aufgabenoperatoren ∈ AFB-Pool des Niveaus.
• Mittlere Satzlänge ≤ Deskriptor-Grenze.
• Mindestens eine Aufgabe für deklarierte prozessbez. Kompetenz.
• Mager-Schema im AB-Kopf vollständig.
• Mindestens ein Bild oder Visual aus Recherche eingebunden (außer n3 darf textdominiert sein).
• § 60a-Footer vorhanden.

Pilot-Anforderung

Output für KW18 Kinderarbeit muss mindestens das Niveau des Gold-Standard erreichen (samples/gold-standard/KW18_Kinderarbeit/AB_n*.md). Plugin-Output und Gold-Standard werden manuell verglichen (Reviewer-Pässe ab Phase 4 Plugin-Roadmap).

Anti-Patterns

• Erfinde keine Lerninhalte, die nicht im TUV oder Recherche-Briefing stehen.
• Nimm Operatoren nicht aus dem falschen AFB-Pool (n1 darf kein „beurteile").
• Übernimm keine bestehenden, qualitativ unzureichenden AB-Materialien als Vorlage (siehe Memory feedback_material_qualitaet.md).
• Schreibe keine reinen Lückentexte für n3 (Niveau-Misfit).