---
title: "Spec-Driven Development com IA: fluxo no VS Code com Codex e Claude Code"
description: "Como programar com IA colocando sistemas inteiros em produção: spec antes do código, skills reutilizáveis e escolha do modelo certo para cada tarefa."
url: "https://williandsantos.com/videos/spec-primeiro-codigo-depois-meu-fluxo-com-ia-no-vs-code/"
language: "pt-BR"
---

Vídeo · Inteligência Artificial

# Spec-Driven Development com IA: fluxo no VS Code com Codex e Claude Code

Como programar com IA colocando sistemas inteiros em produção: spec antes do código, skills reutilizáveis e escolha do modelo certo para cada tarefa.

Duração

11:42

Capítulos

8

Publicado

13 OUT

[Inscrever-se no canal →](https://www.youtube.com/@williandsantos?sub%5Fconfirmation=1) [Ler o resumo ↓](#resumo)

WDS // Vídeo [YouTube](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0)

[![](https://i.ytimg.com/vi/Gm3H_3CRYh0/maxresdefault.jpg)](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0)

## Resumo

Para programar um sistema inteiro com IA, escreva a especificação antes do código (PRD, specs, design system), use skills para repetir o que funciona e escolha o modelo por tarefa: mais raciocínio para planejar, um modelo mediano para implementar. A ferramenta importa menos que a qualidade da direção que você dá: o que construir, dentro de quais limites e como conferir o resultado.

## O que o vídeo mostra

O vídeo mostra o fluxo do Willian no VS Code com Codex e Claude Code, e os três hábitos que mudaram o resultado dele: spec antes do código, skills reutilizáveis como a Superpowers e a escolha do modelo para cada etapa. Ele conta como saiu do copia-e-cola no chat para um processo guiado por especificação e mostra os sistemas pessoais que roda em produção hoje.

- [0:00](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=0s) O resultado: sistemas inteiros em produção com IA
- [0:37](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=37s) Por que método importa mais que o modelo
- [1:33](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=93s) Como eu começava: copiar, colar e testar
- [3:09](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=189s) Hábito 1: spec antes do código (SDD)
- [5:20](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=320s) Não importa a ferramenta
- [5:55](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=355s) Hábito 2: skills
- [7:49](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=469s) Hábito 3: modelo por tarefa
- [9:43](https://www.youtube.com/watch?v=Gm3H%5F3CRYh0&t=583s) O que isso resulta

## Por que pedir direto para a IA não funciona num sistema inteiro?

Para uma tarefa pequena, pedir e ajustar funciona. Você descreve, o agente executa, você corrige e repete o ciclo. O problema aparece quando o que você quer é um projeto: várias partes que precisam conversar, decisões que precisam ficar registradas e padrões que você repete toda hora.

Um agente executa rápido o que você pede. Se o pedido é vago, ele executa de forma vaga, só que rápida. Por isso o gargalo deixa de ser a velocidade da máquina e passa a ser a sua direção: o que construir, dentro de quais limites e como conferir.

Esse é o ponto de partida do Willian no vídeo. Ele mesmo começou no chat, copiando código para a IDE, testando, voltando com o erro e repetindo. Quando passou a usar o Codex, o resultado melhorou, mas o ganho grande veio de mudar o jeito de trabalhar, não só a ferramenta.

## O que é Spec-Driven Development (SDD) e o que vai na especificação?

SDD é desenvolver guiado por especificação: você escreve, em arquivos dentro do projeto, o que a IA deve construir antes de ela escrever código. No vídeo, o Willian mantém uma pasta de especificações aberta no VS Code, e o agente consulta esses arquivos ao implementar.

A especificação define os limites. Quanto mais clara, menos o agente inventa por conta própria. Você pode organizar o material em documentos separados, cada um com uma função.

Uma boa especificação cobre o suficiente para que alguém sem o contexto da sua cabeça consiga executar. Se uma decisão importa, ela precisa estar escrita.

- PRD: o problema, quem usa, o que o sistema faz e o que fica de fora.
- Specs: as tarefas a desenvolver, com o passo a passo e o critério de pronto.
- Design system: padrões visuais e de interface, para o agente não sair do trilho.
- Decisões técnicas: tecnologias, arquitetura, banco de dados e autenticação.
- Critérios de conferência: como você vai verificar se cada entrega está certa.

## Como a spec resolve o problema do contexto que se perde no chat?

Em conversas longas, o contexto cresce até a janela ficar pesada. O Willian relata um projeto em que o chat chegou a travar no computador e a própria IA pediu para continuar em uma nova conversa. Nesse momento, decisões tomadas no início se perdem.

Com a especificação em arquivos, o histórico deixa de morar na conversa. O que foi decidido fica no repositório, estável. Cada vez que o agente vai trabalhar, ele busca o PRD e as specs de que precisa e carrega só isso no contexto.

Na prática, isso também deixa o trabalho retomável: você pode abrir uma sessão nova, apontar para os documentos e continuar de onde parou, sem recontar a história do projeto.

## O que são skills e quando vale usar uma como a Superpowers?

Skills são instruções reutilizáveis que o agente carrega quando precisa. Em vez de repetir o mesmo contexto a cada conversa, você deixa o procedimento registrado e o agente o usa na hora certa. O Willian também comenta que isso pode ajudar a economizar tokens, já que o conteúdo só entra quando é necessário.

Antes, ele montava as specs conversando com o ChatGPT na web: fazia uma espécie de entrevista para construir PRD, parte técnica e design. Com a Superpowers, esse papel passa para uma skill que o entrevista, faz perguntas que ele talvez esquecesse, traça o plano, gera a spec e só então implementa.

Vale criar ou instalar uma skill quando você percebe que está repetindo a mesma instrução ou o mesmo roteiro em vários projetos. Para tarefas únicas e curtas, o ganho é pequeno.

- Use skill para o que se repete: entrevista de requisitos, padrão de implementação, revisão.
- Não crie skill para algo que você fez uma vez e talvez nunca repita.
- Revise o que a skill produz: ela acelera o processo, mas a decisão final continua sendo sua.

## Qual modelo de IA usar em cada etapa do projeto?

A divisão que o Willian usa: modelos de mais raciocínio (Opus no Claude Code, GPT Astra no Codex) para descoberta, plano e spec; um modelo mediano (Sonnet no Claude Code, GPT Sol no Codex) para implementar depois que o plano está definido. Os nomes mudam com o tempo, mas a lógica é a mesma: raciocínio caro onde a decisão pesa, modelo mais econômico onde a tarefa já está bem definida.

Ele próprio diz que viu alguém planejando com um modelo menor e obtendo bom resultado, o que contraria o que aprendeu, e que vai pesquisar mais antes de concluir. Trate a divisão como ponto de partida e teste no seu caso.

Uma regra prática: se um erro aqui custa caro lá na frente (arquitetura, modelo de dados, autenticação), use mais raciocínio. Se a tarefa está claramente especificada e é fácil de conferir, um modelo mediano costuma bastar.

## Preciso do VS Code ou funciona em outra ferramenta?

Não precisa. O Willian usa o VS Code, mas hoje alterna também com os aplicativos desktop do Claude e do Codex. Ele destaca que os hábitos funcionam no Antigravity, no Cursor ou em qualquer ferramenta que integre com IA.

O que se mantém igual é o essencial: um projeto com especificações em arquivos, skills para o que se repete e um modelo escolhido por tarefa. Se você já usa uma ferramenta, comece por aí em vez de trocar.

## Para aplicar

- Escolha um projeto pequeno e crie uma pasta de especificações com um PRD de uma página: problema, usuário, o que entra e o que fica de fora.
- Escreva as specs das primeiras tarefas com passo a passo e critério de pronto antes de pedir qualquer código.
- Defina por escrito as decisões técnicas: tecnologias, arquitetura, banco e autenticação.
- Instale uma skill de planejamento, como a Superpowers, e deixe que ela entreviste você sobre a ideia antes de gerar o plano.
- Use um modelo de mais raciocínio para o plano e a spec, e um modelo mediano para a implementação.
- Confira cada entrega contra os critérios da spec antes de seguir para a próxima tarefa.
- Abra uma sessão nova do agente, aponte para os documentos e verifique se ele consegue continuar sem você recontar o projeto.

## Perguntas frequentes

### Spec-Driven Development serve para projetos pequenos?

Para uma tarefa curta, pedir direto costuma bastar. O SDD compensa quando há várias partes, decisões a registrar e a chance de você voltar ao projeto depois. Mesmo num projeto pequeno, um PRD curto já evita retrabalho.

### Qual a diferença entre PRD e spec?

O PRD descreve o produto: problema, usuário, escopo e o que fica de fora. A spec descreve uma tarefa de implementação específica, com passo a passo e critério de pronto. O PRD orienta o que construir; a spec orienta como executar cada parte.

### Posso criar a spec conversando com o ChatGPT?

Pode, e foi assim que o Willian começou: uma entrevista no chat para montar PRD, parte técnica e design. A diferença é que, com uma skill como a Superpowers, essa entrevista e o plano acontecem dentro do fluxo do agente, e a spec já fica no projeto.

### Skills gastam mais ou menos tokens?

O Willian diz ter descoberto que podem ajudar a economizar, porque o conteúdo da skill só entra no contexto quando é necessário, em vez de você repassar tudo em toda conversa. O efeito real depende da skill e de como você a usa.

### Preciso usar sempre o modelo mais caro?

Não. A lógica descrita no vídeo é reservar o modelo de maior raciocínio para planejamento e decisões, e usar um modelo mediano para implementar o que já está bem especificado. Teste a divisão no seu projeto, porque os modelos e os preços mudam.

## Para continuar

- [IA aplicada: como montar um sistema de IA confiável](https://williandsantos.com/blog/ia-aplicada-sistema-confiavel/): Complementa com o que torna um sistema de IA confiável depois que ele sai do papel.
- [Revisão humana em automação com IA: quando e como fazer](https://williandsantos.com/blog/revisao-humana-e-parte-do-workflow/): Aprofunda a etapa de conferir o resultado que a IA entrega.
- [Nox](https://williandsantos.com/projetos/nox/): Exemplo de projeto construído com agentes, descrito no site.

// Curso · WDS Builders

## [Video Builder IA](https://williandsantos.com/cursos/video-builder-ia/)

Você grava o seu vídeo e dirige um agente de IA que transcreve, corta, legenda, anima e renderiza. Nada avança sem a sua aprovação. Do bruto ao vídeo publicado.

[Entrar na lista de espera →](https://williandsantos.com/cursos/video-builder-ia/#inscricao)

// Canal no YouTube

### Inscreva-se no canal

IA aplicada, automação e os bastidores do que estou construindo, mostrados na prática.

[Inscrever-se no canal →](https://www.youtube.com/@williandsantos?sub%5Fconfirmation=1)

Próximo vídeo 

## [Como programar com IA sem escrever código: plano, build e validação](https://williandsantos.com/videos/programar-com-ia-sem-escrever-codigo-meu-fluxo-num-projeto-real/)

![](https://williandsantos.com/assets/author/avatar-128.webp)

## Willian D. Santos

Desenvolvedor, builder e founder construindo sistemas e produtos em público.

[Sobre mim →](https://williandsantos.com/sobre/) [Artigos →](https://williandsantos.com/autor/willian-d-santos/)

Tags 

spec driven development programar com IA Claude Code Codex VS Code skills para agentes de IA

Continue assistindo 

## Mais vídeos sobre o tema

[Ver todos os vídeos →](https://williandsantos.com/videos/)

Vídeo 11 min

### [Agentes de IA: como a IA evoluiu até eles e o que sobrou para você](https://williandsantos.com/videos/como-a-ia-chegou-aos-agentes-de-ia-e-o-que-sobrou-pra-voce/)

Veja como a IA saiu do texto completado até os agentes de IA que executam tarefas, e quais habilidades de direção você precisa para tirar proveito disso.

YouTube [Assistir →](https://williandsantos.com/videos/como-a-ia-chegou-aos-agentes-de-ia-e-o-que-sobrou-pra-voce/)

Vídeo 12 min

### [Agente de IA: o que é, como funciona e quando usar](https://williandsantos.com/videos/o-que-e-um-agente-de-ia-entenda-o-conceito-de-uma-vez-por-todas/)

Entenda o que é um agente de IA: os três ingredientes, a diferença para o chat, exemplos práticos e como escolher o nível de permissão com segurança.

YouTube [Assistir →](https://williandsantos.com/videos/o-que-e-um-agente-de-ia-entenda-o-conceito-de-uma-vez-por-todas/)

Vídeo 9 min

### [Codex vs Claude Code: como usar o Codex no VS Code e qual escolher](https://williandsantos.com/videos/por-que-uso-as-duas-codex-vs-claude-code-no-vs-code/)

Veja como instalar a extensão do Codex no VS Code, dar a primeira tarefa a um projeto real e entender quando escolher Codex ou Claude Code para programar.

YouTube [Assistir →](https://williandsantos.com/videos/por-que-uso-as-duas-codex-vs-claude-code-no-vs-code/)

Leia também 

## Artigos sobre o mesmo tema

[Ver o blog →](https://williandsantos.com/blog/)

[Inteligência Artificial](https://williandsantos.com/blog/categoria/inteligencia-artificial/) 20 de nov. de 2026

### [Edição de vídeo com IA: como funciona do bruto ao publicado](https://williandsantos.com/blog/edicao-de-video-com-ia/)

Entenda a edição de vídeo com IA, do vídeo bruto ao publicado: o que a IA faz em cada etapa, o que continua sendo sua decisão e como começar.

16 min de leitura [Ler →](https://williandsantos.com/blog/edicao-de-video-com-ia/)

[Inteligência Artificial](https://williandsantos.com/blog/categoria/inteligencia-artificial/) 09 de set. de 2026

### [IA aplicada: como montar um sistema de IA confiável](https://williandsantos.com/blog/ia-aplicada-sistema-confiavel/)

Como levar a IA do teste no chat para o processo real: tarefa delimitada, contexto, avaliação, travas e monitoramento, com passo a passo e erros comuns.

9 min de leitura [Ler →](https://williandsantos.com/blog/ia-aplicada-sistema-confiavel/)

[Inteligência Artificial](https://williandsantos.com/blog/categoria/inteligencia-artificial/) 02 de set. de 2026

### [Revisão humana em automação com IA: quando e como fazer](https://williandsantos.com/blog/revisao-humana-e-parte-do-workflow/)

Como desenhar a revisão humana em automações com IA: onde colocar a etapa, quem revisa, quais critérios usar e como evitar que vire gargalo ou carimbo.

8 min de leitura [Ler →](https://williandsantos.com/blog/revisao-humana-e-parte-do-workflow/)
