XAIO
Docs/Describe/XAIO.md — Projekt-Wissensdatei

XAIO.md — Projekt-Wissensdatei

Aktualisiert 3. Mai 2026Describe

Das dauerhafte Projektgedächtnis, das der Agent zu Beginn jedes Chats liest.

Was ist XAIO.md?

`XAIO.md` ist eine Markdown-Datei, die der Agent in jedem Projekt automatisch pflegt. Sie erfasst dein Design-System, deine Konventionen, wichtige Entscheidungen und Einschränkungen und wird zu Beginn jedes Chats geladen — eine frische Unterhaltung weiß sofort, welche Design-Tokens du verwendest, was dein Code-Stil ist, was bereits entschieden wurde.

Warum das wichtig ist

Ohne XAIO.md startet jeder neue Chat bei null und der Agent müsste deine Konventionen jedes Mal aus dem Code ableiten. Mit XAIO.md bleiben Entscheidungen erhalten:

  • Design-Tokens (Palette, Typografie, Radien, Spacings) werden gemerkt
  • Komponenten-Muster und Naming-Konventionen bleiben konsistent
  • Architektur-Entscheidungen werden nicht jedesmal neu verhandelt
  • Migrations-Vor-Analyse speichert ihre Erkenntnisse hier

Wie nutzen

Früh aufsetzen — am Projekt-Start das Design-System in einem Prompt festlegen:

Bevor wir etwas bauen, lass uns das Design-System festlegen: dunkles Theme, Inter-Font, Akzent #3b82f6, 8px Eckenradius, subtile Schatten, großzügige Abstände. Speichere das in XAIO.md.

Aktualisieren wenn sich was ändert:

Update XAIO.md: wir haben von Tailwinds Standardfarben zu einer eigenen Palette gewechselt. Primär: #1e40af, Sekundär: #059669, Hintergrund: #0f172a.

Auslesen:

Lies XAIO.md und sag mir, welches Design-System und welche Konventionen für dieses Projekt definiert sind.

Wo finden

`XAIO.md` taucht im Dateien-Tab unter einem eigenen Sub-Tab auf, und auch in den Projekt-Einstellungen. Zum Bearbeiten den Agent im Chat fragen — direkte Änderungen funktionieren auch, aber wenn der Agent neu schreibt bleibt die Formatierung konsistent.

Was reingehört (und was nicht)

Rein:

  • Design-Tokens und visuelles System
  • Naming- und Code-Stil-Konventionen
  • Architektur-Entscheidungen (warum React Router statt Next, etc.)
  • Domänen-Glossar (was ist eine 'Session' in dieser App, was ist ein 'Tenant')
  • Externe Integrationen auf die das Projekt baut

Nicht rein:

  • Secrets / API-Keys (Environment-Variablen verwenden — die werden im Chat sowieso maskiert)
  • Per-Feature Implementierungs-Notizen (gehören in den Code selbst)
  • Alles was sich wöchentlich ändert (XAIO.md ist für stabile Entscheidungen, nicht für laufende Arbeit)