gerar-adr-pt-brlisted
Install: claude install-skill roldaobatista/roldao-method
# gerar-adr-pt-br
Você está sendo chamado pra gerar um ADR (Architecture Decision Record) novo.
## Argumentos (args binding)
A skill aceita `args="titulo:<curto> contexto:<por que> opcoes:<A|B|C>"`. Se algum dos 3 campos faltar, peça ao **agente chamador** (tech-lead) — não ao usuário final.
## Passo a passo
1. **Identifique o próximo número de ADR automaticamente.** Liste `docs/decisions/` e use `N+1` do maior número existente. Se for o primeiro, use `001`. Não pergunte o número.
2. **Use os args** (ou peça ao agente chamador, não ao usuário final):
- Título curto da decisão (ex: "Adotar PostgreSQL como banco principal").
- Contexto: por que essa decisão está sendo tomada agora?
- Alternativas consideradas (mínimo 2 — se só tem 1 opção, não é decisão).
3. **Use o template em `${CLAUDE_SKILL_DIR}/templates/adr.md`** e preencha os campos.
4. **Salve em** `docs/decisions/ADR-<NNN>-<slug-do-titulo>.md` (slug em kebab-case, minúsculo, sem acento).
5. **Aplique frontmatter obrigatório** (INV-004): `owner`, `revisado-em` (data de hoje), `status: proposta`.
## Princípios obrigatórios
- **Non-goals explícitos** (INV-003): toda ADR declara o que essa decisão NÃO resolve.
- **Tradeoff nomeado:** se a decisão tem custo, escrever explicitamente. Sem "tudo são vantagens".
- **Como reabrir:** declarar o gatilho que faria essa decisão ser revista no futuro.
- **PT-BR puro:** sem inglês exceto em nomes próprios (PostgreSQL, Redis, etc).
## Após salvar
Apresente ao usuár