Fluxo de Desenvolvimento Orientado por Especificações para Claude Code: Decomposição, Limpeza de Contexto e Controle de Custos

Um novo plugin de código aberto chamado Spec Driven Development Workflow (SDDW) tem como objetivo melhorar o desempenho do Claude Code em tarefas complexas por meio de decomposição estruturada e gerenciamento de contexto. A abordagem, compartilhada no Hacker News pelo desenvolvedor sermakarevich, é projetada para projetos de médio a grande porte onde o modo de planejamento + código do Claude não é suficiente.

Conceitos Principais

• Decomposição bidimensional: Primeiro, gere especificações em várias etapas (requisitos, análise de código, design). Em seguida, divida a implementação em subtarefas e execute-as uma por uma.
• Limpeza de contexto entre cada etapa: Após a geração das especificações e após a implementação de cada subtarefa, o contexto é limpo. Isso mantém os custos baixos e focados, melhorando o desempenho.
• Especificações salvas em disco: Arquivos de especificação persistentes mantêm as informações entre sessões, evitando perdas quando o contexto é limpo.
• Entrega camada por camada: Entregue as especificações incrementalmente para detectar mal-entendidos precocemente.

Quando Usar

Segundo o autor, o SDDW não substitui o modo de planejamento + código do Claude quando este funciona bem. É para cenários em que o planejamento + código falha porque o recurso é muito complicado. A dupla decomposição ajuda a reduzir confusões e melhora as taxas de sucesso em tarefas complexas.

O autor também observa que o SDDW funciona bem com uma frota de agentes — você pode inserir a sequência de etapas do SDDW em uma fila e deixar que vários agentes lidem com as subtarefas.

Comparação com Outras Ferramentas

Comparado a ferramentas como GSD (Generalized Spec-Driven Development), o SDDW é adaptado para projetos de médio porte. O GSD era ótimo, mas pesado em tokens para tarefas menores. O SDDW permite ajustes para tamanhos típicos de projeto.

Críticas da Comunidade

Alguns comentaristas do HN levantaram preocupações:

• Adesão e preguiça do agente — mesmo com uma especificação detalhada, os agentes podem produzir resultados que exigem ajustes e polimento significativos.
• Sem métricas formais — o autor reconhece que medir o sucesso é subjetivo, mas afirma que quando o planejamento + código falha e o SDDW funciona, há um ganho líquido.
• Especificações como código não executável — uma especificação suficientemente detalhada é quase equivalente ao código, então a sobrecarga pode nem sempre ser justificada.

Começando

O plugin está disponível no GitHub: github.com/sermakarevich/sddw. Slides com mais detalhes estão linkados na discussão do HN.