lehrplan

Lehrplan-Skill

Reverse-engineered aus dem GRG-PMM-Unterrichtsrepo (HTL Spengergasse). Dieser Skill ist konventionsbasiert, nicht auf ein Projekt verdrahtet: Er funktioniert in jedem Unterrichtsrepo, das der unten beschriebenen lehrplan/-Konvention folgt.

Der Skill hat drei Kernaufgaben plus ein identifizierendes Präludium:

Aufgabe	Zweck
A — Gegenstand & Ausbildungszweig identifizieren	Immer aktives Präludium: Repo lesen, Rechtsgrundlage berichten, Konformität prüfen
1 — Gesetzesmaterial beschaffen	Gesetzlichen Lehrplan eines Ausbildungszweigs aus dem RIS holen, Novellen-Check
2 — Fach-Extraktion	Lehrplan eines Gegenstands aus dem Gesetz extrahieren, mit Erläuterungen
3 — Semesterplan	Interaktiv einen Semesterplan (Lehrstoffverteilung) aus den extrahierten Lehrplänen entwerfen

Die Signatur-Erweiterung dieses Skills ist die Erläuterungs-Ebene: Für jedes Lernziel (und besonders in den Lehrstoffverteilungen) eine substantielle deutsche Erläuterung, was das Thema inhaltlich ist — Begriffserklärung zuerst, integrierter Anwendungs- und Berufsbezug zweitens. Siehe „Qualitätskriterien für Erläuterungen" unten.

Ausgabesprache: DEUTSCH ZWINGEND

Alle erzeugten Dateien (Extrakte, METADATA.md-Abschnitte, Lehrstoff­ verteilungen, Berichte) MÜSSEN in natürlichem Deutsch mit korrekten UTF-8-Umlauten (ä, ö, ü, ß) geschrieben sein. Niemals Englisch für Dateiinhalte verwenden. Gesetzeszitate sind wortwörtlich aus dem RIS-Inhalt zu übernehmen.

Ziel-Repositorien

Dieser Skill ist für folgende Repositorien konzipiert (Stand 2026-09-10):

Fach-Repos (je ein Gegenstand, unter ~/repos/georgernstgraf/):

GRG-CS, GRG-CYBER, GRG-ETH, GRG-INFI, GRG-JAVA, GRG-NVS, GRG-PMM, GRG-POSTHEORIE, GRG-SWP, GRG-WMC

Fachgruppen-Repos (mehrere Gegenstände/Zweige):

• ~/repos/Die-Spengergasse/WI-Fachgruppe-Informatik
• ~/repos/hoa-spg/pos-wmc-fachgruppe-inf-erw

Wichtige Regeln dazu:

• Fach-Repos können mehrere Zweige bedienen. Ein Gegenstand kann in verschiedenen Ausbildungszweigen unterrichtet werden, in unterschiedlicher Tiefe — Beispiel GRG-INFI: Informatik im Zweig HWII (Anlage 1.24) und im Zweig HWIT (Anlage 1.28). Deshalb bildet die Verzeichnisstruktur immer den Zweig mit ab, auch in Fach-Repos (siehe Repo-Konventionen).
• Der Skill wurde bei weitem nicht in allen Ziel-Repos ausgeführt, und das ist auch nicht vorgesehen. Ein Repo ohne lehrplan/-Struktur ist daher kein Fehler, sondern ein Zustand: Aufgabe A berichtet den Zustand und listet, welche Aufgaben 1/2/3 noch ausstehen — und unternimmt nichts davon ohne ausdrückliche Nutzer-Anweisung. Kein Auto-Scaffolding, keine Auto-Migration, kein Nörgeln.

Abgrenzung zum Unterricht (thematischer Schnitt)

Die Welt ist zweigeteilt in zwei Ebenen mit eigenen Wurzeln im Repo-Root:

Ebene	Wurzel	Inhalt	Zuständig
Lehrplan-Ebene (Gesetz + Planung)	lehrplan/	Gesetzesmaterial, Extrakte, METADATA, KM-Steckbriefe, KM-keyed Ressourcen, Lehrstoffverteilungen/Semesterpläne	dieser Skill
Unterrichtsebene (Vorbereitung + Durchführung)	unterricht/	vorbereitete Einheiten (Prepared Lessons)	create-lesson-Skill

