Sumário · 11 seções0% lido
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 O resultado: sistemas inteiros em produção com IA
- 0:37 Por que método importa mais que o modelo
- 1:33 Como eu começava: copiar, colar e testar
- 3:09 Hábito 1: spec antes do código (SDD)
- 5:20 Não importa a ferramenta
- 5:55 Hábito 2: skills
- 7:49 Hábito 3: modelo por tarefa
- 9:43 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: 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: Aprofunda a etapa de conferir o resultado que a IA entrega.
- Nox: Exemplo de projeto construído com agentes, descrito no site.
// Curso · WDS Builders
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.
// 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 →







