---
title: SDD Layer
description: Entrada principal da documentação da camada de orquestração SDD.
context: Visão executiva do produto, caminhos de leitura e principais contratos operacionais.
---

# SDD Layer

`sdd-layer` é uma camada de orquestração Spec-Driven Development para levar uma demanda da ideia à memória final com artefatos rastreáveis, checkpoints humanos e validação determinística. O núcleo é o CLI Rust `sdd`; Codex, Claude Code, Cursor, opencode, Devin, Antigravity, Trae, MCP/ACP e o bot Slack são superfícies de operação.

Esta documentação é o manual de operação do projeto: ela mostra como instalar, gerar artefatos, conduzir agents, validar gates, recuperar falhas e manter o contrato sincronizado com o código real.

## Comece por aqui

| Objetivo | Página |
|---|---|
| Sair do zero para uma orquestração local | [Primeiros 15 minutos](/comece-aqui/primeiros-15-minutos) |
| Escolher o caminho certo por papel | [Mapa por persona](/comece-aqui/mapa-por-persona) |
| Entender o fluxo completo | [Fluxo SDD](/guide/flow) |
| Rodar uma primeira orquestração | [Primeira orquestração](/tutorials/first-orchestration) |
| Gerar artefatos melhores com agents | [Cookbook de geração](/geracao/cookbook) |
| Ver um ciclo completo | [Exemplo: exportação CSV](/exemplos/export-csv-feature) |
| Configurar editores e agents | [Editores e agents](/editors-agents/overview) |
| Consultar comandos | [Mapa de comandos](/reference/command-map) |

## Três formas de usar

| Modo | Quando usar | Comandos de entrada |
|---|---|---|
| Manual assistido | Você quer controlar cada checkpoint | `sdd init`, `sdd idea`, `sdd prd`, `sdd techspec` |
| Orquestração guiada | Você quer conduzir o ciclo inteiro com pausas humanas | `sdd orchestration`, `sdd workflow run standard-sdd` |
| Automação auditável | Você quer processar demandas aprovadas com trilha explícita | `sdd demand`, `sdd auto run --real`, `sdd quality report` |

## Contratos centrais

| Contrato | Fonte local |
|---|---|
| Pipeline SDD | `AGENTS.md`, `CLAUDE.md`, `.codex/rules/`, `.claude/rules/` |
| CLI determinístico | `src/main.rs`, `src/domain/`, `src/runtime/` |
| Artifact store | `docs/<slug-da-orquestracao>/`, `templates/traceability-map.yaml` |
| Skills | `.agents/skills/`, `plugins/orchestration/skills/`, `templates/skill-catalog.yaml` |
| Workflows | `templates/workflows/*.yaml`, `.sdd/workflows/*.json` |
| Clients | `clients/*.md`, `.claude/`, `.codex/`, `.cursor/`, `.devin/`, `.opencode/`, `.trae/` |

## Rotina recomendada

```bash
cargo install --path .
sdd doctor
sdd clients doctor
sdd skills doctor --strict
sdd workflow validate standard-sdd --json
sdd init "minha-orquestracao"
sdd orchestration "minha ideia"
```

## O que torna um ciclo saudável

| Sinal | Evidência esperada |
|---|---|
| Escopo claro | `01-idea.md`, `02-prd.md` e critérios de aceite verificáveis |
| Arquitetura rastreável | `03-techspec.md`, ADR quando houver decisão técnica e `traceability-map.yaml` atualizado |
| Execução segura | Tasks com prompts agent standalone, ownership de arquivos e validação local |
| Review confiável | Achados classificados, testes citados e bloqueios explícitos |
| Memória reutilizável | `08-memory.md` com decisões, padrões úteis e contexto para o próximo agente |

Os documentos Markdown em `docs/` continuam sendo fontes canônicas detalhadas; este site organiza o conjunto para leitura, onboarding, geração assistida e manutenção.
