tdd-workflow

Visão geral da skill tdd-workflow

O que a tdd-workflow faz

tdd-workflow é uma skill de execução test-first para desenvolvimento de funcionalidades, correções de bugs e refatorações. Ela foi pensada para ajudar você a sair de uma ideia bruta de implementação até um código verificado por testes unitários, de integração e E2E, em vez de corrigir tudo depois do fato.

Quem deve instalar

Instale a skill tdd-workflow se você quer um ciclo de desenvolvimento mais rigoroso para código de aplicação, APIs, mudanças de UI ou trabalho com muita automação. Ela é especialmente útil quando você precisa de cobertura previsível, tratamento explícito de casos de borda e uma ordem de execução repetível para trabalho de Test Automation.

Por que ela se destaca

O principal valor da tdd-workflow é a disciplina: os testes vêm antes do código, as metas de cobertura são explícitas e o fluxo espera evidências em cada etapa. Isso a torna mais útil para decisão do que um prompt genérico de “escreva testes”, porque obriga o agente a planejar, verificar e registrar checkpoints em vez de partir direto para a implementação.

Como usar a skill tdd-workflow

Instale e ative

Use o fluxo tdd-workflow install para este repositório, ou adicione pela sua path de skills do Claude Code se o seu ambiente gerencia skills manualmente. O ponto importante é que o agente veja a skill antes de começar a codificar, e não depois que já existe um primeiro rascunho.

Dê ao skill o formato certo de tarefa

O padrão tdd-workflow usage funciona melhor quando o seu pedido nomeia a mudança, o risco e a prova esperada. Entrada fraca: “corrigir login.” Entrada forte: “Adicionar validação de reset de senha, cobrir estados de erro da API e da UI, e manter o contrato atual de autenticação sem बदलाव.” A segunda versão dá estrutura suficiente para escrever testes primeiro e escolher a combinação certa de cobertura unitária, de integração e E2E.

Leia estes arquivos primeiro

Comece com SKILL.md, depois examine o README.md, AGENTS.md, metadata.json e quaisquer pastas rules/, resources/, references/ ou scripts/, se existirem. Neste repositório, SKILL.md é o único arquivo-fonte visível, então trate-o como a especificação canônica do fluxo e adapte-o ao stack de testes e às restrições do projeto-alvo.

Siga o fluxo na ordem

Use a skill para definir primeiro os testes que falham, depois implemente a menor mudança de código que os faça passar e, em seguida, rode a próxima camada de validação. Se o seu repositório suportar checkpoints no Git, preserve um commit após cada etapa de TDD para manter o rastro de evidências legível e reversível. Isso importa ainda mais quando o trabalho atravessa lógica de backend, fronteiras de API e comportamento no navegador.

FAQ da skill tdd-workflow

A tdd-workflow serve só para mudanças grandes?

Não. A tdd-workflow skill também é útil para correções pequenas, especialmente quando o bug é sutil ou pode voltar a ocorrer. Ela é menos valiosa para ajustes triviais de texto ou mudanças de configuração em uma linha que não se beneficiam de verificação em etapas.

Preciso ter uma suíte de testes madura antes?

Não necessariamente, mas você precisa ter ferramenta de testes suficiente para tornar o fluxo real. Se um projeto não tiver uma configuração prática de testes unitários, de integração ou E2E, o tdd-workflow guide ainda ajuda no processo, mas as metas de cobertura podem precisar ser adaptadas aos limites reais de teste do repositório.

Em que isso é diferente de um prompt normal?

Um prompt normal pode pedir código e testes juntos. A tdd-workflow muda a ordem e as regras de decisão: testes primeiro, expectativas de cobertura explícitas e validação em etapas por tipo de teste. Isso geralmente reduz a adivinhação quando você está fazendo Test Automation ou trabalhando em várias camadas do stack.

É amigável para iniciantes?

Sim, desde que você se sinta confortável lendo falhas de teste e seguindo um ciclo passo a passo. Iniciantes se beneficiam da estrutura, mas precisam manter a tarefa estreita e fornecer critérios de aceitação claros; caso contrário, o fluxo pode parecer rígido em vez de útil.

Como melhorar a skill tdd-workflow

Forneça critérios de aceitação mais precisos

A melhor entrada para tdd-workflow diz o que precisa funcionar, o que não pode mudar e como o sucesso será verificado. Inclua entradas, saídas, casos de falha e quaisquer restrições de compatibilidade. Por exemplo: “Rejeitar email vazio, preservar o formato atual da resposta e cobrir o caminho no navegador junto com o tratamento de erro da API.”

Peça a mistura certa de testes

A skill performa melhor quando você especifica onde está o risco. Se a mudança toca lógica de negócio, peça testes unitários primeiro. Se cruza limites de serviço, exija cobertura de integração. Se a jornada do usuário importa, adicione verificações E2E. Isso evita que o fluxo use demais um tipo de teste e deixe passar o modo real de falha.

Fique atento aos modos de falha mais comuns

O problema mais comum é implementar demais antes que os testes estejam estáveis. Outro é tratar cobertura de 80%+ como um número a bater, e não como um sinal para cobrir casos de borda, fronteiras e caminhos de erro. Se a primeira passagem ficar ampla demais, reduza o escopo e rode novamente o loop tdd-workflow usage com um cenário por vez.

Itere com evidências

Depois da primeira saída, revise qual teste falhou, qual comportamento foi comprovado e o que ainda ficou sem teste. Em seguida, peça o próximo incremento menor, em vez de uma reescrita completa. Para tdd-workflow for Test Automation, isso normalmente significa refinar seletores, tornar as asserções explícitas e cobrir casos negativos antes de expandir para mais fluxos de usuário.