create-lesson

Files (1)

• SKILL.md

SKILL.md (first lines)

# Create-Lesson-Skill

Richtet zu einem **Kompetenzmodul (KM) oder einem Thema daraus** eine
**Lesson** her: eine selbständige HTML-Seite für Schüler:innen mit Erklärung,
interaktivem Quiz und integrierter **Aufgabe** am Lesson-Ende (Aufgabe =
Mitarbeit). Der Skill arbeitet **in `unterricht/`** und legt dort **Prepared
Lessons** ab; die Übernahme in den Kohortenordner erfolgt **per Hand** durch
die Lehrperson. Konventionsbasiert, nicht auf ein Fach verdrahtet (Vorbild:
`lehrplan`- und `teach`-Skill).

## Kohorten-Agnostik (Grundprinzip)

Eine Lesson gehört zu einem **Thema**, das einen **Teil eines KM** deckt —
nicht zu einer Kohorte und nicht zu einer fest geplanten Unterrichtseinheit:

- **Thema → KM** ist die tragende Zuordnung. Das Thema deckt einen Teil des
  Kompetenzmoduls ab; der Skill prüft gegen die KM-Anforderung, nicht gegen
  einen Stundenplan.
- **UE-Zuordnung ist optional.** Semesterpläne können dem Thema eine
  Unterrichtseinheit *zuordnen* — sie müssen es nicht. Die Dynamik des
  tatsächlichen Unterrichts macht eine feste Direktzuordnung lächerlich; der
  Skill erzwingt sie daher **nie** und befasst sich **nicht mit dem
  Lernfortschritt einzelner Kohorten**.
- **Übernahme bleibt manuell.** Die Lehrperson entscheidet zur Tagesdynamik,
  welche vorbereitete Lektion passt, **kopiert** sie per Hand vom
  Unterrichtsordner in den jeweiligen **Kohortenordner** und fügt das **Datum
  manuell in den Ordnernamen** ein. Der Skill schreibt nie in Kohortenordner
  und führt keine Kohorten-Statistik.

Kanonische Referenz-Implementierung (zentrales `assets/`, Bootstrap/Badge,
`<PREFIX>-<NN>-<slug>/`, Stil-Leitfaden):
`/home/georg/repos/georgernstgraf/GRG-PMM`.
**Hinweis:** PMM trennt teils `lesson.html` und `praesentation.html`
(Reveal.js/CDN) — das ist die *alte* Praxis. Hier gilt **Lektion und
Präsentation in einem** (Grundregel 6): **eine** HTML, kein Foliensatz,
kein Framework/CDN.

## Lernplattform: GitHub Pages & `index.html`

**GitHub Pages ist die Lernplattform des Repos.** Veröffentlicht und verlinkt
wird **ausschließlich `unterricht/`** — plus das zentrale `assets/` und der
Navigator `index.html`. Alles andere ist **nicht** Teil der Lernplattform:
Kohorten-Ordner, `lehrplan/`, `Unterlagen/`, Archiv-Ordner usw. werden weder
deployt noch vom Navigator verlinkt.

- Der Root-`index.html` ist der **Navigator** der Lernplattform. Er listet die
  Prepared Lessons aus `unterricht/<PREFIX>-<NN>-<slug>/` — gruppiert nach
  Jahrgang/KM — und verlinkt **nur** `unterricht/`-Ziele.
