GSD-Lite: Uma Máquina de Estado para Código Claude que Impõe TDD e Previne a Omissão de Testes

GSD-Lite é um servidor MCP de código aberto que se acopla ao Claude Code e executa projetos por meio de uma máquina de fluxo de trabalho de 12 estados. A ferramenta é licenciada pelo MIT e consiste em cerca de 15 arquivos-fonte no total.

Como Funciona

Após planejar o que construir em conversa com o Claude, o GSD-Lite assume automaticamente: escrever código, revisá-lo, verificá-lo, avançar para a próxima fase. O ciclo de execução segue este padrão:

• Orquestrador escolhe a próxima tarefa
• Executor escreve o código (TDD, ponto de verificação)
• Revisor verifica (contexto separado, especificação + qualidade)
• Aprovado? Próxima tarefa. Rejeitado? Refazer.
• Todas as tarefas concluídas? Verificação do portão de fase
• Portão passa? Próxima fase
• Todas as fases concluídas? Você terminou

Recursos Principais

Imposição de TDD: A "Lei de Ferro" está embutida em cada despacho de tarefa: nenhum código de produção sem um teste que falhe primeiro. O prompt lista as racionalizações exatas que o Claude usa para pular testes ("Esta é apenas uma alteração de configuração", "Os testes existentes já cobrem isso") e as sinaliza como desculpas conhecidas.

Contextos de Agentes Separados: As revisões são executadas em um contexto de agente separado, onde o revisor nunca vê o raciocínio do executor—apenas o diff e a especificação da tarefa. Isso evita aprovações automáticas e ajuda a capturar bugs reais.

Agente Depurador: Quando uma tarefa falha 3 vezes, em vez de outra tentativa, um agente depurador é despachado. Este agente separado reproduz a falha, formula hipóteses, testa-as, identifica onde a correção deve ser aplicada e, em seguida, fornece as descobertas ao executor.

Rastreamento de Dependências: Se uma tarefa alterar a assinatura de uma API, qualquer coisa subsequente é invalidada e reenfileirada automaticamente.

Detalhes Técnicos

O sistema usa 6 comandos, 4 agentes e 11 ferramentas MCP. O estado é gerenciado em um arquivo JSON com validação de esquema e conflitos de versão tratados por meio de concorrência otimista.

Por Que Não a Versão Original

A primeira versão tinha 32 comandos, 12 agentes, mais de 100 arquivos-fonte e um instalador de 2400 linhas. O autor a descartou e reescreveu do zero porque a maior parte dessa complexidade estava queimando a janela de contexto sem fornecer valor.

Descobertas Inesperadas

A abordagem anti-racionalização funciona—listar frases específicas que o Claude usa para pular etapas diretamente no prompt do agente reduziu a taxa de omissão. O autor observa que exemplos negativos parecem direcionar o modelo melhor do que apenas dizer "sempre escreva testes". A persistência de sessão foi o desafio de implementação mais difícil.