sdd-layer 0.19.0

Spec-Driven Development CLI and agent harness
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

---
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 |
| `agentic-sdd-loop` | Entrada recomendada para agents; resolve demanda e delega para o planejamento durável |
| `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 validate agentic-sdd-loop --json
sdd workflow run standard-sdd --input "Criar busca por tags" --max-iterations 10 --json
sdd workflow run agentic-sdd-loop --input "Criar busca por tags" --max-iterations 3 --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`.

Depois de um gate aprovado, continue com `sdd auto run --real --through review` ou `sdd auto run --real --through memory`. Para um processamento totalmente automático, use `sdd auto run --real --unattended` de forma explícita; o audit trail marca automação, não aprovação humana.