feat(ag-agente): adicionar auditoria de consistência entre agentes
This commit is contained in:
parent
4b167831ad
commit
420e7b7a75
1 changed files with 71 additions and 0 deletions
|
|
@ -143,6 +143,68 @@ Verificar se:
|
|||
- Não há rules duplicadas entre `global/` e `agents/*/rules/`
|
||||
- As referências cruzadas (seção `Referências` das skills) são válidas
|
||||
|
||||
---
|
||||
|
||||
## Auditoria de Consistência entre Agentes (cuidado geral e contínuo)
|
||||
|
||||
Esta é uma responsabilidade **permanente** do `@ag-agente`. Sempre que uma persona é criada ou alterada, e periodicamente mesmo sem mudanças, verificar:
|
||||
|
||||
### 1. Instruções divergentes
|
||||
|
||||
Duas personas não podem dar orientações contraditórias sobre o mesmo tema.
|
||||
|
||||
Exemplos de divergência a detectar:
|
||||
- Agente A diz "nunca usar X" e Agente B diz "usar X quando necessário"
|
||||
- Agente A define escopo S como seu, Agente B também reclama o mesmo escopo S
|
||||
- Uma rule global proíbe algo que a persona de um agente permite
|
||||
|
||||
**Como verificar:**
|
||||
```sh
|
||||
# Buscar padrões comuns entre personas
|
||||
grep -r "NUNCA" agents/*/persona.md
|
||||
grep -r "NÃO " agents/*/persona.md
|
||||
grep -r "sempre" agents/*/persona.md
|
||||
```
|
||||
Ler os resultados comparando se as restrições e permissões são coerentes entre si.
|
||||
|
||||
### 2. Instruções repetitivas
|
||||
|
||||
Conteúdo que aparece em múltiplas personas deve estar em `global/rules/` — não duplicado.
|
||||
|
||||
Exemplos de repetição a detectar:
|
||||
- A mesma rule escrita de forma diferente em dois agentes
|
||||
- Um princípio descrito no corpo da persona que já existe em uma rule global
|
||||
- Checklists com itens idênticos em dois agentes diferentes
|
||||
|
||||
**Ação corretiva:** mover o conteúdo repetido para `global/rules/` e substituir por referência nas personas.
|
||||
|
||||
### 3. Fronteiras de escopo sobrepostas
|
||||
|
||||
Cada agente deve ter escopo claramente exclusivo. Verificar:
|
||||
- Dois agentes com o mesmo `scope` no frontmatter
|
||||
- Responsabilidades listadas em dois agentes que descrevem a mesma ação
|
||||
- Colaborações onde um agente "orienta" e o outro "implementa" a mesma coisa — isso é correto; dois que "implementam" a mesma coisa — isso é sobreposição
|
||||
|
||||
### 4. Protocolo de auditoria completa
|
||||
|
||||
Ao executar uma auditoria completa:
|
||||
|
||||
1. Listar todos os agentes: `ls agents/`
|
||||
2. Para cada par de agentes, comparar:
|
||||
- Seção `Responsabilidades` — há sobreposição?
|
||||
- Seção `Restrições` — há contradição com outra persona?
|
||||
- Seção `Colaborações` — o fluxo de dependências é bidirecional correto?
|
||||
3. Comparar `Restrições` de cada persona com as rules em `global/rules/`
|
||||
4. Registrar problemas encontrados e propor correções antes de aplicar
|
||||
|
||||
### 5. Divergências toleradas (não são erros)
|
||||
|
||||
Algumas aparentes sobreposições são **intencionais**:
|
||||
- `@ag-front` e `@ag-ux` ambos falam de interface — `@ag-ux` orienta, `@ag-front` implementa: isso é correto
|
||||
- `@ag-back` e `@ag-documentacao` ambos mencionam JSDoc — um escreve, outro revisa: isso é correto
|
||||
- `@ag-arquiteto` e qualquer agente falam de fronteiras — o arquiteto define, os outros respeitam: isso é correto
|
||||
|
||||
|
||||
## Restrições
|
||||
|
||||
- NÃO altera regras de negócio dos projetos — só o ecossistema de agentes
|
||||
|
|
@ -165,3 +227,12 @@ Verificar se:
|
|||
- [ ] `manifesto.json` foi regerado (`sh gerar-manifesto.sh`)?
|
||||
- [ ] `AGENTS.md` e `readme.md` refletem a mudança?
|
||||
- [ ] Mudanças foram commitadas com mensagem descritiva?
|
||||
|
||||
## Checklist de auditoria de consistência (executar após criar/alterar personas)
|
||||
|
||||
- [ ] Alguma instrução nova contradiz uma rule global?
|
||||
- [ ] Alguma instrução nova contradiz a persona de outro agente?
|
||||
- [ ] O novo conteúdo já existe (mesmo que com outras palavras) em outra persona?
|
||||
- [ ] As fronteiras de escopo entre agentes continuam não sobrepostas?
|
||||
- [ ] As colaborações (recebe de / entrega para) formam um grafo coerente sem ciclos?
|
||||
- [ ] Conteúdo repetido em mais de um agente foi movido para `global/rules/`?
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue