LPA — Lehrpersonen-Assistent

Benutzerhandbuch v3.6 · Mai 2026

2026-05-10 v3.6 — DocSync-Catch-Up (Nightly Run #1): Konsolidierung aller Spec-Patches der letzten 2 Wochen, die im Handbuch v3.5 noch nicht reflektiert waren. Wichtigste Neuerungen seit v3.5:

• PRF-Aufg-Template-V5 (Real-Design nach LP-Spec 2026-05-09): 1-Zeiler-Eckdaten als kursive Subtitle, 3-Spalten-SuS-Felder (Vorname · Name · Klasse, kein Sitzplatz), Korrektur-Regeln als Heading + Fließtext (kein gelbes Box-Layout mehr), Frage-Übersicht-Spalten Frage · Thema · Max. Pt. · Zeit, Footer „PRF [Thema] [Datum] · Seite X von Y" mit Word-PAGE/NUMPAGES-Fields. V4 ins _Archive/.
• Pattern-Bibliothek REF_PRF-Aufgabenpatterns_v1.md (NEU 2026-05-09 nach n=2-PRF-Analyse KVZ Immo-BH + KZO Recht): 4 Aufgaben-Patterns × 4 Bausteine (Aufg-Snippet · Antw-Snippet · Loes-Snippet · Briefing-Folie-Spec) = 16 wiederverwendbare Spec-Snippets. Pattern A Multi-Markierung mit 2 Sub-Layouts (A.1 Bubble · A.2 R/F-Tabelle), Pattern B Zuordnung (mit +0.25/-0.25-Anti-Raten-Scoring), Pattern C Buchungssätze, Pattern D Falllösungsschema (T-O-R-S juristisch).
• Briefing-Naming: alte Variante PrfgBriefing → neue Variante Briefing (saubere v2.2-Slot-Lösung). Forward-Migration on-touch. Plus Briefing-Folien-Bibliothek: pro Aufgaben-Pattern eine Erklärungsfolie aus SuS-Perspektive für Pre-Teach vor erster Prüfung pro Klasse.
• TPL_KON_Block-Konzept_v2.docx + TPL_AB_Arbeitsblatt_v2.docx (NEU 2026-05-09): Word-Formatvorlagen-basierte Templates mit keep_with_next auf Headings + cantSplit auf Tabellen + Antwort-Boxen mit fixer Mindesthöhe. KON-Filename-Spec korrigiert (KON als Slot-4-Typ, nicht als Sub-Slot in NOT).
• TPL_KHT_Kahoot-Quiz_v1.xlsx + Cowork-Kahoot-Workflow (NEU 2026-05-10): Wrapper-Template für Kahoot-Spreadsheet-Import mit Conditional Formatting für Zeichen-Limits (95 Frage / 60 Antwort), Data Validation für Time Limit, Hinweise_LP-Sheet mit Import-Anleitung. LP-Auftrag-Pattern: „Erstelle Kahoot zu [Thema] mit X Fragen aus Lehrmittel-Kapitel Y".
• NAMING v11: Slot-Tabelle bereinigt (LM und HA gestrichen — nie verwendet) und ergänzt (LZK als eigener Dokumenttyp für formative Lernzielkontrollen, KHT mit korrigierter Definition als Kahoot-Quiz, Briefing als Variante-Wert für PRF). Bereinigte Slot-Liste: LEK/LZK/AB/PRF/NOT/PLN/PFL/KHT.
• CLAUDE.md Regel 10 (NEU 2026-05-10): User-Doku-Sync-Routine — wiederkehrender Nightly-Job alle 2-3 Tage (Mo/Mi/Fr 03:00 Zurich) scannt SKILL-Patches und generiert Befund-Bericht für LP-Apply-Go pro User-Doc-Patch.
• PRF-Auswertung-Template-V3.xlsx archiviert (Coverage durch TPL_NOT_Master_v4_2). qa_lpa_layouts.py v2 (Master-v20-Compat: 31+14 Layouts whitelisted, --whitelist-JSON-Override).

Zwischen-Stände v3.4 (28.4.) und v3.5 (9.5. morgen) bleiben in der Versionshistorie unten dokumentiert.

2026-04-28 v3.4 — Sprint-Konsolidierung: Patches 1B.5 / 1B.6 / 1B.7 / E2-bis / E4 / Erbrecht-Sprint / Phase 1 KI-Cross-Review zusammengeführt. Wichtigste Neuerungen seit v3.3:

• Methodik-Regeln 1+2 (SKILL-LESSON-PREP v16): visuelle Slide-Inspektion vor Inhalts-Aussagen · Folien nie löschen, nur via roter Diagonal-Strich + Pendenz-Box markieren
• Pattern B.11 Prüfungs-Briefing-Pattern (REF_Layout-Patterns v2): generisches 2×2-Card-Grid für Vor-Prüfungs-Briefings
• Rule 6.1 RF-Title-Convention: bei RICHTIG_FALSCH Title fix „Richtig oder Falsch?"
• Rule 9 Bildkonsistenz (Empfehlung) + Drei-Stufen-Bild-Workflow (Stufe 1 Stock / Stufe 2 AI / Stufe 3 Custom-Schema)
• Pattern-Match-Pflicht in Pass 1 + Pass-2-Art-Director-Trigger-Prompt (Excellence Pass)
• Whitespace-Soft-Rule für AUFTRAG/LOESUNG
• Animation-Strategie dokumentiert (manuell bis Master V6.0 Sommerferien)
• A/B/C-Marker-Konvention in Speaker Notes für Live-Steuerung (in B2 v5 vollständig umgesetzt)
• Take-aways als Prüfungsanker (3-Spalten Können / Typischer Fehler / Prüfungsanker)
• Lesezeichen-Folien als Steuerungsinstrument (hidden, LP-internal)
• Fehlerdetektiv-Folien als K3+K4-Sicherung (max 1 pro Block)
• § 1.5 T-Konto-Format DOCX + § 2.5 DOCX-Self-Check 10 Punkte (SKILL-PRUEFUNG v5)
• Strukturelle v2.2-Migration SKILL-NAMING v6 abgeschlossen
• Master „LOESUNG - leer"-Layout (idx=7) ergänzt — Body-PH-frei für Custom-Box-Lösungs-Folien
• AUFTRAG-Dummy-Refactor als Master-V6.0-Backlog-Item (LP-Verdikt 2026-04-28)
• Doppel-Hook V2+V1 für Immo-BH (TikTok-Clip + 80’000-Investment-Frage) mit B3-Schliessfigur in Lek 9

Bestehende v3.3-Notiz: Naming-Korrektur PR→PRF (Prüfung), PRF→PFL (Profil) gem. CLAUDE.md v3.5.

Kontext

Der Lehrpersonen-Assistent (LPA) ist ein KI-gestütztes Vorbereitungssystem für den Unterricht. Es kombiniert Claude (Anthropic) mit standardisierten Templates, Skills und Regeln — mit dem Ziel, die Zeit ausserhalb des Klassenzimmers zu minimieren und die Zeit mit Schüler:innen zu maximieren.

Zielgruppe dieses Handbuchs: der Autor selbst sowie Kolleg:innen, die das LPA adaptieren möchten. Zielfach: Einführung in Wirtschaft und Recht (EWR), Gymnasium und BMS.

Änderungen gegenüber v3.1 (24.04.2026 Abend): Teil 4 Noten-System auf tatsächlich ausgelieferten Stand TPL_NOT_Master_v4_2.xlsx aktualisiert (Handbuch-Behauptung „V3 seit 22.04. deployed" war falsch — V4.2 ist das reale Artefakt). Details: Änderungshistorie am Ende.

QuickStart — Arbeiten mit Cowork in der Praxis

Dieser Abschnitt ist bewusst am Anfang — er ist druckbar als eigenständiges One-Pager DOC_LPA-QuickStart_v1.md.

Drei Modi — wähle bewusst

Wichtig: - EDIT ist chirurgisch (nur das Genannte), REVIEW ist breit (füllt Lücken, darf Folien ergänzen). - PDF-First gilt für EDIT und REVIEW (NEU braucht keine PDF).

Die 31 Layouts auf einen Blick (Master v20 · 6 Sections)

Hinweis (2026-05-09): Master v20 hat 31 Layouts in 6 Sections. Die hier gezeigte Genre-Gruppierung ist eine didaktische Quick-Reference, nicht der vollständige Katalog. Quelle der Wahrheit: SKILL-PPTX.md § 4.11.

Meta (LP-intern): 01_Blank · 02_Buchzeichen Einstieg: 03_Titel · 04_Agenda · 05_Repetition · 06_Lernziele · 07_Fortschritt Kernteil-Input: 08_Input_1Box · 09_Input_2Box · 10_Input_Leer Speziallayouts (Visualisierung + Aktivität + Lösung): 11_Matrix_2x2 · 12_Timeline · 13_Prozess_Stufen · 14_Vergleich_VS · 15_Hub_Spoke · 16_Auftrag_1Box · 17_Auftrag_Leer · 18_Case_Study · 19_Think_Pair_Share · 20_Loesung_1Box · 21_Loesung_Leer Abschluss: 22_Diskussion · 23..26_RichtigFalsch_3..6 · 27_Zusammenfassung · 28_KeyTakeAways · 29_Exit_Ticket Prüfung: 30_Pruefung_Briefing · 31_Pruefung_GoodLuck

Detail-Beschreibung: Teil 5 (historisch · in Migration auf 31-Layout-Stand).

Die magische Formel

❌ Falsch: “Erstelle eine Folie zu Angebot und Nachfrage” ✅ Richtig: “Erstelle INPUT_2BOX-Folie: links ‘Supply’, right ‘Demand’, show difference”

Warum: Cowork erfindet sonst ein eigenes Layout. Das kostet dich Zeit.

Workflow pro Lektion (~20 Min total)

Cowork-Grundregeln

IMMER: Layout-Namen verwenden · Calibri Font · Dunkelblau #1E3A5F · Gelb=Lernziele / Grün=Lösungen / Orange=KeyTakeaways · Platzhalter statt Lehrmittel-Bilder · Max 5–6 Zeilen Text · PDF-Export vor jeder Bearbeitung

NIE: Fonts mischen · Internet-Bilder · Mehr als 6 Zeilen Text · Animationen ohne Grund · Vom Template ohne Rückfrage abweichen · Im REVIEW-Modus existierende Folien löschen

Naming — nie vergessen

SCHULE_FACH_KLASSE_TYP_THEMA_VARIANTE_v#.ext

Beispiel: KSM_EWR_Kl2a_LEK_Marktmodell_LP_v1.pptx

Teil 1 · LPA-Übersicht

1.1 Ziele

• Minimale Zeit ausserhalb Klassenzimmer, maximale Zeit mit SuS
• Standardisierte, wiederverwendbare Templates statt Ad-hoc-Arbeit pro Lektion
• Skalierbar vom Praktikum (ca. 20 Lektionen) zur Vollzeitstelle (100+ Lektionen/Jahr)
• Single Source of Truth für Stil, Didaktik und Unterlagen

1.2 Architektur

Drei Ebenen: Eingabequellen, LPA-Kernsystem, Deliverables.

        INPUT                  LPA-SYSTEM                 OUTPUT
  ┌───────────────┐      ┌───────────────────┐      ┌───────────────┐
  │ Lehrmittel    │      │ Claude Project    │      │ Lektionen     │
  │ Lehrplan      │ ───▶ │  + Memory         │ ───▶ │ Prüfungen     │
  │ Stoffplan     │      │  + Templates      │      │ Arbeitsblätter│
  │ Fachwissen    │      │  + Skills         │      │ Planung       │
  │ KSM-Vorgaben  │      │  + Regeln         │      │ Noten         │
  │ Best Practices│      │ Cowork (OneDrive) │      │ Besprechung   │
  └───────────────┘      └───────────────────┘      └───────────────┘

1.3 Zwei-Chat-Architektur

Der LPA lebt in zwei getrennten Claude-Projekten, bewusst nicht vermischt:

Warum getrennt: Das LPA-Projekt bleibt Single Source of Truth für Stil und Konzept. Inhalt pro Schule würde sonst den Kontext auffressen und Konzeptarbeit mit operativer Produktion vermischen.

1.4 Projektstatus (April 2026)

Praktikum KVZ startet 4. Mai 2026 (BMS, Erbrecht + Immobilienbuchhaltung, 20 Lektionen, Kl1w). Alle In-Arbeit-Items sind darauf ausgerichtet.

Fertig & produktiv

In Arbeit / zu testen

Offen / blockiert

1.5 Benefits

1.6 Style Guide V1

Die 31 Layouts (Master v20, gruppiert auf 13 didaktische Genre-Klassen): TITEL · LERNZIELE · AGENDA · INPUT_1BOX · INPUT_2BOX · INPUT_LEER · AUFTRAG (4 Master-Layouts) · LOESUNG (2) · RICHTIG_FALSCH (4 — je nach Aussagen-Anzahl 3..6) · DISKUSSION · ZUSAMMENFASSUNG · Key Take-Aways · FORTSCHRITT — plus Speziallayouts (Repetition, Matrix_2x2, Timeline, Prozess_Stufen, Vergleich_VS, Hub_Spoke, Case_Study, Think_Pair_Share, Exit_Ticket, Pruefung_Briefing, Pruefung_GoodLuck, Blank, Buchzeichen). Vollständiger Master-Katalog → SKILL-PPTX.md § 4.11.

Designprinzip: Layouts liefern nur Struktur und Titel. Dekorative Elemente (graue Karten, Bild-Platzhalter, Chips) immer auf Content-Ebene — maximale Flexibilität.

Farbsemantik — harte Regel (neu v3.1, P12)

Die Farben Blau / Grün / Gelb sind semantisch reserviert. Sie dürfen nur für ihren jeweiligen Zweck eingesetzt werden, sonst entsteht visuelle Mehrdeutigkeit.

Faustregel: Auftrag? → Blau. Lösung? → Grün. Lernziele/Key Take-Aways? → Gelb. Alles andere → ohne Hintergrund.

Emoji-Standard (neu v3.1, P13)

• Titel-Regel: Keine Emojis in Slide-Titeln. Layout + Klartext-Prefix (Auftrag:, Lösung:, Lernziele, Diskussion:, Richtig oder Falsch?, Key Take-Aways, Zusammenfassung) tragen die Semantik.
• Body-Whitelist (Font-safe): ⏰ Zeit, ✓ Check, ✅ Pflicht-Check, ⚠ Warnung, 🏠 Thema-Icon.
• Body-Blacklist → Text-Fallback: 📷 → [Bild: …], 📄 → [OneNote] / [SKV Kap. X, S. Y], 👥 → [Partnerarbeit] / [Gruppe]. Grund: LibreOffice-Tofu-Risiko, kein Info-Gewinn.

1.7 Didaktische Defaults (ins System eingebaut)

• Mindestens 40 % SuS-aktiv pro Lektion
• Maximal 10 Minuten LP-Input am Stück
• Mindestens eine Transfer-Aufgabe (Bloom K3+) pro Lektion
• Notenformel: geknickt linear, Note 4.0 bei 60 % der Punkte
• MC-Scoring: 4/4 voll · 3/4 halb · ≤2/4 null
• Rechts-Validierung gegen fedlex.admin.ch
• Keine Hausaufgaben — Differenzierung über Bonusfragen auf Arbeitsblatt
• Exit-Ticket-Bezug = Block (nicht einzelne Lektion) (ab Patch B1–B3, siehe Teil 3.6)
• Case-Arbeit: Rotation statt Teilung (neu v3.1, P8) — bei mehreren Mini-Cases bearbeiten alle Gruppen alle Cases, nur in unterschiedlicher Reihenfolge. Nicht jede Gruppe einen eigenen Case
• Highlight-Scope-Regel (neu v3.1, P9) — bei methodischen Highlight-Wünschen prüft Cowork erst das Zeitbudget; bei >90 % Auslastung nur Highlights vorschlagen, die ≤10 Min bestehende Phasen ersetzen (keine Additions)

1.8 Multi-AI Review-Workflow

Kein Tool kann alles. Der LPA nutzt bewusst mehrere parallel:

Review-Routine vor jedem Versionssprung: Claude produziert → Gemini reviewt Didaktik → ChatGPT reviewt Struktur → Perplexity faktencheckt → Claude konsolidiert zu v+1.

1.9 Besonderheiten

• Chat-Trennung: LPA-Projekt (Konzept) vs. Fach-Chat pro Schule (Inhalt)
• Projekt-Regeln: immer Rückfragen, kein Go ohne Klärung, Versionierung v+1
• Voice-Input per Apple Dictation (iPhone im Auto) für Planungsgespräche
• Multi-AI-Cross-Review vor jedem Versionssprung der Templates
• Ökosystem: Apple Hardware, Microsoft Office, OneDrive-Sync
• Strikte Copyright-Hygiene: Lehrmittelbilder nur als Platzhalter
• „Setze auf" ist gegen Cowork verboten — immer „ergänze" + explizit Backup anfordern

1.10 Rollen-Architektur LPA-Chat ↔︎ Cowork (neu in v2)

Der LPA ist ein Mehr-System-Setup. Jedes System hat klar definierte Verantwortung:

Kern-Prinzip: Cowork liest md-Instructions, ändert sie aber nie selbst. Verbesserungsvorschläge liefert Cowork als Patch-Brief an den LPA-Chat zurück. Der LPA-Chat konsolidiert und produziert neue md-Files, die Marc manuell ins Lehre/-Root überträgt.

Details: siehe Teil 3.

Teil 2 · Naming & Storage Convention v1

Regeln für die Benennung und Ablage aller Deliverables. Einheitlich über alle Schulen und Schuljahre hinweg — damit Material langfristig wiederverwendbar bleibt und beim Schulwechsel keine Umbenennung nötig ist.

2.1 Namensformel

SCHULE_FACH_KLASSE_TYP_THEMA_VARIANTE_v#.ext

Universalregeln:

• Feld-Trenner: Unterstrich _
• Keine Leerzeichen, Umlaute, Sonderzeichen (volle OneDrive/Mac/Windows-Kompatibilität)
• Mehrwortige Themen in Kebab-Case: Angebot-Nachfrage, Funktionen-des-Geldes
• VARIANTE nur bei Dokumenten mit mehreren parallelen Versionen

2.2 Codes · Schule

Bei neuen Schulen: 3-Buchstaben-Code wählen, in dieser Tabelle ergänzen, Handbuch-Version hochziehen.

2.3 Codes · Fach & Klasse

FACH ist optional für klassen-scoped Files (PLN-Jahr, NOT), wenn mehrere Fächer parallel in derselben Klasse laufen — dann wird FACH weggelassen und es resultiert z.B. KVZ_Kl1w_PLN-Jahr_v1.xlsx.

Klassen-Code (immer generisch, mit Kl-Präfix):

Wichtig: Auch im Praktikum (KZO, KVZ) gilt die generische Bezeichnung — nicht die schulinterne (M3A, BM1b etc.). Grund: Konsistenz über Schulen hinweg, Gewöhnung an das System.

2.4 Codes · Typ (Dokumentart) (erweitert in v2)

DOC vs. TPL: TPL ist für maschinenlesbare Templates, die in Produktion eingesetzt werden. DOC ist für menschenlesbare Referenz-Dokumentation (dieses Handbuch, Changelogs, Übergabe-Dokumente).

2.5 Codes · Variante

Bei Dokumenten ohne mehrere Varianten (z.B. AB, NOT, PLN-Jahr, DOC) wird der Slot weggelassen — nicht mit ALL oder Master gefüllt.

2.6 Prüfungen bestehen aus 5 Files

Jede Prüfung wird als Set von fünf Dokumenten abgelegt. Schul-/Fach-/Klassen-/Thema-Teil ist identisch, nur VARIANTE unterscheidet. Dadurch sortieren sich alle Prüfungsdokumente automatisch nebeneinander.

2.7 Ordnerstruktur (OneDrive) (aktualisiert in v2)

Lehre/                                  ← Root (fix)
├── CLAUDE.md                           ← Cowork Master-Index (schlank, ab 22.04.2026)
├── DOC_LPA-Benutzerhandbuch_v2.md      ← dieses Dokument (md)
├── DOC_LPA-Benutzerhandbuch_v2.pdf     ← dieses Dokument (pdf, Übergabe-Format)
│
├── _Templates/                       ← schulübergreifend, zentral
│   ├── TPL_LEK_Master_v20.pptx          ← Lektions-Master (31 Layouts, ab 08.05.2026)
│   ├── TPL_AB_Master_v1.docx
│   ├── TPL_PR_Master_v1.docx
│   ├── TPL_NOT_Master_v4_2.xlsx        ← Noten-Master V4.2 (ab 22.04.2026)
│   ├── LPA-STYLE-CARD.md               ← Style-Referenz für externe Tools
│   └── _Archive/                       ← alte Template-Versionen
│
├── _Cowork-Instructions/               ← Cowork-Skill-Dateien (nur md)
│   ├── SKILL-NAMING.md
│   ├── SKILL-PPTX.md
│   ├── SKILL-STYLE.md
│   ├── SKILL-LESSON-PREP.md
│   ├── SKILL-PLANNING.md
│   ├── SKILL-PRUEFUNG.md
│   ├── SKILL-QA.md
│   ├── scripts/                        ← QA-Helper-Skripte (z.B. qa_lpa_layouts.py)
│   ├── _Archive/                       ← alte Skill-Versionen
│   └── _Backup_YYYY-MM-DD_<Beschr.>/   ← Bulk-Patch-Backups (siehe Teil 3.5)
│
├── 01_KSM/
│   └── EWR_Kl2a_2026-27/               ← Fach_Klasse_Schuljahr
│       ├── 00_Planung/                 ← semesterübergreifend
│       │   ├── KSM_EWR_Kl2a_PLN-Jahr_v1.xlsx
│       │   └── KSM_EWR_Kl2a_PLN-Reihe_Marktmodell_v1.docx
│       ├── 01_HS26/
│       │   ├── Lektionen/
│       │   ├── Pruefungen/
│       │   └── Noten/
│       └── 02_FS27/
│           └── ...
│
├── 02_KZO/                             ← Praktikum, identisch strukturiert
│   └── ...
│
├── 03_KVZ/
│   └── KVZ_WR_Kl3a_NOT_v1.xlsx         ← Beispiel: Praktikum-Noten
│
└── 99_Archiv/                          ← abgeschlossene Schuljahre

Prinzipien:

• Root-Ordner ist Lehre/
• Zahlenpräfixe (00_, 01_) erzwingen Reihenfolge statt alphabetischer Sortierung
• Semester (FS/HS) leben nur im Ordnernamen, nie im Dateinamen
• Templates existieren einmal zentral in _Templates/ — Kopien pro Schule sind verboten
• Praktika (KZO, KVZ) sind identisch strukturiert — sorgt für Gewöhnung
• Cowork-Skills liegen in _Cowork-Instructions/ parallel zu den Schulordnern
• CLAUDE.md (nicht INSTRUCTIONS.md) ist der Master-Index im Lehre-Root
• _Archive/-Ordner: nur für echte Obsoleszenz (Skill gelöscht/fusioniert). Backups bei Bulk-Patches gehen in separate _Backup_…/-Ordner (Teil 3.5)

2.8 Beispiele

2.9 Kurzanleitung · neue Datei anlegen

1. Schul-Code bestimmen (Abschnitt 2.2). Für Templates: TPL. Für Dokumentation: DOC.
2. Fach und Klasse anhängen, z.B. EWR_Kl2a. Bei TPL/DOC entfällt dieser Teil.
3. Typ wählen (Abschnitt 2.4).
4. Thema in Kebab-Case eintragen.
5. Variante nur wenn nötig (Abschnitt 2.5).
6. Version: bei Neuanlage v1, bei jeder Änderung hochzählen.
7. Ablage: in den richtigen Unterordner gemäss Abschnitt 2.7.

2.10 Harte Regeln

1. Nie Umlaute, Leerzeichen oder Sonderzeichen im Dateinamen
2. Nie Datum im Dateinamen — nur Versionsnummer
3. Nie Semester im Dateinamen — nur im Ordner
4. Nie Templates pro Schule kopieren — immer zentral
5. Prüfungen immer als vollständiges 5-File-Set ablegen
6. Alte Versionen nicht löschen — neue als vX+1 daneben
7. Klassen-Codes immer generisch (Kl2a), auch im Praktikum
8. Root-Ordner heisst Lehre/, nichts anderes

2.11 Integration in Claude-Projekt & Cowork (aktualisiert in v2)

Claude-Projekt (Memory): Convention v1 ist in der Projekt-Memory des LPA-Projekts verankert und wird bei allen zukünftigen Dateinamen automatisch angewendet.

Cowork: Die Convention ist als Skill-Datei SKILL-NAMING.md in Lehre/_Cowork-Instructions/ abgelegt. Der Master-Index CLAUDE.md im Root Lehre/ verweist auf alle Skills. Cowork lädt diese beim Session-Start automatisch.

Weitergabe an Kolleg:innen: Die PDF-Version dieses Handbuchs (DOC_LPA-Benutzerhandbuch_v2.pdf) ist das Übergabe-Format.

Teil 3 · Cowork-System & md-Dateien-Strategie (neu in v2)

Dieser Teil beschreibt, wie der LPA technisch funktioniert: welche md-Dateien es gibt, wer sie schreibt, wie Updates fliessen.

3.1 Die drei Sorten md-Dateien

Im LPA existieren drei klar unterscheidbare Typen von Markdown-Dateien mit unterschiedlichen Lesern:

3.2 Das 4-Schichten-Modell

Die md-Dateien sind in 4 Schichten gegliedert, jede mit klar abgegrenzter Verantwortung:

Warum getrennt: Cowork soll präzise Regeln befolgen, nicht ganze Konzepte verstehen. Menschen brauchen Kontext und Übersicht, nicht Regel-Paragraphen. Die Schichtung trennt beides sauber.

3.3 Skill-Katalog (Stand 22.04.2026)

Nach dem Big-Bang vom 22.04.2026 hat Cowork 7 Skill-Files:

Master-Index CLAUDE.md verweist auf alle 7 Skills und enthält die Rollen-Architektur (LPA-Chat = SSoT für md, Cowork = SSoT für Produktions-Files).

3.4 Patch-Workflow (Updates an md-Files)

Wie kommen Regeländerungen ins System? Klarer Workflow in 6 Schritten:

Wichtig: Cowork darf Updates vorschlagen, aber nie selbst in md-Files schreiben. Der LPA-Chat ist die einzige Quelle für md-Änderungen.

3.5 Backup-Konvention für md-Patches

Bei grösseren Patches (Bulk-Änderungen über mehrere Skills, Big-Bang-artige Umstellungen):

• Neuer Ordner: Lehre/_Cowork-Instructions/_Backup_YYYY-MM-DD_<Beschreibung>/
• Enthält:
  • alle betroffenen md-Files in ihrem Zustand vor dem Patch
  • LPA-Patch-Brief_YYYY-MM-DD.md (Dokumentation der Änderungen)
  • Changelog_YYYY-MM-DD.md (Detail-Diff pro Skill-File)

Bei kleinen Patches (einzelner Skill, kleine Versionsbump):

• alte Version ins reguläre _Archive/ verschieben (z.B. _Archive/SKILL-LESSON-PREP_v3_pre-block-modus.md)
• keine eigenständige Backup-Ordner-Struktur nötig

Unterschied _Archive/ vs. _Backup_.../:

Regel: Das Einchecken der Backup-Gruppe ist Teil jedes Bulk-Patches. Ohne Backup kein Deployment.

3.6 Block-Modus (Patch B1–B3, in Produktion) (relevant ab SKILL-LESSON-PREP v3.1)

Ursprüngliche Annahme: Bezugseinheit für Lektionsplanung = einzelne Lektion (45 Min.). Neue Realität: Lektionen werden oft in Blöcken über mehrere Tage unterrichtet.

Deployment: folgt nach Task 1 (Priorität 1 in 2-Wochen-Plan).

3.7 DSP-Sheet-Standards (neu v3.1, P2 + P3 + P4)

DSP-Sheets (Lektions-Dispositionen als Tabs im PLN-Jahr-File) folgen zwei neuen verbindlichen Konventionen.

Farbkodierung Zeilen (analog Folien-Kategorie)

Zeilenfarbe = Phase-Kategorie. Konsistent mit PPT-Farbschema.

Buffer-Aktivitäten müssen explizit mit [Buffer] im Phase-Namen markiert werden — triggert die 🟠 Buffer-Farbe.

Material-Referenzen — Fn-Notation

Um Folien von Lehrmittelseiten klar zu trennen:

Regel: Fn = Folie · S. n = Seite · Sn (ohne Punkt) wird automatisch in Fn konvertiert (Legacy-Cleanup).

3.8 AI-Bild-Integration via Picture-Placeholder (neu v3.1, P5)

Pattern für stabile Bild-Integration (löst „kaputte Placeholder"-Regression von 23.04.):

1. Cowork legt Picture-Placeholder mit shape.name = 'pic_img_<beschreibung>' an (z.B. pic_img_titel_waage).
2. die LP ersetzt im AI-Tool (ChatGPT/DALL-E) das Asset, speichert im gleichen Namen unter <Modul>/_Assets/.
3. Cowork-Build erkennt den Placeholder, entfernt ihn via XML und fügt add_picture() mit identischen Koordinaten ein. Neues Bild heisst img_<folienummer>_<beschreibung>.

Asset-Konvention: Verzeichnis _Assets/, Dateiname img_<thema>.png, Aspect 16:9 bevorzugt, PNG/RGB.

Frozen-Grafiken-Prinzip (CLAUDE.md Regel 4): Integrierte Bilder bleiben unverändert. Cowork darf weder löschen, verschieben, skalieren noch ersetzen außer auf explizite Aufforderung.

3.9 Anti-Pattern (Lessons learned)

Teil 4 · Noten-System (NOT V4.2) (aktualisiert in v3.2)

Das Noten-Excel ist seit 22.04.2026 in Version V4.2 ausgeliefert (7’833 Formeln, 0 Fehler). Vollständiger Rebuild gegenüber V2 (geerbt von KZO Wetzikon). Die in Handbuch v2/v3 dokumentierte „V3" hat nie real als eigenständige Auslieferung existiert — die V2→V4-Sprünge liefen inkrementell zwischen 19. und 22.04.2026 im Cowork. Autoritative Detail-Dokumentation: CHANGELOG_NOT_V4-1-V4-2.md und das README-Sheet im Template selbst.

4.1 Architektur — 7 Sheets

4.2 Punkte-Flow

SuS (Klassenliste)   Prüfungen (Metadaten, Status)
        │                    │
        ▼                    ▼
       ┌─────────────────────────┐
       │  P01, P02, ... (Einzel-Sheets) │   ← Punkte pro Aufgabe eintragen
       │  Status-Code ab/di/nh in Spalte C  │   (V4.2: blockiert ganze Prüfung)
       └─────────────────────────┘
                   │
                   ▼
       ┌─────────────────────────┐
       │  Noten (berechnet)      │   ← 5 Aggregate: HS-⌀, FS-⌀,
       │                         │     Jahr (Sem), Jahr (Prüf), Zeugnis
       └─────────────────────────┘
                   │
                   ▼
       ┌─────────────────────────┐
       │  Zeugnis (druckbar)     │
       └─────────────────────────┘

4.3 Kern-Prinzipien V4.2

• Dynamische Excel-Tabellen → keine harten 25-SuS- oder 8-Prüfungs-Grenzen
• Benannte Bereiche → lesbare Formeln statt B$9*$E$5
• Semester-Split HS/FS mit zwei Jahresnoten (neu V4.2):
  • Jahr (Sem) = (HS-⌀ + FS-⌀) / 2 — Semester-gewichtet, Zeugnis-Default (Schweizer Schulrealität)
  • Jahr (Prüf) = gewichteter Schnitt aller Prüfungen — prüfungs-gewichtet, nebenstehend
  • Unterschied relevant bei stark ungleicher Prüfungs-Verteilung HS vs. FS
• Status-Codes pro Prüfung (V4.2 explizit): ab absent · di dispensiert · nh nachgeholt in Spalte C eines P-Sheets blockiert ganze Prüfung → Total leer → Note leer → kein Beitrag zu Aggregaten
• Status-Spalte I im Prüfungen-Sheet (V4.2): automatische Konsistenz-Anzeige — ✅ Aufgaben OK · ⚠ Aufg-Max ≠ X · ⚠ keine Aufgaben · —
• Bonus-Cap auf 6.0 via MIN(MaxNote, ...) — Bonus-Aufgaben zählen nicht in Max-Pkt-Summe
• Rundung „gerundet rein": Einzelnoten werden gerundet, bevor sie in Aggregate einfliessen → Eltern-Transparenz
• Keine Makros, keine Array-IFs → OneDrive-Web-kompatibel
• 7’833 Formeln, 0 Fehler im Funktionstest

4.4 Status (Stand 24.04.2026)

4.5 Offen für V4.3 (nur bei Bedarf)

• Schul-Regelparameter im Config (Mindest-LN/Sem., Nachhol-Logik, Bonus-Verhalten) — aktuell keine harte KSM/KVZ-Regel bekannt
• Performance-Test in Excel Web mit realer Last (40 × 15 × 20)
• Bewusst nicht umgesetzt in V4.2: P-Sheets-Schutz (Collapse-Funktion hat Priorität), Status-Code als separate Spalte (würde Layout brechen)

Teil 5 · Layout-Regeln & Cowork-Workflow (neu in v3)

Dieser Teil dokumentiert alle 13 Layouts detailliert und legt fest, wie Cowork mit PowerPoint-Dateien arbeitet — inklusive der neuen PDF-First-Regel.

5.1 Alle 13 Layouts im Detail

Struktur-Layouts (am Lektions-Anfang)

Input-Layouts (LP erklärt, max 10 Min)

SuS-Arbeit (min. 40% pro Lektion)

Aktivierung & Diskussion

Abschluss-Layouts

5.1.1 Pflicht-Folien pro Block (neu v3.1)

Jede Block-LP-PPT enthält mindestens drei Pflicht-Elemente:

Hinweis Template-Refresh: AGENDA- und LESEZEICHEN-Layouts sind im TPL_LEK_Master_v4 noch nicht als eigene Master-Layouts definiert — Cowork baut sie aktuell als Blank-Folien mit manuellem Content. Formale Master-Layout-Definition: post-Praktikum.

5.1.2 Slide Density — harte Grenzen statt weicher Zeilenregel (geändert v3.1)

Die frühere Regel „max. 5–6 Zeilen Text pro Folie" ist ersetzt durch harte Wortgrenzen pro Layout (siehe SKILL-PPTX.md § 4.5). Grund: Wortzahlen sind layoutspezifisch präziser und maschinell prüfbar.

Quick-Referenz (authoritativer Wert im SKILL):

Bei Überschreitung → Folie splitten oder Grafik statt Text einsetzen (SKILL-PPTX.md § 4.6).

5.2 Die drei Cowork-Modi

NEU-Modus

Einsatz: Du baust eine neue Präsentation von Grund auf.

Anweisung an Cowork: > “Erstelle neue Lektionspräsentation mit folgenden Layouts in dieser Reihenfolge: TITEL → LERNZIELE → AGENDA → INPUT_2BOX (Supply vs Demand) → AUFTRAG (Market-Analyse-Case) → LOESUNG → RICHTIG_FALSCH (3 Fragen) → ZUSAMMENFASSUNG → Key Take-Aways”

Cowork-Verhalten: - Baut Folien in genannter Reihenfolge von Grund auf - Jede Folie nutzt explizit genanntes Layout aus Template - Wenn Layout-Name fehlt: Cowork schlägt passendstes vor und fragt kurz nach - Keine PDF-First-Regel (es existiert noch keine PPT)

EDIT-Modus

Einsatz: Du änderst gezielt einzelne Folien in einer bestehenden Präsentation.

Anweisung an Cowork: > “Edit this presentation: ersetze Folie 3 mit einem INPUT_2BOX-Layout (Thema: Konjunktur vs. Rezession), und füge nach Folie 5 eine RICHTIG_FALSCH-Folie mit 2 Aussagen ein. Alle anderen Folien unverändert lassen.”

Cowork-Verhalten: - Schritt 1: PDF der aktuellen PowerPoint erzeugen (PDF-First) - Schritt 2: PDF lesen (Screenshots, Gesamtkontext) - Schritt 3: NUR die explizit genannten Folien ändern/hinzufügen - Schritt 4: Rest der Präsentation unangetastet lassen - Schritt 5: Änderungsprotokoll liefern

Was EDIT DARF: - Genau die genannten Folien ändern - An genau den genannten Stellen neue Folien einfügen - Layout-Fehler auf den genannten Folien korrigieren

Was EDIT NIE TUT: - Andere Folien anfassen als die genannten - Eigenmächtig neue Folien einfügen an Stellen, die nicht genannt wurden - “Proaktive” Verbesserungen an nicht-genannten Folien

REVIEW-Modus

Einsatz: Cowork prüft die ganze Präsentation, verbessert sie + füllt Lücken.

Anweisung an Cowork: > “Review diese Präsentation: prüfe Inhalt-Qualität, wende Template-Layouts an wo sie fehlen, fülle Lücken, schlage Verbesserungen vor”

Cowork-Verhalten: - Schritt 1: PDF der aktuellen PowerPoint erzeugen (PDF-First, siehe 5.3) - Schritt 2: PDF vollständig lesen (inkl. Screenshots) - Schritt 3: Folien verbessern (Inhalt, Struktur, Layout-Anwendung) - Schritt 4: Fehlende Folien hinzufügen (z.B. LERNZIELE, ZUSAMMENFASSUNG) - Schritt 5: Verbesserungsvorschläge am Ende als Textbericht (nicht automatisch umsetzen)

Was REVIEW DARF: - Bestehende Folien korrigieren - Fehlende Layouts hinzufügen - Lücken füllen (z.B. Übergang zwischen Konzepten) - Nicht-Template-Layouts auf Template migrieren (mit Rückfrage)

Was REVIEW NIE TUT: - Bestehende Folien löschen ohne explizite Anweisung - Folien radikal umschreiben ohne Rückfrage - Style oder Farben willkürlich ändern

Modus-Entscheidungshilfe

5.3 PDF-First-Regel (neu v3)

Gilt für: EDIT-Modus und REVIEW-Modus. Im NEU-Modus nicht anwendbar (keine PPT existiert).

Problem: Cowork kann Screenshots in PowerPoint-Dateien nicht direkt lesen. Das blockiert EDIT- und REVIEW-Workflows mit visuellem Inhalt.

Lösung: Cowork exportiert IMMER zuerst eine PDF der aktuellen PowerPoint, liest diese (inkl. Screenshots), und bearbeitet dann die PowerPoint.

Sequenz bei EDIT- und REVIEW-Arbeit:

1. Export: KSM_EWR_Kl2a_LEK_Marktmodell_LP_v1.pptx → KSM_EWR_Kl2a_LEK_Marktmodell_LP_v1.pdf (gleicher Ordner)
2. Read: PDF vollständig gelesen, Screenshots visuell erfasst
3. Edit: PowerPoint wird bearbeitet mit vollem Kontext
4. Save: PowerPoint wird gespeichert, PDF bleibt als Referenz (wird beim nächsten Workflow überschrieben)

Ausnahme: Nur wenn User explizit sagt “skip PDF export, no images in presentation” — sonst IMMER.

5.4 Die magische Formel

Regel Nummer eins beim Arbeiten mit Cowork: Immer den Layout-Namen nennen.

❌ Falsch: “Erstelle eine Folie zu Angebot und Nachfrage”

✅ Richtig: “Erstelle INPUT_2BOX-Folie: links ‘Supply’, right side ‘Demand’, show difference with bullet points”

Warum: Cowork erfindet sonst ein eigenes Layout. Das bricht Template-Konsistenz und kostet dich Zeit beim Nacharbeiten.

5.5 Cowork-Grundregeln

IMMER ✅

• Layout aus Template-Katalog wählen (eines der 13)
• Calibri / Calibri Light Font
• Dunkelblau #1E3A5F für Struktur
• Blau = Auftrag · Grün = Lösung · Gelb = Lernziele/Key Take-Aways — sonst weiss/transparent (Farbsemantik-Regel, P12)
• Bild-Platzhalter statt echte Bilder (Copyright!)
• Slide-Density einhalten (Wortgrenzen pro Layout, siehe § 5.1.2 + SKILL-PPTX § 4.5)
• Klartext-Prefix in Titeln, keine Emojis im Titel (P13)
• Speaker Notes mit Timing und Didaktik-Hint
• PDF-Export vor jeder Bearbeitung (EDIT- und REVIEW-Modus)
• Pflicht-Folien: Titelblatt zuerst, AGENDA bei 1. Block, Lesezeichen hidden am Ende (§ 5.1.1)

NIE ❌

• Fonts mischen (z.B. Calibri + Arial)
• Internet-Bilder, Clipart, Lehrmittel-Scans
• Slide-Density-Grenzen überschreiten (Folie splitten statt stopfen)
• Animationen ohne didaktischen Grund
• Vom Template-Layout abweichen ohne Rückfrage
• Existierende Folien löschen (REVIEW-Modus)
• Blau/Grün/Gelb für Inhalte, die kein Auftrag/Lösung/Lernziel sind (visuelle Mehrdeutigkeit)
• Emoji-Blacklist (📷📄👥) im Folientext — Text-Fallback verwenden

5.6 Fehler-Troubleshooting

Teil 6 · Roadmap & Ausblick

6.1 Aktueller 2-Wochen-Plan (beschlossen 23.04.2026)

6.2 Nach 2-Wochen-Plan

6.3 Eingefrorener Backlog (nicht jetzt, aber dokumentiert)

• Claude Design als Prototyp-Tool für Visualisierungen (interaktive HTML, Poster, One-Pager) — nicht für regulären Unterricht
• Cowork-Skill-ZIP-Upload auf Basis SKILL-NAMING.md
• Exam-Review PPT + MC-Lösungsdokument mit hervorgehobenen Antworten
• Noten-Excel Weiterentwicklung über V3.1 hinaus

6.4 Lessons Learned / Prinzipien

§ Häufige Fallen — empirisch beobachtet (NEU 2026-05-03)

Diese Sektion fasst Beobachtungen aus den ersten 12 Tagen LPA-Betrieb zusammen. Sie ist Coaching-Material — keine Wertung, sondern Hinweise, wo das System Reibung produziert und wie man es vermeidet.

Vollständiger Audit: LPA/Nightly/Output/2026-05-04/2026-05-03_lpa-coaching-cheatsheet/Phase1_Verhaltens-Audit_2026-05-03.md. 1-Seiten-Cheatsheet: LPA-Cheatsheet_v1.md im selben Output-Ordner.

Falle 1 · Iterations-Verschwendung am gleichen Tag

Was passiert: Du formulierst einen Standard, schreibst Patch-Brief, merkst beim Sichten dass eine Ecke fehlt, schreibst v2, v2-FINAL. Cowork nimmt nichts auf, weil immer ein Nachfolger kommt.

Beleg: 2026-04-26 VisualQualityFix v1 → v2 FarbenContent → v2 FINAL (3 Briefs gleicher Tag, 38 kB redundant, alle erst nachträglich archiviert).

Antidot: Standard erst final ausformulieren (auch wenn das mehr Mut zur ersten Iteration kostet), dann einmal spec’en.

Falle 2 · Big-Bang-Tag mit >5 Patch-Briefs

Was passiert: Sammelphase ohne Submit, dann Mass-Submit. Cowork arbeitet gehorsam ab, aber Cascade-Bezüge zwischen Patches gehen unter — was Brief 3 ändert, kollidiert mit Brief 9.

Beleg: 2026-04-27 hatte 14 Patch-Briefs (44 % aller Briefs des Beobachtungs-Zeitraums an einem Tag).

Antidot: Weiches Limit 5 Briefs/Tag. Bei mehr → Bündelung in Patchday-Spec. Cowork kann Sprint-Risk-Eskalation ergänzen.

Falle 3 · Stuck-Item-Akkumulation

Was passiert: Cowork-Session wird abgebrochen mit Items auf in_progress. Beim nächsten Run rührt Cowork sie nicht an (Spec triggert nur auf open). Items verstauben.

Beleg: 2 Queue-Items vom 2026-04-29 standen 4 Tage auf in_progress, erst durch Briefing 2026-05-03 erkannt.

Antidot: Daily-30-Sek-Check nach Cowork-Session: alle Items auf done / failed / skipped quittieren oder zurück auf open.

Falle 4 · Hygiene-Verschuldung in _Patch-Briefs/

Was passiert: Brief wird applied, Diff-Report geschrieben — aber Original-Brief bleibt im Hauptordner. Nach 6 Tagen sind 37 erledigte Files im Hauptordner und Briefing-Scan dauert länger.

Beleg: Sweep am 2026-05-03 verschob 37 Files ins _Archive/, zurück blieben 11 echt offene.

Antidot: Diff-Report-Schreib-Routine erweitern um Auto-Archivierung des Original-Briefs. Bis zum Tooling-Patch: die LP archiviert manuell nach LP-Verifikation.

Falle 5 · Spec-Tiefe-Defizit (Cascade-Unterschätzung)

Was passiert: Patch-Brief listet 3 Slides als Scope. Pre-Patch-Scan zeigt 5 Slides + Cross-References auf Vorgänger-Block. Ohne Scan würde Patch zu didaktischer Inkonsistenz führen.

Beleg: 2026-05-03 B3-Beträge-Anpassung-Brief (CANCELED nach Scan). Brief listete F6/F13/F22 — real 5 Slides + B2-Lek-6-Cross-Reference. EK-Rendite wäre von 5,56 % auf 17,8 % gesprungen.

Antidot: Pre-Patch-Scan ist Pflicht vor Brief-Submit bei jedem Patch mit File-Eingriff. die LP oder Cowork führt grep/Slide-Scan nach allen patch-relevanten Strings durch und ergänzt den Scope-Block.

Cross-Referenzen: - Cheatsheet 1-Seiter: LPA/Nightly/Output/2026-05-04/2026-05-03_lpa-coaching-cheatsheet/LPA-Cheatsheet_v1.md - Phase-1-Audit (Daten): LPA/Nightly/Output/2026-05-04/2026-05-03_lpa-coaching-cheatsheet/Phase1_Verhaltens-Audit_2026-05-03.md - CLAUDE.md § Hard-Trigger / Soft-Trigger (allgemeine Eskalations-Regeln) - SKILL-QA.md § Propagation-Trigger (Cascade-Pflicht)

Änderungshistorie