sdd-layer 0.18.0

Spec-Driven Development CLI and agent harness
---
title: Workflows
description: DSL YAML, nodes, edges, checkpoints e workflows embutidos.
context: Como declarar e operar loops determinísticos no SDD.
---

# Workflows

Workflows são recipes locais em YAML. Eles encadeiam stages, skills, commands, evals, parallel placeholders e checkpoints com limite explícito de iteração.

## Localização

```text
templates/workflows/*.yaml
.sdd/workflows/<workflow-id>.json
.sdd/workflows.jsonl
```

## Workflows embutidos

| Workflow | Uso |
|---|---|
| `standard-sdd` | Planejamento até o primeiro gate humano |
| `deep-execution-review` | Loop execution, eval, review e correção |
| `discovery-skill-hardening` | Discovery, recomendações, skills doctor e capabilities doctor |
| `bugfix-diagnostic-loop` | Reproduzir, inspecionar, alterar, testar e revisar bug |

## Validar e rodar

```bash
sdd workflow list --json
sdd workflow validate standard-sdd --json
sdd workflow run standard-sdd --input "Criar busca por tags" --max-iterations 10 --json
sdd workflow status standard-sdd --json
```

## Regras

- `version` deve ser `1`.
- Todo loop/back-edge exige `max_iterations`.
- Checkpoint não pode autoaprovar.
- Node intermediário sem saída falha.
- Edge para node inexistente falha.
- Workflow não substitui artifact store nem `traceability-map.yaml`.