Le dossier .ai · Yuli Code

Ce que Yuli conserve dans votre projet, ce qui est versionné avec l’équipe et ce qui reste uniquement sur votre machine.

Yuli conserve dans le dossier .ai/ de chaque projet le contrat de qualité, les missions, la mémoire, les règles et ses données de travail. Une partie est partagée avec l’équipe via Git ; une autre est locale et n’est jamais envoyée.

Yuli ne modifie jamais votre .gitignore. Ce qui doit rester hors de Git est ajouté à .git/info/exclude, qui est local à votre copie du dépôt.

Ce qui reste hors de Git

Yuli ajoute ces lignes à .git/info/exclude :

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

Structure

.ai/
├── contract.json          contrat de qualité
├── quality.json           paramètres de la mesure et hypothèses
├── memory/                mémoire du projet
├── rules/                 règles de l’équipe et règles apprises
├── missions/              missions de l’agent
├── state/                 données de travail (local)
├── codebase/              index du code (local)
├── requirements/          traçabilité des exigences
├── design/                design system de Web Studio
├── web/                   mocks et contrats de l’aperçu
├── glossary.json          glossaire du domaine
├── team.json              configuration de l’équipe
├── devops.json            connexions CI/CD
└── compound.yaml          définition de Compound

Fichiers versionnés

Chemin	Contenu
`contract.json`	Le contrat de qualité. C’est un chemin protégé : un agent ne peut pas le modifier.
`quality.json`	Paramètres de la phase de Mesure et hypothèses des estimations. Facultatif.
`memory/`	`memory.json` et `MEMORY.md` : ce que l’agent doit retenir du projet.
`rules/`	Règles de l’équipe dans `*.md` et `learned.md` avec les règles apprises.
`glossary.json`	Glossaire du domaine, modifiable depuis le Centre de gouvernance.
`team.json`	Paramètres partagés de l’équipe.
`devops.json`	Connexions CI/CD du projet.
`compound.yaml`	Services que Compound démarre dans Web Studio.
`requirements/traceability.json`	Traçabilité règle ↔ test.
`design/system.json`	Design system (tokens) de Web Studio.
`web/mocks.json` et `web/contracts/`	Règles du simulateur d’API et contrats.

Dossiers locaux

`state/`

Données de travail qui n’ont de sens que sur votre machine. Elles ne sont jamais envoyées.

Chemin	Contenu
`state/quality/versions.json`	Chiffres de la version actuelle et de N−1.
`state/quality/history.jsonl`	Courte série de chiffres (30 versions au maximum).
`state/quality/agent.jsonl`	Statistiques de l’agent lui-même.
`state/contract-audit.jsonl`	Audit de chaque modification du contrat.
`state/deployments.jsonl`	Déploiements enregistrés pour DORA.
`state/reviews.jsonl`	Revues indépendantes.
`state/agent-cost.jsonl`	Coût des agents.

`codebase/`

L’index d’intelligence du code : code_intelligence.db, une base SQLite contenant le graphe de symboles. Il se régénère tout seul ; vous pouvez le supprimer sans rien perdre.

Missions

Chaque mission de l’agent se trouve dans missions/<conversation>/ avec deux fichiers :

mission.json : demande d’origine, exigences, critères d’acceptation, décisions, hypothèses, plan, fichiers modifiés et point de passation.
PLAN.md : le plan lisible.

Voir Missions et phases.

Hors du projet

Ce qui est personnel ne se trouve pas dans .ai/. Vos paramètres, prompts, skills et hooks personnels ainsi que l’historique du chat se trouvent dans le dossier de configuration Yuli de votre utilisateur. Sous Windows :

Dossier	Contenu
`%APPDATA%\.yulicode`	Paramètres, prompts, skills personnels, hooks et historique du chat.
`%LOCALAPPDATA%\.yulicode`	Runtimes, index, caches et journaux. Peut être supprimé.

Documents rédigés par l’agent

En dehors de .ai/, l’agent ne rédige des documents que lorsque cela s’impose :

Chemin	Quand
`docs/quality/reporte-calidad.md`	Lors de l’enregistrement d’une version de qualité.
`docs/sistema/`	Uniquement si vous demandez de documenter le système.
`docs/architecture/`	ADR, modèle de menaces et C4, depuis le Centre de gouvernance.