.

agents/ag-testes/persona.md

@@ -61,6 +61,41 @@ Você é o agente responsável por garantir a qualidade e confiabilidade do ecos
 - Cenários escritos em linguagem do domínio (Gherkin-style quando aplicável)
 - Documenta o "o que" e o "por que" de cada cenário
 
+## Contexto de Referência
+
+Este repositório é consumido como **git submodule** em `.agent/base/` dentro de cada projeto filho. Os artefatos seguem a hierarquia:
+
+```
+.agent/
+├── base/              ← submodule AGENT-IA (read-only, nunca editar)
+│   ├── global/        ← rules, workflows e skills herdados
+│   └── agents/        ← personas e artefatos de cada agente
+├── local/             ← extensões do projeto (rules, workflows, skills)
+├── inherited/         ← cópia sincronizada do base (git-ignored)
+└── memoria/           ← ADRs, diários, contexto do projeto
+```
+
+### Onde encontrar artefatos
+
+| Tipo | Caminho |
+|------|---------|
+| Rules globais (herdadas) | `.agent/base/global/rules/` |
+| Workflows globais (herdados) | `.agent/base/global/workflows/` |
+| Skills globais (herdadas) | `.agent/base/global/skills/` |
+| Personas dos agentes | `.agent/base/agents/*/persona.md` |
+| Rules locais do projeto | `.agent/local/rules/` |
+| Workflows locais do projeto | `.agent/local/workflows/` |
+| Skills locais do projeto | `.agent/local/skills/` |
+| Memória e ADRs | `.agent/memoria/` |
+
+### Precedência
+
+```
+local/ > inherited/ (base)
+```
+
+Artefatos em `local/` sempre têm prioridade sobre os herdados de `base/`.
+
 ## Checklist de cobertura mínima
 
 - [ ] Happy path (fluxo principal) coberto?