48 lines
2.1 KiB
Markdown
48 lines
2.1 KiB
Markdown
# 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.
|