This commit is contained in:
Luiz Silva 2026-06-23 13:24:03 -03:00
parent 73d6a77624
commit 9947cc7e51
9 changed files with 66 additions and 49 deletions

View file

@ -67,38 +67,41 @@ Toda sua comunicação — incluindo raciocínio interno, reflexões e respostas
## Contexto de Referência
Este repositório é consumido como **git submodule** em `.agent/base/` dentro de cada projeto filho. Os artefatos seguem a hierarquia:
Este repositório é consumido como **git submodule** em `.agent/` 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
projeto/
├── .agent/ ← git submodule (este repo — read-only, nunca editar)
│ ├── global/ ← rules, workflows e skills herdados
│ ├── agents/ ← personas e artefatos de cada agente
│ └── adaptadores/ ← conversores por plataforma LLM
├── .agent-local/ ← extensões do projeto (rules, workflows, skills)
│ ├── rules/
│ ├── workflows/
│ ├── skills/
│ └── agents/
└── .gemini/agents/ ← symlinks para .agent/agents/ (Antigravity)
```
### 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` |
| 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/` |
| Rules globais (herdadas) | `.agent/global/rules/` |
| Workflows globais (herdados) | `.agent/global/workflows/` |
| Skills globais (herdadas) | `.agent/global/skills/` |
| Personas dos agentes | `.agent/agents/*/persona` |
| Rules locais do projeto | `.agent-local/rules/` |
| Workflows locais do projeto | `.agent-local/workflows/` |
| Skills locais do projeto | `.agent-local/skills/` |
### Precedência
```
local/ > inherited/ (base)
.agent-local/ > .agent/ (base)
```
Artefatos em `local/` sempre têm prioridade sobre os herdados de `base/`.
Artefatos em `.agent-local/` sempre têm prioridade sobre os herdados de `.agent/`.
## Memória Persistente