adr-draft

name	adr-draft
description	Use ao rascunhar Architecture Decision Records, avaliar alternativas ou documentar trade-offs técnicos. Aciona com "ADR", "architecture decision", "decisão arquitetural", "trade-off", "pick between", "why did we choose".

Rascunho de ADR

Quando invocar

• "Draft an ADR for choosing PostgreSQL over MongoDB."
• "Document our decision to adopt event-driven architecture."
• "Revisit ADR-007 - we need to supersede it."

Quando escrever um ADR

Escreva um ADR quando uma decisão:

• É difícil ou cara de reverter.
• Afeta mais de um time.
• Restringe escolhas futuras (technology lock-in).
• Provavelmente será questionada em 6 meses.

Não escreva um ADR para um refactor local ou ajuste de configuração reversível.

Estrutura

# ADR-NNN: <Decision title in imperative>

**Status**: proposed | accepted | superseded by ADR-NNN | deprecated
**Date**: YYYY-MM-DD
**Deciders**: <names>
**Context tags**: security, performance, cost

## Context
2-4 paragraphs. What is the forcing function? What constraints apply?

## Decision
One paragraph. "We will <decision>."

## Alternatives considered
- **Option A**: <summary>. Pros: ... Cons: ...
- **Option B**: <summary>. Pros: ... Cons: ...
- **Option C (chosen)**: <summary>. Pros: ... Cons: ...

## Consequences
### Positive
- ...
### Negative
- ...
### Neutral
- ...

## Follow-ups
- [ ] Update REQ-NNN
- [ ] Migrate <system>
- [ ] Revisit in Q<N>

## References
- Source 1
- Source 2

Dicas de escrita

• Escreva no tempo presente ("We use X").
• Inclua pelo menos 2 alternativas rejeitadas.
• Nomeie consequências que você sabe que vão doer - seu eu futuro vai agradecer.
• Substitua, nunca delete. A história é o valor.

Antipadrões

• ADRs escritos depois do fato para justificar decisão já tomada.
• Um ADR que agrupa 5 decisões não relacionadas.
• Sem seção de alternativas (sinaliza que não houve análise de trade-off).
• Status preso em "proposed" por meses.

Gate de qualidade

Rejeite qualquer ADR sem seções Context, Decision, Alternatives e Consequences.