Spec Driven Development

Por que este livro

Capítulo 1: Vibe coding: funciona até que não funciona

1. O projeto que vai bem até que não vai
2. Os três sintomas
3. Por que isso acontece
4. O erro que quase todo mundo comete
5. Não é um problema de IA
6. O que vem a seguir

Capítulo 2: O que é SDD (e o que não é)

1. O que não é
2. Como chegamos até aqui
3. Por que agora
4. A tabela que resume tudo
5. O que SDD não resolve
6. Uma definição para guardar

Capítulo 3: A spec como artefato primário

1. Por que as specs tradicionais falham
2. A spec viva
3. Comportamento, não arquitetura
4. O que uma spec tem e o que não tem
5. O contrato entre você e o agente
6. Quanto tempo leva para escrever uma spec
7. A spec mais curta que você pode escrever
8. Antes de continuar

Capítulo 4: As 7 fases do desenvolvimento com IA

1. Fase 1: Ideia
2. Fase 2: Pesquisa
3. Fase 3: Protótipo
4. Fase 4: PRD
5. Fase 5: Kanban
6. Fase 6: Execution loop
7. Fase 7: QA
8. Quando pular fases
9. O fluxo completo

Capítulo 5: O PRD — como escrever uma spec que a IA não vai interpretar errado

1. Antes de escrever: o grilling
2. As oito partes do PRD
3. Um PRD completo
4. Onde vive o PRD
5. O tamanho certo

Capítulo 6: Do PRD aos issues — vertical slices e tracer bullets

1. O que é um vertical slice
2. Tracer bullets: o incerto vem primeiro
3. Blocking relationships
4. O que um issue executável precisa ter
5. Um issue mal escrito e um bem escrito
6. Como criar os issues
7. Antes do próximo capítulo

Capítulo 7: O loop de execução

1. O contrato com o agente
2. Ralph loop
3. Quando intervir
4. O humano sempre lê o código
5. GSD: gestão de contexto entre sessões
6. QA como issue, não como remendo de última hora
7. O loop completo em uma imagem

Capítulo 8: GitHub SpecKit — SDD com estrutura formal

1. O que é o SpecKit exatamente
2. Instalação e estrutura de diretórios
3. A constitution
4. Os 5 comandos do fluxo principal
5. Os 3 comandos de qualidade
6. Branch strategy: a spec viaja com o código
7. Quando usar o SpecKit

Capítulo 9: OpenSpec — Specs leves para projetos existentes

1. O que é OpenSpec
2. O problema que resolve
3. Como funciona
4. O caso brownfield
5. Um exemplo real
6. A diferença de “escrever bem o prompt”
7. Quando migrar para o SpecKit
8. Pontos-chave

Capítulo 10: Fluxos agnósticos de ferramenta

1. Ralph loop
2. GSD
3. BMAD
4. Living-spec platforms
5. Como escolher
6. O que vem na Parte IV

Capítulo 11: Greenfield vs brownfield

1. Greenfield: o cenário ideal
2. A armadilha do greenfield
3. Brownfield: a realidade da maioria
4. A adoção gradual
5. O retrofit do SpecKit
6. Brownfield sem SpecKit
7. O que o brownfield ensina sobre o greenfield
8. Uma regra para cada contexto

Capítulo 12: Os 5 antipadrões que destroem uma spec

1. Antipadrão 1: O PRD quilométrico
2. Antipadrão 2: Prescrever a implementação
3. Antipadrão 3: Out of Scope vazio
4. Antipadrão 4: Premissas vazias ou ausentes
5. Antipadrão 5: Critérios de aceitação vagos
6. A verificação rápida

Capítulo 13: SDD em equipe

1. A spec como linguagem comum
2. Quem escreve o PRD
3. Review de specs, não de código
4. A constitution compartilhada
5. SDD assíncrono
6. O risco das specs de vitrine
7. O que o SDD não substitui
8. O livro termina aqui

Spec-Driven Development

1. Sumário

Por que este livro

Capítulo 1: Vibe coding: funciona até que não funciona

1. O projeto que vai bem até que não vai
2. Os três sintomas
3. Por que isso acontece
4. O erro que quase todo mundo comete
5. Não é um problema de IA
6. O que vem a seguir

Capítulo 2: O que é SDD (e o que não é)

1. O que não é
2. Como chegamos até aqui
3. Por que agora
4. A tabela que resume tudo
5. O que SDD não resolve
6. Uma definição para guardar

