sdd-layer 0.26.1

Spec-Driven Development CLI and agent harness
---
description: Etapa 2 - PRD do fluxo SDD
argument-hint: "\"<ideia aprovada ou contexto>\""
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>`.

Rode `SDD_PROVIDER=opencode sdd prd "$ARGUMENTS"` e use o subagent `prd` para materializar requisitos de produto.

Entrada:

$ARGUMENTS

## Pesquisa e Context Harvest

Antes de rascunhar, leia a Idea, os ADRs e o Context Pack; explore em paralelo o codebase em busca de gaps doc-vs-código e consulte pesquisa externa apenas quando pertinente. Achados citam fonte concreta (arquivo:linha, comando, artefato ou link); sem fonte, entram como "não verificados".

## Grill interativo (OBRIGATÓRIO — nunca pule silenciosamente)

Use `grill-with-docs` para uma sessão focada nas lacunas de produto que ainda não estejam travadas na Idea/ADR. Faça uma pergunta por vez, ofereça sua recomendação e aguarde a resposta. Cubra MVP, personas prioritárias, requisitos não funcionais e trade-offs reais até que não exista decisão de alto impacto aberta; não repita perguntas já resolvidas.

Um bypass explícito ou `--unattended` autorizado deve registrar assumptions, riscos, fontes ausentes e perguntas em aberto no PRD; sem autorização, pause. Decisões com trade-off real usam `adr` em `docs/<slug-da-orquestracao>/adrs/adr-NN.md`.

Saída obrigatória:

- Resumo executivo.
- Contexto.
- Objetivos.
- Não objetivos.
- Personas e jornadas (una personas, casos de uso e fluxos numa única seção coesa por persona — evite repetir o mesmo fluxo em seções separadas).
- Requisitos funcionais e não funcionais.
- Regras de negócio.
- Critérios de aceite.
- Estados (só quando a feature for stateful; senão omita com justificativa em vez de repetir os fluxos).
- Métricas.
- Riscos.
- Dependências.
- Fases de entrega (MVP com critério de saída, e próximas fases quando existirem — substitui "Escopo do MVP" isolado).
- Diagramas Mermaid/Excalidraw em `## Diagramas`, ou `Não aplicável` com justificativa. Quando houver companion visual do `diagram-design`, referencie `assets/diagrams/*.html|*.svg` sem substituir o Mermaid/Excalidraw canônico.
- ADRs: linke `adrs/adr-NN.md` relevantes já registrados nesta orquestração, uma linha por ADR.
- Rastreabilidade para Idea.

Pare para checkpoint humano antes de marcar como `approved`. Depois salve em `docs/<slug-da-orquestracao>/02-prd.md` via `sdd artifact save "<nome-da-orquestracao>" prd --file <arquivo> --state approved`.

Após aprovação e save, indique o próximo passo (`/techspec` usando este PRD como entrada) sem esperar o usuário perguntar.

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`.