Como um desenvolvedor da YADRO configura o Claude Code com Spec-Driven Development

Daniil Podolsky, programador e arquiteto da YADRO, trabalha há nove meses com a metodologia Spec-Driven Development e conduz agentes de IA que escrevem código no lugar dele. Ele não se considera um vibe coder, e sim um engenheiro, e explica por quê. Este é o primeiro artigo de sua série sobre como organizar o ambiente de trabalho de um desenvolvedor SDD: uma análise da configuração básica do Claude Code para trocar de modelo rapidamente, sem reiniciar.

SDD versus vibe coding

Vibe coding é quando o desenvolvedor descreve uma tarefa para a IA, olha o resultado e itera "no feeling". A abordagem é popular justamente porque é rápida e não exige preparação prévia.

O Spec-Driven Development funciona com um princípio bem diferente. Primeiro se cria uma especificação completa: requisitos, arquitetura, comportamento do sistema, casos de borda. Só depois disso o agente de IA começa a trabalhar com o documento como se fosse um briefing técnico. O desenvolvedor define a estrutura e toma as decisões de arquitetura; a IA implementa os detalhes e preenche o código.

Podolsky insiste que sua abordagem é "mais abrangente do que simplesmente conversar com uma IA". O SDD devolve a disciplina de engenharia a um ponto onde ela vinha desaparecendo por causa da velocidade das ferramentas de IA: requisitos, design, implementação, verificação. O executor mudou, mas o processo continua sendo de engenharia. É isso que diferencia o SDD do vibe coding: é uma metodologia, não uma ferramenta.

Configuração do Claude Code para vários projetos

A tarefa central do artigo é como trocar de modelo no Claude Code sem reiniciar, individualmente para cada projeto. Parece um detalhe, mas na prática é um freio sério para quem mantém vários repositórios ao mesmo tempo.

A configuração global padrão de modelo não funciona bem nesse cenário. Cada projeto tem exigências diferentes: um serviço em produção precisa do Opus, com raciocínio profundo e seguimento rigoroso de instruções, enquanto um protótipo ou uma tarefa de rotina se dá bem com Sonnet ou Haiku. Se cada passagem de um projeto para outro exige reconfiguração manual e reinício do agente, o desenvolvedor passa a evitar a troca de modelo e escolhe um modelo "universal" em vez do ideal.

Princípios-chave da configuração:

• `CLAUDE.md` na raiz do projeto: modelo e contexto ficam totalmente isolados no nível do repositório
• O comando `/model` troca o modelo na hora, sem reiniciar a sessão atual
• O `settings.json` no nível do projeto guarda perfis de agentes, permissões e o conjunto de ferramentas
• Arquivos locais de override separam as configurações de dev e prod
• Variáveis de ambiente permitem controlar o modelo via CI/CD sem editar arquivos de configuração

Por que a velocidade de troca muda a qualidade

No Spec-Driven Development, um mesmo projeto usa vários modelos em sequência, em etapas diferentes. Para criar a especificação, é preciso um modelo poderoso, com raciocínio forte e respostas detalhadas. Para implementar a partir de uma especificação pronta, basta um modelo rápido e previsível, o que reduz a chance de desvio do escopo. Para a revisão final, é necessário outro perfil.

Se a troca leva meio minuto e exige passos manuais, o desenvolvedor aos poucos passa a evitar trocar de modelo. Isso piora tanto a velocidade quanto a qualidade, principalmente na etapa de escrita da especificação, em que o raciocínio é crítico.

"Minha abordagem de trabalho é mais abrangente do que simplesmente conversar com uma IA", —

Daniil Podolsky, YADRO.

A série vai continuar. Os próximos artigos tratarão da orquestração de vários agentes em paralelo, do gerenciamento de contexto e da estrutura das próprias especificações.

O que isso significa

O Spec-Driven Development vai se consolidando como uma disciplina de engenharia própria. Enquanto a maioria dos desenvolvedores aprende vibe coding, parte deles migra para metodologias rigorosas: documentação, especificação, agente, verificação. Esta análise da configuração do Claude Code feita por um arquiteto da YADRO é um dos primeiros materiais sistemáticos em russo sobre o assunto. Vale acompanhar a série também para quem ainda usa ferramentas de IA de forma intuitiva.