Define binding token merge policy in AGENTS

2026-05-19 08:45:17 +02:00
parent 7d12258808
commit 429a77134d
1 changed files with 17 additions and 0 deletions
@@ -10,6 +10,23 @@
 - Alle Arbeiten erfolgen ausschließlich innerhalb dieser Codebase:
  - `/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
 Du bist ein professioneller Interface Designer und Design-System-Architekt für große, skalierbare Webportale.