Ralph Loop skill

Um projeto dividido em tarefas anda uma de cada vez, com revisão e correção no meio, sem estourar o contexto do agente, porque o andamento fica num arquivo.

por giuseppe-trisciuoglio

instalações: 1.700
estrelas no GitHub: 363
No skills.sh desde: abril de 2026
Licença: MIT

Atualizada no GitHub em 10 de setembro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

giuseppe-trisciuoglio
ralph-loop
Um projeto dividido em tarefas anda uma de cada vez, com revisão e correção no meio, sem estourar o contexto do agente, porque o andamento fica num arquivo.Auditada1.700 instalações, grátis

O que ela faz

Aplica a técnica Ralph Wiggum, de Geoffrey Huntley, ao desenvolvimento guiado por especificação. Um script Python, o ralph_loop.py, lê as tarefas TASK-*.md da pasta da spec, respeita as dependências entre elas e guarda o andamento num arquivo fix_plan.json.

Cada rodada faz uma etapa só e para: escolher a tarefa, implementar, revisar, corrigir (até 3 tentativas), limpar, sincronizar e marcar como feita, com commit no git. Fazer tudo de uma vez estoura a janela de contexto; assim, a rodada seguinte retoma do arquivo.

O script não executa os comandos: ele mostra qual comando do pacote developer-kit-specs rodar a seguir. Dá pra limitar a faixa de tarefas, escolher o agente de cada uma (Claude, Codex, Copilot, Gemini, Kimi e outros) e repetir a cada 5 minutos com o /loop do Claude Code.

Nas palavras de quem fez

Ralph Wiggum-inspired automation loop for specification-driven development. Orchestrates task implementation, review, cleanup, and synchronization using a…

giuseppe-trisciuoglio, no SKILL.md

Quando usar

Tocar uma lista longa de tarefas de programação sem perder o fio entre sessões
Implementar só um trecho das tarefas, por exemplo da TASK-036 à TASK-041
Dividir as tarefas entre Claude e Codex no mesmo projeto
Garantir uma revisão antes de marcar cada tarefa como pronta

Depois de instalar, é só pedir assim

Inicia o ralph loop na spec docs/specs/001-checkout, da TASK-001 à TASK-005
Roda o próximo passo do ralph loop e me mostra o comando
Qual o status do ralph loop? Quantas tarefas faltam?

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

Gen Agent Trust HubPassou
SocketPassou
SnykPassou

Perguntas

Como instalar a Ralph Loop no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Ralph Loop, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

Ainda dá pra usar?

O próprio autor marcou como descontinuada em favor do ralph-loop-v2 e depois tirou do repositório o pacote developer-kit-specs, de que ela faz parte. A instalação pode não achar mais a skill.

O que precisa pra funcionar?

Python 3, git sem alteração pendente antes de começar, as tarefas no formato TASK-XXX.md com cabeçalho YAML e os comandos do pacote developer-kit-specs. Também precisa de testes no projeto: sem eles, a revisão perde a força. Não pede chave nem serviço pago.

Roda no Codex e no Antigravity?

O script gera comandos pra Codex, Copilot, Gemini, Kimi, GLM e MiniMax, além do Claude. O Antigravity não está na lista, e a repetição automática a cada 5 minutos usa o /loop, que é do Claude Code.

Levar essa skill

1x ralph-loopR$ 0,00

TotalR$ 0,00

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/giuseppe-trisciuoglio/developer-kit

Aprenda a usar

O que é o Claude Code (Claude CLI) e como começar
O que é o Claude Code (Claude CLI), pra que serve pra quem não programa, o que ele pede pra rodar e como se compara ao Codex, ao Antigravity e ao Cursor.