Developer Tool Workflows

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: KWDDMMYY ABn .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).

Recherche-Coordinator. Liest TUV, ruft aktive Quellen-Adapter über source-registry.yaml, aggregiert über lib/briefing.py, schreibt recherche.yaml. Triggert NUR aus dem artefakte-generator-Skill heraus oder explizit auf User-Anfrage 'Recherche für UE '. Phase 1: Adapter wikimedia + wikipedia aktiv. Spätere Phasen erweitern um berufenet, gesetze, bpb, statistischesbundesamt, ilo, pixabay etc.

Top-Level-Orchestrator für die Erzeugung unterrichtsreifer Artefakte (AB, PPP, Tafelbild, Plakat, Diagnose) aus einem TUV. IMMER triggern bei: 'Artefakte für UE ', 'Material für KW', 'erzeuge AB für', 'Plugin-Output für TUV', explizite Erwähnung des Plugins. Setzt Vertragsfeld-Treue zum TUV-Format gemäß tuvv1.json voraus (ADR 0007 + ADR 0019). NICHT triggern bei reiner TUV-Planung ohne Material-Bedarf, bei Lehrproben-Vollausarbeitungen ohne Plugin-Bezug.

Phase-2/3-Skill (T-30-1b) für Aufgaben-Formulierung aus Mager-Quartett. Eingabe: Teilziel (Operator+Inhalt+Bedingung+Indikator) + Niveau (n1/n2/n3) + AFB-Stufe + optional Recherche-Kontext + optional TUV-Phase-6-Methode. Ausgabe: niveau-konforme, mager-konjugierte SuS-Aufgabe mit Aufgabentext + Erwartungshorizont + Operator-Konformitäts-Check. Cowork-Mode (Default): Claude reasont via diesem Skill. CLI-Mode: nutzt from llm import complete (ADR 0031). Triggert auf 'Aufgabe formulieren für Lernziel Niveau ' / 'Plane Aufgabe zu Lernziel ' / aus Pipeline-Skills wie material.generieren.

[DEPRECATED-VAULT-FILTER] Phase-3-Bildungstheorie-Audit-Skill (Track-β-4-2, Bridge-Pair 5aa66198 D-011) fuer Adorno-Audits ueber Zettelkasten-Vault mit 5-Schicht-Read-Pattern. Trigger: 'Adorno-Audit fuer Sequenz X', 'Halbbildung-Check', 'Anti-Barbarei-Anker', 'Verdinglichungs-Filter fuer UE'. Eingabe: Audit-Kandidat (sequenzthema oder Konzept). Pflicht-Pre-Read: pflichttagsetv1.yaml[adorno] + vaultindexv1.yaml. Output: auditadornov1.yaml mit relevancescore + filterdimensionen (Halbbildung/Muendigkeit-Anti-Barbarei/Kritische-Reflexion/Verdinglichung/Aufklaerung-Dialektik/Subjekt-Objekt-Vermittlung). Pattern-Wiederverwendung von β-4-1 (D-011.2).

[DEPRECATED-VAULT-FILTER] Phase-3-Bildungstheorie-Audit-Skill (Track-β-4-4, D-011) fuer Foucault-Audits ueber Zettelkasten-Vault mit 5-Schicht-Read-Pattern. Trigger: 'Foucault-Audit fuer Sequenz X', 'Disziplinar-Macht-Check', 'Diskurs-Analyse-Anker', 'Subjekt-Konstitution fuer UE'. Eingabe: Audit-Kandidat. Output: auditfoucaultv1.yaml mit filterdimensionen (Disziplinar-Macht/Diskurs-Analyse/Subjekt-Konstitution/Macht-Wissen/Marginalisierte-Stimmen/Gouvernementalitaet). Pattern-Wiederverwendung von β-4-1 (D-011.2).

[DEPRECATED-VAULT-FILTER] Phase-3-Bildungstheorie-Audit-Skill (Track-β-4-3, D-011) fuer Freire-Audits ueber Zettelkasten-Vault mit 5-Schicht-Read-Pattern. Trigger: 'Freire-Audit fuer Sequenz X', 'Banking-vs-Problemposing-Check', 'Befreiungs-Anker', 'Praxis-Theorie-Zyklus fuer UE'. Eingabe: Audit-Kandidat. Output: auditfreirev1.yaml mit filterdimensionen (Banking-vs-Problemposing/Schueler-Subjekt/Praxis-Theorie-Praxis/Befreiung-Emanzipation/Dialogizitaet/Kritisches-Bewusstsein). Pattern-Wiederverwendung von β-4-1 (D-011.2).

