---
description: ADR utilitário do fluxo SDD - registra decisão arquitetural em qualquer etapa, sem posição fixa no pipeline
argument-hint: "\"<decisão a registrar>\""
agent: sdd-orchestrator
---
Antes de rodar comandos `sdd`, resolva o CLI uma vez: use `sdd` quando `command -v sdd` encontrar o binário; no checkout fonte `sdd-layer`, use `cargo run --bin sdd --`; se ambos falharem, reporte instalação/PATH ausente com o comando exato que precisa ser reexecutado.
Use a skill ou subagent desta etapa se o client a expuser. Se a skill/subagent não existir ou não carregar, este adapter é o fallback executável: siga as instruções abaixo e delegue estado, persistência e validação ao CLI `sdd`.
Nesta superfície OpenCode, propague o provider real para o harness com `SDD_PROVIDER=opencode`. Se a sessão estiver usando um modelo específico fora do roteamento, exporte também `SDD_MODEL=<modelo>` e, se aplicável, `SDD_EFFORT=<medium|high|xhigh>`.
Use o subagent `adr` pra registrar uma decisão arquitetural, escrevendo o arquivo diretamente (Write tool) — NÃO rode `SDD_PROVIDER=opencode sdd adr`, esse comando não existe mais como scaffold de artefato.
ADR não é uma etapa do pipeline — é um utilitário chamável de qualquer etapa (Idea, PRD, Tech Spec, Tasks, Execution ou qualquer outra) sempre que houver decisão não óbvia com alternativas reais. Numere sequencialmente em `docs/<slug-da-orquestracao>/adrs/adr-NN.md` (`adr-01`, `adr-02`... 2 dígitos), continuando a numeração existente na orquestração. Não crie um ADR por decisão trivial; só quando houver trade-off que vale documentar.
Entrada:
$ARGUMENTS
Saída obrigatória:
- Rastreabilidade.
- Status.
- Contexto.
- Problema.
- Decisão.
- Alternativas.
- Consequências.
- Impactos/riscos.
- Plano de adoção.
- Plano de reversão.
- Evidências.
- Histórico de revisão.
Salve o ADR em `docs/<slug-da-orquestracao>/adrs/adr-NN.md` (arquivo próprio, numeração sequencial contínua, 2 dígitos) — este é o único destino; não existe mais artefato único de ADR nem ponteiro em etapa fixa.
Antes de persistir qualquer artefato, garanta que o artifact store exista com `sdd init "<nome-da-orquestracao>"` quando ainda não houver `docs/<slug-da-orquestracao>/traceability-map.yaml`.