---
titulo: Auditar a construção e diagnosticar lacunas
modelo: Modelo de Gestão de Agentes de IA
codigo: M12
versao: "1.2.0-rc.1"
consumo: integral na auditoria completa; critérios afetados e dependências em avaliação focal
---

# M12 — Auditar a construção e diagnosticar lacunas

A auditoria entrega uma conclusão sustentada sobre um objeto e o ajuste que muda o próximo trabalho. Examina conteúdo, estrutura e relações. Funcionamento e utilidade pedem evidências próprias e julgamento do responsável pelo trabalho. Um kit organizado não comprova uma entrega útil; uma boa entrega isolada não aprova todo o kit.

O instrumento deste capítulo tem nove dimensões e 42 critérios. Sua versão identifica a régua; a versão do agente, a edição de cada componente, a data da leitura e o ambiente examinado são informações distintas. Aplicabilidade depende do trabalho, não da conveniência de obter uma conclusão favorável.

## 1. Definir objeto, pergunta e alcance

Recupere identidade, responsabilidade, entregas, instruções, fontes, condição atual, originais, cópias e ambientes pertinentes. Especifique a pergunta: conferir construção completa; examinar uma relação focal; compreender uma ocorrência; ou verificar correção já decidida. Uma mudança pequena não exige automaticamente auditoria integral.

Na conferência completa, percorra todos os critérios aplicáveis no universo declarado. Em conferência focal, nomeie critérios e dependências e limite a conclusão a esse recorte. Uma amostra pode comprovar uma lacuna; não aprova silenciosamente o restante da dimensão.

Declare o acesso efetivo. Documento inacessível, busca sem resultado e conteúdo lido insuficiente são situações diferentes. Antes de apontar uma ausência, procure a contribuição no corpo, nos apoios e nas relações pertinentes. O conteúdo pode existir com outra apresentação.

### Relacionar pergunta e prova

Antes do veredito, separe as perguntas que o pedido reúne. Congruência pede confronto das proposições, condições e relações nos corpos; clareza pede percorrer pedido, orientação e julgamento; capacidade operacional pede transformação finalística com insumos, operação, produto e efeito; localização pede percurso real na superfície examinada. Diga o que cada evidência permite concluir e o que falta para a pergunta restante.

Igualdade por hash e conferência de versão têm valor para correspondência, mas não concedem lógica ou suficiência de inteligência. Tabelas na entrada, núcleo e rotas podem cumprir funções complementares. Só proponha consolidação quando identificar fato concorrente, divergência ou esforço de manutenção material; preserve a relação correta. Data de modificação não prova mudança de conteúdo sem histórico. Uma auditoria de leitura não precisa produzir escrita para ser válida.

## 2. Ler conteúdo e relações

Relacione responsabilidade e entrega ao conhecimento necessário. Leia o que a fonte ensina a perceber, compreender, julgar e fazer. Extensão, títulos completos e quantidade de documentos não demonstram profundidade. Uma referência pontual não precisa ter a mesma anatomia de um método inteiro; o conjunto precisa sustentar o trabalho.

Separe as casas de avaliação: Estrutura examina componentes e lugares; Higiene examina o conteúdo que os ocupa e suas versões; Inteligências examina conhecimento; Cognição examina mobilização e julgamento; Skills examina transformações reutilizáveis. Um mesmo achado pode afetar relações entre dimensões, sem se tornar várias falhas independentes.

Confira original e cópia, conteúdo e edição, disponibilidade e presença. Corpos iguais podem ter edição de origem ambígua; versão visível não prova igualdade dos corpos. Uma fonte bem escrita que não chega ao contexto tem problema diferente de uma fonte que chega sem critério suficiente.

## 3. Aplicar os 42 critérios

Os critérios são funcionais. Use a organização decidida no contexto; não imponha sigla, pasta ou plataforma sem necessidade. Quando houver procedimento, preserve sua finalidade e seu original, separado funcionalmente do repertório. A separação física depende do consumo e da manutenção definidos em M05/M07.

### Identidade — 4 critérios

