god-ralph

# god-ralph Skill

god-ralph is an autonomous development system that combines two powerful patterns:

1. **Ralph Wiggum**: Ephemeral, iterative agents that work until completion
2. **Beads**: Granular, dependency-tracked work items

## When to Use god-ralph

Use god-ralph when:
- You have multiple beads ready to work on
- You want autonomous execution without babysitting
- You need parallel development on independent tasks
- You want verification after each completion
- You need persistent progress tracking

## Core Concepts

### Ephemeral Ralphs
Each Ralph worker:
- Completes exactly ONE bead
- Iterates until acceptance criteria met (or max iterations)
- Dies after completion
- Works in isolated git worktree

### Orchestrator
Persistent agent that:
- Finds ready beads via `bd ready`
- Analyzes parallelism opportunities
- Spawns and monitors Ralphs
- Merges completed work
- Runs verification
- Creates fix-beads on failure

### Verification Ralph
After each merge:
- Runs all acceptance criteria
- Checks for integration issues
- Creates high-priority fix-beads on failure

## Commands

| 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 |

## Bead Specification

For god-ralph to work effectively, beads should include:

```yaml
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"
```

## Workflow Example

```bash
# 1. Plan your work
/god-ralph plan
# Wizard asks questions, creates beads

# 2. Review what's ready
bd ready

# 3. Start auton