Ralph loop

Skill joaquimscosta/arkhe-claude-plugins/plugins/ralph/skills/ralph-loop

Execute an autonomous development loop that picks one task per iteration, implements it, verifies it, and commits the result — each iteration in a fresh context window. Use when user runs /ralph, mentions "ralph loop", "autonomous loop", "builder verifier", "run tasks automatically", "iterate on tasks", "develop autonomously", or wants an automated build-verify-commit cycle with task tracking.From its SKILL.md

Install

npx -y skills add joaquimscosta/arkhe-claude-plugins --skill ralph-loop

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.3 KB, 683 tokens by cl100k_base, as published. Nobody here has run it

Ralph Loop Execution Protocol

Autonomous development with fresh context per iteration and Hat-lite builder/verifier workflow.

Quick Start

# From project directory (after /create-prd)
./ralph.sh 20          # Run up to 20 iterations
./ralph.sh 5           # Quick test with 5 iterations

How It Works

Each iteration runs in a fresh context window:

┌─────────────────────────────────────────────────────┐
│ ITERATION (Fresh Context)                           │
├─────────────────────────────────────────────────────┤
│ 1. ORIENT: Read activity.log + tasks.json + memories│
│ 2. BUILD:  Pick ONE task, implement, verify        │
│ 3. VERIFY: Review, update status, commit           │
│ 4. LEARN:  (Optional) Save insights to memories    │
│ 5. DECIDE: All done? → RALPH_COMPLETE              │
└─────────────────────────────────────────────────────┘

Hat-Lite System

Role	When	Responsibility
Builder	~65% of iteration	Implement ONE task
Verifier	~35% of iteration	Review, update, commit

Key Files

File	Purpose
`.ralph/current-taskset/tasks.json`	Task state (source of truth)
`.ralph/current-taskset/activity.log`	Iteration history
`.ralph/current-taskset/memories.md`	Persistent learnings
`.ralph/current-taskset`	Symlink to active task set
`PROMPT.md`	Instructions per iteration
`ralph.sh`	Loop runner script

Task JSON Format

Tasks are stored in .ralph/current-taskset/tasks.json:

{
  "tasks": [
    {
      "id": "setup-001",
      "description": "Initialize project",
      "verificationTier": "build",
      "passes": false,
      "iteration_completed": null
    }
  ]
}

Valid verificationTier values: "build" (default), "visual", "api", "e2e". See WORKFLOW.md for details.

Completion Signal

When all tasks pass, output:

RALPH_COMPLETE: All tasks verified

Commands

Subcommands: /ralph run [N], /ralph status, /ralph init, /ralph taskset <new|list|switch|delete>, /ralph add-task, /ralph remember, /ralph memories.

Workflow Details

See WORKFLOW.md for the 5-phase iteration lifecycle (Orient, Build, Verify, Learn, Decide) and Hat-Lite role definitions.

Examples

See EXAMPLES.md for web app, API, resumption, and mid-loop status checking scenarios.

Troubleshooting

See TROUBLESHOOTING.md for immediate exit, premature completion, infinite loop, and context issues.

What ships with it: 4 files

31.3 KB alongside SKILL.md, 1 of them executable

scripts/

ralph.shruns4.6 KB