Spec Driven Development

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

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

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: Research
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 interprete mal

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

Capítulo 6: De PRD a issues — vertical slices e tracer bullets

1. O que é um vertical slice
2. Tracer bullets: o incerto vai 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. Loop multi-agente
4. Quando intervir
5. O humano sempre lê o código
6. GSD: gestão de contexto entre sessões
7. QA como issue, não como remendo de última hora
8. O loop completo em uma imagem

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

1. O que é SpecKit?
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 SpecKit
8. Na prática

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 com “escrever o prompt bem”
7. Quando migrar para SpecKit
8. Pontos-chave
9. Na prática

Capítulo 10: Fluxos agnósticos de ferramenta

1. Ralph loop
2. GSD
3. BMAD
4. ShipSpec
5. Tessl
6. Living-spec platforms
7. Como escolher
8. O que vem na Parte IV
9. Na prática

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 anti-padrões que destroçam uma spec

1. Anti-padrão 1: O PRD quilométrico
2. Anti-padrão 2: Prescrever a implementação
3. Anti-padrão 3: Out of Scope vazio
4. Anti-padrão 4: Assumptions vazias ou ausentes
5. Anti-padrão 5: Acceptance Criteria vaga
6. Anti-padrão 6 (bônus): Abandonar a spec no meio da execução
7. O checklist rápido

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 escaparate (Spec Theater)
7. SDD como prática de governança
8. O que SDD não substitui
9. Antes do caso prático

Capítulo 14: SDD na prática — o ciclo completo

1. O ticket como chega
2. O grilling
3. O PRD
4. De PRD para issues
5. O loop de execução
6. O que o agente produz
7. O que o spec comprou
8. O plano de QA

Capítulo 15: Caso completo — sistema de notificações multicanal

1. O ticket como ele chega
2. O grilling
3. O PRD
4. De PRD a issues: três vertical slices
5. O loop de execução
6. O plano de QA
7. O que o spec comprou
8. A diferença entre os dois casos

Capítulo 16: Caso completo — converter uma API interna em um contrato público com OpenSpec

1. O ticket como chega
2. O problema antes do código
3. /opsx:onboard — fotografia do sistema real
4. O grilling — as perguntas do contrato
5. O PRD — o contrato antes do código
6. /opsx:propose partner-orders-v1 + revisão de artefatos
7. /opsx:apply + a decisão de versioning
8. /opsx:archive — o spec delta como artefato de negócio
9. O que a Acme Corp recebe
10. /opsx:verify — quando o contrato encontra a realidade
11. A política de versioning como gate de CI
12. O que o OpenSpec adiciona que o SDD manual não tem

Apêndice: Glossário SDD