From 420e7b7a75d208a9422542daa873486a102f7b81 Mon Sep 17 00:00:00 2001 From: Luiz Silva Date: Thu, 18 Jun 2026 16:20:57 -0300 Subject: [PATCH] =?UTF-8?q?feat(ag-agente):=20adicionar=20auditoria=20de?= =?UTF-8?q?=20consist=C3=AAncia=20entre=20agentes?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- agents/ag-agente/persona.md | 71 +++++++++++++++++++++++++++++++++++++ 1 file changed, 71 insertions(+) diff --git a/agents/ag-agente/persona.md b/agents/ag-agente/persona.md index 70d78bf..1e96e6c 100644 --- a/agents/ag-agente/persona.md +++ b/agents/ag-agente/persona.md @@ -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/`?