| ID | O que conferir |
|---|---|
| ID-01 | O propósito explica o trabalho persistente e o resultado que o agente ajuda a produzir. |
| ID-02 | Entregas, responsabilidades, limites de atuação e decisões reservadas estão identificados. |
| ID-03 | Nome, identificador e vínculos representam o mesmo agente no cadastro, instruções e fontes. |
| ID-04 | Território e interfaces com pessoas e agentes preservam responsabilidades próprias e alheias. |

### Estrutura — 5 critérios

| ID | O que conferir |
|---|---|
| ES-01 | Componentes e destinos necessários têm função reconhecível e cobrem a forma de trabalho. |
| ES-02 | Nomes, identificadores e literais de execução atendem às convenções e ao ambiente efetivamente adotados. |
| ES-03 | Originais, cópias e aplicações são identificados; a entrada corresponde à origem e às variações declaradas. |
| ES-04 | Componentes estão nos destinos previstos e os caminhos conservam a composição adotada. |
| ES-05 | Procedimentos necessários têm casa e vínculo com o processo e original competentes; sem procedimento pertinente, a condição é dispensável. |

### Inteligências — 6 critérios

| ID | O que conferir |
|---|---|
| IN-01 | O conjunto de fontes sustenta as responsabilidades e entregas, inclusive compreensão e julgamento além dos procedimentos existentes. |
| IN-02 | O conteúdo desenvolve sinais, conceitos, distinções e relações que mudam a leitura da situação. |
| IN-03 | Critérios e razões permitem comparar alternativas e reconhecer condições de aplicação. |
| IN-04 | As operações explicam como transformar informações na contribuição prometida. |
| IN-05 | Exemplos, contrastes, exceções e limites esclarecem o mecanismo na profundidade necessária. |
| IN-06 | Origem, autoridade, relação de aplicação e atualização são identificáveis; existe conteúdo efetivo além de títulos e links. |

### Cognição — 4 critérios

| ID | O que conferir |
|---|---|
| CO-01 | A entrada declara identidade, direção e como ativar núcleo e fontes necessários. |
| CO-02 | O núcleo desenvolve sinais, distinções e julgamentos próprios do território. |
| CO-03 | A orientação explica quando mobilizar cada contribuição material, o que acrescenta e onde termina. |
| CO-04 | Percepção, compreensão, escolha, produção e conclusão estão articuladas com autoridade e continuidade. |

### Skills — 5 critérios

| ID | O que conferir |
|---|---|
| SK-01 | Transformações recorrentes foram relacionadas aos recursos pertinentes, aproveitando o suficiente antes de criar concorrentes. |
| SK-02 | Cada Skill tem situação de uso, entrada, transformação e saída utilizável reconhecíveis. |
| SK-03 | Pacote e acessos declarados fornecem método, conhecimento e apoios sem dependência silenciosa da autoria. |
| SK-04 | Skills são descobertas e relacionadas à orientação, com identidades e caminhos coerentes com a forma de uso. |
| SK-05 | Skill baseada em procedimento conserva transformação, ocasião e vínculo com o original e a edição pertinente; a conversão não é obrigação de todo procedimento. |

### Rotas — 5 critérios

| ID | O que conferir |
|---|---|
| RO-01 | Há entrada de rotas proporcional às necessidades de recuperação do agente. |
| RO-02 | Entradas materiais relacionam contribuição procurada, fonte competente e destino. |
| RO-03 | Consulta, identidade, cobertura, interpretação e alternativa estão desenvolvidas quando necessárias. |
| RO-04 | Caminhos e referências são coerentes e conduzem à origem competente, sem cadastro concorrente de conteúdo mutável. |
| RO-05 | Procedimentos são localizados pela situação de trabalho, com original, acesso e seleção de contexto definidos. |

### Continuidade — 4 critérios

| ID | O que conferir |
|---|---|
| CT-01 | A fonte vigente apresenta a condição atual dos trabalhos relevantes, sem confundir construção do kit e demanda operacional. |
| CT-02 | Decisões, pendências e próximos movimentos preservam o contexto necessário à retomada. |
| CT-03 | A condição atual permite chegar a entregas, fontes e registros que a sustentam. |
| CT-04 | Registros e histórico preservam origem e mudanças úteis sem fazer a condição antiga disputar com a atual. |

