diff --git a/AGENTS.md b/AGENTS.md index 18d3df1..0756c2a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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.