Shell — Agent-Richtlinien

Scope

Nutzer-Schnittstellen-Schicht (@addxion/shell): Layout, Chat, Command, Gates.

Nicht die OS-Shell (bash/zsh). In ADDXION meint Shell immer dieses Package.

Chat gehört zur Shell (KI-Schnittstelle), nicht zu einer Feature-Seite.

Regeln

• PageHeader: nur Titel auf Tab-Seiten; Struktur nur in @addxion/shell, Inhalt nur in manifest.ts pro App
• Keine lokalen PageHeader-Forks in süper oder addxion.ai — nur dünnes Wiring (Manifest + resolveSection)
• Nach Shell-Änderung: beide Consumer auf gleiche @addxion/shell-Version bumpen
• Nav-Daten aus @addxion/xi/nav, nicht in Shell hardcoden
• Scroll aus @addxion/behavior
• LLM aus @addxion/ai
• Styling: @addxion/neon
• Icons: Lucide (lucide-react) für Nav und Command Palette — Iconography
• Docs: Command Palette optional (Content-Index + xi federated). Starlight-Sidebar bleibt Content-SSOT.

Extraktions-Reihenfolge (aus süper)

1. PageHeader
2. ChatSurface + CommandPalette + behavior
3. Gates
4. BottomNav

PageHeader-Sync

Vollständige Regeln: PageHeader — Cross-App-Sync.

Truths

ID	Wahrheit
T-PKG-SHELL	Shell = UI-Schicht, nicht bash/zsh
T-MAINTAIN	Einmal pflegen — keine Doppelpflege
T-TRUTHS-SSOT	Truths-Registry — referenzieren, nicht duplizieren

Für Agents

Scope: Diese Seite ist der Block-Einstieg für @addxion/shell.

• Bei Shell-Arbeit zuerst hier, dann Architektur
• Strukturelle UI-Änderungen nur in addxion-ai/packages/shell
• Keine Nav-Hardcodes; Einmal pflegen