Agente de Decisão Arquitetural: Framework Multi-Arquivo para Governança de Mudanças com IA

Este não é um prompt solto — é um pacote completo de 5 arquivos complementares que transforma qualquer LLM de código em um Agente de Decisão Arquitetural para sua organização.

O que você leva?

5 arquivos projetados para trabalhar juntos:

1. 01-prompt-principal.md — O prompt reutilizável que transforma o modelo num arquiteto de software sênior. Define persona, metodologia de raciocínio, formato de saída estruturado (schema YAML completo) e o passo a passo para avaliar mudanças arquiteturais.

2. 02-regras-e-restricoes.md — Guardrails explícitos: regras numeradas sobre o que o modelo JAMAIS deve fazer, como lidar com contexto insuficiente, casos de borda em decisões ambíguas e formato padronizado de erro.

3. 03-contexto-e-exemplos.md — Glossário de termos (ADR, trade-off, risco técnico, dívida arquitetural), premissas do ambiente (organização de engenharia com N squads) e 3 exemplos completos few-shot, incluindo um caso de borda real (CVE recém-descoberta que força uma mudança de rota).

4. 04-harness-de-verificacao.md — Checklist de auto-verificação que o modelo executa antes de entregar a resposta, mais critérios de aceite objetivos para o comprador validar as saídas.

5. 05-adaptacao-stacks.md — Templates de variação para adaptar o prompt a diferentes stacks (Kubernetes, Serverless, Microsserviços) e níveis de maturidade.

Para quem é?

• Arquitetos de software que precisam escalar sua capacidade de revisão
• Tech leads que querem automatizar ADRs sem perder qualidade
• Plataformas de engenharia que desejam embedar governança em pipelines CI/CD
• Consultorias que fazem avaliações arquiteturais recorrentes