---
title: Cookbook de geração
description: Entradas e comandos práticos para gerar artefatos SDD melhores.
context: Guia de prompts e comandos para produzir artefatos rastreáveis.
---

# Cookbook de geração

Uma boa geração SDD começa com entrada concreta, artefato de origem e critério de aceite. Evite pedir “faça tudo”; peça o próximo stage com contexto suficiente para validar.

## Ideia

```bash
sdd idea --name "exportacao csv relatorio vendas" \
  "Usuário precisa exportar relatório de vendas em CSV com filtros aplicados"
```

Boa entrada inclui usuário, objetivo e limite. A saída deve separar problema, hipótese, não escopo e perguntas abertas.

## PRD

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

Boa saída inclui requisitos, regras de negócio e critérios Gherkin. Não misture decisão técnica prematura no PRD.

## Tech Spec

```bash
sdd techspec --name "exportacao csv relatorio vendas" \
  "Projetar implementação para o PRD aprovado, preservando contratos existentes"
```

Boa saída aponta módulos prováveis, contratos, riscos, dados, segurança, testes e rollback.

## Tasks

```bash
sdd tasks --name "exportacao csv relatorio vendas" \
  "Quebrar a Tech Spec aprovada em fatias verticais verificáveis"
```

Cada task precisa ter ownership, Definition of Done, validação e prompt agent standalone.

## Execution

```bash
sdd execution --name "exportacao csv relatorio vendas" "TASK-003"
```

Boa execução altera apenas o escopo da task, preserva worktree sujo e registra comandos executados.

## Review

```bash
sdd review --name "exportacao csv relatorio vendas"
```

Boa revisão começa por achados, evidencia testes e bloqueia merge se houver problema crítico.

## Memory

```bash
sdd memory --name "exportacao csv relatorio vendas"
```

Boa memória captura decisões, padrões úteis, limitações, comandos e contexto para o próximo agente.

## Checklist de qualidade do prompt

| Pergunta | Sinal saudável |
|---|---|
| Qual é o artefato de origem? | Caminho local explícito em `docs/<slug>/` |
| Qual é o resultado verificável? | Uma frase de outcome e critérios de aceite |
| O que está fora do escopo? | Lista curta de exclusões |
| Como validar? | Comandos ou instrução para descobrir comandos reais |
| Como persistir? | `sdd artifact save` com estado correto |