### Ambiente de gestão — 4 critérios

| ID | O que conferir |
|---|---|
| AM-01 | Entradas e páginas apresentam primeiro o necessário à pergunta de uso e permitem compreender o trabalho. |
| AM-02 | Objetos, propriedades e relações representam o significado correto e aproveitam fontes existentes sem duplicação de cadastro. |
| AM-03 | Navegação permite chegar às fontes, ao trabalho e à continuidade pelos percursos previstos. |
| AM-04 | Identificação, hierarquia e apresentação são coerentes com usuários e convenções do contexto, sem tratar aparência como evidência de execução. |

### Higiene — 5 critérios

| ID | O que conferir |
|---|---|
| HI-01 | O conteúdo de cada destino corresponde à sua finalidade e ao trabalho do agente. |
| HI-02 | Conteúdo vigente, trabalho em curso, resultados e versões substituídas são distinguíveis. |
| HI-03 | Duplicações concorrentes, edições ambíguas, material sem finalidade e desatualizações materiais foram identificados e tratados ou encaminhados. |
| HI-04 | Versões anteriores conservam origem e utilidade quando necessárias; descarte depende de autoridade e dependências, sem usar idade como prova de inutilidade. |
| HI-05 | Procedimentos em uso têm processo, responsável quando definido, origem e edição recuperáveis; cópias mantêm vínculo e substituídos não se apresentam como vigentes. |

## 4. Registrar sustentação e sintetizar

Para cada critério examinado, registre objeto/edição, localização lida, evidência, conclusão e ajuste quando houver. Se a condição é inaplicável, justifique pelo trabalho. Falta de acesso não dispensa critério; falta de ensaio comportamental não impede a conferência documental do que foi suficientemente lido.

A síntese por dimensão utiliza:

- **Em ordem:** todos os critérios aplicáveis estão sustentados no universo examinado.
- **Ajustar:** há mudança concreta sustentada. Outro acesso pendente não apaga o ajuste já demonstrado.
- **Não se aplica:** existe condição real de dispensa da dimensão inteira, com razão. Dispensar um critério de procedimento não dispensa toda Estrutura, Rotas ou Higiene.

Quando falta leitura indispensável e não há conclusão sustentada, deixe a dimensão sem classificação e registre a dependência. Não invente falha e não aprove por ausência de evidência contrária. Não calcule média, percentual ou farol para compensar uma lacuna essencial. A síntese serve à ação, sem substituir as evidências.

## 5. Distinguir construção, funcionamento e utilidade

| Pergunta | Evidência adequada | Limite |
|---|---|---|
| A construção é suficiente? | Leitura de conteúdo, estrutura, relações e cópias no alcance | Não prova que a sessão recebeu ou aplicou |
| O agente funciona nesta operação? | Entrada, contexto recebido, fontes, ações e efeitos observados | Não prova que o resultado foi útil ao destinatário |
| A entrega permite o uso pretendido? | Produto, critérios, esforço residual e retorno do destinatário/responsável | Um caso não prova eficácia recorrente ou ganho causal |

Em uma ocorrência, recupere pedido, material recebido, conteúdo lido, julgamento, ação, entrega e continuidade. Preserve fatos, relatos, inferências e propostas. A avaliação humana de adequação e utilidade permanece distinta de uma classificação documental. [M15](M15-Conferir-o-Sistema-em-Uso.md) define os ensaios pertinentes.

## 6. Diagnosticar a causa e preparar ajuste

| Camada | Pergunta discriminante | Correção típica |
|---|---|---|
| Demanda | O destino e o critério estavam suficientemente definidos? | Recuperar condição decisiva em M01 |
| Conhecimento | A fonte ensina o julgamento ou a operação necessários? | Desenvolver conteúdo em M04 |
| Orientação | O agente reconheceu e mobilizou a contribuição correta? | Corrigir núcleo/entrada em M06/M08 |
| Presença | O conteúdo chegou no momento necessário? | Corrigir kit/implementação em M07/M11 |
| Rota/acesso | A sessão alcança objeto e fonte corretos? | Corrigir percurso e meio em M05/M10 |
| Execução | A operação produziu o efeito no alvo? | Corrigir contrato ou realização em M10/M11 |
| Comunicação | O destinatário consegue compreender e agir? | Ajustar a entrega aos critérios e ao uso |
| Continuidade | A próxima ocorrência encontra condição e resultado válidos? | Corrigir destino e atualização em M07/M13 |

