adr

Skill de Architecture Decision Record (ADR)

Quando usar

Para decisões de alto impacto que afetam a arquitetura do projeto:

• Escolha de framework, banco, ORM, auth strategy
• Padrões arquiteturais (monolito vs microserviço, REST vs GraphQL)
• Decisões de infraestrutura (cloud, CI/CD, deploy)
• Mudanças que são caras de reverter

Para decisões menores, o formato padrão do DECISIONS.md é suficiente.

Processo

1. Contexto

Entenda o problema que exige decisão. Se necessário, delegue ao subagent researcher para pesquisar opções.

2. Criar ADR

Crie .spec/adrs/ADR-0xx-[titulo-kebab-case].md:

# ADR-0xx: [Título da Decisão]

## Status
Proposta | Aceita | Deprecada | Substituída por ADR-0yy

## Data
YYYY-MM-DD

## Autoria
- **Proposta por:** [humano | Claude | colaboração]
- **Aprovada por:** [humano]

## Contexto
[Descrição detalhada do problema e por que uma decisão é necessária.
Inclua restrições técnicas, requisitos de negócio e contexto do time.]

## Opções Consideradas

### Opção 1: [Nome]
- **Descrição:** [Como funcionaria]
- **Prós:**
  - [vantagem 1]
  - [vantagem 2]
- **Contras:**
  - [desvantagem 1]
  - [desvantagem 2]
- **Estimativa de esforço:** [baixo/médio/alto]

### Opção 2: [Nome]
- **Descrição:** [Como funcionaria]
- **Prós:** ...
- **Contras:** ...

### Opção 3: [Nome]
...

## Decisão
[Qual opção foi escolhida e POR QUÊ]

## Consequências

### Positivas
- [Benefício 1]
- [Benefício 2]

### Negativas
- [Trade-off 1]
- [Trade-off 2]

### Riscos
- [Risco 1 — mitigação: ...]

## Notas de Implementação
[Como esta decisão afeta o código. Quais padrões seguir.
O que evitar. Referências a docs ou exemplos.]

3. Registrar

• Adicione uma entrada resumida em DECISIONS.md apontando para o ADR
• Se o ADR afeta o milestone atual, atualize o ROADMAP.md se necessário

4. Informar

"ADR-0xx registrado. Decisão: [resumo em uma linha]."