Arquiteto de Troca de Modelo de IA: ADR, matriz de paridade e rollout por fatias de tráfego

Arquiteto de Troca de Modelo de IA — um pacote de 6 arquivos que leva um LLM a produzir uma decisão arquitetural defensável quando um modelo de linguagem muda debaixo do seu produto: um lançamento mais barato, um corte de preço, uma deprecação anunciada ou um novo fornecedor no radar.

O problema: o mercado de modelos muda a cada poucas semanas — um modelo novo chega mais barato, outro é descontinuado com prazo, o preço cai pela metade. A maioria dos times reage com um palpite ("esse é melhor no benchmark, vamos trocar") e descobre a regressão na tarefa que mais importa, já em produção. Trocar de modelo não é uma questão de benchmark público: é uma decisão de arquitetura que envolve paridade na tarefa crítica, custo por tarefa concluída, latência, reversibilidade e lock-in. Este pacote transforma esse evento de mercado em uma ADR completa, com matriz de pesos, plano de avaliação, rollout por fatias de tráfego e plano de reversão.

Para quem: arquitetos de software, tech leads, staff engineers, donos de plataforma e times de IA que já colocaram LLMs em produção e precisam decidir, com evidência, se e como trocar de modelo — sem quebrar o que já funciona.

Você fornece: um dossiê do sistema — o que o produto faz, qual é a tarefa crítica, modelo atual, custo e latência atuais, volume, requisitos de qualidade, restrições de compliance e dados, contexto do evento de mercado que disparou a dúvida.

Você recebe: um Documento de Decisão de Modelo em 7 seções fixas: enquadramento e fronteira da decisão; no mínimo 3 alternativas (incluindo "não fazer nada"); matriz de decisão com pesos explícitos e soma visível; plano de avaliação com golden set e critérios numéricos; estratégia de rollout por fatias com rollback automático; plano de reversão com RTO; e a lista de lacunas e riscos aceitos.

Arquivos do pacote:

• 01-prompt-principal.md — o prompt reusável: persona de arquiteto de plataforma de IA, objetivo, schema exato de saída em 7 seções e o passo a passo de raciocínio.
• — guardrails numerados: nunca inventar números, nunca recomendar 100% de tráfego de uma vez, nunca adotar modelo sem golden set no domínio, casos de borda (dossiê vazio, deprecação com prazo, tarefas com requisitos opostos) e formato de erro.