Phase-3.6-Pipeline-Skill (T-35-A6, ADR 0034) für Sequenz-Bootstrap aus Lehrplan-Verankerung im Cowork-Mode. Trigger (dual-mode): userdirekt 'Erstelle Sequenz-Initial für GPG7c LB3 Industrialisierung 6 UEs', 'Bootstrappe Sequenz für M7c LB2 Bruchrechnen 8 UEs', 'Plane Initial-Sequenz GPG7c LB4 Reichsgründung 5 UEs'; vollautomatisch aus cowork.setupunterrichtsplanung bei neuem Fach+Lernbereich. Eingabe: fach + lernbereich + ueanzahl (+ optional afbprogression / identifikationsfiguranchor). Output: / / / / /sequenzstub.yaml (Phase 1) bzw. sequenz.yaml (Phase 3 Voll-Mode) per ADR0061 Lehrkraft-Project-Folder-Konvention + ADR0063 Per-Sequenz-Granularitaet. Pilot-Daten in core/fach/projectskeletonsklassen/ sind Skeleton-Templates, nicht der produktive Output-Pfad. Komposition: substanzrecherche-Konsumption (HARD-CONSTRAINT pre-Phase-3) + lehrplan-load + identifikationsfigur.generierepool + cowork.auditprecommit. Lehrkraft-Bestätigung Pflicht vor Persist.

Phase-3-Pipeline-Skill (T-31-3, ADR 0034) für Material-Generation zu existierender UE im Cowork-Mode. Trigger: 'Erzeuge AB für KW', 'Generiere Material zur UE', 'AB / Lösungsblatt / PPP', 'Material-Set für Stunde', 'Plugin-Output'. Eingabe: TUV-Pfad (v2.1 mit erwartungshorizont) ODER Sequenz-Stand-Verweis + MaterialGeruest (Track-AC-Output). Output: AB n1+n2+n3 + Lösungsblätter (= Erwartungshorizont-Visualisierung, ADR0040 + ADR0052) + PPP + Tafelbild + manifest.md. Komposition: artefakte-generator (Phase-1-Orchestrator) + cowork.bdhookp23material (R57 Track-C Phase-3) + cowork.auditprecommit. Persistierung erst nach Lehrkraft-Bestätigung. NICHT-Trigger: Kein reines AB-Single-Output (das ist artefakt-arbeitsblatt); kein UE-Authoring/Planning (das ist upstream Sequenz-/UE-Planungs-Skills).

Phase-3-Pipeline-Skill (T-31-1, ADR 0034) für End-to-End-UE-Planung im Cowork-Mode. Trigger (vorausschauend, NIE für bereits gehaltene Stunden): 'Plane mir die nächste Stunde', 'Plane KW Thema X', 'Plane UE für', 'Plane GPG7c-Stunde', 'Plane WiB7c-Stunde', 'Bereite UE vor'. NICHT triggern bei retrospektiven Dokumentations-Anfragen oder examinations-relevanten Vollausarbeitungen — siehe alternative Pipelines (dokumentiere / entwerfe). Eingabe: Lehrkraft-Anweisung mit Klassen-/Themen-Bezug. Output: TUV-File (KWDDMMYY TUV.md) im Project + Sequenz-Plan-Update + Memory-Update. Komposition: methodemapping + aufgabe.formulieren + mager.konjugieren + lizenz.pruefen + cowork.auditprecommit. Persistierung erst nach Lehrkraft-Bestätigung.

