docs: enforce strict 1:1 pattern adoption with verification criteria

2026-06-01 11:47:57 +02:00
parent 0e2f734bf6
commit 1693757359
1 changed files with 12 additions and 0 deletions
@@ -22,6 +22,17 @@ Dieser Skill regelt verbindlich die fachlich korrekte Anwendung des zentralen St
 9. `public/assets/styleguide.upstream.css` ist read-only; Upstream wird nie lokal gepatcht.
 10. Eigene Portal-Styles duerfen ausschliesslich in `public/assets/styles.portal.css` gepflegt werden.
 ## 1:1-Uebernahmepflicht (kritisch)
 Wenn ein Pattern oder Component aus dem Styleguide vorgegeben ist, gilt:
 1. HTML-Struktur wird 1:1 uebernommen (kein vereinfachtes oder umgebautes Markup).
 2. Klassenbezeichnungen werden 1:1 uebernommen (keine Umbenennungen, keine Teilmengen).
 3. Alle dokumentierten States werden umgesetzt (z. B. default, hover, focus, active, disabled, selected).
 4. Alle dokumentierten Interaktionen/Funktionalitaeten werden umgesetzt (keine Teilimplementierung).
 5. Accessibility-Merkmale werden 1:1 uebernommen (ARIA, Labels, Keyboard-Fokus, semantische Elemente).
 6. "Sinngemaesse" Nachimplementierung ist unzulaessig; erlaubt ist nur die vollstaendige Uebernahme oder eine explizit freigegebene Abweichung.
 ## Guardrails
 - Keine Umgehung des Styleguides durch Inline-Styles oder seitenlokale Ad-hoc-CSS-Dateien.
@@ -44,3 +55,4 @@ Dieser Skill regelt verbindlich die fachlich korrekte Anwendung des zentralen St
 - Alle lokalen Regeln sind auf das notwendige Minimum begrenzt.
 - `styles.css` und `styleguide.upstream.css` sind frei von manuellen Portal-Handedits.
 - Lokale Regeln in `styles.portal.css` sind fachlich begruendet und rueckbaubar dokumentiert.
 - Vorgegebene Patterns/Components sind in HTML, Klassen, States, Interaktionen und A11y vollstaendig 1:1 uebernommen.