class83108/insight-to-quality

O que insight-to-quality faz?

Habilidades opinativas de fluxo de trabalho TDD para Claude Code — impõe especificação → Gherkin → Red/Green/Refactor com Registro de Verificação, revisão de design e verificações pré-conclusão.

Visão Geral

Esta skill fornece uma abordagem estruturada e opinativa para Desenvolvimento Orientado a Testes (TDD) dentro do Claude Code. Ela guia o desenvolvedor pelas etapas:

1. Especificação: Defina os requisitos e critérios de aceitação.
2. Gherkin: Traduza a especificação para cenários Gherkin legíveis por humanos.
3. Red/Green/Refactor: Implemente o código seguindo o ciclo TDD clássico.
4. Registro de Verificação: Mantenha um registro contínuo de cada etapa, com resultados e decisões.
5. Revisão de Design: Revise a arquitetura e o design da solução.
6. Verificações Pré-Conclusão: Valide se todos os critérios foram atendidos antes de marcar a tarefa como concluída.

Como Usar

Para ativar a skill, use o comando apropriado no Claude Code ou inclua-a em seu arquivo de configuração. Uma vez ativa, a skill guiará você por cada etapa do fluxo de trabalho TDD.

Exemplo de Fluxo

1. Iniciar Especificação:

   claude code --skill class83108/insight-to-quality --spec "Adicionar funcionalidade de login"
   

2. Gerar Cenários Gherkin:

   claude code --skill class83108/insight-to-quality --gherkin
   

3. Executar Ciclo Red/Green/Refactor:

   claude code --skill class83108/insight-to-quality --tdd
   

4. Revisar Design:

   claude code --skill class83108/insight-to-quality --review-design
   

5. Verificar Pré-Conclusão:

   claude code --skill class83108/insight-to-quality --pre-complete
   

Registro de Verificação

O Registro de Verificação é um arquivo Markdown (por exemplo, VERIFICATION_LEDGER.md) que registra cada etapa do fluxo. Ele inclui:

• Especificação: Os requisitos originais.
• Cenários Gherkin: Os cenários de teste gerados.
• Resultados dos Testes: Status de cada ciclo Red/Green/Refactor.
• Decisões de Design: Notas sobre revisões de design.
• Checklist Pré-Conclusão: Lista de verificação final.

Exemplo de Registro de Verificação

# Registro de Verificação

## Especificação
- **Funcionalidade**: Login de usuário
- **Critérios de Aceitação**:
  - Usuário deve fornecer email e senha válidos.
  - Sistema deve validar credenciais contra o banco de dados.
  - Em caso de sucesso, redirecionar para a página inicial.
  - Em caso de falha, exibir mensagem de erro.

## Cenários Gherkin
- `login_success.feature`
- `login_failure.feature`

## Resultados dos Testes
- **Ciclo 1 (Red)**: Teste de login bem-sucedido falhou (esperado).
- **Ciclo 2 (Green)**: Código implementado, teste passou.
- **Ciclo 3 (Refactor)**: Código refatorado, todos os testes continuam passando.

## Decisões de Design
- Utilizar autenticação baseada em JWT.
- Armazenar senhas com hash bcrypt.

## Checklist Pré-Conclusão
- [x] Todos os testes passando
- [x] Revisão de design concluída
- [x] Código documentado
- [ ] Revisão por pares pendente

Personalização

A skill pode ser personalizada via variáveis de ambiente ou arquivo de configuração. Consulte a documentação da skill para opções avançadas.

Suporte

Para dúvidas ou problemas, consulte o repositório oficial da skill: class83108/insight-to-quality

---

Esta skill é mantida pela comunidade e não é afiliada oficialmente ao Anthropic ou Claude Code.