Diretório selecionado de Agent Skills: arquivos de instruções SKILL.md que ensinam novas tarefas a assistentes de programação com IA, como Claude, Codex e Copilot.
ClaytonFarr/ralph-playbook
Um guia para executar ciclos autônomos de programação com IA usando a metodologia Ralph de Geoff Huntley, com planejamento, implementação, especificações e modelos de prompt.
- Estrelas
- 1,037
- Forks
- 266
- Issues abertas
- 3
- Último commit
- há 8 meses
O que é?
O Ralph Playbook é um guia prático sobre Ralph, um método para executar agentes de programação com IA em um ciclo autônomo. Cada iteração começa com um contexto novo, lê um arquivo de prompt e um plano de implementação compartilhado no disco, conclui uma tarefa, faz o commit e encerra. Assim, o agente continua avançando sem orquestração manual.
O guia divide o fluxo de trabalho em três fases: definir requisitos em arquivos de especificação por tópico, executar um ciclo de planejamento que identifica lacunas entre as especificações e o código e executar um ciclo de implementação que realiza tarefas com base em testes e outros mecanismos de feedback. Ele inclui os modelos PROMPT_plan e PROMPT_build prontos para adaptação, uma convenção de AGENTS.md para comandos de build e teste, um script loop.sh de exemplo e orientações para isolar em sandbox um agente executado com as permissões ignoradas.
O repositório também apresenta extensões propostas, como derivar requisitos de teste a partir de critérios de aceitação, usar LLM-as-judge para avaliar aspectos subjetivos de qualidade e fazer engenharia reversa de bases de código existentes para gerar especificações. O conteúdo está publicado como um guia web formatado e também em Markdown.
Recursos principais
- 01Define um fluxo de trabalho em três fases, dos requisitos ao planejamento e à implementação
- 02Fornece modelos de prompt PLANNING e BUILDING para agentes de programação no estilo Claude
- 03Inclui um script loop.sh de exemplo com seleção de modo e limite máximo de iterações
- 04Descreve as convenções de AGENTS.md e do plano de implementação para compartilhar o estado entre iterações
- 05Apresenta orientações para executar em sandbox agentes com as permissões ignoradas
Casos de uso
- Configurar um ciclo autônomo de programação que implementa um projeto a partir de especificações escritas
- Estruturar prompts e arquivos de planejamento para um agente de IA que trabalha em muitas tarefas pequenas
- Revisar práticas de execução segura antes de rodar agentes de programação com permissões amplas
Início rápido
- 1
Leia o guia Ralph Playbook no README
- 2
Configure o script básico de loop usado em execuções autônomas
while :; do cat PROMPT.md | claude ; done
Antes de usar
- O repositório é um guia de metodologia, não um pacote de software instalável.
- O loop de exemplo executa o Claude com --dangerously-skip-permissions, então é necessário usar um sandbox isolado por segurança.
- Os resultados dependem do ajuste cuidadoso do prompt, das especificações e do backpressure, e podem ser não determinísticos.
Tópicos
Perguntas frequentes
- O que é ralph-playbook?
- Um guia para executar ciclos autônomos de programação com IA usando a metodologia Ralph de Geoff Huntley, com planejamento, implementação, especificações e modelos de prompt. O Ralph Playbook é um guia prático sobre Ralph, um método para executar agentes de programação com IA em um ciclo autônomo. Cada iteração começa com um contexto novo, lê um arquivo de prompt e um plano de implementação compartilhado no disco, conclui uma tarefa, faz o commit e encerra. Assim, o agente continua avançando sem orquestração manual.
- ralph-playbook é gratuito? Qual é a licença?
- ralph-playbook é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- ralph-playbook ainda é mantido?
- Sem commits há mais de 6 meses. O último commit de ralph-playbook foi em 6 de mar. de 2026.
- Para que posso usar ralph-playbook?
- Configurar um ciclo autônomo de programação que implementa um projeto a partir de especificações escritas Estruturar prompts e arquivos de planejamento para um agente de IA que trabalha em muitas tarefas pequenas Revisar práticas de execução segura antes de rodar agentes de programação com permissões amplas
- Como instalar ralph-playbook?
- Leia o guia Ralph Playbook no README Configure o script básico de loop usado em execuções autônomas: while :; do cat PROMPT.md | claude ; done
- Onde consigo ralph-playbook?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ClaytonFarr/ralph-playbook
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Diretório selecionado com mais de 1.000 Claude Skills e plugins para Claude Code, Claude.ai e agentes de programação como Codex, Cursor e Gemini CLI.
Coleção de skills para agentes de programação, como Claude Code e Codex, com sessões de perguntas, TDD, diagnóstico de bugs, planejamento e revisão de código.
Repositório público de Agent Skills: pastas com instruções e recursos que o Claude carrega para realizar tarefas especializadas.
Uma skill baseada em prompt que faz agentes de programação com IA escreverem apenas o código necessário para cada tarefa, priorizando reutilização e soluções mínimas em vez de implementações extensas.
Um agente de programação em TypeScript cuja CLI planeja, delega tarefas a vários modelos e verifica o trabalho quando você inclui `ulw` ou `mass ulw` no prompt.