# 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, riscos e `## Diagramas`.
## Tech Spec
Precisa conter arquitetura, contratos, dados, segurança, performance, observabilidade, testes, riscos, plano e `## Diagramas`.
## Diagramas
IDEA pode incluir `## Diagramas` quando o visual melhorar entendimento; a seção é recomendada no scaffold, mas não obrigatória. PRD e Tech Spec precisam ter a seção com Mermaid versionável, referência `.excalidraw`, `Não aplicável` com justificativa curta ou companion validado em `assets/diagrams/*.html|*.svg`.
`diagram-design` é companion editorial: gere HTML/SVG quando pedido ou configurado, salve em `docs/<slug-da-orquestracao>/assets/diagrams/` e anexe ao artefato com:
```bash
sdd diagram attach --name "<ciclo>" --stage idea|prd|techspec --file <arquivo.html|svg|excalidraw> --title "<título>" --source "<origem>"
```
## 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.