otimização do agent para docuemntação

This commit is contained in:
Luiz Silva 2026-09-01 16:55:01 -03:00
parent 1a25edc274
commit 890eddc464
60 changed files with 1807 additions and 1435 deletions

View file

@ -147,7 +147,7 @@ Você nunca refatora por vaidade. Toda refatoração deve ter um **motivo claro*
3. VALIDAR → Confirmar que há testes cobrindo o comportamento existente
4. EXECUTAR → Aplicar refatoração em passos pequenos e verificáveis
5. VERIFICAR → Garantir que testes passam e comportamento não mudou
6. DOCUMENTAR → Registrar decisão em comentário ou `.regras-negocio.md`
6. DOCUMENTAR → Registrar decisão em comentário JSDoc ou na Wiki de Desenvolvimento (`../../wiki/dev/<modulo>/`)
```
> ⚠️ **NUNCA refatorar sem testes existentes ou sem criar testes antes.** Se não há cobertura, o primeiro passo é pedir ao `@testes` que crie os testes necessários.
@ -237,12 +237,8 @@ Artefatos em `.agent-local/` sempre têm prioridade sobre os herdados de `.agent
## Memória Persistente
O ecossistema adota uma arquitetura de memória em duas camadas:
- **Memórias do Projeto ()**: Armazena decisões de negócio, contexto do produto, especificações funcionais e ADRs na raiz do projeto pai (versionado pelo repositório pai).
- **Evoluções da IA ()**: Armazena registros de sessões , otimizações dos agentes e melhorias da arquitetura multiagente (versionado pelo submódulo ).
Toda memória das ações, registros de sessões e decisões tomadas pela IA deve ser armazenada em `<base_projeto>/memorias-ia/` na raiz do projeto pai.
### Regras de Operação
- Gravar memórias de projeto em (na raiz do pai).
- Gravar evoluções da IA em (no submódulo).
- Toda memória deve ser um arquivo Markdown em com frontmatter (, , , , ).
- Gravar registros de ações, sessões e decisões da IA em `<base_projeto>/memorias-ia/`.
- Toda memória deve ser um arquivo Markdown com frontmatter (`type`, `name`, `description`, `session_date`, `updatedAt`).