---
title: Templates e schemas
description: Contratos versionados para artefatos, capabilities, workflows, adapters e presets.
context: Inventário das fontes declarativas do projeto.
---

# Templates e schemas

Os arquivos declarativos reduzem comportamento implícito. Eles sustentam instalação, validação, workflows, skills e artifact store.

## Templates

| Arquivo | Uso |
|---|---|
| `templates/project-discovery.md` | Formato de discovery |
| `templates/traceability-map.yaml` | Mapa canônico de feature |
| `templates/artifact-index.yaml` | Índice de artefatos |
| `templates/checkpoint.md` | Registro de checkpoint |
| `templates/skill-catalog.yaml` | Catálogo híbrido de skills |
| `templates/capability-catalog.yaml` | Capabilities por client |
| `templates/client-skills/orchestration.md` | Skill/client de orquestração |
| `templates/workflows/*.yaml` | Workflows determinísticos |

## Schemas

| Arquivo | Uso |
|---|---|
| `schemas/artifact-sections.json` | Seções obrigatórias por artefato |
| `schemas/provider-config.schema.json` | Configuração de providers |
| `schemas/sdd-contract.schema.json` | Contrato JSON |
| `schemas/sdd-contract.yaml` | Contrato YAML |

## Presets

`presets/*.yaml` definem defaults por tipo de projeto. Eles são aplicados por `sdd init` e podem ser atualizados por `sdd update --update-config --preset <preset>`.

## Regra de manutenção

Ao adicionar um contrato declarativo, documente:

- comando que valida;
- arquivo que consome;
- fallback quando ausente;
- impacto em clients;
- evidência esperada em review.
