Repo Boundaries
Jedes Repo hat eine klare Grenze. Überschneidungen führen zu Duplikaten und Drift.
Leitprinzip: Einmal pflegen — keine parallele Pflege derselben Wahrheit in mehreren Repos.
Übersicht
Abschnitt betitelt „Übersicht“| Repo | Verantwortung | Nicht hier |
|---|---|---|
| addxion-neon | Neon (@addxion/neon) — Tokens, Components, markenneutral | Marken-Tokens, App-Logik |
| addxion-com | addxion.com — Marketing, Brand (brand.css), CMS (/cms) | Design-System-Primitives, Plattform-Docs |
| addxion-docs | Plattform-Docs SSOT — Ökosystem, XI, Shell, Behavior, Branding | Marketing-Seiten, CMS, App-Code |
| addxion-ai | addxion.ai — KI-App, @addxion/auth, @addxion/ai | Marketing, Neon-Tokens |
| süper | süper.app — Fahrschul-Lern-App, Neon-Consumer | Auth-Schema (kommt aus @addxion/auth) |
| (archiviert — Code lebt in addxion-com/cms/) | — |
Single Source of Truth
Abschnitt betitelt „Single Source of Truth“| Inhalt | SSOT-Repo |
|---|---|
| Design Tokens + Primitives | addxion-neon |
| Markenwerte (ink, cream, electric) | addxion-com (brand.css) |
| Auth-Schema + Permissions | addxion-ai (@addxion/auth) |
| Shared Shell (Layout, Chat, Command) | addxion-ai (@addxion/shell) |
| Scroll / Interaktion | addxion-ai (@addxion/behavior) |
| Cross-App Nav | addxion-ai (@addxion/xi) |
| LLM-Client | addxion-ai (@addxion/ai) |
| Plattform-Dokumentation | addxion-docs (SSOT, ausgeliefert unter addxion.com/docs) |
| Markenstrategie | addxion-docs /docs/branding/ |
| Marketing-Seiten-Copy | addxion-com (folgt Branding-SSOT) |
| Headless CMS (Payload) | addxion-com (/cms, Quellcode in cms/) |
Konsum-Regel
Abschnitt betitelt „Konsum-Regel“Änderungen am Design System zuerst in addxion-neon, dann in Consumern (addxion-com, später addxion.ai) einbinden.
# addxion-com konsumiert Neon lokal"@addxion/neon": "file:../addxion-neon/packages/neon" # Primärname; core intern"@addxion/components": "file:../addxion-neon/packages/components"Schreibweise
Abschnitt betitelt „Schreibweise“Neon — nicht „ADDXION NEON“.
Plattform-Dokumentation lebt in addxion-docs (SSOT). Auslieferung unter addxion.com/docs via separates CF Pages-Projekt. addxion-com enthält nur Marketing und CMS — keine Plattform-Docs mehr.
Neue Ökosystem-Inhalte (XI, Shell, Behavior, Package-Leitfaden) nur in addxion-docs anlegen. Sync-Prozess: Docs-Sync.
| ID | Wahrheit |
|---|---|
| T-REPO-BOUNDARY | Klare Repo-Verantwortung pro Inhaltstyp |
| T-PLATFORM-SSOT | Plattform-Wahrheit nur in addxion-docs |
| T-MAINTAIN | Einmal pflegen — keine Doppelpflege |
Für Agents
Abschnitt betitelt „Für Agents“Scope: Verantwortlichkeiten und SSOT pro Repo.
- Vor Änderung klären: welches Repo ist SSOT?
- Einmal pflegen — keine parallele Pflege
- Neon-Änderungen zuerst addxion-neon, dann Consumer