O que claude-code-tdd faz?
Automatize TDD para Claude Code com agentes baseados em funções, revisões obrigatórias e CI verde para PRs prontos para merge.
Visão Geral
Este skill configura um fluxo de trabalho TDD completo usando o Claude Code com agentes especializados. Ele garante que todo código seja escrito seguindo o ciclo Vermelho-Verde-Refatoração, com revisões de código obrigatórias e verificação de CI antes do merge.
Funcionalidades
- Agentes baseados em funções: Define papéis de 'Desenvolvedor' e 'Revisor' para dividir responsabilidades.
- Fluxo TDD automático: Executa o ciclo escrever teste (Vermelho), implementar código (Verde), refatorar.
- Revisões obrigatórias: Todo código deve passar por uma revisão aprovada antes do merge.
- Verificação de CI: Garante que o status de CI esteja verde antes de finalizar o PR.
- PRs prontos para merge: Produz pull requests com testes, documentação de API e CI verde.
Como Funciona
- O agente 'Desenvolvedor' recebe uma tarefa e executa o ciclo TDD:
- Escreve um teste que falha (Vermelho)
- Implementa o código mínimo para passar (Verde)
- Refatora o código se necessário
- O agente 'Revisor' revisa o código:
- Verifica testes, estilo de código e documentação
- Solicita mudanças ou aprova
- Após aprovação, o sistema verifica o status de CI (usando GitHub Actions, CircleCI, etc.)
- Se a CI estiver verde, o PR é criado com todos os detalhes necessários
Uso
Configuração
Adicione o skill ao seu projeto do Claude Code:
claude code install-skill fnfremixer/claude-code-tdd
Execução
Inicie o fluxo de trabalho com:
/claude-code-tdd iniciar-tarefa "Descrição da tarefa"
Ou use:
/claude-code-tdd ciclo-tdd "Implementar funcionalidade X"
Variáveis de Ambiente
| Variável | Descrição | Obrigatória |
|---|---|---|
GITHUB_TOKEN | Token de acesso pessoal do GitHub para criar PRs e verificar CI | Sim |
CI_PROVIDER | Provedor de CI (github, circleci, etc.) | Não (padrão: github) |
APPROVAL_THRESHOLD | Número de aprovações necessárias para o merge | Não (padrão: 1) |
Exemplo
# Definir variáveis de ambiente
export GITHUB_TOKEN=seu_token_aqui
export CI_PROVIDER=github
# Executar o skill
claude code
"/claude-code-tdd ciclo-tdd 'Adicionar autenticação de usuário'"
Licença
MIT