ralph-execute
Autonomous execution loop that processes a Beads epic task-by-task with fresh subagents, two-stage review, and circuit breaker safety. Use after plan-to-epic creates the epic.
npx skills add majiayu000/claude-skill-registry --skill ralph-execute-itsmattg-property-tracker --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Ralph Execute — Autonomous Epic Runner Process a Beads epic autonomously, dispatching fresh subagents per task with two-stage review gates. ## Arguments - First argument: Beads epic ID (required) - `--dry-run`: Show what would execute without doing it (optional) ## Pre-Flight Checks Before starting the loop: 1. **Verify epic exists**: `bd show <epic-id>` 2. **Check ready tasks**: `bd ready --parent <epic-id>` — must have at least one 3. **Verify worktree**: Must be in a worktree, not main repo (enforced by block-work-on-develop hook) 4. **Initialize circuit breaker**: `.claude/hooks/circuit-breaker.sh reset` 5. **Create session marker**: `mkdir -p .ralph-session/questions .ralph-session/answers .ralph-session/messages` 6. **Notify start**: Send ntfy notification "Ralph starting epic <id>" 7. **Set phase to IMPLEMENT**: If `.claude/phases/output/current-phase.json` exists and `current_phase` is not `implement`, update it: ```bash PHASE_FILE=".claude/phases/output/current-phase.json" if [[ -f "$PHASE_FILE" ]]; then python3 -c " import json with open('$PHASE_FILE') as f: state = json.load(f) if state.get('current_phase') != 'implement': completed = state.get('completed_phases', [])
- Arguments
- Pre-Flight Checks
- Execution Loop
- Step A: Claim Task
- Step A.5: Plan Pass (First Iteration Only)
- Step B: Generate PROMPT.md
- Step C: Check Circuit Breaker
- Step D: Dispatch Subagent
- Step D.5: Handle Escalation
- Step E: Two-Stage Review
- Step F: Handle Review Results
- Step F.5: Record to eval-tracker
- Step G: Next Task
- Exit Conditions
if [[ -f "$PHASE_FILE" ]]; then
python3 -c "
import json
with open('$PHASE_FILE') as f: state = json.load(f)
if state.get('current_phase') != 'implement':
completed = state.get('completed_phases', [])
if state.get('current_phase') and state['current_phase'] not in completed:
with open('$PHASE_FILE', 'w') as f: json.dump(state, f, indent=2)
fi
mkdir -p .claude/phases/outputWhat does the ralph-execute skill do?
Autonomous execution loop that processes a Beads epic task-by-task with fresh subagents, two-stage review, and circuit breaker safety. Use after plan-to-epic creates the epic.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ralph-execute-itsmattg-property-tracker --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.