Ligue evidência → consequência → causa confirmada ou hipótese → correção → conferência afetada. Uma hipótese causal não ganha certeza porque está em tabela. Se várias causas forem compatíveis, busque a observação que as discrimina.

Exemplo ilustrativo: o agente tratou proposta como decisão. Se a fonte não ensina a distinção, falta conteúdo; se ensina mas não chegou, falta presença; se chegou e não foi aplicada, investigue orientação/julgamento; se a análise distingue corretamente mas o registro final perde essa condição, investigue comunicação ou escrita. Acrescentar “não erre” ao início não resolve essas causas.

### Auditar comunicação e condução

Recupere destinatário, objeto, compreensão e ação esperadas, comunicação efetiva e sinais posteriores. Identifique a fratura: aquilo que a pessoa teria de inventar para compreender relação, condição, consequência ou próximo movimento. Explique a fratura com trecho e efeito, sem presumir dificuldade por vocabulário abstrato ou ausência de exemplo apenas.

Distinga os elos Recebeu → Processou → Aplicou → Resultado. Sustente cada elo necessário por evidência própria; publicação não prova leitura, “entendido” não demonstra reconstrução suficiente e silêncio não comprova falha. Sem sinais posteriores, a lacuna textual pode ser demonstrada enquanto seu efeito humano permanece desconhecido. Se a aplicação foi correta e o efeito inadequado, examine conteúdo, decisão ou processo, além da comunicação.

Prepare resposta ou ação compatível com a fratura: referente claro, mecanismo, exemplo, sequência, evidência ou forma adequada ao uso. Preserve identidade, condição, responsabilidade, certeza e limite. Na condução, examine se perguntas mudam decisão indispensável, se há trabalho já autorizado devolvido à pessoa e se a decisão reservada vem preparada. Uma aplicação manual recebe texto/pacote, destino e critério de conferência. [M14](M14-Construir-a-Conducao-do-Agente-Construtor.md) desenvolve a condução; esta seção orienta sua auditoria.

O diagnóstico pode concluir sem classificação documental; quando os 42 critérios contribuírem, vincule a evidência aos IDs pertinentes, sem criar nota ou dimensão comunicacional. Nova redação é preparada; recebimento, compreensão, aplicação e utilidade continuam dependendo de prova própria.

## 7. Devolver, corrigir e retestar

Entregue conclusão primeiro, seguida de objeto/alcance, sustentação, achados com consequência, ajuste prioritário e dependências. “Melhorar inteligência” não orienta: identifique a contribuição faltante, onde precisa entrar e como conferir. Priorize pelo efeito no trabalho, sem pesos inventados.

Auditoria produz diagnóstico e recomendação; correção depende do alcance recebido. Com ordem suficiente, aplique o ajuste, preserve evidências e contribuições, releia o alvo e examine consumidores pertinentes. Mudanças de identidade, mandato e autoridade permanecem com a competência correspondente. Reforma ampla utiliza a construção de [M03](M03-Conceber-o-Agente-e-suas-Capacidades.md)–[M11](M11-Implementar-e-Instalar-em-Cada-Ambiente.md).

Corrija também a entrega ou condição falsa que continuaria produzindo erro, quando autorizado. Repita a conferência material afetada, preservando o critério e distinguindo reteste documental de novo uso. Não amplie automaticamente para todos os agentes nem repita testes já suficientes sem nova razão. [M13](M13-Operar-Gerir-e-Evoluir-o-Conjunto.md) dá destino ao aprendizado, e M15 organiza a evidência de operação. O encerramento informa o que foi examinado, corrigido e conferido, com os limites reais.