Modelos de ADR: Minimal, Extended e MADR 4.0

O formato controla como você expressa uma decisão; a categoria de decisão descreve o assunto. Uma decisão de segurança pode usar Minimal, Extended, Custom ou MADR 4.0 conforme seu risco e o padrão da equipe.

02

Compare a mesma decisão

O raciocínio permanece; a profundidade e o contrato estrutural mudam.

# 0042. Adotar Redis para cache distribuído

Date: 2026-10-09

## Status

Proposed

## Context

Leituras repetidas pressionam o banco de dados.

## Decision

Usaremos Redis com o padrão cache-aside.

## Consequences

Reduzimos a latência, mas operamos um novo serviço.

# 0042. Adotar Redis para cache distribuído

## Status
Proposed

## Context
Leituras repetidas pressionam o banco.

## Decision Drivers
- Latência p95
- Tolerância a dados obsoletos
- Custo operacional

## Considered Options
- Redis gerenciado
- Cache em processo
- Sem cache

## Decision Outcome
Redis gerenciado com cache-aside e TTL por domínio.

## Consequences
Menos carga; invalidação e observabilidade adicionais.

# Adotar Redis para cache distribuído

## Context and Problem Statement
Como reduzir leituras repetidas sem perder controle de consistência?

## Decision Drivers
* Latência p95
* Tolerância a falhas

## Considered Options
* Redis gerenciado
* Cache em processo

## Decision Outcome
Chosen option: Redis gerenciado, porque centraliza o cache entre réplicas.

### Consequences
* Good, because reduz carga no banco.
* Bad, because adiciona uma dependência operacional.

Matriz de capacidades

Formato	Melhor uso	Detalhe	Suporte no ADR Guard	Limite importante
Minimal	Escolhas focadas e de menor risco	Contexto, decisão, consequências	Gerado e validado como canônico	Mantenha a escolha precisa apesar do registro curto
Extended	Escolhas de alto impacto ou várias opções	Motivadores, alternativas, resultado, consequências	Gerado e validado como canônico	Extended não é MADR
Custom	Estrutura canônica específica da organização	Depende do template	`new --template-file` com invariantes estruturais	Markdown arbitrário não é automaticamente válido
MADR 4.0	Equipes já padronizadas em MADR	Motivadores, opções, resultado, prós/contras	Validação opcional com `--adr-format madr-4`	Valide separadamente dos ADRs canônicos; não afirmamos geração automática de MADR

Regra prática de seleção

Use o formato mais leve que preserve o raciocínio necessário para futuros leitores. Aumente o detalhe conforme impacto, irreversibilidade, quantidade de alternativas, risco ou coordenação organizacional aumentarem. Se a equipe já tem um padrão explícito, consistência pode importar mais do que preferência pessoal.

Leia o guia detalhado de formatos e templates e a referência MADR 4.0.