ADR de Migração de Produtores Kafka com Zero Downtime: pacote multi-arquivo para projetar corte reversível e sem perda de mensagens em sistemas orientados a eventos

Pacote de 5 arquivos complementares (não é um prompt solto) que transforma você e a sua ferramenta de IA em um Engenheiro Sênior de Confiabilidade de Streaming, capaz de desenhar e validar a migração de produtores Apache Kafka de um cluster para outro SEM parar serviços, SEM janela de manutenção e SEM perder mensagens reconhecidas.

O pacote foi construído a partir de um caso real e recente da indústria: a migração automática de produtores entre clusters Kafka que fez sucesso no Hacker News (o sistema 'Orbit Auto Migration' da WarpStream, que usa uma state machine por tópico e um proxy de encaminhamento de produce). O tema é genérico: migrar para Kafka gerenciado (Confluent/MSK/Aiven), trocar de provedor, consolidar clusters ou mover produtores legados — todos os cenários que exigem corte com zero downtime.

O que você recebe: • 01-prompt-principal.md — o prompt reusável de verdade, com a persona de 'Engenheiro Sênior de Streaming', o objetivo (ADR + protocolo de corte), um schema de saída absoluto em Markdown (Status, Contexto, Decisão, Protocolo por estado REJECT/PROXY/MIGRATING/COMPLETE, detecção de riscos, rollback, durabilidade e idempotência, critérios de aceite, observabilidade e plano de implementação) e um passo a passo de raciocínio em 7 etapas para levar a precisão a ~99%. • 02-regras-e-restricoes.md — 21 guardrails imperativos e numerados: proibido inventar fatos, proibido perder mensagem reconhecida, corte sempre reversível, barreira de lag em tempo, authN/authZ do destino antes de encaminhar, latency shaping + Little's Law no dimensionamento, preservação de sequência do produtor idempotente, e um formato de erro estruturado quando a tarefa não puder ser cumprida. • 03-contexto-e-exemplos.md — glossário de domínio (proxy de produce, state machine por tópico, lease de escrita, time lag, rogue producer, dual-write), premissas padrão do ambiente e 3 exemplos few-shot completos de input real → output esperado, incluindo o caso-difícil de borda (lag alto, produtor órfão de alta e de baixa frequência e idempotência com múltiplos batches em voo). • 04-harness-de-verificacao.md — checklist de autoverificação em 14 itens que o modelo roda ANTES de entregar, 15 critérios objetivos de aceite que VOCÊ usa para julgar as saídas (7 essenciais + 8 de robustez) e um roteiro de teste prático de 5 passos. • 05-templates-de-variacao.md — 6 templates: versão executiva curta, versão longa com apêndices, adaptação para MirrorMaker 2, produtor sem idempotência, tópicos de alto volume e um comando de sweep comparando proxy vs dual-write vs feature-flag.

Inclui 3 diagramas SVG ilustrando a state machine por tópico, a fase PROXY com o proxy de encaminhamento e a sequência do corte com as garantias de durabilidade. Ideal para arquitetos de plataforma, SRE, times de dados e streams, e equipes que migram para Kafka gerenciado ou trocam de provedor sem poder parar a produção.