---
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 trace doctor
sdd skills doctor --strict
sdd workflow validate standard-sdd --json
```
## O que bloqueia avanço
| 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 |
| Review com achado crítico | Não aprova merge |
## Logs
| `.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 capabilities doctor --targets all
```