Repolode
ClaytonFarr

ClaytonFarr/ralph-playbook

Guía para ejecutar ciclos autónomos de programación con IA usando la metodología Ralph de Geoff Huntley, con planificación, desarrollo, especificaciones y plantillas de prompts.

Estrellas
1,037
Forks
266
Issues abiertos
3
Último commit
hace 8 meses

¿Qué es?

Ralph Playbook es una guía práctica sobre Ralph, un método para ejecutar agentes de programación con IA en un ciclo autónomo. Cada iteración empieza con un contexto nuevo, lee un archivo de prompt y un plan de implementación compartido en disco, completa una tarea, hace un commit y termina. Así, el agente sigue avanzando sin necesidad de orquestarlo manualmente.

La guía divide el flujo de trabajo en tres fases: definir los requisitos en archivos de especificaciones por tema, ejecutar un ciclo de planificación que analiza las diferencias entre las especificaciones y el código, y ejecutar un ciclo de desarrollo que implementa tareas con pruebas y otros mecanismos de retroalimentación. Incluye plantillas PROMPT_plan y PROMPT_build listas para adaptar, una convención AGENTS.md para los comandos de compilación y pruebas, un script de ejemplo loop.sh y pautas para aislar en un sandbox a un agente que se ejecuta con los permisos omitidos.

El repositorio también describe posibles extensiones, como derivar requisitos de pruebas a partir de criterios de aceptación, usar LLM-as-judge para evaluar aspectos subjetivos de la calidad e invertir el proceso para generar especificaciones a partir de bases de código existentes. Está publicado como guía web con formato y también en Markdown.

Funciones clave

  • 01Define un flujo de trabajo de tres fases: requisitos, planificación y desarrollo
  • 02Proporciona plantillas de prompts PLANNING y BUILDING para agentes de programación al estilo de Claude
  • 03Incluye un loop.sh de ejemplo que permite elegir el modo y establecer un máximo de iteraciones
  • 04Describe las convenciones de AGENTS.md y del plan de implementación para compartir el estado entre iteraciones
  • 05Incluye pautas para aislar en un sandbox a agentes que se ejecutan con los permisos omitidos

Casos de uso

  • Configurar un ciclo autónomo de programación que implemente un proyecto a partir de especificaciones escritas
  • Estructurar prompts y archivos de planificación para que un agente de IA trabaje en muchas tareas pequeñas
  • Revisar prácticas de ejecución segura antes de usar agentes de programación con permisos amplios

Inicio rápido

  1. 1

    Lee la guía Ralph Playbook del README

  2. 2

    Configura el script básico de bucle que se usa en las ejecuciones autónomas

    while :; do cat PROMPT.md | claude ; done

Antes de usarlo

  • El repositorio es una guía metodológica, no un paquete de software instalable.
  • El bucle de ejemplo ejecuta Claude con --dangerously-skip-permissions, por lo que necesita un entorno aislado (sandbox) para garantizar la seguridad.
  • Los resultados dependen de ajustar cuidadosamente el prompt, las especificaciones y el backpressure, y pueden ser no deterministas.

Temas

Preguntas frecuentes

¿Qué es ralph-playbook?
Guía para ejecutar ciclos autónomos de programación con IA usando la metodología Ralph de Geoff Huntley, con planificación, desarrollo, especificaciones y plantillas de prompts. Ralph Playbook es una guía práctica sobre Ralph, un método para ejecutar agentes de programación con IA en un ciclo autónomo. Cada iteración empieza con un contexto nuevo, lee un archivo de prompt y un plan de implementación compartido en disco, completa una tarea, hace un commit y termina. Así, el agente sigue avanzando sin necesidad de orquestarlo manualmente.
¿ralph-playbook es gratuito? ¿Qué licencia tiene?
ralph-playbook es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ralph-playbook sigue mantenido?
Sin commits en más de 6 meses. El último commit de ralph-playbook fue el 6 mar 2026.
¿Para qué puedo usar ralph-playbook?
Configurar un ciclo autónomo de programación que implemente un proyecto a partir de especificaciones escritas Estructurar prompts y archivos de planificación para que un agente de IA trabaje en muchas tareas pequeñas Revisar prácticas de ejecución segura antes de usar agentes de programación con permisos amplios
¿Cómo se instala ralph-playbook?
Lee la guía Ralph Playbook del README Configura el script básico de bucle que se usa en las ejecuciones autónomas: while :; do cat PROMPT.md | claude ; done
¿Dónde consigo ralph-playbook?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ClaytonFarr/ralph-playbook

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados