Architecture Decision Records (ADRs)¶

O que são ADRs?¶

Architecture Decision Records (ADRs) documentam decisões arquiteturais significativas junto com seu contexto e consequências.

Por que ADRs?¶

Quando alguém pergunta "Por que fizemos dessa forma?", um ADR fornece a resposta: - Contexto: Qual situação motivou essa decisão? - Decisão: O que foi decidido? - Consequências: Quais são os trade-offs?

Formato do ADR¶

# ADR-XXXX: Título

## Status

[Proposto | Aceito | Depreciado | Substituído]

## Contexto

Qual problema estamos resolvendo?
Quais restrições existem?

## Decisão

O que foi decidido?

## Consequências

### Positivas
- Benefícios dessa decisão

### Negativas
- Desvantagens ou trade-offs

### Neutras
- Outros efeitos

## Alternativas Consideradas

Quais outras opções foram avaliadas?
Por que não foram escolhidas?

ADRs Atuais¶

Criando um Novo ADR¶

1. Copie o template abaixo
2. Use o próximo número disponível
3. Preencha todas as seções
4. Submeta para revisão

Quando Escrever um ADR¶

Escreva um ADR quando: - Fizer uma mudança arquitetural significativa - Escolher entre múltiplas abordagens viáveis - A decisão afetar múltiplas partes do sistema - Desenvolvedores futuros possam questionar a decisão

Ciclo de Vida do ADR¶

1. Proposto: Rascunho inicial para discussão
2. Aceito: Aprovado e implementado
3. Depreciado: Não é mais relevante
4. Substituído: Substituído por um ADR mais recente