lehrplan

Files (5)

• ERLAEUTERUNGS-QUALITAET.md
• KLASSEN-ZUORDNUNG.md
• RIS-PRAXIS.md
• SKILL.md
• SPENGERGASSE-KLASSEN.md

SKILL.md (first lines)

# 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](./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

From georgernstgraf/opencode-helpers, MIT.

More from georgernstgraf/opencode-helpers