Package-Naming

Namenskonventionen und Abgrenzungen.

Warum bestimmte Namen gewählt werden und wie sie von anderen Konzepten abgegrenzt sind.

`@addxion/shell`

Definition

Shell = Nutzer-Schnittstellen-Schicht zwischen Mensch und dem, was darunter liegt.

Shell-Schicht	Darunter	Shell-Komponenten
App	Seiten, Features	PageHeader, Gates, BottomNav
Navigation / Aktion	Routen, Tools	Command Palette
KI	Model, Streaming, Tools	Chat Surface

Chat ist keine Seite, sondern eine permanente Schnittstelle zur Intelligenz. Command Palette ist eine Schnittstelle zu Navigation und Aktionen. Beides gehört zur Shell.

┌─ @addxion/shell ─────────────────────────┐
│  PageHeader        (App-Schnittstelle)   │
│  Command Palette   (Nav/Akt-Schnittstelle)│
│  Chat Surface      (KI-Schnittstelle)    │
│  Gates             (Auth-Schnittstelle)  │
├─────────────────────────────────────────┤
│  Seiten-Inhalt     (Features)           │
└─────────────────────────────────────────┘

Abgrenzung zur OS-Shell (bash, zsh)

	OS-Shell	`@addxion/shell`
Darunter	Kernel, Prozesse	App, KI, Nav-Daten
Eingabe	Terminal-Befehle	UI, Chat, Command
Package	Systemprogramm	`@addxion/shell`

Gleiches Wort, anderer Kontext. In ADDXION-Docs und Code meint Shell immer das Package, nie bash.

Was nicht in Shell liegt

Verantwortung	Package
Nav-Daten, Manifeste	`@addxion/xi/nav`
Scroll, Haptics	`@addxion/behavior`
LLM, Streaming	`@addxion/ai`
Look, Tokens	`@addxion/neon`

`@addxion/neon` statt `@addxion/core`

core ist zu abstrakt für ein Design System. @addxion/neon ist der öffentliche Name. @addxion/core bleibt optional als interne Engine (Tokens, Manifest-Generierung) innerhalb von addxion-neon.

`@addxion/behavior`

Scroll, Haptics, Intent-Erkennung. Verhalten der Shell, nicht ihr Aussehen.

`@addxion/xi`

Cross-App-Glue. Ein Package, Subpaths protocol, nav, runtime.

Truths

ID	Wahrheit
T-PKG-SHELL	Shell = UI-Schicht, nicht bash/zsh
T-PKG-NEON	Consumer-Einstieg: @addxion/neon, nicht @addxion/core
T-TRUTHS-SSOT	Truths-Registry — referenzieren, nicht duplizieren

Für Agents

Scope: Namenskonventionen — Shell vs. OS-Shell, Package-Bezeichnungen.

@addxion/shell = Nutzer-Schnittstellen-Schicht, nicht bash/zsh
Chat ist Shell-Komponente (KI-Schnittstelle), keine Feature-Seite
Öffentlicher Design-Package-Name: @addxion/neon, nicht @addxion/core