---
description: Inicia o Agentic SDD Loop com 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 agentic-sdd-loop --json
```

3. Rode o recipe de entrada:

```bash
SDD_PROVIDER=opencode sdd workflow run agentic-sdd-loop --input "$ARGUMENTS" --max-iterations 3 --json
```

4. Leia o status persistido:

```bash
SDD_PROVIDER=opencode sdd workflow status agentic-sdd-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/AGENTIC-SDD-LOOP.md`.
