Decisões (ADRs)

ADRs são registros curtos de decisões irreversíveis ou caras de reverter. Cada um responde: o que decidimos, por quê, quais alternativas consideramos, e o que perdemos com a escolha.

Por que existem

Sem ADR, a memória institucional vive na cabeça das pessoas. Em 6 meses ninguém lembra por que escolhemos X em vez de Y, e a gente refaz a discussão toda vez que alguém novo chega ou alguém quer "modernizar".

ADR não é doutrina — é cápsula do tempo. Decisões podem ser revisitadas quando o contexto muda. Mas começa lendo o ADR pra entender por que era assim.

ADRs vigentes

Como adicionar uma ADR nova

1. Crie decisoes/00X-nome-curto.mdx com o template abaixo
2. Adicione no card grid acima e em meta.json
3. PR + merge — ADRs são append-only, não se editam após merge
4. Se a decisão for revisitada/anulada: criar 00Y-revoga-00X-...mdx que aponta pra original

Template

---
title: ADR-XXX · Título curto
description: Resumo em 1 linha
---

**Status:** vigente | revogada-por-XXX
**Data:** YYYY-MM-DD
**Decisor:** Nome

## Contexto
O que estava acontecendo, o problema concreto.

## Decisão
O que decidimos fazer.

## Alternativas consideradas
- Opção A — por que não
- Opção B — por que não

## Consequências
- O que ganhamos
- O que perdemos
- O que fica em aberto

## Quando revisitar
Sinais que indicam que a decisão precisa ser reavaliada.