Repolode
ClaytonFarr

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. 1

    Leia o guia Ralph Playbook no README

  2. 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