---
title: Contratos de dados
description: Configuração, schemas, logs JSONL e arquivos YAML usados pelo SDD.
context: Estruturas persistidas e sua função operacional.
---

# Contratos de dados

O SDD usa YAML, JSON, JSONL e Markdown para manter a operação auditável e simples de versionar.

## YAML

| Arquivo | Uso |
|---|---|
| `sdd.config.yaml` | Configuração do projeto |
| `adapters/*.yaml` | Integrações externas |
| `presets/*.yaml` | Defaults por stack |
| `templates/traceability-map.yaml` | Estado de feature |
| `templates/workflows/*.yaml` | Workflows |
| `templates/skill-catalog.yaml` | Catálogo de skills |

## JSON/JSONL

| Arquivo | Uso |
|---|---|
| `schemas/*.json` | Validação estrutural |
| `.sdd/events.jsonl` | Eventos normalizados |
| `.sdd/runs.jsonl` | Runs |
| `.sdd/execution-runs.jsonl` | Execução task-by-task |
| `.sdd/evaluations.jsonl` | Evals e quality reports |
| `.sdd/state/<slug>.json` | Estado durável |
| `.sdd/workflows/<id>.json` | Último status de workflow |

## Markdown

Artefatos de stage, docs de client, commands, agents e skills são Markdown. Quando forem artefatos principais, precisam conter `Rastreabilidade`.
