update

templates/Format/Baustein.md

@@ -0,0 +1,104 @@
+```
+BAUSTEIN-CARD-STIL (HTML+CSS, in Browser anzeigbar)
+
+ZWECK
+- Einzelner Baustein als kompakte Card-Darstellung
+- Schnelles Nachschlagen einzelner Konzepte
+- Card ist Teil einer größeren Baustein-Sammlung
+- Nicht zum Lernen, sondern zum Wiedererkennen
+- Pro Card genau 1 Baustein
+
+FORMAT
+- HTML mit eingebettetem CSS
+- Im Browser anzeigbar (kein PDF-Output)
+- Card auf hellgrauem Hintergrund zentriert
+- Max-width 1000px, padding 28px 36px
+- Border-radius 12px, dezenter Schatten
+- Page-Hintergrund #f0f0f5
+
+STRUKTUR — STRIKT NUR DIESE 4 ELEMENTE
+1. Titel (h1, fett, ohne Label, ohne Logo)
+2. Beschreibung (ein knapper Satz)
+3. Zweck (kursiv, grau, ein knapper Satz)
+4. Code-Beispiele (untereinander, mit Mini-Label oben)
+
+KEIN Logo, KEIN "Baustein"-Label, KEIN Sprach-Tag, KEINE Sektion-Überschriften ("Beschreibung", "Zweck", "Relevante Beispiele"), KEINE Info-Blöcke, KEINE Warn/Tip/Note-Boxen, KEINE Meta-Informationen, KEINE Trennlinien zwischen Sektionen.
+
+TYPOGRAFIE
+- Body: -apple-system, "Segoe UI", sans-serif, 14px, line-height 1.5
+- Titel h1: 28px, font-weight 800, letter-spacing -0.5px, line-height 1.1
+- Beschreibung: 14px, line-height 1.55
+- Zweck: 14px, italic, color #5a6470
+- Code: "SF Mono", Consolas, monospace, 12px, line-height 1.5
+- Code-Label: 10px, uppercase, letter-spacing 1px
+
+FARBEN
+- Card-Hintergrund: #ffffff
+- Page-Hintergrund: #f0f0f5
+- Text: #1a1a1a
+- Muted (Zweck): #5a6470
+- Code-Hintergrund: #1e2a3a
+- Code-Text: #e6e6e6
+- Syntax-Highlighting:
+  - Keywords (.k): #ff79c6 (pink)
+  - Variablen (.v): #ffb86c (orange)
+  - Strings (.s): #f1c40f (gelb)
+  - Funktionen (.f): #50fa7b (grün)
+  - Typen (.t): #8be9fd (cyan)
+  - Kommentare (.c): #6b8aae italic
+- Label-Farbe in Code: #8be9fd (cyan)
+
+INHALTLICHE PRINZIPIEN
+- Titel: nur der Baustein-Name, kein Präfix, keine Variante
+- Beschreibung: 1 Satz, was es macht (mechanisch, neutral)
+- Zweck: 1 Satz, wofür man es nutzt (Anwendungsfall)
+- Beide Sätze knapp wie möglich, jedes überflüssige Wort raus
+- Pro Beispiel ein knappes Label oben (2-4 Wörter, uppercase)
+
+LAYOUT-DETAILS
+- Header und Body keine separaten Sektionen, alles in einer Card
+- Titel zuerst, darunter direkt Beschreibung, darunter Zweck (mit margin-bottom)
+- Margin-bottom Beschreibung: 6px (eng zum Zweck)
+- Margin-bottom Zweck: 22px (Abstand zu Code)
+- Margin-bottom Titel: 14px
+- Code-Blöcke untereinander, gap 14px
+- Code-Block padding: 14px 16px, border-radius 8px
+
+CODE-BEISPIELE
+- So viele wie nötig, so wenige wie möglich
+- Untereinander gestapelt (grid-template-columns: 1fr)
+- Jedes Beispiel zeigt eine sinnvolle Variante / Use-Case
+- Sehr kurz: ideal 3-6 Zeilen, max 8 Zeilen
+- Mit kurzem Label was die Variante zeigt
+- Syntax-Highlighting durch span-Klassen (.k, .v, .s, etc.)
+- Triviale Bausteine: 1-2 Beispiele
+- Komplexere Bausteine: 4-6 Beispiele
+- Anzahl ergibt sich aus dem Inhalt, nicht aus Vorgabe
+
+VERMEIDEN
+- Lange Erklärungstexte
+- Mehrere Sätze für Beschreibung oder Zweck
+- Performance-Tipps, Trade-Offs, Edge Cases
+- Verwandte Bausteine, Varianten, Anti-Patterns
+- Tabellen, Listen, Aufzählungen
+- Icons, Emojis, Symbole
+- Komplexe Code-Beispiele (über 8 Zeilen)
+
+THEMENSPEZIFISCHE ANPASSUNGEN
+- Bei anderen Sprachen: Syntax-Highlighting-Klassen anpassen
+- Titel-Größe und Spacing bleiben gleich
+- Card-Layout bleibt gleich
+- Inhalte (Beschreibung, Zweck, Beispiele) sprachspezifisch
+
+GENERIERUNG MIT FEEDBACK-LOOP
+1. HTML schreiben
+2. In Browser anzeigen (Playwright-Screenshot oder direkt)
+3. Prüfen:
+   - Wirklich nur 4 Elemente (Titel, Beschreibung, Zweck, Beispiele)?
+   - Beschreibung und Zweck unter 15 Wörtern?
+   - Code-Beispiele unter 8 Zeilen?
+   - Labels über Code-Blöcken kurz und prägnant?
+   - Card kompakt, kein leerer Raum?
+4. Wenn etwas zu viel: weglassen, nicht hinzufügen
+5. Bei jeder Iteration prüfen: lässt sich noch was weglassen?
+```