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.