diff --git a/docs/skill-styleguide-anwendung.md b/docs/skill-styleguide-anwendung.md index 3191441..015a6b2 100644 --- a/docs/skill-styleguide-anwendung.md +++ b/docs/skill-styleguide-anwendung.md @@ -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.