Pipeline-Skill (Track-α-2-Folge-5, ADR0075) fuer strukturfunktionale Qualifizierung des Recherche-Asset-Pools nach Substanz-Recherche. Trigger: 'Qualifiziere Assets fuer Sequenz ', 'Qualifiziere Asset-Index '. Eingabe: /assetindex.yaml (assetindexv1, ADR0069). Output: /assetqualifikation.yaml (assetqualifikationv1, proposed). 5-Stages-Pipeline (Dedupe + Embedder + Clusterer + Role-Classifier + Person-Detector). Liefert Topoi-Cluster (funktional aequivalente Bilder) + Unicorns (ikonische Einzelwerke) + didaktischerolle pro Asset (anker/topos-vertreter/austauschbar/unicorn-leitplanke/differenzierungs-pool/personen-anker). Empfohlen post cowork.recherchieresubstanz / pre cowork.erstellesequenzinitial. NICHT triggern fuer Pre-TUV-Briefing (separater Skill cowork.recherchierebriefing). Modular erweiterbar via QualifierStage-ABC.

Setup-Skill für Lehrkraft-Cowork-Project-Initialisierung (Phase-3.6.D'' E.5-Refactor 2026-04-28). PFLICHT-TRIGGER-PATTERN: 'hilf mir beim planen meines schuljahres' (Pflicht-Match-Pattern für Setup-Aktivierung gemäß User-Empirie Round 47). Synonyme erweitert: 'Schuljahres-Setup', 'neues Schuljahr starten', 'Plugin einrichten', 'Onboarding starten', 'Lehrkraft-Setup', 'Setup unterrichtsplanung'. Führt durch 5-Schritt-Reflective-Listening-Pattern PRO LEVEL (Level 1 Allgemeinsituation 1× / Level 2 Kurs-Profil N× iterativ / Level 3 Kursplanung on-demand via separate Skills). Output: persistierte lehrkraftprojectinstructions.md + memory/lehrkraftprofil.md + Project-Folder-Struktur Schriftwesen-Format. Idempotent — bei existing-Setup wird Pflege-Modus aktiviert. Pre-Setup-Cleanup für AVV-Residuals aus v0.1.0-v0.1.2 (Step 0 NEU).

Phase-3-Kritiker-Cluster-Dispatcher (Track-γ-2, ADR0065 D-γ-3). Dispatcht Bildungstheoretiker-Kritiker-Subagents (Klafki/Adorno/Freire/Foucault fixed + N high-need-on-demand) auf eine Sequenz-Setzung (Sequenz-Stub). Trigger: 'Kritiker-Audit fuer Sequenz ', 'Bildungstheoretiker-Audit fuer Sequenz X', 'Dispatch Kritiker-Pool'. Eingabe: sequenzstub.yaml + substanzrecherche.yaml. Output: 4 Subagent-Outputs sequenzaudit .yaml. Konsumiert von cowork.k6kaggregator + cowork.konkretisieresequenz.

Pipeline-Skill (Track-α-Y, Layer-9 Calendar-Sync) für RFC 5545 ICS-Generation aus Schulkalender + TUV-Files. Trigger: 'Aktualisiere Kalender', 'Synchronisiere ICS', 'Generiere Unterrichtsplan-ICS', 'Calendar-Sync für ', 'ICS-File für '. Eingabe: schulkalenderref + klasse + optional tuvfiles. Output: / / /unterrichtsplan .ics. Komposition: Schulkalender-Load + TUV-Files-Discovery + Stundenplan-Match + ICS-Writer-Aufruf + Validator-Pass + Auto-Hook in cowork.auditprecommit. NICHT triggern für TUV-Erstellung selbst (siehe cowork.planenaechstestunde) oder Schulkalender-Erstellung (siehe cowork.erstelleschulkalender).

CREATE-Skill für neue Personen-Stammbäume beim UE-Bootstrap. Phase-3.6 (T-35-A7-1). Triggert: 'Generiere Personen-Stammbaum', 'Erstelle Familien-Bogen', 'Lege Personen-Set an', 'Bootstrappe Narrativ-Anker neu'. Verb-Anker GENERATE/ERSTELLE/BOOTSTRAP. Aufrufer: cowork.erstellesequenzinitial.

VALIDATE-Skill für Konsistenz-Audits zwischen TUV-Frontmatter und Stammbaum-File. Phase-3.6 (T-35-A7-2). Triggert: 'Prüfe TUV-Kongruenz', 'Audit-Check Pre-Persist', 'Konsistenz-Test 3-Ebenen-Verzahnung'. Verb-Anker VALIDATE/PRÜFE. Aufrufer: cowork.auditprecommit.

