---
title: Mini geração guiada
description: Exemplo pequeno de geração segura, com comandos e trechos esperados.
context: Tutorial de geração sem depender de integrações externas.
---

# Mini geração guiada

Este exemplo usa uma demanda pequena e segura: adicionar uma exportação CSV em um relatório. Ele serve para aprender o formato do ciclo, não para demonstrar uma implementação real de produto.

## 1. Crie o ciclo

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

Trecho esperado:

```text
docs/exportacao-csv-relatorio-vendas/
traceability-map.yaml
```

## 2. Gere a ideia

```bash
sdd idea --name "exportacao csv relatorio vendas" \
  "Adicionar exportação CSV no relatório de vendas mantendo filtros aplicados"
```

Trechos que devem aparecer:

- Usuário e objetivo.
- Hipótese de valor.
- Não escopo.
- Rastreabilidade.

## 3. Gere PRD e pare no gate

```bash
sdd prd --name "exportacao csv relatorio vendas" \
  "Criar PRD para a ideia aprovada em docs/exportacao-csv-relatorio-vendas/01-idea.md"
```

Antes de marcar como `approved`, revise:

- Critérios de aceite em Gherkin.
- Regras de negócio separadas de requisitos.
- Métricas ou evidências de sucesso.

## 4. Registre a aprovação

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

## 5. Valide o ciclo

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

Se a validação reclamar de rastreabilidade, corrija o artefato, não o relatório.
