laravel-tdd

Visão geral do skill laravel-tdd

O skill laravel-tdd é um guia prático de desenvolvimento orientado a testes para Laravel, pensado para escrever os testes primeiro e só depois implementar o código com PHPUnit ou Pest. Ele é ideal para desenvolvedores que querem um workflow repetível para novas funcionalidades, correções de bugs, refatorações e automação de testes em Laravel, sem precisar reinventar a estratégia de testes a cada tarefa.

O que torna o laravel-tdd útil é o foco nas decisões que normalmente travam as equipes: qual camada de teste usar, quando recorrer a refresh do banco, como lidar com fakes e como manter metas de cobertura realistas. Isso faz do laravel-tdd skill uma opção mais acionável do que um prompt genérico para “escrever testes”.

Melhor uso para automação de testes em Laravel

Use laravel-tdd quando você precisa de automação de testes para código Laravel que passa por HTTP, autenticação, validação, Eloquent, jobs, notificações ou filas. É uma ótima escolha se o seu projeto já valoriza ciclos rápidos de feedback e você quer que o skill ajude a manter a disciplina do ciclo red-green-refactor.

O que ele ajuda a decidir mais rápido

O principal valor do laravel-tdd skill não está em teoria abstrata de TDD. Ele ajuda você a decidir:

• se a mudança deve começar com um teste unitário, de feature ou de integração
• se Pest ou PHPUnit é o melhor padrão para o repositório
• quanto de configuração de banco o teste realmente precisa
• quando fakes bastam e quando vale exercitar fronteiras reais

Quando talvez não seja a melhor opção

Se você quer só um exemplo de código pontual, um prompt amplo sobre Laravel pode ser mais simples. O laravel-tdd skill é mais valioso quando o resultado precisa seguir um workflow de testes que funcione de verdade e quando você se importa com manutenibilidade, cobertura e estrutura consistente ao longo das iterações.

Como usar o skill laravel-tdd

Instale o skill na sua configuração do Claude Code

Instale laravel-tdd com:
npx skills add affaan-m/everything-claude-code --skill laravel-tdd

Esse é o passo de laravel-tdd install de que a maioria dos usuários precisa. Depois da instalação, invoque o skill em um repositório Laravel em que o modelo consiga inspecionar os testes existentes, a configuração de testes e o código que será alterado.

Dê ao skill o formato certo de tarefa

O melhor laravel-tdd usage começa com uma solicitação concreta de comportamento, não com um pedido vago de implementação. Bons inputs descrevem:

• a funcionalidade ou o bug
• o comportamento esperado visível para o usuário
• os models, routes, controllers, jobs ou notifications envolvidos
• qualquer preferência já adotada pelo repositório em relação ao framework de testes

Exemplo de prompt mais forte:
“Use laravel-tdd para adicionar login sem senha por link de e-mail. Prefira o estilo de teste já existente, escreva primeiro o feature test que falha e depois implemente o mínimo necessário. Use fakes quando fizer sentido e mantenha os testes alinhados com as convenções atuais do Laravel.”

Leia primeiro os arquivos mais úteis

Para este laravel-tdd guide, comece por SKILL.md e depois examine a documentação de apoio do repositório, se houver. Neste repo, SKILL.md é a principal fonte de verdade, e as seções mais relevantes são:

• When to Use
• How It Works
• Red-Green-Refactor Cycle
• Test Layers
• orientação sobre estratégia de banco de dados

Se o seu projeto já segue convenções próprias de Laravel, compare-as com o skill antes de escrever testes para não brigar com o estilo local.

Use um workflow que combine com a intenção do skill

Um bom workflow de laravel-tdd é:

1. definir o comportamento em uma frase
2. escolher a camada de teste que comprova esse comportamento
3. escrever o teste que falha
4. implementar o mínimo de código para passar
5. refatorar só depois que o teste ficar verde

Quando você pede ao modelo para seguir essa sequência, reduz detalhes de implementação inventados e recebe uma saída mais fácil de aplicar em uma base Laravel real.

FAQ do skill laravel-tdd

O laravel-tdd é só para quem usa PHPUnit?

Não. O skill dá suporte tanto a PHPUnit quanto a Pest, com preferência por Pest em novos testes, a menos que o projeto já padronize PHPUnit. Se o seu repo for misto, diga ao modelo qual estilo ele deve seguir para não criar inconsistência.

Preciso ter uma suíte grande de testes para usar?

Não. O laravel-tdd skill é útil até em projetos pequenos porque ajuda a escolher o nível certo de teste para cada mudança. Ele é especialmente valioso quando você quer que os primeiros testes criem um padrão que o restante do time possa seguir.

Em que isso difere de um prompt comum para Laravel?

Um prompt comum pode gerar código que funciona uma vez, mas ignora a estrutura de testes. O laravel-tdd skill centraliza o workflow de testes primeiro, a escolha da camada de teste e a estratégia de banco, o que o torna mais adequado para automação de testes e mais compatível com um projeto Laravel real.

Quando devo pular este skill?

Pule se você não estiver testando comportamento de Laravel, se precisar de um protótipo rápido sem disciplina de testes, ou se o seu app tiver um framework interno rígido de testes que conflite com as premissas de PHPUnit/Pest do skill.

Como melhorar o skill laravel-tdd

Dê comportamento, não só objetivos de implementação

Os melhores resultados com laravel-tdd vêm de especificações de comportamento. Em vez de “crie um sistema de notificações”, diga “envie uma notificação por e-mail quando uma fatura ficar vencida e verifique isso com um feature test”. Isso dá ao skill um alvo testável e reduz a troca de mensagens.

Declare a fronteira e o estilo de teste desde o início

Diga ao modelo o que deve ser testado e como. Por exemplo:

• “Use um feature test para o endpoint HTTP e um unit test para a regra de precificação.”
• “Use RefreshDatabase porque o teste toca em Eloquent e policies.”
• “Use Pest, a menos que a suíte existente seja PHPUnit.”

Esses detalhes ajudam o laravel-tdd skill a evitar padrões errados e a produzir uma saída que se encaixa no seu repo.

Fique atento a dois modos comuns de falha

Os problemas mais comuns são testar demais detalhes de implementação e escolher a camada errada de teste. Se a primeira versão vier baixa demais no nível de abstração, peça uma reescrita focada em comportamento. Se a montagem do teste parecer pesada, peça ao modelo para reduzir fixtures, preferir factories e simplificar a configuração de banco sempre que possível.

Itere com uma revisão do teste que falha

Depois da primeira resposta, verifique se o teste realmente falharia pelo motivo certo antes da mudança no código. Se não, peça uma asserção mais estrita, uma fixture mais limpa ou um escopo mais estreito. Essa é a forma mais rápida de melhorar a saída do laravel-tdd para automação de testes em projetos reais.