Capítulo 3: A spec como artefato primário

1. Por que as specs tradicionais falham
2. A spec viva
3. Comportamento, não arquitetura
4. O que uma spec tem e o que não tem
5. O contrato entre você e o agente
6. Quanto tempo leva para escrever uma spec
7. A spec mais curta que você pode escrever
8. Antes de continuar

Capítulo 4: As 7 fases do desenvolvimento com IA

1. Fase 1: Ideia
2. Fase 2: Pesquisa
3. Fase 3: Protótipo
4. Fase 4: PRD
5. Fase 5: Kanban
6. Fase 6: Execution loop
7. Fase 7: QA
8. Quando pular fases
9. O fluxo completo

Capítulo 5: O PRD — como escrever uma spec que a IA não vai interpretar errado

1. Antes de escrever: o grilling
2. As oito partes do PRD
3. Um PRD completo
4. Onde vive o PRD
5. O tamanho certo

Capítulo 6: Do PRD aos issues — vertical slices e tracer bullets

1. O que é um vertical slice
2. Tracer bullets: o incerto vem primeiro
3. Blocking relationships
4. O que um issue executável precisa ter
5. Um issue mal escrito e um bem escrito
6. Como criar os issues
7. Antes do próximo capítulo

Capítulo 7: O loop de execução

1. O contrato com o agente
2. Ralph loop
3. Quando intervir
4. O humano sempre lê o código
5. GSD: gestão de contexto entre sessões
6. QA como issue, não como remendo de última hora
7. O loop completo em uma imagem

Capítulo 8: GitHub SpecKit — SDD com estrutura formal

1. O que é o SpecKit exatamente
2. Instalação e estrutura de diretórios
3. A constitution
4. Os 5 comandos do fluxo principal
5. Os 3 comandos de qualidade
6. Branch strategy: a spec viaja com o código
7. Quando usar o SpecKit

Capítulo 9: openSpec — specs leves para projetos existentes

1. O que é o openSpec
2. O problema que resolve
3. Como funciona
4. O caso brownfield
5. Um exemplo real
6. A diferença de “escrever o prompt bem”
7. Quando migrar para o SpecKit
8. A regra de ouro

Capítulo 10: Fluxos agnósticos de ferramenta

1. Ralph loop
2. GSD
3. BMAD
4. Living-spec platforms
5. Como escolher
6. O que vem na Parte IV

Capítulo 11: Greenfield vs brownfield

1. Greenfield: o cenário ideal
2. A armadilha do greenfield
3. Brownfield: a realidade da maioria
4. A adoção gradual
5. O retrofit do SpecKit
6. Brownfield sem SpecKit
7. O que o brownfield ensina sobre o greenfield
8. Uma regra para cada contexto

Capítulo 12: Os 5 antipadrões que destroem uma spec

1. Antipadrão 1: O PRD quilométrico
2. Antipadrão 2: Prescrever a implementação
3. Antipadrão 3: Out of Scope vazio
4. Antipadrão 4: Premissas vazias ou ausentes
5. Antipadrão 5: Critérios de aceitação vagos
6. A verificação rápida

Capítulo 13: SDD em equipe

1. A spec como linguagem comum
2. Quem escreve o PRD
3. Review de specs, não de código
4. A constitution compartilhada
5. SDD assíncrono
6. O risco das specs de vitrine
7. O que o SDD não substitui
8. O livro termina aqui

Apêndice A: Modelo de PRD completo

1. Checklist rápido antes de aprovar
2. Notas de uso

Apêndice B: Constitution — as 5 seções com exemplo real

1. O modelo
2. Exemplo real: projeto web moderno
3. Como escrever a constitution para um projeto existente
4. O que NÃO vai na constitution

Apêndice C: Checklist de qualidade antes de executar

1. Checklist do PRD
2. Checklist dos issues
3. Checklist da constitution
4. Checklist pré-QA
5. Checklist pós-QA
6. A pergunta mais importante

Apêndice D: Glossário SDD

Exemplo: PRD resolvido — migrar auth para httpOnly cookies

Apêndice D: Glossário SDD

Apêndice C: Checklist de qualidade antes de executar

1. Checklist do PRD
2. Checklist dos issues
3. Checklist da constitution
4. Checklist pré-QA
5. Checklist pós-QA
6. A pergunta mais importante