Pare de reabrir debates resolvidos
Encontre o contexto e os trade-offs originais antes de repetir uma discussão cara.
ADR Guard — Registros de Decisões Arquiteturais
Decisões que permanecem compreensíveis
Decisões arquiteturais merecem mais do que documentos esquecidos.
Documente, valide, revise e evolua decisões de arquitetura com confiança. O ADR Guard une aprendizado, fluxo de equipe e automação verificável.
ADR-0042 · Proposta
Adotar Redis para cache distribuído
- Contexto
- Consultas repetidas elevam a latência.
- Decisão
- Cache-aside com TTL explícito.
- Consequência
- Menos carga; nova complexidade operacional.
Por que ADRs importam
Dê memória duradoura às decisões.
O código mostra o que o sistema faz. Um ADR preserva por que uma escolha relevante foi feita, quais alternativas foram consideradas e o que a equipe aceitou em troca.
Integre pessoas com contexto
Ajude novos profissionais a entender restrições sem deduzir a intenção apenas pelo código.
Rastreie mudanças no tempo
Substitua decisões explicitamente e preserve o caminho até a arquitetura atual.
O que o ADR Guard faz
Uma proteção prática, não um robô de aprovação.
O ADR Guard funciona localmente e em fluxos de entrega. Ele valida contratos documentais e relações; pessoas continuam responsáveis pelo julgamento e pela aceitação arquitetural.
Criar
Gere ADRs canônicos Minimal ou Extended, ou use um template customizado com restrições claras.
Validar
Confira estrutura, status, relações, arquivos alterados e baselines de diagnósticos.
Revisar
Solicite revisão assistida por IA com provedores explícitos, controles de segurança e julgamento humano.
Rastrear
Gere um índice e mantenha substituições e relações navegáveis.
Integrar
Use CLI, GitHub Action oficial, contêiner e extensão VS Code executada no workspace.
Rascunhar
Use assistência opcional de IA sem tratar texto gerado como decisão aceita.
Escolha seu caminho
Comece de onde você está.
Aprenda o conceito, escreva o primeiro registro, desenhe uma prática de equipe ou vá direto às ferramentas.
Agent Skills
Leve o ADR Guard para seu agente de IA.
11 Agent Skills portáteis orientam a identificação, criação, validação, revisão e evolução de decisões arquiteturais — sem transferir a aprovação para a IA.
Escolha o fluxo certo
Descubra seis skills essenciais e cinco avançadas: da decisão sobre registrar um ADR à auditoria e substituição.
Instale no seu agente
Use o Skills CLI para selecionar o necessário. A CLI .NET do ADR Guard é instalada separadamente.
Experimente exemplos reais
Analise uma escolha, compare alternativas, proponha um ADR ou revise seu histórico com segurança.
Ciclo da decisão
Preserve o histórico. Mude de direção de forma explícita.
Os status canônicos descrevem o registro. Sua organização decide quem propõe, revisa e aceita.
- 1Proposed
A decisão está aberta para análise e revisão.
- 2Accepted
Pessoas autorizadas concordaram em seguir a decisão.
- 3Deprecated
A decisão não é mais recomendada, mas o histórico permanece.
- 4Superseded
Um novo ADR substitui explicitamente esta decisão.
Biblioteca de exemplos
Veja trade-offs reais, não templates vazios.
Cada cenário explica contexto, alternativas, critérios, consequências e quando aquele nível de detalhe é útil.
Performance
Cache distribuído com Redis
Compare a mesma decisão em Minimal, Extended e MADR 4.0.
Ler exemplo →Integração
Comunicação síncrona ou assíncrona?
Equilibre acoplamento, resiliência, latência, consistência e custo operacional.
Ler exemplo →Evolução
Substituir uma decisão
Mude de direção sem reescrever o histórico arquitetural.
Ler exemplo →Faça a próxima decisão arquitetural ser explicável.
Comece com uma decisão real. Mantenha o registro proporcional, revise com as pessoas afetadas e automatize somente as verificações que uma ferramenta pode realmente fazer.