sdd-layer 0.18.3

Spec-Driven Development CLI and agent harness
---
title: Primeira orquestração
description: Como criar um ciclo SDD local do zero.
context: Tutorial rápido para materializar artifact store e iniciar o fluxo.
---

# Primeira orquestração

Este tutorial cria uma demanda local e para no primeiro gate humano.

## 1. Verifique o projeto

```bash
sdd doctor
sdd clients doctor
sdd skills doctor --strict
```

## 2. Inicialize o artifact store

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

Isso cria `docs/exportacao-csv-relatorio-vendas/` com `README.md` e `traceability-map.yaml`.

## 3. Rode o fluxo

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

O fluxo deve produzir ideia e PRD, depois pausar no checkpoint de PRD quando executado pelo harness completo.

## 4. Aprove ou ajuste

Se o PRD estiver correto, registre a aprovação pelo mecanismo do client ou salve o artefato aprovado:

```bash
sdd artifact save "exportacao csv relatorio vendas" prd --file prd.md --state approved
```

Se faltar contexto, volte para PRD ou Project Discovery antes de avançar.

## 5. Valide

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