ADDXION Ökosystem

North Star

Ein durchgängiges Nutzererlebnis über süper.app, addxion.ai und addxion.com. Gleiche Design-Sprache, gemeinsame Auth, getrennte App-Daten pro Produkt.

Pflege-Prinzip: Truth T-MAINTAIN — Shared Packages statt Duplikate. Ausarbeitung: Einmal pflegen.

Truth-Prinzip: T-TRUTHS-SSOT — Wahrheiten nur in Truths, überall sonst per T-…-ID referenzieren.

Produkte

Produkt	Repo	Zielgruppe
süper	süper	Fahrschul-Lernende, Fahrlehrer
addxion.ai	addxion-ai	KI-Power-User, Teams
addxion.com	addxion-com	Marketing, CMS (Docs-Proxy unter addxion.com/docs)
Plattform-Docs	addxion-docs	Ökosystem, Neon-Guidance, Patterns

Shared Packages

                    ┌─────────────────────────────────────┐
                    │         Consumer-Apps               │
                    │  süper · addxion.ai · addxion.com   │
                    └──────────────┬──────────────────────┘
                                   │
         ┌─────────────────────────┼─────────────────────────┐
         ▼                         ▼                         ▼
  @addxion/shell            @addxion/xi              @addxion/behavior
  (Layout, Chat, Command, Gates)     (nav, protocol, runtime)  (Scroll, Haptics)
         │                         │                         │
         └─────────────────────────┼─────────────────────────┘
                                   ▼
                    @addxion/neon · @addxion/auth · @addxion/ai
                                   │
                    ┌──────────────┴──────────────┐
                    ▼                             ▼
             addxion-neon                  addxion-ai/packages/
             (Design System)                auth · ai

Schichtenmodell

Schicht	Package	Verantwortung
Design	@addxion/neon	Tokens, Components, AI-Manifest
Identity	@addxion/auth	User, Session, Org, Grants
LLM	@addxion/ai	OpenRouter, Streaming, Message-Typen
Interaktion	@addxion/behavior	Scroll-Engineering, Haptics (framework-agnostic)
Shell	@addxion/shell	PageHeader, ChatSurface, Gates, Command Palette
Glue	@addxion/xi	Nav-Daten, Protokoll, Runtime-Hooks zwischen Apps

Daten-Trennung

• Identity geteilt: eine Auth-DB (addxion-auth)
• App-Daten isoliert: jedes Produkt eigene DB (D1 oder Neon Postgres)
• Kein Cross-Product-Leak: Chat in addxion.ai ≠ Fortschritt in süper

Docs SSOT

Plattform-Dokumentation lebt in addxion-docs (dieses Repo). addxion-com liefert Marketing und CMS. Auslieferung weiter unter addxion.com/docs.

Nächste Schritte

• Changelog — Dokumentierte Plattform- und Docs-Änderungen
• Truths — Plattform-Wahrheiten — SSOT für unveränderliche Prinzipien
• Einmal pflegen — Ökosystem-Prinzip gegen doppelte Pflege
• Package-Leitfaden — Sinn, Grenzen, Status pro Package
• Packages und Grenzen — Verantwortlichkeitstabellen
• Roadmap (Schritt-für-Schritt) — Phasen und offene Punkte
• Docs-Sync — Wie Docs aktuell bleiben
• Package-Naming (Shell vs. OS-Shell)
• Navigation: xi vs. Docs vs. Shell
• EvolutionCore → xi-runtime — These, Ports, XI-Slot (T-EVOLUTION-CORE)

Truths

ID	Wahrheit
T-NORTH-STAR	Durchgängiges UX, getrennte App-Daten
T-MAINTAIN	Einmal pflegen — keine Doppelpflege
T-PLATFORM-SSOT	Plattform-Wahrheit nur in addxion-docs
T-TRUTHS-SSOT	Truths-Registry — referenzieren, nicht duplizieren

Für Agents

Scope: North Star, Schichtenmodell und Package-Übersicht des ADDXION-Ökosystems.

• Package-Grenzen nicht hier duplizieren — verweisen auf packages.md und packages-guide.md
• Status-Änderungen auch in roadmap.md
• Einmal pflegen bei Extraktionen oder Shared-Package-Entscheidungen