ADR de adoção de sandbox seguro para agentes de IA (pacote multi-arquivo: prompt + guardrails + exemplos + harness de verificação)

Gerador de Architecture Decision Records (ADR) para adotar sandboxing seguro na execução autônoma de agentes de IA de codificação (Claude Code, Codex, Gemini CLI, OpenCode). Este não é um prompt solto: é um pacote de 5 arquivos complementares, no padrão que um engenheiro de prompt senior usaria para levar um agente a alta precisão numa tarefa real de arquitetura.

Conteúdo do pacote: • 01-prompt-principal.md — o prompt reusável com persona (arquiteto sênior de agentes/segurança), objetivo, formato de saída exigido (schema estrito de 9 seções de um ADR) e passo a passo de raciocínio. • 02-regras-e-restricoes.md — 12 guardrails imperativos (nada de métricas inventadas, sem docker.sock / --privileged / credenciais no filesystem, egress-by-default) + formato de erro padronizado. • 03-contexto-e-exemplos.md — glossário de domínio, premissas do ambiente e 2 exemplos few-shot completos, incluindo um caso difícil (prompt injection tentando exfiltrar código). • 04-harness-de-verificacao.md — checklist de autoverificação de 9 itens que o modelo roda antes de entregar + 8 critérios objetivos de aceite para você validar as saídas. • 05-templates-de-variacao.md — 4 variações: Docker vs. microVM vs. serviço gerenciado, versão executiva enxuta, agentes de propósito geral e transição sem secret broker.

Para quem é: • Plataformas e DevEx engineers que querem dar autonomia a agentes de codificação sem abrir a superfície de ataque; • Times de segurança precisando documentar em ADR por que “só isolar” não basta (egress e credenciais importam); • Qualquer engenheiro que queira uma forma reproduzível de gerar decisões de arquitetura auditáveis.

Negócio: cada arquivo tem um papel distinto; use-os juntos para gerar ADRs consistentes, lastreados no contexto e aprováveis por review — com critérios objetivos para distinguir uma boa resposta de uma resposta imprecisa.