# 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.
