---
name: artifact-schemas
description: Validar contratos de artefatos SDD e seções obrigatórias de PRD, Tech Spec, Tasks, Refinement, Execution, Review, Memory e Checkpoint. Use antes de avançar etapa, ao revisar documentação gerada ou ao configurar schemas para novos projetos.
---

# Artifact Schemas SDD

## Objetivo

Impedir que a pipeline avance com artefato incompleto.

## Contratos

Os contratos mínimos vivem no repositório da camada em:

```text
schemas/artifact-sections.json
```

Em projetos instalados, o espelho esperado é:

```text
.sdd/schemas/artifact-sections.json
```

Valide com:

```bash
sdd validate-artifact <tipo> <arquivo.md>
```

Tipos: `project-discovery`, `risk`, `idea`, `prd`, `techspec`, `tasks`, `refinement`, `execution`, `adr`, `review`, `memory`, `checkpoint`.

Quando o artefato for parte de uma orquestração, salve a versão aprovada/registrada no artifact store local:

```bash
sdd artifact save "<nome-da-orquestracao>" <stage> --file <arquivo.md> --state approved
```

## Regras

- Artefato principal precisa ter `Rastreabilidade`.
- PRD e Tech Spec precisam ter `Diagramas` com Mermaid/Excalidraw útil ou justificativa explícita de `Não aplicável`.
- Tasks precisam ter `Prompts Agent` com prompt standalone por task, além de Backlog, Dependências, Critérios de aceite, Definition of Done, Estratégia de testes e Ordem sugerida.
- Artefato aprovado precisa estar em `docs/<slug-da-orquestracao>/` quando não houver fonte externa canônica.
- Review precisa ter evidência e veredito.
- Memory precisa ser compacta e linkar artefatos, não copiá-los.
- Checkpoint precisa pedir decisão explícita.
