Como um Desenvolvedor da YADRO Configura Claude Code com Spec-Driven Development

O programador e arquiteto da YADRO Daniil Podolskiy trabalha com a metodologia Spec-Driven Development há nove meses e gerencia agentes de IA que escrevem código no lugar dele. Ele se chama não de vibe coder, mas de engenheiro — e explica por quê. Este é o primeiro artigo de sua série sobre organização do espaço de trabalho de um desenvolvedor SDD: um exame da configuração básica do Claude Code para troca rápida de modelos sem recarregar.

SDD contra Vibe Coding

Vibe coding é quando um desenvolvedor descreve uma tarefa para IA, vê o resultado e itera "por intuição". A abordagem é popular justamente porque funciona rápido e não requer preparação prévia. Spec-Driven Development é fundamentalmente diferente.

Primeiro, cria-se uma especificação completa: requisitos, arquitetura, comportamento do sistema, casos extremos. Somente depois o agente de IA começa a trabalhar a partir do documento como uma especificação técnica. O desenvolvedor molda a estrutura e toma decisões arquiteturais, enquanto a IA implementa os detalhes e preenche o código.

Podolskiy insiste que sua abordagem é "mais compreensiva do que simplesmente conversar com IA". O SDD restaura a disciplina de engenharia em uma área onde começou a desaparecer devido à velocidade das ferramentas de IA — requisitos, design, implementação, verificação. O executor mudou, mas o próprio processo permanece de engenharia.

Isto é o que distingue SDD de vibe coding: não a ferramenta, mas a metodologia.

Configurando Claude Code para Múltiplos Projetos

A tarefa central do artigo é como alternar modelos no Claude Code sem recarregar, individualmente para cada projeto. À primeira vista um detalhe, na prática — um sério gargalo para quem gerencia múltiplos repositórios simultaneamente. A configuração global padrão de modelo não é adequada nessa situação. Diferentes projetos impõem diferentes requisitos: um serviço de produção precisa de Opus com reasoning profundo e adesão rigorosa a instruções, um protótipo ou tarefa rotineira funciona bem com Sonnet ou Haiku. Se cada transição entre projetos requer reconfiguração manual e reinicialização do agente, o desenvolvedor gradualmente começa a evitar mudanças de modelo — e pega um "universal" em vez do ótimo.

Princípios-chave de configuração:

• `CLAUDE.md` na raiz do projeto — modelo e contexto são totalmente isolados no nível do repositório
• O comando `/model` alterna modelos em tempo real sem reiniciar a sessão atual
• `settings.json` no nível do projeto armazena perfis de agentes, permissões e conjuntos de ferramentas
• Arquivos de override locais distinguem configurações dev e prod
• Variáveis de ambiente permitem controlar modelos através de CI/CD sem editar arquivos de config

Por Que a Velocidade de Alternância Muda a Qualidade

Com Spec-Driven Development, um único projeto usa sequencialmente vários modelos em diferentes estágios. Criar uma especificação requer um modelo poderoso com reasoning forte e respostas detalhadas. Implementar a partir de uma especificação pronta precisa de um modelo rápido e previsível — menos chance de desvio da tarefa. Para revisão final, outro perfil é necessário novamente. Se a alternância leva trinta segundos e requer manipulação manual, o desenvolvedor gradualmente começa a evitar mudanças de modelo. Isto prejudica tanto a velocidade quanto a qualidade — especialmente no estágio de escrita de especificação, onde reasoning é crítico.

"Minha abordagem para o trabalho é mais compreensiva do que simplesmente conversar com IA", —

Daniil Podolskiy, YADRO.

A série continuará. Os próximos artigos abordarão orquestração de múltiplos agentes em paralelo, gerenciamento de contexto e a estrutura das próprias especificações.

O Que Isto Significa

Spec-Driven Development gradualmente se torna uma disciplina de engenharia separada. Enquanto a maioria dos desenvolvedores estão aprendendo vibe coding, alguns estão fazendo a transição para metodologias rigorosas: documentação, especificação, agente, verificação. Uma análise da configuração do Claude Code de um arquiteto na YADRO é um dos primeiros materiais sistemáticos em língua russa sobre este tópico. A série vale a pena acompanhar para quem ainda trabalha com ferramentas de IA intuitivamente.