Pacote Multi-Arquivo: Runtime Resiliente para Agentes de IA - ADR, Guardrails e Harness de Verificacao contra Degradacao de Provedor de Modelo

Seus agentes de código transformaram a API do provedor de modelo em dependência crítica de runtime. Em 22/09/2026, um incidente de erros elevados num provedor de fronteira durou cerca de 80 minutos e derrubou ao mesmo tempo CI, triagem de tickets e resumo de documentos. O time descobriu pelo Slack.

Este NÃO é um prompt solto. É um pacote de 5 arquivos complementares, escritos para levar um modelo a ~99% de precisão numa tarefa real de arquitetura: decidir, documentar e provar como a sua organização mantém fluxos baseados em agentes operando (ou degradando de forma controlada) quando o provedor degrada, muda contrato, esgota cota ou sai do ar.

O QUE VEM NO PACOTE

01-prompt-principal.md — o prompt reusável de verdade. Papel/persona de arquiteto sênior cético, objetivo, dois modos de operação (ADR formal ou Plano de implementação), passo a passo de raciocínio em 7 etapas obrigatórias, contrato de saída com schema exato seção por seção, e formato de erro estruturado para quando a tarefa não for cumprível.

02-regras-e-restricoes.md — guardrails numerados e imperativos. 10 proibições absolutas (a mais importante: nunca recomendar failover para fora de fronteira de compliance declarada), escala de 3 degraus para informação faltante, 10 casos de borda reais com a resposta correta, formato de erro e limites numéricos. Inclui uma versão comprimida de ~600 tokens para harness com contexto apertado.

03-contexto-e-exemplos.md — glossário operacional de 13 termos, 8 premissas do ambiente, fatos de referência verificados de setembro/2026 (com URLs), e 2 exemplos completos de input → output esperado em few-shot. O segundo exemplo é o caso difícil: um contexto com restrições mutuamente impossíveis, onde a resposta CERTA é recusar a tarefa e pedir o desempate — em vez de entregar um plano bonito que finge atender tudo.

04-harness-de-verificacao.md — 24 itens de autoverificação que o modelo roda ANTES de entregar, organizados em 4 grupos (schema, veracidade, qualidade arquitetural, integridade). Mais uma rubrica de aceite de 11 critérios com pesos para VOCÊ validar a saída, 3 testes rápidos de 30 segundos, e a receita de duas passadas (geração + crítica independente) que é o que realmente separa ~80% de perto de 99%.

05-templates-de-variacao.md — versão curta para modelos pequenos, checklist de expansão para comitê de arquitetura, tabela de ancoragem por stack (Kubernetes, serverless, CI, JVM, Python, Node) e uma variação temática completa sobre adoção de runtime dedicado vs. orquestrador genérico.