# SDD orchestration

Primeiro, resolva o contexto-esqueleto unificado (vale para card ID, bot ou texto livre):

```bash
sdd resolve-input "$ARGUMENTS"
```

Adote o `--name` canônico retornado e use-o em TODAS as etapas e comandos `sdd`; comece pela próxima etapa sugerida sem pular etapas; monte o contexto de cada etapa com `sdd context build --name "<name>" --stage <etapa>`; e não regenere etapas já aprovadas.

Em seguida, rode:

```bash
sdd orchestration "$ARGUMENTS"
```

O core SDD governa o contrato SDLC; Rig, Flue, LangGraph, Agno e runtimes futuros são engines/adapters opcionais. Se estiverem ausentes, continue com Markdown, comandos `sdd`, artifact store local e validações determinísticas.

Antes de produzir qualquer artefato de etapa, defina o nome da orquestração e garanta o artifact store local:

```bash
sdd init "<nome-da-orquestracao>"
```

Depois conduza Project Discovery, Risk Classification, Idea, PRD, Tech Spec, Tasks, Refinement quando exigido, Execution, ADR, Review e Memory. Salve cada etapa em `docs/<slug-da-orquestracao>/` com `sdd artifact save`; use `approved` somente depois do checkpoint humano e `recorded` para etapas informativas.

Para demandas vindas de card, bot, webhook ou agent externo, prefira o recipe durável:

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

Depois consulte `docs/AGENTIC-SDD-LOOP.md` para continuar por gates, execution/review/memory supervisionados e política de parada sem progresso.

`orchestrator` é apenas alias legado; use `orchestration` para comandos, docs e skills.
