← ClaudeAtlas

gerar-adr-pt-brlisted

Cria um Architecture Decision Record (ADR) em português brasileiro seguindo o template do ROLDAO-METHOD. Use sempre que tomar decisão arquitetural não-trivial (escolha de stack, biblioteca, integração com sistema externo, padrão arquitetural).
roldaobatista/roldao-method · ★ 0 · AI & Automation · score 72
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