Der /unterricht/-Ordner am Repo-Root enthält nur vorbereitete Einheiten. Sie liegen flach unter unterricht/ und tragen das zugehörige Kompetenzmodul im Namen (KM<#>-<NN>-<slug> bzw. SA-<NN>-<slug> für schulautonome Teile; <NN> läuft pro KM). Planungs-Dateien (Einheiten, Semesterpläne) gehören nicht hierher, sondern auf die Lehrplan-Ebene (lehrplan/<zweig-ordner>/). Terminierte Lektionen wandern in die Kohorten-Ordner am Repo-Root.

unterricht/
  KM<#>-<NN>-<slug>/              # vorbereitete Einheit (KM-Lehrstoff)
  SA-<NN>-<slug>/                 # vorbereitete Einheit (schulautonom)

<klasse>/YYYY-MM-DD__thema/       # Kohorten-Ablage am Repo-Root (terminierte Lektion)

• Das <ZWEIG>-Kürzel der Lehrplan-Ebene folgt der Klassen-Postfix-Tabelle (siehe KLASSEN-ZUORDNUNG.md): HWII, HWIT, AIF, KIF, CIF usw.
• Klein geschriebenes jg<N>-Präfix für alle Einheiten- und Semesterplan-Dateien — einheitliches Schema, keine Ausnahmen.
• Kein unterricht/<ZWEIG>-<FACH>/-Ordner. Die Kompetenzmodule sind formunabhängig, deshalb braucht die Unterrichtsebene keine Zweig-Fach-Ebene — die trägt allein die Lehrplan-Ebene.
• Dokumentierte Ausnahme (GRG-WMC): WMC unterrichtet die Formen AIF/KIF/CIF gemeinsam (dieselbe Anlage 1.9, gemischte Kohorten). Die form-übergreifenden Planungsdateien (Einheiten/Semesterpläne, die bewusst alle Formen eines Jahrgangs abdecken) dürfen deshalb per DECISIONS-Eintrag in einem benannten Ort liegen, statt pro Form dupliziert zu werden; der Konformitäts-Check meldet das nicht als Befund.
• Das detaillierte Unterrichts-Layout (Prepared-Lesson-Inhalte, Materialien, Aufgaben) gehört zum create-lesson-Skill; dieser Skill legt auf der Lehrplan-Ebene nur die Lehrstoffverteilungen und Semesterpläne ab (Aufgabe 3) und meldet Altbestände als Befund (siehe Retrofit-Klausel).

Repo-Konventionen

⛔ VERBINDLICHES ZIEL-LAYOUT — NICHT NUR EMPFEHLENSAM. Das unten gezeigte Layout ist der verbindliche Zielzustand jedes Unterrichts-Repos. Wann immer eine Session auf ein Repo trifft, das davon abweicht (z. B. Lehrplan-Dateien unter docs/lehrplan/, Klassenordner unter lehrplan/ ohne Zweig-Ordner, unterricht/<ZWEIG>-<FACH>/-Ordner, Planungsdateien unter unterricht/, Stunden-Ordner unter lehrplan/), gilt: melden als Befund mit Migrationspflicht; Migration selbst nur auf ausdrücklichen Nutzer-Wunsch. Nur eine explizite, dokumentierte Nutzer-Entscheidung (DECISIONS-Eintrag) kann eine Ausnahme rechtfertigen. Konform sind dagegen kompetenzmodule/ und KM-keyed Ressourcen am lehrplan/-Root (Fach-Ebene) sowie Semesterpläne unter lehrplan/<zweig-ordner>/. Einzige erlaubte Abweichung bleibt das dreischichtige LEHRPLAN.md als Dateiformat (② Schuladaption und ③ Didaktik mitlegen) — die Ablage unter lehrplan/<zweig-ordner>/ ist davon nicht berührt und bleibt Pflicht.

Zweig-Ordner <zweig-ordner>: im Fach-Repo lehrplan/<zweig>/ (z. B. hwii — das Fach ist bereits der Repo-Name, kein Präfix), im Fachgruppen-Repo lehrplan/<fach>-<zweig>/ (z. B. infi-hwii, swp-hwii).

Fach-Repo (z. B. GRG-INFI)

lehrplan/
  METADATA.md                    # deckt ALLE Zweige des Fachs ab: Rechtsgrundlage,
                                 #   RIS-Verweise + NOR-Kopf-Belege, Änderungshistorie,
                                 #   Klassen-Zuordnung, Datei-Inventar
  RIS/                           # NUR Gesetzestext-PDFs (Rechtsinformationssystem)
    YYYY-MM-DD_<name>.pdf        # Anlagen/Novellen, ISO-Datum (Kundmachungsdatum)
  kompetenzmodule/               # km<N>.md + README-Matrix — FACH-Ebene, weil die
                                 #   Kompetenzmodule vom Zweig unabhängig sind
  <fach-keyed-ressourcen>.md     # fakultativ: KM-keyed Ressourcen (Fach-Ebene)
                                 #   (z. B. ressourcen-matrix.md, r4ds-abdeckung.md)
  <zweig>/                       # pro Zweig ein Ordner, klein: hwii, hwit (Fach-Repo
                                 #   OHNE Fach-Präfix – das Fach ist der Repo-Name)
    LEHRPLAN.md                  # ① Komplett-Extrakt (oder dreischichtig ①②③) DIESES Zweigs
    RIS.md                       # Rechtsstand, Novellen-Historie, Schichten-Vergleich
    <FACH>_②.pdf                 # Schuladaption-PDF, falls vorhanden
    jg<N>-einheiten.md           # Lehrstoffverteilung ("Einheiten"), falls geführt
    jg<N>-semesterplan-ws.md     # Semesterplan Wintersemester
    jg<N>-semesterplan-ss.md     # Semesterplan Sommersemester
    <KLASSE>/                    # GROSSBUCHSTABEN, z. B. 4HWII
      <KLASSE>.lehrplan.md       # Klassen-relevanter Extrakt (jahrgangsweise)
unterricht/                      # siehe "Abgrenzung zum Unterricht"
  KM<#>-<NN>-<slug>/             # vorbereitete Einheit (KM-Lehrstoff)
  SA-<NN>-<slug>/                # vorbereitete Einheit (schulautonom)

<klasse>/YYYY-MM-DD__thema/       # Kohorten-Ablage am Repo-Root (terminierte Lektion)
AGENTS.md                        # Repo-weite Agent-Regeln
GLOSSAR.md                       # Domänen-Abkürzungen und Begriffe

Fachgruppen-Repo (z. B. WI-Fachgruppe-Informatik)

Identisches Muster, nur mit mehreren Fächern/Zweigen nebeneinander. Hier trägt jeder Zweig-Ordner das Fach-Präfix (<fach>-<zweig>, z. B. infi-hwii) — im Fach-Repo dagegen nur <zweig> (siehe Beispiel oben):

lehrplan/
  METADATA.md                    # deckt ALLE Anlagen/Fächer des Repos ab
  RIS/                           # Gesetzestext-PDFs (über alle Fächer geteilt)
  kompetenzmodule/               # je Fach EINE KM-Steckbrief-Reihe (Fach-Ebene);
                                 #   bei mehreren Fächern Unterordner je Fach
  infi-hwii/                     # jedes Fach-Zweig-Verzeichnis in sich geschlossen
  infi-hwit/
  swp-hwii/
unterricht/
  KM<#>-<NN>-<slug>/
  SA-<NN>-<slug>/
AGENTS.md
GLOSSAR.md

• Jedes Zweig-Verzeichnis (<zweig-ordner>) ist in sich geschlossen: LEHRPLAN, RIS, ②-PDF, Klassen-Extrakte und die Planung (Einheiten, Semesterpläne) liegen beieinander; Querverweise bleiben flach.
• kompetenzmodule/ liegt auf Fach-Ebene. Bedient ein Repo mehrere Fächer, bekommt jedes Fach seine eigene Reihe — in einem fach-benannten Unterordner kompetenzmodule/<fach>/ (sonst kollidieren die KM-Nummern zwischen den Fächern).
• Dokumentierte Ausnahme (GRG-WMC): wenn ein Fach mehrere Zweige/Formen mit identischem Lehrplanunterbau bedient (WMC: AIF/KIF/CIF, alle aus Anlage 1.9), dürfen LEHRPLAN.md und RIS.md form-übergreifend in EINEM benannten Zweig-Ordner liegen und die Planungsdateien (Einheiten, Semesterpläne) in einem benannten Ort bleiben — pro-Form-Duplikate wären drift-gefährdete Kopien. Voraussetzung: DECISIONS-Eintrag im Repo; der Konformitäts-Check meldet das nicht als Befund. Die Block-/Klassen- Ordner selbst wandern in die wmc-<form>/-Ordner (34AIF → wmc-aif/34AIF usw.).
• Die Planungs-Dateien (Einheiten, Semesterpläne) liegen als jg<N>-einheiten.md bzw. jg<N>-semesterplan_{ws,ss}.md in lehrplan/<zweig-ordner>/; die Zuordnung Jahrgang ↔ KM ↔ generisches Klassen-Label steht in lehrplan/METADATA.md.

Ordner- und Datei-Benennung

• Zweig-Ordner lehrplan/<zweig-ordner>/: klein geschrieben, Bindestrich. Im Fach-Repo trägt er nur den Zweig — <zweig> (z. B. hwii, hwit), weil das Fach bereits der Repo-Name ist. Im Fachgruppen-Repo trägt er das Fach-Präfix — <fach>-<zweig> (z. B. infi-hwii, swp-hwii). Das Zweig-Kürzel folgt der Klassen-Postfix-Tabelle (hwii, hwit, aif, kif, cif). Vorhandene Alt-Ordner mit ausgeschriebenem Zweig-Kürzel (z. B. infi-wii, infi-wit) sind ein Befund mit Umbenennungsempfehlung (infi-wii → infi-hwii) — Umbenennung nur auf Nutzer-Wunsch.
• Klassenordner: <Stufe><Postfix> in GROSSBUCHSTABEN (z. B. 4HWII, 4HWIT), innerhalb des Zweig-Ordners (<zweig-ordner>). Generische Labels decken Parallellklassen ab (4HWIT deckt 4AHWIT/4BHWIT ab).
• Einheiten-Ordner: <PREFIX>-<NN>-<slug>/ (KM<#> = Kompetenzmodul, SA = schulautonom; <NN> läuft pro KM) liegen direkt unter unterricht/; sobald der Unterrichtstermin fixiert ist, wandern die Inhalte in die Kohorten-Ablage am Repo-Root YYYY-MM-DD__thema/.
• Einheiten/Semesterpläne: jg<N>-einheiten.md und jg<N>-semesterplan-{ws,ss}.md, kleines jg, Unterstrich, in lehrplan/<zweig-ordner>/.
• RIS-Ordner: lehrplan/RIS/ — Großbuchstaben-Ausnahme (Abkürzung, wie Klassen-Labels); enthält nur RIS-Gesetzestext-PDFs.
• PDFs: RIS/YYYY-MM-DD_<name>.pdf (ISO-8601-Datumspräfix).
• Klein mit Bindestrichen für alle mehrteiligen Datei- und Ordnernamen.
• Root-Klassenordner (Kohorten-Ablage, konform): Klein geschriebene Klassenordner direkt am Repo-Root (z. B. 5ahwit/) sind kein Befund, sondern bewusste Konvention: Unterrichts-Repos werden allen Kohorten bereitgestellt; jeder Root-Klassenordner ist der Kohorten-Einstiegspunkt und hält den aktuell relevanten Inhalt (Arbeitsblätter, Abgaben, klassenbezogene Kommunikation) für genau diese Kohorte — archiviert wird am Schuljahresende. Nicht verwechseln mit den GROSSBUCHSTABEN- Klassenordnern unter lehrplan/<zweig-ordner>/ (dort liegen die Lehrplan-Extrakte, Klein- vs. Großschreibung markiert die Ebene: Root = Ablage/Kohorte, lehrplan/ = Gesetz/Extrakt).

Klassen-Zuordnung (MANUELL GEPFLEGT)

Die handgepflegte Gegenstand→Klassen-Postfix-Tabelle steht in KLASSEN-ZUORDNUNG.md. Sie wird vom Nutzer editiert — nie selbst erweitern oder ändern.

Spengergasse-Klassen-Decoder (Abendform, Berufstätige-Formen)

Verifiziertes Wissen zu den Abendform-/Berufstätigen-Klassenkürzeln (AIF, KIF, CIF) steht in SPENGERGASSE-KLASSEN.md. Nur für Repos mit diesen Formen relevant.

Ausbildungszweig-Konzept

Aufgabe 1 arbeitet auf Ausbildungszweig-Ebene (z. B. WII, WIT, KIF), nicht auf Gegenstands-Ebene. Die rechtliche Hierarchie:

Ausbildungszweig (z. B. WII, WIT, KIF)
  → Rechtsgrundlage: BGBl.-Verordnung mit Anlagen (z. B. BGBl. II Nr. 262/2015)
    → Anlage(n): das Gesetz publiziert die Unterrichtsfächer eines
      Ausbildungszweigs MEIST GEMEINSAM in EINEM Dokument (z. B. deckt
      Anlage 1.28 ALLE Gegenstände des Zweigs WIT ab)
    → Variiert: manche Zweige/Fächer haben eigene Anlagen (z. B. WMC:
      Anlage 1.9 aus BGBl. II Nr. 368/2022 statt der WIT-Sammelanlage)
      → einzelne Fächer (Abschnitte der Anlage)

Konsequenzen für den Skill:

• Aufgabe 1 (Beschaffung) zielt auf die Dokumente des Zweigs. Eine gemeinsame Anlage pro Zweig ist der Normalfall; eigene Anlagen werden erkannt und berichtet, wenn sie existieren. Die METADATA.md des Repos speichert, welche Anlage welchen Gegenstand deckt.
• Aufgabe 2 (Extraktion) extrahiert immer EINEN Gegenstand (einen Abschnitt) aus dem Zweig-Dokument — nie den ganzen Zweig. Bei einem Gegenstand in mehreren Zweigen (z. B. INFI) wird pro Zweig ein eigener Extrakt im jeweiligen lehrplan/<zweig-ordner>/-Ordner angelegt.
• Die Fetch-Strategie bleibt anlagen-basiert (NOR-Dokument pro Anlage, siehe RIS-Praxiswissen) — ein Zweig-Dokument wird einmal gefetcht und dient allen seinen Gegenständen.

Ablaufübersicht

Aufgabe	Modus	Trigger-Beispiele
A — Gegenstand & Ausbildungszweig identifizieren	Standard (bei jedem Aufruf)	„Unterricht", „Vorbereitung prüfen"
1 — Gesetzesmaterial beschaffen (Zweig)	Bei Bedarf	„Lehrplan auf Novellen prüfen", „RIS sync", „Gesetzesmaterial holen"
2 — Fach-Extraktion mit Erläuterungen	Bei Bedarf	„Lehrplan extrahieren", „Jahrespläne neu ziehen", „Erläuterungen ergänzen"
3 — Lehrstoffverteilung/Semesterplan (interaktiv)	Bei Bedarf	„Semesterplan erstellen", „Semesterplan überarbeiten", „Einheiten erstellen"

Vor Aufgabe 1, 2 oder 3: einen kurzen Plan anzeigen (was wird gefetcht, verglichen, geschrieben) und dann fortfahren. Bei schreiblastigen Schritten mit dem Nutzer bestätigen, wenn der Plan vom Auftrag abweicht.

Aufgabe A — Gegenstand & Ausbildungszweig identifizieren

In dieser Reihenfolge lesen:

1. lehrplan/METADATA.md — Rechtsgrundlage (BGBl.-Nummer, Anlage), RIS-Verweise (ELI, konsolidierte Fassung, NOR-Links), Änderungshistorie, Schulautonomie-Notizen, Klassen-Zuordnung, Datei-Inventar.
2. README.md, AGENTS.md, GLOSSAR.md — Gegenstandsname, Konventionen, Domänenbegriffe.

Danach berichten:

• Gegenstand: Name und Abkürzung, aus den eigenen Docs des Repos gelesen (METADATA.md, README.md, AGENTS.md) — nie eine Auflösung erfinden. Beispiel: GRG-PMM nutzt „Prozessmanagement (PMM)" als Maturafach-Name (Anlage 1.28, Abschnitt 5).
• Ausbildungszweig(e): welchem Zweig(en) der Gegenstand des Repos angehört (z. B. WIT für PMM; HWII und HWIT für GRG-INFI) und welche Anlage ihn deckt — gemeinsam mit anderen Gegenständen oder als eigene (siehe Ausbildungszweig-Konzept).
• Rechtsgrundlage: BGBl. II Nummer, Kundmachungsdatum, Anlage (z. B. Anlage 1.28 der BGBl. II Nr. 262/2015), plus den Allgemeinen Teil (Anlage 1), falls referenziert.
• RIS-Verweise: die in METADATA.md gespeicherten Links.
• Klassen: vorgefundene Klassenordner (pro Zweig-Ordner <zweig-ordner>) — via Postfix-Tabelle auf Jahrgänge abgebildet.
• Lücken: falls lehrplan/METADATA.md fehlt oder unvollständig ist, die Standardstruktur vorschlagen (siehe unten), bevor irgendetwas erstellt wird — und nur auf ausdrücklichen Nutzer-Wunsch erstellen.

Konformitäts-Check (immer als Teil von Aufgabe A)

Nach dem Lesen des Repos jeden Punkt prüfen und berichten — das beantwortet die wiederkehrende Frage „ist alles eingerichtet, muss der Skill noch laufen?":

Prüfpunkt	Konform, wenn
METADATA.md vollständig	Alle Skeleton-Abschnitte vorhanden und gefüllt (Rechtsgrundlage, RIS-Verweise, Änderungshistorie, Klassen-Zuordnung, Datei-Inventar)
Zweig-Ebene vorhanden	Jeder unterrichtete Zweig hat ein lehrplan/<zweig-ordner>/-Verzeichnis — flache Klassen-/Extrakt-Ordner direkt unter lehrplan/ (Alt-Layout) sind ein Befund mit Migrationspflicht
Komplett-Extrakt	lehrplan/<zweig-ordner>/LEHRPLAN.md existiert pro Zweig, deckt alle Jahrgänge des Gegenstands in diesem Zweig ab
Klassen-Extrakte	lehrplan/<zweig-ordner>/<KLASSE>/<KLASSE>.lehrplan.md existiert für jeden Klassenordner
KM-Steckbriefe (Fach-Ebene)	lehrplan/kompetenzmodule/ (bzw. kompetenzmodule/<fach>/ im Mehr-Fächer-Repo) liegt am Root — im Zweig-Ordner (<zweig-ordner>/) wären sie ein Befund
KM-keyed Ressourcen (Fach-Ebene)	ressourcen-matrix.md, r4ds-abdeckung.md o. Ä. liegen am lehrplan/-Root — im Zweig-Ordner wären sie ein Befund
Klassen-Zuordnung	METADATA.md bildet jeden unterrichteten Jahrgang ↔ KM ↔ GROSSBUCHSTABEN-Klassenname (pro Zweig) ab
Novellen-Check-Datum	METADATA.md dokumentiert die letzte RIS-Abfrage („RIS-Status abgefragt am …") und ihr Ergebnis
RIS-Verzeichnis	Alle Gesetzestext-PDFs unter lehrplan/RIS/ — PDFs im lehrplan/-Root sind ein Migrationsbefund
Erläuterungen	KM-Überblicke und Lernziel-Erläuterungen in allen Extrakten vorhanden (siehe Aufgabe 2)
Planungs-Ablage	Einheiten (jg<N>-einheiten.md) und Semesterpläne (jg<N>-semesterplan-{ws,ss}.md) liegen in lehrplan/<zweig-ordner>/; unter unterricht/ (Zweig-Fach-Ordner oder lose) sind sie ein Migrationsbefund (Retrofit-Klausel)
Einheiten-Ordner	Vorbereitete Ordner <KM#/SA>-<NN>-<slug>/ liegen direkt unter unterricht/ (KM-Präfix, <NN> pro KM); terminierte Lektionen in der Kohorten-Ablage am Repo-Root <klasse>/YYYY-MM-DD__thema/. Ein unterricht/<ZWEIG>-<FACH>/-Ordner ist ein Befund (zuständig: create-lesson-Skill)
Root-Klassenordner	Klein geschriebene Klassenordner am Repo-Root (z. B. 5ahwit/) sind konforme Kohorten-Einstiegspunkte (Ablage pro Kohorte, Archivierung am Schuljahresende) — kein Befund; GROSSBUCHSTABEN-Klassenordner mit Lehrplan-Extrakten liegen unverändert unter lehrplan/<zweig-ordner>/

Anschließend ausdrücklich feststellen: „Der Skill muss noch ausgeführt werden" (Auflistung, welche Aufgaben 1/2/3 ausstehen) oder „Der Skill ist vollständig ausgeführt" — oder, bei Repos ohne lehrplan/-Struktur: „Repo noch nicht lehrplan-aktiviert; Aufgaben 1/2/3 stehen aus" plus Befundliste. In keinem Fall eigenmächtig migrieren, anlegen oder löschen.

METADATA.md-Skeleton (nur vorschlagen, wenn fehlend/unvollständig)

# Metadaten zum Lehrplan

## Rechtliche Grundlage
<!-- Kundmachungsorgan, Datum, Typ, Titel, einbringende Stelle, Anlage -->

## RIS-Verweise
<!-- ELI, konsolidierte Fassung (Gesetzesnummer), Anlage-Links -->

## Änderungshistorie
<!-- | Datum | Änderung | Betrifft | -->

## Schulautonomie
<!-- Freiheitsgrade, schulautonome Stundentafel -->

## Klassen-Zuordnung
<!-- | Zweig | Jahrgang | Klassenname | -->  <!-- GROSSBUCHSTABEN, generische Labels -->

## Zeitmodell
<!-- Wochenstunden/Doppelstunden pro Semester -->

## Dateien in diesem Verzeichnis
<!-- | Datei (RIS-PDFs als `RIS/<name>.pdf`) | Herkunft | Beschreibung | -->

Aufgabe 1 (bei Bedarf) — Gesetzesmaterial beschaffen (Ausbildungszweig)

Zweck: sicherstellen, dass das Repo das geltende Gesetz für den Ausbildungszweig des Gegenstands vollständig abbildet und keine gesetzgeberische Änderung der letzten 12 Monate verpasst wurde.

Protokoll:

1. Gespeicherten Zustand lesen aus lehrplan/METADATA.md: Gesetzesnummer der konsolidierten Fassung, RIS-Links (insbesondere der Anlage-NOR-Link), Änderungshistorie-Tabelle, PDF-Inventar.
2. Novellen-Check (letzte 12 Monate) — mit der NOR-Kopf-Methode (siehe „RIS-Praxiswissen" unten; nie webfetch auf die GeltendeFassung.wxe-Seite — sie enthält das ganze Lehrplanpaket, überschreitet das Fetch-Limit und schlägt fehl):
   • curl auf das NOR-Dokument der Anlage des Zweigs (Link in METADATA.md). Sein Kundmachungsorgan-Kopf enthält die autoritative Ein-Zeilen-Prüfung, z. B.: „BGBl. II Nr. 262/2015 zuletzt geändert durch BGBl. II Nr. 250/2021"
   • Die „zuletzt geändert durch"-Novelle mit der Änderungshistorie-Tabelle in METADATA.md vergleichen. Abfragedatum notieren.
   • Ist die Novelle bereits dokumentiert: keine Änderung melden, mit Schritt 4 fortfahren.
3. Bei einer dokumentierten-neueren Novelle (nur wenn neuer als der letzte dokumentierte Eintrag):
   • Identifizieren über die ELI-Seite (https://www.ris.bka.gv.at/eli/bgbl/II/<Jahr>/<Nr>): Kurztitel, Kundmachungsdatum, Typ.
   • Herunterladen des signierten PDFs: https://www.ris.bka.gv.at/Dokumente/BgblAuth/BGBLA_<Jahr>_II_<Nr>/BGBLA_<Jahr>_II_<Nr>.pdf
   • Auswirkungen analysieren: pdftotext, dann nach Anlage <N.N> und Gegenstands-Schlüsselwörtern greppen. Novellen-§§ sind pro Novelle nummeriert; das Inkrafttreten-Muster ist typischerweise „Abschnitte I und VII … treten hinsichtlich des I. Jahrganges mit
     1. September <Jahr> … jahrgangsweise aufsteigend in Kraft".
   • Zuerst den Nutzer informieren: was sich ändert, welche Teile des Lehrplans des Zweigs betroffen sind, ob der Lehrstoff des Gegenstands (der Abschnitt des Gegenstands in der Anlage) berührt ist.
   • PDF speichern unter lehrplan/RIS/ als YYYY-MM-DD_BGBl-II-<Nr>_Novelle-<slug>.pdf (Kundmachungsdatum).
   • METADATA.md aktualisieren: RIS-Verweise (Novellen-ELI-Link), Änderungshistorie (Zeile anhängen: Kundmachungsdatum, Novelle + Inkrafttreten, Betrifft), Datei-Inventar, plus die Belegzeile „RIS-Status abgefragt am …".
   • Aufgabe 2 (Re-Extraktion) als erforderlich markieren nur, wenn der Abschnitt/Lehrstoff des Gegenstands geändert wurde (z. B. berührte 250/2021 nur Religion/Ethik — der Prozessmanagement-Abschnitt blieb unverändert, die Extrakte blieben gültig).
4. PDFs vergleichen: prüfen, ob die gespeicherten PDFs noch den aktuellen RIS-Originalen entsprechen (Daten/Dokument-IDs vergleichen; Byte-Vergleich, wenn ein frischer Download verfügbar ist).
5. Bei keiner Änderung: Bestätigung mit Beleg berichten — die gefetchte NOR-Kopf-Zeile (mit Abfragedatum) und das Datum des letzten Eintrags in METADATA.md. Ausdrücklich festhalten: „Alles Relevante aus dem Gesetz ist im Repository abgebildet."
6. Bei Fetch-Fehler: den exakten Fehler melden und stoppen — nie den Rechtsstand raten oder fabrizieren.

Aufgabe 2 (bei Bedarf) — Fach-Extraktion mit Erläuterungen

Zweck: den Gesetzestext in lesbare Markdown-Schichten überführen — das wortwörtliche Gesetz plus die Erläuterungs-Ebene (was der Inhalt tatsächlich ist).

1. Quelle: Text aus der RIS-HTML der Anlage des Zweigs extrahieren (bevorzugt: aktueller konsolidierte-Fassung-Link in METADATA.md) oder aus dem gespeicherten PDF. Nur gefetchte Inhalte zitieren — nie Gesetzestext aus dem Gedächtnis rekonstruieren.
2. Komplett-Extrakt — lehrplan/<zweig-ordner>/LEHRPLAN.md:
   • Alle Jahrgänge des Gegenstands in diesem Zweig, in Reihenfolge (I.–V. Jahrgang).
   • Struktur: ## <Jahrgang> → ### <Semester> — Kompetenzmodul <N> → #### Bildungs- und Lehraufgabe → #### Lehrstoff.
   • Erläuterungs-Ebene (zwingend), siehe „Qualitätskriterien für Erläuterungen":
     • KM-Überblick: direkt unter jeder ### <Semester> — Kompetenzmodul <N>-Überschrift eine kurze Einleitungs-Beschreibung als Annotation (> **Überblick:** …) — worum geht es in diesem Kompetenzmodul insgesamt.
     • Lernziel-Erläuterungen: direkt unter jedem Lernziel-Bullet der Bildungs- und Lehraufgabe eine Inline-Annotation (> **Erläuterung:** …), die erklärt, was das Thema IST.
     • Lehrstoff-Erläuterungen: eine Annotation (> **Erläuterung:** …) pro Lehrstoff-Bereich (Lehrstoff ist verdichteter Fließtext — eine Erläuterung pro Bereich, nicht pro Fragment).
   • Meilensteine annotieren (z. B. „III. Jahrgang — Statistik beginnt hier"), falls in der Quelle vorhanden, klar als Annotation markiert.
   • Kopfzeile: Rechtsgrundlage, RIS-Link, Extraktionsdatum.
3. Klassen-Extrakte — einer pro Klassenordner:
   • Ziel: lehrplan/<zweig-ordner>/<KLASSE>/<KLASSE>.lehrplan.md (z. B. lehrplan/hwii/4HWII/4HWII.lehrplan.md).
   • Inhalt: nur der klassenrelevante Jahrgang (z. B. IV. Jahrgang = KM 7 + KM 8 für eine 4.-Jahres-Klasse), also Bildungs- und Lehraufgabe + Lehrstoff ihrer Kompetenzmodule — inklusive der vollständigen Erläuterungs-Ebene (KM-Überblicke, Lernziel- und Lehrstoff-Erläuterungen).
   • Kopfzeile: Klassenname ↔ Jahrgang ↔ Kompetenzmodule, Rechtsgrundlage, Extraktionsdatum.
   • Die Jahrgang ↔ KM-Zuordnung stammt aus METADATA.md.
4. Klassennamen in den Lehrplan aufnehmen: sicherstellen, dass die Klassen-Zuordnung in METADATA.md jeden unterrichteten Jahrgang (pro Zweig) auf seine GROSSBUCHSTABEN-Klassennamen abbildet. Fehlende Zeilen ergänzen; nie Zeilen ohne Nutzer-Bestätigung entfernen.
5. Manuelle Annotationen bewahren: existiert eine Extrakt-Datei bereits, zuerst lesen. Re-Extraktion darf menschliche Annotationen (Hervorhebungen, Querverweise) oder existierende Erläuterungen nicht still verwerfen. Gesetzestext neu aufbauen, dann betroffene Annotationen und Erläuterungen neu anwenden, regenerieren oder markieren — nie eine menschlich verfasste Erläuterung still löschen; im Zweifel behalten und zur Durchsicht markieren.
6. Bericht: geschriebene Dateien, abgedeckte Jahrgänge, Annotationen oder Erläuterungen, die manuell nachgeprüft werden müssen.

Aufgabe 3 (bei Bedarf) — Lehrstoffverteilung/Semesterplan (interaktives Protokoll)

Zweck: aus den extrahierten Lehrplänen eine konkrete Lehrstoffverteilung entwerfen — jg<N>-einheiten.md und jg<N>-semesterplan-ws.md bzw. jg<N>-semesterplan-ss.md in lehrplan/<zweig-ordner>/. Dies ist ein interaktives Protokoll: der Skill entwirft, der Nutzer entscheidet. Nie eine finale Lehrstoffverteilung ohne den Nutzer-Review-Schritt schreiben.

Protokoll:

1. Input-Check (alles muss existieren; falls nicht, auf die fehlenden Aufgaben-1/2-Ausgaben hinweisen und stoppen):
   • Klassen-Extrakt lehrplan/<zweig-ordner>/<KLASSE>/<KLASSE>.lehrplan.md mit Erläuterungs-Ebene (die inhaltliche Wirbelsäule).
   • KM-Steckbriefe lehrplan/kompetenzmodule/km<N>.md (zur Kontextlektüre).
   • Zeitmodell aus lehrplan/METADATA.md (Wochenstunden/ Doppelstunden pro Semester — bestimmt die Anzahl der UE).
   • Ressourcen-Matrix (z. B. lehrplan/ressourcen-matrix.md), falls vorhanden — für Lektüre-Anker.
2. UE-Raster-Entwurf: den KM-Inhalt (Lernziele + Lehrstoff) gemäß Zeitmodell auf UE-Blöcke abbilden (reale UE + reservierte DS für Tests/Admin). Den Entwurf als kompakte Tabelle präsentieren (UE | Thema | KM/Lernziel-Bezug | geplante Lektüre-Anker). Annahmen explizit nennen (Vorwissen aus früheren KMs, Reihenfolge-Entscheidungen).
3. Nutzer-Review (Pflichtschritt): Entwurf präsentieren und nach Bestätigung/Anpassungen fragen — Reihenfolge, Schwerpunkte, reservierte Slots. Erst fortfahren, wenn der Nutzer das Raster geprüft hat.
4. Ausarbeitung: lehrplan/<zweig-ordner>/jg<N>-einheiten.md bzw. jg<N>-semesterplan-ws.md / jg<N>-semesterplan-ss.md schreiben, dem bestehenden Format im Repo folgend (UE-Tabellen nach thematischen Blöcken, Kopf mit Zeitmodell, Werkzeug, KM-Steckbrief- und Ressourcen-Anker-Verweisen, reservierte DS und Schwerpunkte-Zusammenfassung am Ende).
   • <N> = Jahrgang der Zielklasse (z. B. 4HWII → jg4-…).
   • Pro UE-Themenblock: eine inhaltliche Beschreibung — ein kurzer Erläuterungsabsatz (oder annotierte Tabellenzeilen) pro thematischem Block/UE: was das Thema IST, mit integriertem Anwendungs- und Berufsbezug (siehe „Qualitätskriterien für Erläuterungen"). Gerade hier müssen die Erläuterungen substantiell sein — dies ist die Schicht, aus der Lehrkräfte tatsächlich unterrichten.
5. Manuellen Inhalt bewahren: existiert bereits eine Lehrstoffverteilung, zuerst lesen. Überarbeitung darf bestehenden Inhalt (UE-Blöcke, Annotationen, didaktische Notizen) nicht still verwerfen. Diff-artige Zusammenfassung der Änderungen zeigen.
6. Iteration: Folge-Anpassungen anbieten (Umreihung, Lektüre-Anker tauschen, Reserve-UE ergänzen). Der Nutzer entscheidet, wann der Plan final ist.

Retrofit-Klausel (bereits lehrplan-aktivierte Repos)

In Repos, die nach der früheren Trennung (Planung unter unterricht/) aufgesetzt wurden, liegen Altbestände auf der Unterrichtsebene — typischerweise:

• unterricht/<ZWEIG>-<FACH>/jg<N>-semesterplan-ws.md / -ss.md
• unterricht/<ZWEIG>-<FACH>/jg<N>-einheiten.md
• die ganze Zweig-Fach-Ebene unterricht/<ZWEIG>-<FACH>/
• NN-slug/- und YYYY-MM-DD_thema/-Stunden-Ordner unter lehrplan/<KLASSE>/

Vorgehen beim Antreffen (Aufgabe A oder 3):

1. Melden, nicht handeln: Altbestände als Migrationsbefund listen (Quelle → Ziel), z. B. unterricht/HWII-INFI/jg4-einheiten.md → lehrplan/hwii/jg4-einheiten.md.
2. Umbenennungen auf das einheitliche jg<N>-Schema mit einbeziehen (z. B. semesterplan-ws.md in einem 4HWII-Ordner → jg4-semesterplan-ws.md; abweichende Namen wie JG3-einheiten.md → jg3-einheiten.md).
3. Migration (verschieben + umbenennen, bevorzugt git mv) nur nach ausdrücklicher Nutzer-Bestätigung des Vorschlags — nie still löschen, nie ohne Bestätigung verschieben.
4. Nach der Migration: Querverweise in METADATA.md, README.md und den Semesterplänen auf die neuen Pfade prüfen und (auf Wunsch) anpassen.

Die Stunden-Ordner (NN-slug/, YYYY-MM-DD_thema/) gehören inhaltlich zum create-lesson-Skill — ihr Umzug wird gemeldet und empfohlen, ihre Detailpflege liegt danach beim create-lesson-Skill.

Qualitätskriterien für Erläuterungen

Die gemeinsamen Regeln für jede Erläuterung (Aufgabe-2-Extrakte und Aufgabe-3-Lehrstoffverteilungen) stehen in ERLAEUTERUNGS-QUALITAET.md.

RIS-Praxiswissen (projektübergreifend)

Generisches Wissen zum Fetchen von ris.bka.gv.at steht in RIS-PRAXIS.md. Nach jedem Aufgabe-1/2-Lauf neu gelernte generische RIS-Muster dort ergänzen.

Explizit außerhalb des Scopes

• Prepared Lessons, Präsentationen, Aufgaben gehören zu anderen Skills — der create-lesson-Skill ist für unterricht/ zuständig; homework und teach für die jeweiligen Spezialfälle.
• KM-Steckbriefe (kompetenzmodule/) sind didaktische Autorenschaft; dieser Skill liest sie nur zur Kontextlektüre, schreibt sie nie um.
• Kein Auto-Commit. Niemals committen. Commits folgen dem Issue-Workflow des Repos, falls vorhanden.
• Keine Auto-Migration. Alt-Layouts werden gemeldet (Befund mit Migrationsvorschlag); verschoben/umbenannt wird nur nach ausdrücklicher Nutzer-Bestätigung.

Done when

• [ ] Aufgabe A hat berichtet: Gegenstand, Ausbildungszweig(e), Rechtsgrundlage (BGBl. + Anlage), RIS-Verweise und Klassen — alles aus den Repo-Docs gelesen, nichts erfunden.
• [ ] Der Konformitäts-Check ist Punkt für Punkt durchgeführt und mit genau einem der drei Sätze abgeschlossen („muss noch ausgeführt werden" / „ist vollständig ausgeführt" / „Repo noch nicht lehrplan-aktiviert").
• [ ] Aufgabe 1 (falls beauftragt): der Novellen-Check stützt sich auf die NOR-Kopf-Zeile der Anlage samt Abfragedatum; eine neue Novelle wurde vor dem Download berichtet und danach unter lehrplan/RIS/ abgelegt und in METADATA.md eingetragen.
• [ ] Aufgabe 2 (falls beauftragt): LEHRPLAN.md und jeder Klassen-Extrakt tragen die Erläuterungs-Ebene (KM-Überblick, Lernziel- und Lehrstoff-Erläuterungen); bestehende Annotationen sind erhalten oder als zu prüfen markiert.
• [ ] Aufgabe 3 (falls beauftragt): der UE-Raster-Entwurf wurde im Nutzer-Review bestätigt, erst dann stehen jg<N>-einheiten.md bzw. jg<N>-semesterplan-{ws,ss}.md in lehrplan/<zweig-ordner>/.
• [ ] Alle Ausgaben sind deutsch mit echten UTF-8-Umlauten; kein Gesetzestext und keine BGBl.-Referenz ist ohne gefetchte Quelle zitiert.
• [ ] Alt-Layouts sind als Befund mit Migrationsvorschlag gemeldet, nichts ist migriert, umbenannt oder committet.

Randbedingungen

• Deutsche Ausgabe mit korrekten UTF-8-Umlauten; keine Transliterationen (ae/oe/ue).
• Niemals Gesetzestext, Daten oder BGBl.-Referenzen fabrizieren. Nur aus gefetchtem RIS-Inhalt zitieren; im Zweifel neu fetchen.
• Erläuterungen sind immer klar als Annotationen markiert (Blockquote mit **Überblick:** / **Erläuterung:**) — Gesetzestext und didaktische Erläuterung dürfen sich visuell nie vermischen.
• RIS-Gesetzestext-PDFs mit ISO-8601-Kundmachungsdatum präfixen; andere Referenz-PDFs sind ausgenommen.
• Vor dem Schreiben von Dateien einen Plan zeigen; vor Abweichungen vom angefragten Umfang bestätigen lassen.
• Aufgabe 3 schreibt nie eine finale Lehrstoffverteilung ohne den Nutzer-Review-Schritt (Pflichtschritt).
• Die Klassen-Zuordnungstabelle (KLASSEN-ZUORDNUNG.md) wird manuell gepflegt — vorschlagen, nie selbst editieren.
• GROSSBUCHSTABEN-Klassennamen überall (Ordner, Extrakt-Dateien, METADATA.md); Ausnahme: die Ordner lehrplan/<zweig-ordner>/ sind klein.
• Repos ohne lehrplan/-Struktur: nur berichten, nichts anlegen oder migrieren ohne ausdrückliche Nutzer-Anweisung.