# Contratos de artefato
Os schemas em `.sdd/schemas/artifact-sections.json` definem as seções mínimas de cada artefato. Eles não substituem julgamento técnico; servem para impedir que a pipeline avance com documentos incompletos.
## Validação
```bash
sdd validate-artifact prd caminho/para/prd.md
sdd validate-artifact techspec caminho/para/techspec.md
sdd validate-artifact review caminho/para/review.md
```
## Persistência local
Quando Jira/Confluence/etc. não forem a fonte canônica, salve os artefatos da orquestração em `docs/<slug-da-orquestracao>/`:
```bash
sdd init "<nome-da-orquestracao>"
sdd artifact save "<nome-da-orquestracao>" prd --file caminho/para/prd.md --state approved
```
O arquivo `traceability-map.yaml` do diretório local registra o estado das etapas e os links externos quando existirem.
## Seção obrigatória em todos os artefatos principais
```md
## Rastreabilidade
- Origem:
- Estado atual:
- Dono humano:
- Evidências:
- Próximo artefato:
```
## PRD
Precisa conter problema, objetivos, não objetivos, usuários, requisitos, critérios de aceite, métricas e riscos.
## Tech Spec
Precisa conter arquitetura, contratos, dados, segurança, performance, observabilidade, testes, riscos e plano.
## Tasks
Cada task precisa ter origem, critérios de aceite, Definition of Done e dependências.
## Refinement
Consolida o backlog em plano executável: solução, pontos de observação, checklist, subtasks, DoD e flags/configurações.
## Review
Precisa trazer escopo revisado, evidências, achados, testes e veredito.
## Memory
Compacta estado final, links, decisões, padrões úteis, comandos, pendências e contexto para o próximo agente.