gitea_admin/Styleguide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Define binding token merge policy in AGENTS

Browse Source
This commit is contained in:
Mathias Gläser
2026-05-19 08:45:17 +02:00
parent 7d12258808
commit 429a77134d
1 changed files with 17 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+17
View File
@@ -10,6 +10,23 @@
- Alle Arbeiten erfolgen ausschließlich innerhalb dieser Codebase: - Alle Arbeiten erfolgen ausschließlich innerhalb dieser Codebase:
- `/Users/mathias/Documents/Dokumente Chouchou/Codebases/Styleguide` - `/Users/mathias/Documents/Dokumente Chouchou/Codebases/Styleguide`
## Verbindliche Token-Policy (Merge vs. Behalten)
- Semantische Tokens dürfen denselben Foundation-Wert teilen, **wenn** sie unterschiedliche fachliche Bedeutung, unterschiedlichen UI-Kontext oder unterschiedliche Zustandssemantik ausdrücken.
- Semantische Tokens mit identischem Wert sind **zu mergen**, wenn sie:
- denselben Zweck haben,
- im selben UI-Kontext gelten,
- keinen eigenständigen fachlichen Namen benötigen.
- Reine Namensduplikate ohne zusätzliche Semantik sind nicht zulässig.
- Alias-Ketten sind auf maximal eine sinnvolle Fach-Abstraktion zu begrenzen; unnötige Alias-of-Alias-Ketten sind zu reduzieren.
- Pattern-spezifische Tokens sind nur zulässig, wenn das Pattern eine eigene fachliche Verantwortung hat; andernfalls sind bestehende Component-/Layout-Tokens zu verwenden.
- Sehr spezifische Einzelwerte (z. B. feste `rem`/`%` nur für einen Einzelfall) müssen als bewusste Ausnahme begründet werden; ohne Begründung sind bestehende Foundation-/Dimension-Tokens zu verwenden oder zu erweitern.
- Für jede Token-Bereinigung ist vor Umsetzung kurz zu klassifizieren:
- `mergebar` (semantisch gleich, zusammenführbar),
- `behalten` (semantisch verschieden, trotz gleichem Wert),
- `prüfen` (Unsicherheit, fachliche Klärung nötig).
- Breaking Renames von Tokens sind ohne explizite Freigabe nicht erlaubt; Standardvorgehen ist rückwärtskompatible Migration (Alias-Übergang oder schrittweise Referenzumstellung).
## Rolle des Agents ## Rolle des Agents
Du bist ein professioneller Interface Designer und Design-System-Architekt für große, skalierbare Webportale. Du bist ein professioneller Interface Designer und Design-System-Architekt für große, skalierbare Webportale.