MVP-Skill für Lizenz-Klassifikation. Eingabe: URL oder Bild-Metadaten + lizenz-String aus Adapter; Ausgabe: lizenzklasse (frei|cc-by|cc-by-sa|nichtzugelassen) + Attribution-String + ggf. § 60a-Footer-Marker. Triggert aus recherche.bilder oder artefakte-generator. Whitelist via core/config/lizenzquellen.json. Wikimedia-Lizenz-Strings werden gegen MIT/CC-By/CC0/CC-By-SA-Heuristik gematcht.

Phase-2-Skill (T-30-2) für Mager-Konjugation: TUV-L-Perspektive ('Die SuS benennen drei Merkmale, indem sie...') → AB-S-Perspektive ('Du benennst drei Merkmale, indem du...'). Hybrid-Ansatz: deterministische Regel-Logik mit kuratiertem Operator-Pool-Verb-Table (46 Operatoren aus afbI/II/III) + Subjekt-Pronomen-Rewrite + Trennverb-Handling. LLM-Fallback (from llm import complete, ADR 0031) für unbekannte Verben oder komplexe Satz-Strukturen. Triggert aus aufgabe.formulieren oder explizit 'Mager konjugieren '. Ersetzt L-Perspektive im AB-Output (Schauseite, ADR 0008) — Lösungsblatt-Manifest behält L-Perspektive für Lehrkraft-Sicht.

Phase-2-Skill (T-30-5) für TUV-Phase-6-Methode → Aufgaben-Type-Mapping. Eingabe: free-form Methodenname (z. B. 'Quellenanalyse', 'Fallbewertung', 'Tabellen-Vergleich') + Niveau (n1/n2/n3) + optional erwartete Mindest-Argumente/Quellen/etc. Ausgabe: methodeklasse (analyse/bewertung/ordnung/recherche/handeln/kommunikation) + recommendedformate (gegen niveaustufen.json gefiltert) + Bewertungs-Pattern-Template. Universal-Schicht über fach-spezifische Methoden-Kataloge (core/fach/ /methoden.yaml). Triggert aus aufgabe.formulieren (T-30-1b) zur Antwortformat-Vorauswahl ODER aus generate.py (T-30-7) für bewertungshinweis()-Generation. Ersetzt String-Match-Heuristik in bauelsgaufgaben (generate.py:264-298).

Pre-Flight-Skill für TUV-Phase-Start (ADR 0028). Triggert vor Phase KONZEPT/SEQUENZ/STUNDE/ARTEFAKT-/FINALISIERT um External-Dependencies (MCPs, CLI-Tools, Python-Packages) zu validieren. Bei PFLICHT-FAIL: Phase BLOCKIERT mit Install-Anweisungen. Bei EMPFOHLEN-WARN: DEGRADED-DATA-Modus aktiviert + WebFetch-Fallback-Hinweis. Override via meta.mcpoverridereason.

MVP-Skill für Bildrecherche aus aktiven Bild-Adaptern (Phase-1: wikimedia). Liest Suchbegriff + lizenz-Whitelist aus Kontext, ruft Adapter, prüft Lizenz via lizenz.pruefen-Skill, cached lokal in core/.cache/bilder/. Triggert NUR aus artefakte-generator oder explizit 'Bildersuche für '. Output: Liste von BildEntry mit lokalem Cache-Pfad + Attribution + Lizenz-Klasse. Phase-2 erweitert um pixabay/pexels/mebis.

Skill-Modul für 5-Achsen-Heuristik-Check (read-only, kein Text-Edit). Eingabe: Text + Ziel-Niveau; Ausgabe: Score je Achse + Pass/Fail-Ampel. Aufruf aus Hook postrenderniveaucheck oder Audit-Subagent. NICHT inline in Hook (ADR 0023): Skill-Modul-Trennung erlaubt eigene Tests + Re-Use.

MVP-Skill für Sprachniveau-Anpassung von Texten. Eingabe: Text + Ziel-Niveau (n1/n2/n3) + AFB-Stufe; Ausgabe: niveau-konformer Text mit dokumentierten Eingriffen. Nutzt 5-Achsen-Heuristik (R7) als Klasse-2-Pattern aus escape-game-generator (ADR 0026): Wortlänge, Satzlänge, Fachbegriff-Dichte, Subordinations-Tiefe, Operator-Klarheit. Triggert aus artefakt-arbeitsblatt oder explizit 'Niveau anpassen für '.