Pacote Multi-Arquivo: Resiliência de Registry de Artefatos — Write-Path Degradado, Read-Only e Contingência (ADR + Runbook + Harness)

Pacote de 6 arquivos complementares para levar um LLM a ~99% de precisão ao projetar a resiliência do write-path do seu registry de artefatos — exatamente o modo de falha que derrubou a publicação de imagens quando o Quay.io entrou em modo read-only por corrupção de tabelas de metadados (14–15/set/2026): push bloqueado, pull intacto.

NÃO é um prompt solto. É um sistema de instruções em camadas, no padrão que engenheiros de IA usam em produção, com papéis, schema de saída, guardrails, few-shot real e harness de auditoria:

• 01-prompt-principal.md — o prompt reusável de verdade: persona ARQ-REG (arquiteto de resiliência de registry), objetivo, schema JSON exato de saída (classificação de falha, impacto build vs. execução, contingência em 3 camadas, controles de integridade, gatilhos, ADRs MADR, reconciliação, métricas, resumo executivo, confiança) e raciocínio em 10 passos. • 02-regras-e-restricoes.md — 32 guardrails imperativos: o que o modelo NUNCA faz (inventar CVE, afrouxar assinatura/RBAC, atribuir culpa, emitir texto fora do JSON), 10 casos de borda conhecidos (contexto vago, contraditório, corrupção de metadados, falha de auth, pressão por prazo) e formato de erro padronizado. • 03-contexto-e-exemplos.md — glossário de domínio (write-path, read-path, digest vs. tag, attestation, outbox, reconciliação, burn rate), 8 premissas de ambiente e 2 exemplos completos input→output: o caso real do Quay.io em read-only e um caso difícil de recusa (pedido para desabilitar verificação de assinatura). • 04-harness-de-verificacao.md — checklist de 22 autoverificações (schema, anti-alucinação, integridade, qualidade) + critérios objetivos de aceite para o COMPRADOR: 8 eliminatórios, 6 de qualidade, 5 testes de robustez e sistema de pontuação. • 05-templates-de-variacao.md — modo TRIAGEM RÁPIDA (JSON reduzido para on-call) e modo DOCUMENTO DE ARQUITETURA (ADR completo + plano por fases + riscos), mais tabela de adaptação para Harbor, ECR, GitLab, Artifactory e Docker Hub. • 06-runbook-operacional.md — playbook executável minuto a minuto (detecção, contenção, contingência, recuperação, pós-incidente), comandos de verificação reais e tabela de decisão para o plantão.

O QUE VOCÊ RESOLVE COM ISSO: separar o plano de build (write) do plano de execução (read); descobrir que um registry read-only NÃO precisa derrubar o que já está rodando; definir gatilhos com limiar numérico; ter ADRs prontos para aprovação; e garantir que a contingência nunca vire brecha de segurança.

INVARIANTE DO PACOTE: nenhuma ação de contingência pode autorizar artefato sem assinatura verificada. A degradação de disponibilidade nunca produz degradação de segurança — o pacote recusa e documenta a recusa se alguém pedir o contrário.