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
62

---
title: Qualidade
description: Gates determinísticos, quality report, logs append-only e evidências de review.
context: Como medir prontidão, falhas críticas e lacunas de validação.
---

# Qualidade

Qualidade no SDD significa evidência verificável. O CLI mede seções obrigatórias, rastreabilidade, freshness de contexto, estado de artefatos e sinais opcionais de ferramentas externas.

## Comandos principais

```bash
sdd eval stage --name "minha feature" --stage techspec --json
sdd eval orchestration --name "minha feature" --json
sdd quality report --name "minha feature" --json
sdd health --name "minha feature" --json
sdd trace doctor
sdd skills doctor --strict
sdd workflow validate standard-sdd --json
```

## O que bloqueia avanço

| Falha | Efeito |
|---|---|
| Seções obrigatórias ausentes | Bloqueia stage |
| Rastreabilidade incompleta | Bloqueia avanço automático |
| `traceability-map.yaml` incoerente | Bloqueia orquestração |
| Tasks sem `Prompts Agent` | Bloqueia execução segura por agent |
| Context Pack crítico obsoleto | Exige atualização antes de executar/revisar |
| `missing-memory` ou `stale-learning` | Exige `sdd intelligence repair` ou revisão manual de memória |
| Review com achado crítico | Não aprova merge |

## Logs

| Arquivo | Conteúdo |
|---|---|
| `.sdd/events.jsonl` | eventos normalizados |
| `.sdd/runs.jsonl` | runs de stages e comandos |
| `.sdd/execution-runs.jsonl` | execução task-by-task |
| `.sdd/evaluations.jsonl` | evals e quality reports |
| `.sdd/subagents.jsonl` | auditoria de subagents |
| `.sdd/task-gates.jsonl` | gates de tasks |
| `.sdd/workflows/*.json` | status durável de workflows |

Todos os logs devem passar por redaction antes de persistir comandos, erros, stdout, stderr ou payloads de provider.

## Checklist de release

```bash
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo build --release
sdd eval orchestration --name "minha feature" --json
sdd quality report --name "minha feature" --json
sdd health --name "minha feature" --strict
sdd capabilities doctor --targets all
```

Use `sdd intelligence repair --name "minha feature" --json` quando `health` ou `intelligence health` apontarem memória ausente ou learning obsoleto. O comando repara derivados e pode gerar `08-memory.md` operacional, mas não substitui decisão humana nem promove cache a fonte primária.