- **Jede neu gebaute Lesson wird im selben Commit im `index.html` verlinkt**
  (Titel + ein Satz „Worum geht's"). Bestehende Blöcke/Einträge ergänzen,
  nicht umsortieren; fehlt der passende Block, einen anlegen.
- Das Deployment läuft über `.github/workflows/pages.yml` und kopiert nur
  `index.html`, `assets/` und `unterricht/` (rsync) in die Site. Fehlt der
  Workflow, einmal nach dem Vorbild des Repos (bzw. GRG-INFI/GRG-PMM) anlegen.
- **Prepared Lessons müssen in allen Auslieferungskontexten funktionieren** —
  lokal über `./serve.sh`, im **VS-Code-Browser** (Simple Browser/Live Preview,
  immer über die Server-URL, **nie** `file://`) **und** auf GitHub Pages unter
  der Basis `/<repo>/`. Daraus folgen: Nicht-Asset-Links **relativ**; **kein
  `<base>`**, **keine root-absoluten Pfade**; Assets nur über den generischen
  Ahnen-Bootstrap (Root-Resolver, kein Repo-Name); **genau ein** Top-Level-
  `assets/` (kein Dot-Ordner `.assets` — Pages überspringt diese; ggf.
  `.nojekyll`); Badge-Basis aus `assets/site.js`.
- **Referenzen liegen außerhalb des Deploys:** `GLOSSAR.md` (und weiteres
  Root-Nachschlagewerk) wird **nicht** mitdeployt. Links aus Lessons/Navigator
  darauf laufen daher über die **GitHub-URL** des Repos (siehe § Referenzmaterial).

## Referenzmaterial (nicht unter `unterricht/`)

`unterricht/` ist **nicht** der Ort für Nachschlagewerke — dort liegen
ausschließlich Lesson-Ordner (Grundregel 3):

- **Glossar = `GLOSSAR.md` im Repo-Root.** Neue Fachbegriffe (mit KM-Verweis;
  UE-Verweis nur, wenn tatsächlich zugeordnet) kommen dorthin.
- **Weiteres repo-weites Nachschlagewerk** (z. B. ein SQL-Spickzettel) liegt
  ebenfalls als eigene Markdown-Datei im **Repo-Root** — nie als `reference/`
  unter `unterricht/`.
- **Lesson-spezifische Checklisten** (z. B. eine Normalformen-Tabelle) bleiben
  **in** der jeweiligen Lesson.
- Auf Root-Referenzen wird per **GitHub-URL** verlinkt (siehe § Lernplattform).

## Abgrenzung zum Teach-Skill (wichtig, keine Duplikation)

- **`teach` = Selbstlernen** (die Lehrperson lernt: Lernpfade, Meisterschaft,
  Learning Records). Die HTML-Anatomie dort (self-contained, Assets,
  Quiz-Widget-Muster) wird hier **referenziert, nicht kopiert**.
- **`create-lesson` = Lehren** (Schüler-Material): KM-/themengebunden,
  kohortenagnostisch, lektüregebunden (Lizenzregeln!), per Code-Ausführung
  verifiziert, als **Prepared Lesson** in `unterricht/<PREFIX>-<NN>-<slug>/`
  abgelegt.
- Faustregel: Wer `MISSION.md`/`learning-records/` braucht → `teach`.
  Wer `KM + Thema` nennt → dieser Skill.

## Grundregeln (nicht verhandelbar)

1. **Anforderung ist das KM, nicht die Unterlage.** Was die Lesson lehren
   muss, ergibt sich aus dem KM bzw. dem bestellten Thema
   (`lehrplan/kompetenzmodule/`; der Semesterplan dient nur als optionale
   Orientierung, welche UE das Thema typischerweise trägt). Der
   vorhandene Bestand (`Unterlagen/`, frühere Lektionen) ist die *bisherige
   gelebte Praxis*: Der Skill prüft **kritisch, ob er das geforderte Material
   ausreichend abdeckt**, darf daraus borgen und kopieren — aber der Bestand
   ist **keine Obergrenze**. Deckt er nicht, ergänzt der Skill eigenständig.
2. **Nie nachfragen.** Fehlende Angaben werden autonom aufgelöst, in dieser
   Reihenfolge: (a) KM-Steckbriefe + Semesterplan, (b) `Unterlagen/` und
   bestehende Lektionen, (c) PMM-Referenz. Einzige zulässige Rückfrage:
   fehlendes Bestellformat (KM/Thema).
3. **Arbeitsort `unterricht/`.** Prepared Lessons liegen **flach** unter
   `unterricht/` als `<PREFIX>-<NN>-<slug>/` (`KM<#>` = Kompetenzmodul,
   `SA` = schulautonom; `<NN>` läuft **pro KM**) und bestehen aus
   `lesson.html` + `aufgabe.md` (plus Tages-README-Vorlage, siehe
   § Prepared Lessons) — **kein lauffähiger Projektcode** (siehe
   § Beispielprojekte). Die `lesson.html` ist **zugleich die Präsentation**
   (Grundregel 6): **kein** separater Foliensatz. **`unterricht/`
   enthält ausschließlich solche Lesson-Ordner** — *keine* weiteren Ordner
   (kein `reference/`, kein lesson-lokales `assets/`; das repo-weite
   `assets/` liegt im Repo-Root). Kohortenordner werden **nicht** direkt
   beschrieben — die Lehrperson kopiert die Lesson per Hand in den
   Datums-Ordner der Kohorte (siehe § Prepared Lessons).
4. **Immer 90 Minuten.** Eine Lesson ist **immer** eine ganze Doppelstunde

From georgernstgraf/opencode-helpers, MIT.

More from georgernstgraf/opencode-helpers