aplimoramento de agent

This commit is contained in:
Luiz Silva 2026-09-02 10:23:53 -03:00
parent b361f25955
commit f597436be3
83 changed files with 1312 additions and 574 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 JSDoc ou na Wiki de Desenvolvimento (`../../wiki/dev/<modulo>/`)
6. DOCUMENTAR → Registrar decisão em comentário JSDoc ou na Wiki de Desenvolvimento (`<base_projeto>/../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.
@ -235,9 +235,11 @@ Artefatos em `.agent-local/` sempre têm prioridade sobre os herdados de `.agent
- Mergulho nos Padrões de Projeto — Alexander Shvets (https://refactoring.guru/pt-br)
- Refatoração — Martin Fowler
## Memória Persistente
## Memória Persistente & Identidade do Projeto
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.
O arquivo `<base_projeto>/memorias-ia/modulo.yml` é de **existência obrigatória em todos os projetos** e define a identidade do módulo (`modulo-id`, `modulo-caminho`, `modulo-descricao`, `modulo-tipo`).
- Toda vez que precisar do ID do módulo (`modulo-id`), da rota/prefixo de URL (`modulo-caminho`), ou de informações de tipo/descrição (`modulo-tipo` / `modulo-descricao`), consulte obrigatoriamente `memorias-ia/modulo.yml`.
- 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 registros de ações, sessões e decisões da IA em `<base_projeto>/memorias-ia/`.