Folderul .ai · Yuli Code

Ce salvează Yuli în proiectul tău, ce se versionează împreună cu echipa și ce rămâne doar pe calculatorul tău.

Yuli salvează în folderul .ai/ al fiecărui proiect contractul de calitate, misiunile, memoria, regulile și datele lui de lucru. O parte se partajează cu echipa prin Git; o parte este locală și nu este urcată niciodată.

Yuli nu editează niciodată fișierul tău .gitignore. Ce trebuie să rămână în afara Git se adaugă în .git/info/exclude, care este local pentru copia ta a depozitului.

Ce rămâne în afara Git

Yuli adaugă aceste linii în .git/info/exclude:

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

Structură

.ai/
├── contract.json          contractul de calitate
├── quality.json           setările măsurării și ipoteze
├── memory/                memoria proiectului
├── rules/                 regulile echipei și regulile învățate
├── missions/              misiunile agentului
├── state/                 date de lucru (local)
├── codebase/              indexul codului (local)
├── requirements/          trasabilitatea cerințelor
├── design/                design system-ul din Web Studio
├── web/                   mock-uri și contracte pentru previzualizare
├── glossary.json          glosarul domeniului
├── team.json              configurația echipei
├── devops.json            conexiunile CI/CD
└── compound.yaml          definiția Compound

Fișiere care se versionează

Cale	Conținut
`contract.json`	Contractul de calitate. Este o cale protejată: un agent nu o poate edita.
`quality.json`	Setările fazei de Măsurare și ipotezele estimărilor. Opțional.
`memory/`	`memory.json` și `MEMORY.md`: ce trebuie să rețină agentul despre proiect.
`rules/`	Regulile echipei în `*.md` și `learned.md` cu regulile învățate.
`glossary.json`	Glosarul domeniului, editabil din Centrul de guvernanță.
`team.json`	Setările partajate ale echipei.
`devops.json`	Conexiunile CI/CD ale proiectului.
`compound.yaml`	Serviciile pe care le pornește Compound în Web Studio.
`requirements/traceability.json`	Trasabilitate regulă ↔ test.
`design/system.json`	Design system-ul (tokenii) din Web Studio.
`web/mocks.json` și `web/contracts/`	Regulile simulatorului de API-uri și contractele.

Foldere locale

`state/`

Date de lucru care au sens doar pe calculatorul tău. Nu sunt urcate niciodată.

Cale	Conținut
`state/quality/versions.json`	Cifrele versiunii curente și ale N−1.
`state/quality/history.jsonl`	O serie scurtă de numere (maximum 30 de versiuni).
`state/quality/agent.jsonl`	Statistica agentului însuși.
`state/contract-audit.jsonl`	Auditul fiecărei modificări a contractului.
`state/deployments.jsonl`	Implementările înregistrate pentru DORA.
`state/reviews.jsonl`	Revizuirile independente.
`state/agent-cost.jsonl`	Costul agenților.

`codebase/`

Indexul inteligenței codului: code_intelligence.db, o bază SQLite cu graful de simboluri. Se regenerează singur; îl poți șterge fără să pierzi nimic.

Misiuni

Fiecare misiune a agentului se află în missions/<conversación>/, cu două fișiere:

mission.json: cererea originală, cerințele, criteriile de acceptare, deciziile, ipotezele, planul, fișierele atinse și punctul de predare.
PLAN.md: planul lizibil.

Vezi Misiuni și faze.

În afara proiectului

Ce este personal nu se află în .ai/. Setările tale, prompturile, skills-urile și hooks-urile proprii și istoricul chatului se află în folderul de configurare Yuli al utilizatorului tău. În Windows:

Folder	Ce conține
`%APPDATA%\.yulicode`	Setări, prompturi, skills proprii, hooks și istoricul chatului.
`%LOCALAPPDATA%\.yulicode`	Runtime-uri, indexuri, cache-uri și jurnale. Poate fi șters.

Documente scrise de agent

În afara .ai/, agentul scrie documente doar când este cazul:

Cale	Când
`docs/quality/reporte-calidad.md`	La înregistrarea unei versiuni de calitate.
`docs/sistema/`	Doar dacă ceri documentarea sistemului.
`docs/architecture/`	ADR, model de amenințări și C4, din Centrul de guvernanță.