Der Ordner .ai · Yuli Code

Was Yuli in deinem Projekt speichert, was mit dem Team versioniert wird und was nur auf deinem Rechner bleibt.

Yuli speichert im Ordner .ai/ jedes Projekts den Qualitätsvertrag, die Missionen, das Gedächtnis, die Regeln und seine Arbeitsdaten. Ein Teil wird per Git mit dem Team geteilt; ein Teil ist lokal und wird nie hochgeladen.

Yuli bearbeitet niemals deine .gitignore. Was außerhalb von Git bleiben soll, wird in .git/info/exclude eingetragen – das ist lokal für deine Kopie des Repositorys.

Was außerhalb von Git bleibt

Yuli fügt diese Zeilen zu .git/info/exclude hinzu:

.yuli/
**/.ai/codebase/
**/.ai/state/

Struktur

.ai/
├── contract.json          Qualitätsvertrag
├── quality.json           Einstellungen der Messung und Annahmen
├── memory/                Projektgedächtnis
├── rules/                 Teamregeln und gelernte Regeln
├── missions/              Missionen des Agenten
├── state/                 Arbeitsdaten (lokal)
├── codebase/              Code-Index (lokal)
├── requirements/          Nachverfolgbarkeit der Anforderungen
├── design/                Design-System von Web Studio
├── web/                   Mocks und Verträge der Vorschau
├── glossary.json          Domänenglossar
├── team.json              Team-Konfiguration
├── devops.json            CI/CD-Verbindungen
└── compound.yaml          Compound-Definition

Versionierte Dateien

Pfad	Inhalt
`contract.json`	Der Qualitätsvertrag. Ein geschützter Pfad: Ein Agent kann ihn nicht bearbeiten.
`quality.json`	Einstellungen der Messphase und Annahmen der Schätzungen. Optional.
`memory/`	`memory.json` und `MEMORY.md`: was sich der Agent über das Projekt merken soll.
`rules/`	Teamregeln in `*.md` und `learned.md` mit den gelernten Regeln.
`glossary.json`	Domänenglossar, bearbeitbar im Governance-Center.
`team.json`	Gemeinsame Team-Einstellungen.
`devops.json`	CI/CD-Verbindungen des Projekts.
`compound.yaml`	Dienste, die Compound in Web Studio startet.
`requirements/traceability.json`	Nachverfolgbarkeit Regel ↔ Test.
`design/system.json`	Design-System (Tokens) von Web Studio.
`web/mocks.json` und `web/contracts/`	Regeln des API-Simulators und Verträge.

Lokale Ordner

`state/`

Arbeitsdaten, die nur auf deinem Rechner Sinn ergeben. Sie werden nie hochgeladen.

Pfad	Inhalt
`state/quality/versions.json`	Kennzahlen der aktuellen Version und von N−1.
`state/quality/history.jsonl`	Kurze Zahlenreihe (maximal 30 Versionen).
`state/quality/agent.jsonl`	Statistik des Agenten selbst.
`state/contract-audit.jsonl`	Audit jeder Vertragsänderung.
`state/deployments.jsonl`	Für DORA erfasste Deployments.
`state/reviews.jsonl`	Unabhängige Reviews.
`state/agent-cost.jsonl`	Kosten der Agenten.

`codebase/`

Der Code-Intelligenz-Index: code_intelligence.db, eine SQLite-Datenbank mit dem Symbolgraphen. Er wird automatisch neu erzeugt; du kannst ihn löschen, ohne etwas zu verlieren.

Missionen

Jede Mission des Agenten liegt in missions/<conversación>/ mit zwei Dateien:

mission.json: ursprüngliche Anfrage, Anforderungen, Akzeptanzkriterien, Entscheidungen, Annahmen, Plan, berührte Dateien und Übergabepunkt.
PLAN.md: der lesbare Plan.

Siehe Missionen und Phasen.

Außerhalb des Projekts

Persönliches liegt nicht in .ai/. Deine Einstellungen, eigenen Prompts, Skills und Hooks sowie der Chatverlauf liegen im Yuli-Konfigurationsordner deines Benutzers. Unter Windows:

Ordner	Inhalt
`%APPDATA%\.yulicode`	Einstellungen, Prompts, eigene Skills, Hooks und Chatverlauf.
`%LOCALAPPDATA%\.yulicode`	Runtimes, Indizes, Caches und Logs. Kann gelöscht werden.

Dokumente, die der Agent schreibt

Außerhalb von .ai/ schreibt der Agent Dokumente nur, wenn es passt:

Pfad	Wann
`docs/quality/reporte-calidad.md`	Beim Erfassen einer Qualitätsversion.
`docs/sistema/`	Nur wenn du die Dokumentation des Systems anforderst.
`docs/architecture/`	ADR, Bedrohungsmodell und C4, aus dem Governance-Center.