ralph-loop
/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.
- Author
- joaquimscosta ↗
- Repository
- arkhe-claude-plugins ↗
- Licence
- MIT
- Last repository change
- 14.08.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 1
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 14.08.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 1 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/ralph.sh
What it does and when to use it
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.
Triggers from the description
Original author description
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.
How it works
- Quick Start
- How It Works
- Hat-Lite System
- Key Files
- Task JSON Format
- Completion Signal
- Commands
- Workflow Details
- Examples
- Troubleshooting
SKILL.md preview
---
name: ralph-loop
description: 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.
---
# Ralph Loop Execution Protocol
Autonomous development with fresh context per iteration and Hat-lite builder/verifier workflow.
## Quick Start
```bash
# 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`:
```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](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](WORKFLOW.md) for the 5-phase iteration lifecycle (Orient, Build, Verify, Learn, Decide) and Hat-Lite role definitions.
## Examples
See [EXAMPLES.md](EXAMPLES.md) for web app, API, resumption, and mid-loop status checking scenarios.
## Troubleshooting
See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for immediate exit, premature completion, infinite loop, and context issues.
Files in this package (5)
- EXAMPLES.md 5 KB
- SKILL.md 3 KB
- TROUBLESHOOTING.md 5 KB
- WORKFLOW.md 17 KB
- scripts/ralph.sh 5 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · joaquimscosta/arkhe-claude-plugins | 95 | MIT |
| mnzralee/claude-multi-agent-architecture | 95 | MIT |
| mikeyobrien/ralph-orchestrator | 90 | MIT |
Database snapshot: 13.11.2026 · package version 8397d578057a (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100ralph
This skill should be used when the user wants to set up an autonomous coding loop, plan a Ralph loop, prepare for headless Claude execution, create a spec and implementation plan for autonomous coding, or run an autonomous development workflow. Trigger phrases include "ralph",… - 92b00t-ooda
Run an autonomous OODA (Observe-Orient-Decide-Act) loop via ralph to execute task queues with a chosen AI executor. Use when asked to run autonomously, start an agent loop, execute pending tasks without supervision, or run OODA cycles. Activates on "run ooda", "autonomous loop",… - 100ralph-expert
Build and launch well-structured Ralph Loop commands from a user's task description. Use when the user says "ralph this", "loop this until done", "set up a ralph", "run this iteratively", invokes `/ralph-expert`, or hands over a vague goal that needs to become an iterative loop… - 90harness-ralph-loop
Runs iterate-until-pass loops with ralph-worker agents in a worktree. Use when running [ralph]-marked tasks or looping until verify passes. - 100ralph-loop-kiro-specs
Automated iterative agent runner for spec-based development in Kiro. Wraps kiro-cli in a self-correcting bash loop that picks up tasks from a Kiro spec, implements them one at a time, verifies against exit criteria, and accumulates corrections and codebase patterns across… - 95ralph-loop-init
Transform approved plans into ralph loop infrastructure. Triggers on: '/ralph-loop-init', '/ralph-init', 'setup ralph loop', 'generate ralph loop'. Creates .ralph/ directory with prd.json, loop.py, CLAUDE.md, and supporting files.