Repository navigation
Agente internal auditor
Esta página descreve o agente internal-auditor de forma didática. Se algum termo for novo, consulte o Glossário.
Este agente é o auditor interno: o dono do "livro" do projeto, ou seja, o dossiê de auditoria completo que se entregaria a um auditor externo. Auditar é revisar com cuidado para confirmar que tudo está correto e em conformidade. Ele não revisa tudo sozinho: ele define o escopo, organiza os especialistas certos para cada parte, junta os resultados num documento único e coerente, classifica os problemas encontrados e acompanha a correção.
O Claude Code aciona este agente quando o pedido envolve uma revisão consolidada e organizada do projeto inteiro. Exemplos de frases que costumam acionar o auditor:
- "preciso de uma auditoria completa do projeto".
- "monte o dossiê de auditoria, o livro do projeto".
- "um auditor externo pediu todas as evidências do projeto".
- "quais são as falhas de conformidade técnica que ainda temos?".
- "acompanhe a correção dos problemas que a auditoria encontrou".
- Define o escopo da auditoria, ou seja, quais capítulos o livro precisa ter, conforme a tecnologia usada e o tamanho do projeto. Um projeto pequeno tem um livro enxuto; um produto regulado tem o livro completo.
- Organiza os especialistas certos para cada capítulo. Por exemplo, segurança vai para o engenheiro de segurança; testes vão para o engenheiro de qualidade; documentação vai para o redator técnico. Ele decide o plano e a thread principal aciona cada especialista.
- Consolida tudo num livro coerente, guardado na pasta de auditoria do projeto, com um índice mestre e um resumo executivo (uma visão geral curta para quem tem pouco tempo).
- Classifica cada problema encontrado por gravidade: crítico, importante ou cosmético. Cosmético é um detalhe que não afeta o funcionamento.
- Acompanha a correção. Para cada problema, registra o plano de correção, confirma o reteste e marca se já foi resolvido.
- Exige evidência. Problema sem prova não entra no livro, e nenhum problema crítico fica sem plano de correção. O livro é honesto: lista o que falhou, sem maquiar.
Cor azul (operacional). Família: Suporte, Docs, Legal e Idiomas. Ele coordena especialistas e consolida resultados; reporta a Cláudio (CLO, jurídico e conformidade), Narciso (CISO, segurança) e Caetano (CTO, técnico).
-
AUDITORIAS: o manual mestre da auditoria, com as listas de verificação e a escala de gravidade. É a fonte obrigatória dos capítulos e da classificação. -
CONTRACT: padrões de código do projeto. -
TESTES: a suíte de testes e o que precisa estar coberto. -
DEPLOY_CHECKLIST: as verificações de publicação e de reversão (voltar atrás com segurança). -
pipeline_release_1.0: as 12 fases; ele atua na fase de conformidade e nas auditorias periódicas. -
ORG: governança, quem decide o que e o ajuste de escopo conforme o tamanho do projeto. -
TOOLING: as ferramentas livres que ele pode usar para apoiar a auditoria.
Você diz: "um cliente vai contratar uma auditoria externa, prepare o livro do nosso projeto". O agente define os capítulos necessários, monta o plano indicando qual especialista cuida de cada parte, organiza o dossiê com índice mestre e resumo executivo, classifica os problemas por gravidade e entrega um parecer sobre o quanto o projeto está pronto para a auditoria externa.
Veja também Cláudio (CLO), Narciso (CISO) e Caetano (CTO), que coordenam este agente, e os colegas de família support-engineer, technical-writer, compliance-legal e i18n-l10n-specialist. Voltar para a Home.