---
title: Primeiros 15 minutos
description: Caminho curto para instalar, validar e gerar a primeira orquestração local.
context: Onboarding prático para operadores que ainda não conhecem o sdd-layer.
---

# Primeiros 15 minutos

Este caminho cria uma instalação funcional, valida os contratos principais e materializa uma primeira demanda sem depender de Jira, Confluence, MCP ou provider específico.

## 1. Instale o CLI

```bash
cargo install --path .
sdd doctor
```

Resultado esperado:

- `sdd doctor` reconhece o projeto e aponta problemas acionáveis.
- Se `codegraph` existir no `PATH`, a inicialização pode criar `.codegraph/` em modo best-effort.
- Se algo faltar, corrija o pré-requisito antes de gerar artefatos.

## 2. Verifique as superfícies de agent

```bash
sdd clients doctor
sdd skills doctor --strict
sdd capabilities doctor --targets all
sdd workflow validate standard-sdd --json
sdd health --json
```

Use esta leitura como gate de sanidade. O SDD funciona em Markdown puro, mas clients e skills precisam estar sincronizados para Codex, Claude, Cursor, opencode, Devin, Trae e Antigravity entregarem a mesma política.

## 3. Crie o artifact store

```bash
sdd init "exportacao csv relatorio vendas"
```

Isso cria `docs/exportacao-csv-relatorio-vendas/` e `traceability-map.yaml`. Em ambientes sem integrações externas, esse diretório é a fonte canônica local.

## 4. Rode uma primeira geração

```bash
sdd orchestration "Adicionar exportação CSV no relatório de vendas"
```

O fluxo deve gerar artefatos iniciais e parar nos checkpoints humanos. Não trate uma pausa como falha: checkpoint é parte do contrato.

## 5. Valide antes de avançar

```bash
sdd eval orchestration --name "exportacao csv relatorio vendas" --json
sdd quality report --name "exportacao csv relatorio vendas" --json
sdd health --name "exportacao csv relatorio vendas" --json
```

Se a validação apontar seções ausentes, rastreabilidade incompleta ou Context Pack obsoleto, volte para o stage anterior e corrija a origem.

## Próximas leituras

| Próximo objetivo | Página |
|---|---|
| Entender cada etapa | [Fluxo SDD](/guide/flow) |
| Aprender com um ciclo pronto | [Exemplo completo](/exemplos/export-csv-feature) |
| Melhorar prompts de geração | [Cookbook de geração](/geracao/cookbook) |
| Recuperar falhas comuns | [Erros comuns](/comece-aqui/erros-comuns) |
