# Ralph

> Acciones para gestionar bucles Ralph: preparar un `plan/plan.md` con las instrucciones canónicas del bucle (`/ralph set-up`), o expandirlo a ficheros de tarea listos para el bucle (`/ralph fase0`).

- Skill: `santanderai/ralph` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add santanderai/ralph`
- Raw SKILL.md: https://api.skillmd.com/api/skills/santanderai/ralph/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: santanderai (https://skillmd.com/u/santanderai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/santanderai/ralph

---


# Ralph

Herramientas para gestionar los bucles Ralph (`ralph-loop.sh`) sobre un repositorio: preparar el fichero `plan/plan.md` con las instrucciones canónicas del bucle, expandirlo a ficheros `plan/task/NN.md` accionables, y otras acciones futuras sobre el ciclo.

Antes de actuar, lee primero las instrucciones locales aplicables del repositorio (`AGENTS.md` y, si existe, `CLAUDE.md`) y respétalas.

**Ubicación del plan**: por defecto el plan vive en `plan/plan.md` y sus tareas en `plan/task/NN.md` desde la raíz del repositorio. Si el usuario nombra explícitamente otra ruta (otro directorio, otro nombre de fichero), usa la que indique en lugar de la por defecto. Todas las referencias a estas rutas en las acciones de esta skill son relativas a esa convención.

## Acciones

| Invocación | Acción | Cargar |
|---|---|---|
| `/ralph set-up` (o usuario pide «preparar el plan para el bucle ralph», «inserta las instrucciones de ralph», etc.) | **Set-up**: inserta al inicio de `plan/plan.md` el bloque canónico de instrucciones del bucle Ralph | `set-up.md` |
| `/ralph fase0` (o usuario pide «hacer la fase 0», «expandir el plan en tareas», «preparar las tareas del plan», etc.) | **Fase 0**: descompone `plan/plan.md` en ficheros `plan/task/NN.md` accionables, valida contexto, inserta marcas de esfuerzo y planifica los `[juez]`. Orquesta subagentes en paralelo. | `fase0.md` |

En uso normal, carga solo el fichero correspondiente (`set-up.md` o `fase0.md`) y sigue sus instrucciones. Para revisar o actualizar la propia skill, puedes leer varios.

## Detección proactiva: plan sin subtareas

Cuando inspecciones un repositorio con `plan/plan.md` (por la razón que sea: el usuario acaba de invocar `set-up`, te pide revisar el estado del bucle, o simplemente abres el fichero) y detectes que el plan **no contiene ninguna línea `- [ ]` ni `- [x]`** (es decir, tiene objetivo/contexto pero no lista de tareas accionable), **sugiere al usuario invocar `/ralph fase0`** para descomponerlo en `plan/task/NN.md`. Sin subtareas, el bucle ralph no tiene nada que ejecutar y creará `stop.md` en la primera iteración. No lances `fase0` tú sin que el usuario lo pida; solo sugiérelo.