From god-ralph
Autonomous development orchestrator that combines ephemeral Ralph workers with Beads granular task tracking. Use when executing multiple beads autonomously, running parallel development tasks, or when you need persistent work tracking across sessions.
How this skill is triggered — by the user, by Claude, or both
Slash command
/god-ralph:skills/god-ralphThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
god-ralph is an autonomous development system that combines two powerful patterns:
god-ralph is an autonomous development system that combines two powerful patterns:
Use god-ralph when:
Each Ralph worker:
Persistent agent that:
bd readyAfter each merge:
| Command | Purpose |
|---|---|
/god-ralph start | Start autonomous execution (dry-run first) |
/god-ralph plan | Interactive wizard to create beads |
/god-ralph status | Show current progress |
/god-ralph stop | Gracefully stop execution |
/god-ralph <id> | Run Ralph on specific bead |
For god-ralph to work effectively, beads should include:
title: "Clear, actionable title"
description: "Detailed description"
type: feature|task|bug
priority: 0-4
# In comments until schema supports:
ralph_spec:
completion_promise: "BEAD COMPLETE"
max_iterations: 50
acceptance_criteria:
- type: test
command: "npm test"
- type: lint
command: "npm run lint"
# 1. Plan your work
/god-ralph plan
# Wizard asks questions, creates beads
# 2. Review what's ready
bd ready
# 3. Start autonomous execution
/god-ralph start
# Shows dry-run plan, asks for confirmation
# 4. Monitor progress
/god-ralph status
# 5. Stop when needed
/god-ralph stop
god-ralph automatically parallelizes independent beads:
Group 1 (parallel):
- beads-abc: "Add API endpoint" → worktree/1
- beads-def: "Add frontend page" → worktree/2
Group 2 (after Group 1):
- beads-ghi: "Integration tests" → worktree/3
Beads with file overlap run sequentially.
Each Ralph works in a separate git worktree:
Main repo: /project/ → main
Worktree 1: .worktrees/ralph-1/ → ralph/beads-abc
Worktree 2: .worktrees/ralph-2/ → ralph/beads-def
This allows:
Typical costs:
/god-ralph status shows running cost estimate.
When things go wrong:
Ralph fails (max iterations)
Merge conflict
Verification fails
god-ralph extends the beads ecosystem:
# Create beads normally
bd create --title="..." --type=feature
# Add ralph_spec via comments
bd comments <id> --add "ralph_spec: ..."
# god-ralph uses bd CLI under the hood
bd ready # Find work
bd update # Claim work
bd close # Complete work
bd dep # Manage dependencies
/god-ralph status periodicallynpx claudepluginhub DuncanJurman/entropy-plugins --plugin god-ralphGuides customization of Choo Choo Ralph workflows, formulas, learning harvest, troubleshooting loops, and multi-Ralph setups. Use for Ralph-specific questions.
Guides using Beads (bd) distributed git-backed issue tracker for task management, dependency tracking, AI agent workflows, and multi-branch parallel development.
Guides using Beads (bd), a distributed git-backed graph issue tracker for managing tasks, tracking dependencies, AI agent workflows, and multi-branch git development.