.ai 文件夹 · Yuli Code

Yuli 在你的项目中保存了什么、哪些内容与团队一起进行版本管理，以及哪些只保留在你的电脑上。

Yuli 在每个项目的 .ai/ 文件夹中保存质量契约、任务、记忆、规则及其工作数据。其中一部分通过 Git 与团队共享；另一部分是本地的，绝不会上传。

Yuli 绝不会编辑你的 .gitignore。需要排除在 Git 之外的内容会添加到 .git/info/exclude 中，该文件仅对你的仓库副本生效。

排除在 Git 之外的内容

Yuli 会将以下几行添加到 .git/info/exclude：

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

结构

.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

纳入版本管理的文件

路径	内容
`contract.json`	质量契约。这是受保护的路径：智能体无法编辑。
`quality.json`	度量阶段的设置和估算假设。可选。
`memory/`	`memory.json` 和 `MEMORY.md`：智能体需要记住的项目信息。
`rules/`	`*.md` 中的团队规则，以及包含习得规则的 `learned.md`。
`glossary.json`	领域术语表，可在治理中心中编辑。
`team.json`	团队共享设置。
`devops.json`	项目的 CI/CD 连接。
`compound.yaml`	Web Studio 中由 Compound 启动的服务。
`requirements/traceability.json`	规则 ↔ 测试可追溯性。
`design/system.json`	Web Studio 的设计系统（token）。
`web/mocks.json` 和 `web/contracts/`	API 模拟器的规则和契约。

本地文件夹

`state/`

只在你的电脑上才有意义的工作数据。绝不会上传。

路径	内容
`state/quality/versions.json`	当前版本和 N−1 的数据。
`state/quality/history.jsonl`	简短的数字序列（最多 30 个版本）。
`state/quality/agent.jsonl`	智能体自身的统计数据。
`state/contract-audit.jsonl`	每次契约更改的审计记录。
`state/deployments.jsonl`	为 DORA 记录的部署。
`state/reviews.jsonl`	独立评审。
`state/agent-cost.jsonl`	智能体的成本。

`codebase/`

代码智能索引：code_intelligence.db，一个包含符号图的 SQLite 数据库。它会自动重新生成；删除它不会丢失任何内容。

任务

智能体的每个任务都保存在 missions/<conversación>/ 中，包含两个文件：

mission.json：原始需求、需求条目、验收标准、决策、假设、计划、改动过的文件和交接点。
PLAN.md：可读的计划。

参见任务与阶段。

项目之外

个人内容不保存在 .ai/ 中。你的设置、自定义提示词、技能和钩子以及聊天历史，都保存在你用户目录下的 Yuli 配置文件夹中。在 Windows 上：

文件夹	保存的内容
`%APPDATA%\.yulicode`	设置、提示词、自定义技能、钩子和聊天历史。
`%LOCALAPPDATA%\.yulicode`	运行时、索引、缓存和日志。可以删除。

智能体编写的文档

在 .ai/ 之外，智能体只在适当的时候编写文档：

路径	时机
`docs/quality/reporte-calidad.md`	记录质量版本时。
`docs/sistema/`	仅在你要求为系统编写文档时。
`docs/architecture/`	ADR、威胁模型和 C4，由治理中心生成。