La carpeta .ai · Yuli Code

Qué guarda Yuli dentro de tu proyecto, qué se versiona con el equipo y qué queda solo en tu equipo.

Yuli guarda en la carpeta .ai/ de cada proyecto el contrato de calidad, las misiones, la memoria, las reglas y sus datos de trabajo. Parte se comparte con el equipo por Git; parte es local y nunca se sube.

Yuli nunca edita tu .gitignore. Lo que debe quedar fuera de Git se agrega a .git/info/exclude, que es local a tu copia del repositorio.

Qué queda fuera de Git

Yuli agrega estas líneas a .git/info/exclude:

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

Estructura

.ai/
├── contract.json          contrato de calidad
├── quality.json           ajustes de la medición y supuestos
├── memory/                memoria del proyecto
├── rules/                 reglas del equipo y reglas aprendidas
├── missions/              misiones del agente
├── state/                 datos de trabajo (local)
├── codebase/              índice de código (local)
├── requirements/          trazabilidad de requisitos
├── design/                design system de Web Studio
├── web/                   mocks y contratos de la vista previa
├── glossary.json          glosario del dominio
├── team.json              configuración del equipo
├── devops.json            conexiones de CI/CD
└── compound.yaml          definición de Compound

Archivos que se versionan

Ruta	Contenido
`contract.json`	El contrato de calidad. Es una ruta protegida: un agente no lo puede editar.
`quality.json`	Ajustes de la fase de Medición y supuestos de las estimaciones. Opcional.
`memory/`	`memory.json` y `MEMORY.md`: lo que el agente debe recordar del proyecto.
`rules/`	Reglas del equipo en `*.md` y `learned.md` con las reglas aprendidas.
`glossary.json`	Glosario del dominio, editable desde el Centro de Gobierno.
`team.json`	Ajustes compartidos del equipo.
`devops.json`	Conexiones de CI/CD del proyecto.
`compound.yaml`	Servicios que levanta Compound en Web Studio.
`requirements/traceability.json`	Trazabilidad regla ↔ prueba.
`design/system.json`	Design system (tokens) de Web Studio.
`web/mocks.json` y `web/contracts/`	Reglas del simulador de APIs y contratos.

Carpetas locales

`state/`

Datos de trabajo que solo tienen sentido en tu equipo. Nunca se suben.

Ruta	Contenido
`state/quality/versions.json`	Cifras de la versión actual y de N−1.
`state/quality/history.jsonl`	Serie corta de números (máximo 30 versiones).
`state/quality/agent.jsonl`	Estadística del propio agente.
`state/contract-audit.jsonl`	Auditoría de cada cambio al contrato.
`state/deployments.jsonl`	Despliegues registrados para DORA.
`state/reviews.jsonl`	Revisiones independientes.
`state/agent-cost.jsonl`	Costo de los agentes.

`codebase/`

El índice de inteligencia de código: code_intelligence.db, una base SQLite con el grafo de símbolos. Se regenera solo; puedes borrarlo sin perder nada.

Misiones

Cada misión del agente vive en missions/<conversación>/ con dos archivos:

mission.json: pedido original, requerimientos, criterios de aceptación, decisiones, supuestos, plan, archivos tocados y punto de traspaso.
PLAN.md: el plan legible.

Ver Misiones y fases.

Fuera del proyecto

Lo personal no vive en .ai/. Tus ajustes, prompts, skills y hooks propios y el historial del chat están en la carpeta de configuración de Yuli de tu usuario. En Windows:

Carpeta	Qué guarda
`%APPDATA%\.yulicode`	Ajustes, prompts, skills propios, hooks e historial del chat.
`%LOCALAPPDATA%\.yulicode`	Runtimes, índices, cachés y registros. Se puede borrar.

Documentos que escribe el agente

Fuera de .ai/, el agente solo escribe documentos cuando corresponde:

Ruta	Cuándo
`docs/quality/reporte-calidad.md`	Al registrar una versión de calidad.
`docs/sistema/`	Solo si pides documentar el sistema.
`docs/architecture/`	ADR, modelo de amenazas y C4, desde el Centro de Gobierno.