---
title: Visão geral
description: O que é a camada SDD, quais problemas resolve e quais contratos não podem ser quebrados.
context: Conceitos fundamentais para operar o projeto sdd-layer.
---

# Visão geral

A camada SDD transforma uma demanda em uma sequência auditável de decisões. Ela separa planejamento, execução, revisão e memória para reduzir improviso e preservar rastreabilidade. O projeto é runtime-agnostic: o contrato principal está no CLI, nos templates, nos schemas e nos artefatos locais; runtimes como Rig, LangGraph, Agno, Flue ou adapters futuros entram como complementos.

## O que a camada entrega

| Área | Entrega |
|---|---|
| Produto | Ideia, PRD, critérios de aceite, riscos e métricas |
| Arquitetura | Tech Spec, ADR, contracts, dados, segurança e observabilidade |
| Engenharia | Tasks executáveis, prompts agent, execução task-by-task e review |
| Governança | Checkpoints humanos, artifact store, traceability map e quality report |
| Operação | CLI `sdd`, TUI, clients de editor, providers, workflows, MCP e logs |

## Princípios

- A spec é o contrato; a rastreabilidade é o produto.
- Cada etapa transforma um artefato no próximo.
- Checkpoints humanos são obrigatórios em PRD, Tech Spec, Refinement quando houver risco, review/merge e deploy.
- Logs e MCP são observabilidade derivada; o `traceability-map.yaml` e os artefatos aprovados continuam sendo a fonte local de verdade.
- Provider não é client, e client não é adapter de escrita. Geração de Markdown e mutação real do workspace são capacidades diferentes.

## Superfícies

| Superfície | Uso |
|---|---|
| CLI `sdd` | Núcleo determinístico, validações, artifact store, workflows e providers |
| TUI `sdd tui` | Cockpit terminal para conduzir etapas e ver trace |
| Codex/Claude/Cursor/opencode/Devin/Trae/Antigravity | Experiência de agent e comandos por editor |
| Bot Slack | Entrada operacional por Slack com integrações Jira/Bitbucket/LLM |
| MCP | Consulta read-only de artefatos, traces e adapters runtime |

## Quando usar

Use SDD quando uma mudança precisa de clareza de escopo, aceite verificável, revisão técnica e memória reutilizável. Para mudanças triviais, o fluxo ainda pode ser mais leve, mas os contratos de artifact store, validação e review continuam úteis quando a alteração entra em produção.
