---
description: Etapa 1 - Idea do fluxo SDD
argument-hint: "\"<ideia 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 idea "$ARGUMENTS"` e use o subagent `idea` para transformar a entrada em descoberta de produto.
Entrada:
$ARGUMENTS
## Pesquisa e Context Harvest
Antes de rascunhar, faça o `Context Harvest`: leia os artefatos aprovados e o Context Pack; explore em paralelo o codebase (grep/Explore/CodeGraph) em busca de gaps reais entre documentação e comportamento; consulte providers configurados e pesquisa externa/mercado quando houver padrão externo relevante. Todo achado cita fonte concreta (arquivo:linha, comando, artefato ou link); sem fonte, entra como "não verificado".
## Grill interativo (OBRIGATÓRIO — nunca pule silenciosamente)
Depois da pesquisa, use `grill-with-docs` como padrão desta nova orquestração (ou `grill-me` quando a etapa for isolada) para entrevistar o usuário. Faça uma pergunta por vez, ofereça sua recomendação e aguarde a resposta antes da próxima. Fatos descobríveis são pesquisados; decisões de produto são perguntadas.
Continue até fechar todos os ramos de alto impacto, registrar alternativas rejeitadas e deixar apenas perguntas não bloqueantes. Não use uma contagem fixa de perguntas como critério de conclusão. Se o usuário pedir explicitamente "sem perguntas"/"direto ao rascunho", ou o fluxo estiver em `--unattended` autorizado, esse bypass explícito deve registrar assumptions, riscos, fontes ausentes e perguntas em aberto no artefato; sem autorização, pause.
Quando houver mais de uma abordagem de produto plausível, apresente as opções (o quê muda, trade-off) e trave a escolha antes de escrever o rascunho.
## ADR obrigatório (adr-01)
Depois do grill e antes de escrever o rascunho da Idea, use a skill `adr` (ou `grill-with-docs` se já tiver sido usada para o grill) para escrever, via Write tool, `docs/<slug-da-orquestracao>/adrs/adr-01.md` com a decisão de abordagem de produto travada no grill (mesmo que a decisão pareça óbvia — registre o porquê e as alternativas descartadas). Este é o PRIMEIRO ADR da orquestração e não é opcional: toda orquestração nova começa sua trilha de ADRs aqui, antes do PRD existir. ADRs seguintes (adr-02, adr-03...) continuam sendo condicionais a decisão real em PRD/Tech Spec/Tasks/Execution — só o adr-01 pós-Idea é sempre gerado.
Saída obrigatória:
- Visao geral da ideia.
- Problema.
- Público-alvo.
- Proposta de valor.
- Jornada principal.
- MVP.
- Fora do MVP.
- Hipóteses.
- Riscos.
- Perguntas em aberto.
- `## Diagramas` opcional quando jornada, decisão, estado ou dependência ficarem mais claros visualmente.
- ADR: link para `adrs/adr-01.md` (e demais ADRs desta orquestração, se houver).
- Rastreabilidade para Project Discovery/Risk quando existirem.
Salve a etapa em `docs/<slug-da-orquestracao>/01-idea.md` via `sdd artifact save "<nome-da-orquestracao>" idea --file <arquivo> --state recorded`.
Após aprovação e save, indique o próximo passo (`/prd` usando esta Idea 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`.