--- name: artefakt-arbeitsblatt description: "Generiert ein Arbeitsblatt (docx) für eine WiB-UE-Phase aus geparstem TUV + Recherche-Briefing. Niveau-differenziert (n1/n2/n3 entsprechend AFB der Teilziele). Triggert NUR aus dem artefakte-generator-Skill heraus oder explizit auf 'AB für UE Niveau '. Output: KW##_DDMMYY__AB_n.docx + entsprechendes _lsg-Lösungsblatt. Erzeugt strikt nur Schauseite (ADR 0008): keine AFB-Tags, Mager-Notation oder prozessbez.-Kompetenz-Header im SuS-Material; didaktische Annotation lebt im Lösungsblatt-Manifest (Lehrkraft-Sicht)." domain_scope: universal schema_pin: tuv_v1 phase: phase_1_mvp mode: cowork-first skill_typ: orchestrator adr_refs: [ADR_0008, ADR_0017, ADR_0023, ADR_0032] --- # Arbeitsblatt-Generator `artefakt-arbeitsblatt` (Phase-1 / Phase-3-Cowork) ## 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__AB_n.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 ```yaml tuv: niveau: n1 | n2 | n3 phase_fokus: phase_6 # Default: Phase 6 (Lösung) recherche_briefing: 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: `/KW##_DDMMYY__AB_n.docx` - Lösungsblatt: `..._AB_n_lsg.docx` - Slug: aus TUV-Dateinamen extrahieren Im Pilot Phase 1 darf zuerst Markdown-Draft (`AB_n.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).