Styleguide/docs/skill-styleguide-anwendung.md

AGENTS.md — Skill: styleguide-anwendung

Zweck

Dieser Skill regelt verbindlich die Anwendung des zentralen Styleguides in konsumierenden Portalen.

Scope

• Gilt nur fuer Portal-Repositories, die den Styleguide per Sync-Skript uebernehmen.
• Gilt nur fuer die CSS-Integrationsschicht im Portal.

Verbindliche Regeln

1. public/assets/styleguide.upstream.css ist Upstream und read-only.
2. public/assets/styles.css ist Build-/Sync-Output und read-only.
3. Eigene Portal-Styles duerfen ausschliesslich in public/assets/styles.portal.css gepflegt werden.
4. Direkte manuelle Aenderungen in public/assets/styles.css sind verboten.
5. Direkte manuelle Aenderungen in public/assets/styleguide.upstream.css sind verboten.
6. Bei jedem Styleguide-Update wird ausschliesslich synchronisiert und danach styles.css neu erzeugt/uebernommen.
7. Konflikte nach Sync werden nur in styles.portal.css geloest, nie durch Patchen von Upstream-Dateien.
8. Es darf keine weitere lokale Vollkopie des Styleguides in anderen Portaldateien geben.
9. Produktiv eingebunden wird nur public/assets/styles.css.
10. Die Reihenfolge der CSS-Quellen bleibt strikt:

• public/assets/styleguide.upstream.css
• public/assets/styles.portal.css
• Ausgabe: public/assets/styles.css

Guardrails

• Keine :root-Duplikate aus lokalen Legacy-Bloecken in produktiven Zielpfaden.
• Keine Umgehung durch Inline-Styles oder seitenlokale CSS-Dateien als Ersatz fuer styles.portal.css.
• Keine Vermischung von Upstream- und Portal-Verantwortung in derselben Quelldatei.

Arbeitsmodus bei Aenderungen

1. Styleguide-Sync ausfuehren.
2. Ergebnisdateien aktualisieren lassen.
3. Nur notwendige Portal-Abweichungen in styles.portal.css anpassen.
4. Smoke-Test der betroffenen Seiten.
5. Commit mit kurzer Begruendung der lokalen Abweichungen.

Abnahmekriterien

• styles.css enthaelt keine manuell gepflegten Portalregeln.
• Portal-spezifische Regeln liegen vollstaendig in styles.portal.css.
• Upstream-Datei bleibt unveraendert durch lokale Handedits.
• Nach Sync und Build gibt es keine visuelle Regression in den betroffenen Kernseiten.