SPixs/claude-skill-ratchet

Skill para Claude Code: fluxo de desenvolvimento disciplinado por fases para projetos Java/Maven multi-módulo (SPEC + ADR + tags de fase)

O que é claude-skill-ratchet?

Este skill para Claude Code implementa um fluxo de desenvolvimento estruturado e disciplinado, especificamente projetado para projetos Java/Maven com múltiplos módulos. Ele combina a criação de Especificações (SPEC) com Registros de Decisão de Arquitetura (ADR) e o uso de tags de fase para guiar o processo de desenvolvimento passo a passo. A principal utilidade é impor uma sequência lógica e documentada de fases — desde a especificação até a implementação e revisão — reduzindo o risco de mudanças não planejadas ou desalinhamento entre equipes. O skill suporta plataformas como Claude Code e outros agentes que interpretam SKILL.md. Ele funciona analisando o estado atual do projeto, propondo a próxima fase com base nas tags existentes (como `phase:spec`, `phase:design`, `phase:impl`), e executando tarefas como gerar arquivos SPEC e ADR antes de iniciar a codificação, garantindo que cada etapa seja concluída e aprovada antes de avançar.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add SPixs/claude-skill-ratchet

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que claude-skill-ratchet faz?

Skill para Claude Code: fluxo de desenvolvimento disciplinado por fases para projetos Java/Maven multi-módulo (SPEC + ADR + tags de fase)

Fonte: https://github.com/SPixs/claude-skill-ratchet

Descoberto pelo caçador de skills incríveis do Awesome Skills.

Visão Geral

Este skill impõe um fluxo de trabalho rigoroso e incremental para o desenvolvimento de software em projetos Java/Maven complexos. Ele garante que cada funcionalidade ou modificação siga uma sequência predefinida de fases, cada uma documentada com artefatos específicos.

Fases do Fluxo de Trabalho

  1. Especificação (SPEC): Criação de um documento de especificação detalhando requisitos e comportamento esperado. A fase é marcada com a tag phase:spec.
  2. Decisão de Arquitetura (ADR): Documentação da decisão arquitetural relevante usando um Arquivo de Registro de Decisão (ADR). Marca com phase:adr.
  3. Implementação: Codificação propriamente dita, seguindo a especificação e as decisões arquiteturais. Marca com phase:impl.
  4. Revisão: Verificação cruzada entre código, SPEC e ADR para assegurar consistência. Marca com phase:review.

Como Usar

  1. Certifique-se de que o Claude Code esteja configurado com este skill.
  2. Inicie uma nova tarefa com claude-code.
  3. O agente detectará as tags de fase atuais e sugerirá o próximo passo automaticamente.
  4. Siga as instruções para criar ou atualizar os artefatos (SPEC, ADR) antes de prosseguir para a próxima fase.

Comandos e Tags

  • phase:spec: Indica que a fase de especificação está ativa.
  • phase:adr: Indica que a fase de registro de decisão arquitetural está ativa.
  • phase:impl: Indica que a fase de implementação está ativa.
  • phase:review: Indica que a fase de revisão está ativa.

Exemplo de Uso

# Iniciar nova funcionalidade
$ claude-code "Implementar módulo de autenticação"

# O agente responderá com a fase SPEC e solicitará a criação do documento.

Requisitos

  • Projeto Java/Maven com estrutura multi-módulo.
  • Claude Code ou ambiente compatível com skills.

Licença

Este skill é distribuído sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

Habilidades Relacionadas