A pasta .ai · Yuli Code

O que o Yuli guarda dentro do seu projeto, o que é versionado com a equipe e o que fica apenas na sua máquina.

O Yuli guarda na pasta .ai/ de cada projeto o contrato de qualidade, as missões, a memória, as regras e os seus dados de trabalho. Parte é compartilhada com a equipe pelo Git; parte é local e nunca é enviada.

O Yuli nunca edita o seu .gitignore. O que deve ficar fora do Git é adicionado a .git/info/exclude, que é local à sua cópia do repositório.

O que fica fora do Git

O Yuli adiciona estas linhas a .git/info/exclude:

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

Estrutura

.ai/
├── contract.json          contrato de qualidade
├── quality.json           configurações da medição e premissas
├── memory/                memória do projeto
├── rules/                 regras da equipe e regras aprendidas
├── missions/              missões do agente
├── state/                 dados de trabalho (local)
├── codebase/              índice de código (local)
├── requirements/          rastreabilidade de requisitos
├── design/                design system do Web Studio
├── web/                   mocks e contratos da pré-visualização
├── glossary.json          glossário do domínio
├── team.json              configuração da equipe
├── devops.json            conexões de CI/CD
└── compound.yaml          definição do Compound

Arquivos versionados

Caminho	Conteúdo
`contract.json`	O contrato de qualidade. É um caminho protegido: um agente não pode editá-lo.
`quality.json`	Configurações da fase de Medição e premissas das estimativas. Opcional.
`memory/`	`memory.json` e `MEMORY.md`: o que o agente deve lembrar sobre o projeto.
`rules/`	Regras da equipe em `*.md` e `learned.md` com as regras aprendidas.
`glossary.json`	Glossário do domínio, editável na Central de Governança.
`team.json`	Configurações compartilhadas da equipe.
`devops.json`	Conexões de CI/CD do projeto.
`compound.yaml`	Serviços que o Compound sobe no Web Studio.
`requirements/traceability.json`	Rastreabilidade regra ↔ teste.
`design/system.json`	Design system (tokens) do Web Studio.
`web/mocks.json` e `web/contracts/`	Regras do simulador de APIs e contratos.

Pastas locais

`state/`

Dados de trabalho que só fazem sentido na sua máquina. Nunca são enviados.

Caminho	Conteúdo
`state/quality/versions.json`	Números da versão atual e da N−1.
`state/quality/history.jsonl`	Série curta de números (máximo de 30 versões).
`state/quality/agent.jsonl`	Estatística do próprio agente.
`state/contract-audit.jsonl`	Auditoria de cada alteração no contrato.
`state/deployments.jsonl`	Implantações registradas para DORA.
`state/reviews.jsonl`	Revisões independentes.
`state/agent-cost.jsonl`	Custo dos agentes.

`codebase/`

O índice de inteligência de código: code_intelligence.db, um banco SQLite com o grafo de símbolos. Ele é regenerado automaticamente; você pode apagá-lo sem perder nada.

Missões

Cada missão do agente fica em missions/<conversa>/ com dois arquivos:

mission.json: pedido original, requisitos, critérios de aceitação, decisões, premissas, plano, arquivos alterados e ponto de passagem.
PLAN.md: o plano legível.

Veja Missões e fases.

Fora do projeto

O que é pessoal não fica em .ai/. As suas configurações, prompts, skills e hooks próprios e o histórico do chat ficam na pasta de configuração do Yuli do seu usuário. No Windows:

Pasta	O que guarda
`%APPDATA%\.yulicode`	Configurações, prompts, skills próprias, hooks e histórico do chat.
`%LOCALAPPDATA%\.yulicode`	Runtimes, índices, caches e logs. Pode ser apagada.

Documentos que o agente escreve

Fora de .ai/, o agente só escreve documentos quando é o caso:

Caminho	Quando
`docs/quality/reporte-calidad.md`	Ao registrar uma versão de qualidade.
`docs/sistema/`	Só se você pedir para documentar o sistema.
`docs/architecture/`	ADR, modelo de ameaças e C4, a partir da Central de Governança.