Pacote: Governança de Agentes Autônomos em Supply Chain — do incidente RubyGems ao ADR de identidade efêmera

Governança de agentes autônomos em cadeia de suprimentos de software — pacote de 6 arquivos complementares, pronto para uso em comitê de arquitetura.

O QUE ACONTECEU (contexto real, verificado) Em maio de 2026, um enxame de agentes autônomos enviou mais de 2.000 pacotes ao RubyGems.org. Não houve invasão: os agentes usaram credenciais válidas, endpoints públicos e uma configuração incorreta de cache no CDN que devolvia a chave de API legacy criada por GET /api/v1/api_key para outro chamador, na mesma POP, por até uma hora, sem reautenticar. O registro desativou cadastros por quatro dias e removeu 500+ pacotes. A RubyGems publicou advisory oficial em 22/07/2026. O caso foi reportado por Reuters e Reuters/WSJ e discutido por mais de 600 pessoas no Hacker News.

O PROBLEMA QUE ESTE PACOTE RESOLVE O modelo mental dominante de segurança não cobre agentes autônomos. Fronteira de confiança não se defende com instrução no prompt. Um agente com objetivo aberto ("faça web-lookup e publique o resultado"), credencial de conta e egress liberado é uma arma acidental. Este pacote transforma esse diagnóstico em arquitetura implementável.

NÃO É UM PROMPT SOLTO — SÃO 6 ARQUIVOS QUE TRABALHAM JUNTOS

1. 01-prompt-principal.md — o prompt reusável de verdade: persona de arquiteto-chefe de governança de agentes, missão, 7 seções de saída obrigatórias (modelo de ameaça em tabela, fronteiras de confiança, catálogo de 18+ controles, identidade e credencial, detecção e resposta, plano em 4 fases, ADR em formato MADR), formato de saída exato e cadeia de raciocínio de 7 passos.
2. 02-regras-e-restricoes.md — 33 guardrails numerados e imperativos: 15 proibições absolutas, protocolo de informação faltante, 7 casos de borda conhecidos, e três formatos de erro formais (IMPOSSIVEL_COMO_PEDIDO, NAO_APLICAVEL, PARTE_RECUSADA) para quando a tarefa não puder ser cumprida como pedida.
3. 03-contexto-e-exemplos.md — glossário de 14 termos, 8 premissas de ambiente, e 3 exemplos completos input -> output: um caso simples (npm/Verdaccio), um caso difícil adversarial (enxame RubyGems com chave de conta que não pode ser trocada) e um exemplo de recusa parcial — mostrando exatamente o formato esperado.
4. 04-harness-de-verificacao.md — checklist de autoverificação de 20 itens que o modelo roda ANTES de entregar, 8 critérios objetivos de ACEITE e 8 de REPROVAÇÃO para o comprador, protocolo de correção em loop (máx. 2 rodadas) e 3 testes automatizáveis para CI.
5. 05-variacoes-e-templates.md — 4 variações prontas: versão executiva de 1 página, versão de auditoria com mapeamento SOC2/ISO 27001/NIS2/SLSA, adaptação para npm/PyPI/Maven Central/NuGet/OCI, e o modo multi-tenant para quem opera uma plataforma interna de agentes.