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
50
51
52
53
54
55
56
57
58
59
60
61

---
title: Fluxo SDD
description: Etapas, subagents, checkpoints e responsabilidades da pipeline.
context: Mapa das etapas Project Discovery, Risk, Idea, PRD, Tech Spec, Tasks, Refinement, Execution, ADR, Review e Memory.
---

# Fluxo SDD

O fluxo completo é iniciado com:

```bash
sdd orchestration "minha ideia"
```

`sdd orchestrator` continua aceito apenas como alias legado.

## Etapas

| Ordem | Stage | Comando | Papel |
|---:|---|---|---|
| 0 | Project Discovery | `sdd discover` | Entender stack, comandos, riscos e contexto |
| 0 | Risk Classification | `sdd risk` | Calibrar rigor, checkpoints e Agent Teams |
| 1 | Ideia | `sdd idea` | Definir oportunidade e problema |
| 2 | PRD | `sdd prd` | Especificar requisitos e aceite |
| 3 | Tech Spec | `sdd techspec` | Desenhar solução técnica |
| 4 | Tasks | `sdd tasks` | Quebrar execução com prompts agent |
| 5 | Refinement | `sdd refinement` | Grooming obrigatório quando risco pede |
| 6 | Execution | `sdd execution` | Implementar escopo aprovado |
| 6.5 | ADR | `sdd adr` | Registrar decisão arquitetural confirmada |
| 7 | Review | `sdd review` | Revisar diff, testes e riscos |
| 8 | Memory | `sdd memory` | Compactar aprendizado final |

## Checkpoints

| Gate | Decisão humana |
|---|---|
| PRD | Problema, requisitos e critérios de aceite estão corretos |
| Tech Spec | Solução, contratos, dados, riscos e testes são aceitáveis |
| Refinement | Backlog está pronto para execução quando o risco exigir |
| Review/merge | Diff, evidências e riscos estão aceitáveis |
| Deploy | Release pode ir para produção |

Timeout, ausência de evento ou comentário solto não são aprovação.

## Caminho autônomo

Demandas já aprovadas até Refinement podem seguir pelo motor:

```bash
sdd auto run --real --through review
sdd auto run --real --through memory
sdd auto run --real --unattended
```

Sem `--unattended`, o motor não aprova PRD, Tech Spec, Refinement, merge, release ou deploy. Ele materializa execução, avaliação, review e memória quando o estado permite.

`--unattended` é um modo explícito de automação auditável: autoaceita gates de planejamento como `channel: automation`, registra `sdd-auto` como autor e, quando `--through` não é informado, segue até `memory`. Isso não equivale a aprovação humana nem libera merge/deploy.

## Workflows

Workflows em `templates/workflows/*.yaml` encadeiam etapas, skills, comandos, avaliações e checkpoints com limite de iteração. Eles não substituem o fluxo SDD; são recipes determinísticas para operar partes recorrentes. O recipe `agentic-sdd-loop` é a entrada recomendada para agents: resolve a demanda, roda o planejamento durável até o primeiro gate e deixa o pós-planejamento para `sdd auto`.