---
description: Inicia o Workflow durável
agent: sdd-orchestrator
---
Use este módulo quando uma demanda vier de texto livre, card, bot, webhook ou agent externo e precisar entrar no loop SDD durável.
Entrada:
$ARGUMENTS
Passos:
1. Resolva o CLI uma vez. Use `sdd` quando disponível; no checkout fonte `sdd-layer`, use `cargo run --bin sdd --`; fora disso, reporte PATH/instalação ausente.
2. Valide o workflow quando houver dúvida sobre instalação:
```bash
SDD_PROVIDER=opencode sdd workflow validate loop --json
```
3. Rode o recipe de entrada:
```bash
SDD_PROVIDER=opencode sdd workflow run loop --input "$ARGUMENTS" --max-iterations 3 --json
```
4. Leia o status persistido:
```bash
SDD_PROVIDER=opencode sdd workflow status loop --json
```
5. Quando o PRD estiver em checkpoint, pare. A aprovação deve vir de decisão humana explícita via `sdd demand approve` ou canal verificado.
6. Depois do gate aprovado, continue com o motor SDD conforme a fronteira autorizada:
```bash
sdd auto run --real
sdd auto run --real --through review
sdd auto run --real --through memory
sdd auto run --real --unattended
```
Regras:
- Artifact store: antes de criar artefatos, garanta `sdd init "<nome-da-orquestracao>"`; persista Markdown em `docs/<slug-da-orquestracao>/` e registre estados com `sdd artifact save`.
- Provider fallback: quando o provider, client ou adapter não suportar execução, use artifact store local, registre o comando necessário e deixe a decisão humana continuar o ciclo.
- Use `--unattended` somente quando a intenção for uma execução 100% automática: ele autoaceita PRD, Tech Spec e Refinement com `channel: automation`, registra `gate_auto_accept` e segue até `memory` quando `--through` não for informado.
- Não trate `--unattended` como aprovação humana e não autoaprove merge, release ou deploy.
- Não execute escrita no workspace sem adapter autorizado.
- Se o provider/client não suportar comando, registre o comando necessário e produza handoff Markdown com caminhos de artefatos.
- Continue o loop somente quando houver nova hipótese, fonte, escopo menor ou evidência nova.
- Pare se repetir o mesmo erro, diff, comando ou busca sem progresso observável.
- Preserve acentos em conteúdo humano PT-BR; use ASCII apenas para slugs, paths, branches, comandos, schemas e identificadores.
Documentação completa: `docs/WORKFLOW.md`.