Refactor-Status · `refactor/didaktik-rewrite-2026`

Letzter Stand: 2026-05-14

Was steht

Foundation (Phasen 0–1)

CLAUDE.md · README.md · AGENTS.md mit didaktischem Fundament (auf main)
docs/klausur-themen-2026.md — 9 Klausur-Blöcke für 223015b gelockt (D1–D4 entschieden)
docs/223015b-lernziele.md — 33 operative Lernziele im Fließsatz-Eichmaß
docs/223015b/01-…-bogen.md bis 05-…-bogen.md — 5 Kapitel-Skelette mit Folien-Plan, Streichungs-Liste, Demo-TODO

Demos (Phase 3)

kap02-eroeffner.png — Lossless vs Lossy Wellenform-Vergleich (FLAC vs MP3 128)
kap03-eroeffner.png — Drei Modalitäten Datei-Größen-Tabelle (Bild/Audio/Video)
Kap 4 Eröffner — Datei-Reise-Pfad (SSD → SATA → USB-C → HDMI → Display mit Datenraten)
Kap 5 Eröffner — Foto mit EXIF-Overlay (Privacy-Reveal)
Übrige ~40 unterstützende Demos pro Kapitel (siehe Visualisierungs-Listen in den Bogen-Docs)

Erste 5 Eröffner-Versuche (verworfen)

Frühere Advance Organizer (kap01-advance-organizer, kap02-bogen, kap03-modalitäten-bogen, kap04-bogen, kap05-bogen) waren plump, gleichförmig und nicht erkenntnisgewinnend. Per Commit 1c8185b gelöscht. Begründung: Topic-Boxen mit Pfeilen statt konkrete Daten in Transformation. Neue Strategie: pro Kapitel eigene Konkret-Komposition.

Slides selbst (Phase 4)

Komplett offen — die Bogen-Docs sind das Skelett, daraus werden in Phase 4 die Marp-Markdown-Files erzeugt
Reihenfolge laut Plan: 01-fundamentale → 02-kompression → 03-inhalte → 04-speicher → 05-distribution
Aktuelle Slide-Files (01-grundlagen-text-audio.md etc.) bleiben unangetastet bis die neuen Files stehen — kein „halb migriert"-Zustand
Make-Pattern erlaubt es, die alten Files weiterzulaufen während neue gebaut werden (gleicher Build-Befehl)

Wo weitermachen

Empfohlene nächste Schritte (in dieser Reihenfolge):

Kap 4 Eröffner-Demo bauen — Datei-Reise-Pfad
Kap 5 Eröffner-Demo bauen — EXIF-Overlay
Pro Kapitel die 3–4 wichtigsten neuen Demos (z.B. JPEG-Pipeline-Stationen, USB-C-drei-Achsen, CDN-Schema)
Phase 4 starten: Slide-MD-Files pro Kapitel schreiben, dabei existierende + neue Demos einbinden
Build-Test (make build-223015b), Render-Spot-Check
Erste Dozenten-Lesart durch Kapitel 1+2, justieren
Iterativ Kap 3–5
PR auf main, Review, Merge, Deploy

Wichtige Konventionen

Keine Emojis — auch nicht als Icons in HTML-Demos
„Bit"/„Byte" sind Maßwörter — kein s-Plural („Bits"/„Bytes")
„Selbstlernen", nicht „Hands-On"
Klausur-Folien bleiben verstreut — kein Sammelblock am Kapitel-Ende
Lernziele = Vorschläge an den Dozenten, nicht gesetzte Anforderungen; Default Bloom-Level Verstehen
Render vor Layout-Aussage — chromium-headless, dann PNG mit Read-Tool inspizieren
Advance Organizer = Erkenntnisgewinn, nicht Topic-Boxen mit Pfeilen

Branch-Operationen

# Stand sehen
git log --oneline refactor/didaktik-rewrite-2026

# Auf neuesten Stand bringen
git switch refactor/didaktik-rewrite-2026
git pull origin refactor/didaktik-rewrite-2026

# Plan-Datei
cat ~/.claude/plans/1-infinity-2-neue-wild-ember.md

3.2 KiB Raw Blame History Unescape Escape

Refactor-Status · refactor/didaktik-rewrite-2026