Warum — der Grund, aus dem sich die Regel im Zweifel selbst herleiten lässt
Woran Du den Verstoß erkennst — das Merkmal, nach dem im Code gesucht werden kann
Richtig / falsch — Wireframe oder Minimalbeispiel
Grenzen — wann die Regel nicht greift
Das Warum ist kein Beiwerk. Ohne Grund baut ein Agent die Regel weg, sobald sie im konkreten Fall unbequem wird.
Hart und weich
Manche Regeln enthalten eine Zahl. Die Zahl ist fast nie das Allgemeingültige daran, sie ist eine Frage der Handschrift. Solche Regeln trennen deshalb zwei Dinge:
Hart ist die Invariante: dass es überhaupt genau einen Wert gibt, dass er als Token steht, und in welchem Korridor er liegen darf.
Weich ist die Zahl im Korridor. Dafür nennt die Regel einen Vorgabewert, der gilt, solange das Projekt nichts anderes festlegt.
So bleibt die Sammlung ohne Marken-Richtlinie benutzbar: ein Agent hat immer etwas Konkretes zur Hand, und eine Marke kann es überschreiben, ohne die Regel zu brechen. Im Frontmatter stehen dafür korridor und default.
Die drei Geltungsbereiche
scope
Bedeutung
universal
Gilt in jedem Projekt, unabhängig von Marke und Technik
stack
Gilt innerhalb einer Technik (Web, React Native), aber projektübergreifend
project
Bleibt im Repo. Steht nicht hier
Dazu sagt applies-to, für welche Techniken eine Regel gedacht ist. Damit lässt sich die Sammlung später gefiltert exportieren: ein Agent bekommt genau die Regeln, die zu seinem Projekt passen, statt aller.
Nichts im Browser-Aussehen. color-scheme, gestalten oder ersetzen
Daneben, keine Regel
Body, Role und Skin ist die persönliche Haltung: Cellular Design, die Wörter Body, Role und Skin, die Abgrenzung zu Atomic Design. Sie ist keine Regel dieser Sammlung. Die Notizen hier gelten auch ohne sie.
Was bewusst NICHT hier steht
Diese Dinge bleiben im jeweiligen Projekt, weil sie eine Marke oder ein bestimmtes Produkt beschreiben:
Stilrichtung und Stimmung — die Formsprache, das Lichtverhalten, die Liste der Stile, die man vermeiden will. Das ist die Handschrift eines Produkts, keine Regel für alle
Marke und Schreibweise — Produktname, Schreibweise, Wortmarke
Konkrete Werte — Farbwerte, Schriftfamilien, Breakpoint-Zahlen, Pfade zu Token-Dateien
Fachliche Schwellen — wo die Grenze zwischen gut, mittel und schlecht liegt. Die Regel „Schwellen kommen aus einer Quelle" ist allgemeingültig, die Zahlen sind es nicht
Sprache der Oberfläche — welche Sprache, geduzt oder gesiezt
Altlasten und Migration — offene Fundstellen, Umbaupläne, Zwischenstände
Wichtig ist die Richtung: eine Regel darf ihren Grund nennen und ein typisches Muster beschreiben, aber sie nennt kein Projekt, keine Person, keine Datei und keinen Zählstand. Was nur in einem Projekt wahr ist, gehört nicht in die Sammlung.