From 429a77134d6fc0ed68c153e55818a9eef3145d14 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mathias=20Gla=CC=88ser?= Date: Tue, 19 May 2026 08:45:17 +0200 Subject: [PATCH] Define binding token merge policy in AGENTS --- AGENTS.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) 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.