claude-loops-pack

Licença: MIT · Requer: Node.js 20+ · Sem chave de API necessária

Pare de usar o Claude Code como chatbot. Faça ele planejar, executar, testar, corrigir e repetir até entregar.

claude-loops-pack é um pacote gratuito que adiciona cinco loops de trabalho ao Claude Code: sistemas de execução completos — não prompts soltos — para criar MVPs, corrigir bugs, melhorar landing pages, produzir conteúdo e estruturar SaaS.

Demonstração rápida

$ npx claude-loops-pack

CLAUDE LOOPS PACK  (v0.1.0)

  [1] Instalar todos os loops
  [2] Escolher loops
  [3] Atualizar
  [4] Verificar instalação
  [5] Desinstalar
  [6] Mostrar caminhos instalados
  [7] Sair

Escolha uma opção (1-7): 1

Claude Loops Pack instalado com sucesso.

Comandos disponíveis:

  /loop-mvp
  /loop-bug
  /loop-landing
  /loop-conteudo
  /loop-saas

Depois, dentro do Claude Code, dentro do seu projeto:

/loop-mvp

E descreva sua ideia.

Instalação em um comando

npx claude-loops-pack

Não é necessário clonar repositório, editar arquivos manualmente, nem entender programação. O instalador detecta automaticamente Windows, macOS e Linux, localiza a pasta de configuração do Claude Code, faz backup de qualquer arquivo que já exista e pergunta antes de sobrescrever qualquer comando. Veja docs/installation.md para todos os detalhes (incluindo os caminhos exatos usados em cada sistema).

Os cinco loops

| Comando | Objetivo | | --- | --- | | /loop-mvp | Transforma uma ideia em um MVP funcional, do escopo mínimo até um fluxo principal testado. | | /loop-bug | Corrige bugs com diagnóstico de causa raiz e prova — reproduz, testa, corrige, verifica regressão. | | /loop-landing | Cria ou melhora uma landing page orientada à conversão: clareza da oferta, CTA, prova, mobile, SEO básico. | | /loop-conteudo | Transforma uma ideia em conteúdo (Reels, carrossel, e-mail, LinkedIn, roteiro, stories) com múltiplos ângulos avaliados. | | /loop-saas | Classifica uma ideia de SaaS (explorar → validar → prototipar → construir → lançar → otimizar) e executa a etapa certa como Produto, Desenvolvimento, Marketing e Validação. |

Cada loop segue a mesma arquitetura: entender o objetivo, ler o contexto, identificar o que falta, planejar, definir critérios de conclusão verificáveis, executar em etapas pequenas, testar, corrigir (até 5 ciclos), e entregar um relatório final com evidências — nunca apenas a afirmação de que "está pronto".

Exemplos de uso

/loop-mvp
Quero um MVP de lista de tarefas para times pequenos, com responsável e
status por tarefa. Sem login por enquanto.

/loop-bug
Usuários com e-mail em maiúsculas não conseguem logar depois do cadastro.
Aqui está o log do erro: [...]

/loop-landing
Minha landing de mentoria converte pouco. Aqui está a página atual.

/loop-conteudo
Quero um Reels sobre automação de IA para pequenos negócios.

/loop-saas
Quero um SaaS de agendamento para clínicas pequenas, mas ainda não validei
se elas pagariam por isso.

Mais exemplos em docs/examples.md.

Como funciona

• Os cinco loops são instalados como skills de usuário do Claude Code (~/.claude/skills/<nome>/SKILL.md), o formato atualmente recomendado pela documentação oficial para comandos disponíveis em qualquer projeto. Ficam disponíveis como /loop-mvp, /loop-bug etc. e só são executados quando você digita o comando — nunca são acionados automaticamente.
• Toda a lógica de instalação está isolada em um único módulo (src/paths.js). Se a Anthropic mudar a estrutura oficial no futuro, apenas esse módulo precisa mudar.
• O pacote não tem nenhuma dependência externa: só usa módulos nativos do Node.js (fs, path, os, crypto, readline, child_process).
• Não é feita nenhuma chamada de rede depois que o npx baixa o pacote, e nenhuma chave de API é necessária — o instalador só copia arquivos de texto para a sua própria máquina.

Segurança

• Backup automático. Qualquer arquivo que já exista é copiado para ~/.claude/claude-loops-pack-backups/ antes de ser sobrescrito ou removido.
• Confirmação antes de sobrescrever. Por padrão, o instalador pergunta antes de alterar qualquer comando existente. --yes pula a pergunta, mas não pula o backup.
• Idempotente. Rodar a instalação várias vezes não duplica nem corrompe nada — se o conteúdo já está atualizado, o instalador não faz nada.
• Nada fora do escopo. O pacote só cria/altera arquivos dentro de ~/.claude/skills/<loop>/, ~/.claude/claude-loops-pack/ e ~/.claude/claude-loops-pack-backups/. Nenhum outro arquivo do seu sistema é tocado.
• Os próprios loops seguem regras de segurança fixas: nunca apagam arquivos sem autorização, nunca publicam/fazem deploy/enviam mensagens sem confirmação explícita, nunca alteram banco de produção, e nunca executam comandos destrutivos silenciosamente.

Atualização

npx claude-loops-pack update

Loops que você nunca editou manualmente são atualizados automaticamente (com backup da versão anterior guardado). Loops que você customizou pedem confirmação antes de qualquer alteração.

Desinstalação

npx claude-loops-pack uninstall

Remove os cinco loops, com backup automático antes de remover qualquer coisa. Para remover só um: npx claude-loops-pack uninstall loop-saas.

Solução de problemas

Comece com:

npx claude-loops-pack doctor

Ele verifica a versão do Node, localiza o Claude Code, confere permissões, valida os comandos instalados, identifica arquivos quebrados e oferece corrigir automaticamente. Mais casos comuns em docs/troubleshooting.md.

Contribuição

Este é um projeto open source e simples de propósito. Contribuições são bem-vindas:

1. Abra uma issue descrevendo o problema ou a ideia antes de um PR grande.
2. Rode npm test, npm run lint e npm run validate antes de enviar qualquer alteração — os três precisam passar.
3. Novos loops ou seções devem manter a mesma estrutura mínima obrigatória (Objetivo, Quando usar, Quando não usar, Entradas necessárias, Processo, Critérios de conclusão, Limite máximo de tentativas, Regras de segurança, Formato da entrega, Exemplo de uso) — é isso que npm run validate verifica.

Licença

MIT.