Principles
1. Lean-Agile
Abschnitt betitelt „1. Lean-Agile“YAGNI. Iteriere schnell. Liefere früh. Refaktoriere regelmäßig.
2. Single Source of Truth
Abschnitt betitelt „2. Single Source of Truth“Design Tokens + Core Components leben in addxion-neon.
3. Minimal Adaptation
Abschnitt betitelt „3. Minimal Adaptation“90 % zentral. Nur dünne Plattform-Wrapper.
4. Versioning & Backward Compatibility
Abschnitt betitelt „4. Versioning & Backward Compatibility“Shopify Sections versioniert (hero-v1.liquid). Breaking Changes mit Migration-Guide.
5. Brand Flexibility
Abschnitt betitelt „5. Brand Flexibility“Multi-brand via [data-brand] — Mechanismus in Neon, konkrete Markenwerte beim Consumer (z. B. addxion-com/src/styles/brand.css).
6. Performance & Accessibility First
Abschnitt betitelt „6. Performance & Accessibility First“Mobile-first, Core Web Vitals, WCAG-konform.
7. Developer Experience
Abschnitt betitelt „7. Developer Experience“Bun Workspaces, klare Package-Grenzen.
8. Documentation as Code
Abschnitt betitelt „8. Documentation as Code“Plattform-Docs in addxion-docs (SSOT, ausgeliefert unter addxion.com/docs). Design-System-Implementierung in addxion-neon. Consumer-brand.css beim jeweiligen Produkt.
| ID | Wahrheit |
|---|---|
| T-PKG-NEON | Consumer-Einstieg: @addxion/neon, nicht @addxion/core |
| T-PLATFORM-SSOT | Plattform-Wahrheit nur in addxion-docs |
| T-NEON-SECTIONS | Versionierte Sections nicht in-place überschreiben |
Für Agents
Abschnitt betitelt „Für Agents“Scope: Acht Core Principles des Neon Guidance Layers.
- SSOT: Tokens und Core Components in addxion-neon
- YAGNI und versionierte Sections nicht in-place überschreiben
- AI-ready Checkliste vor größeren Neon-Änderungen