# Ralph Scripts

Auto-generated by `/create-ralph` on 2026-03-15.

## Usage

```bash
# Run with default max iterations (25)
./scripts/ralph/run.sh

# Run with custom max iterations
./scripts/ralph/run.sh 10
```

## Task Management

This Ralph setup uses **beads** for task management.
Run `bd prime` for current workflow guidance.

### View Tasks
```bash
bd status        # Overview
bd ready         # Ready to work
bd list          # All tasks
bd show <id>     # Task details
```

### Manual Task Control
```bash
bd close <id>                  # Mark complete
bd create --title="title" --type=task --priority=2  # Add new task
bd dolt push                   # Push beads state
```

## Files

- `run.sh` - Main loop script
- `prompt.md` - Instructions for AI agent
- `progress.txt` - Knowledge accumulation log

## Signals

- `<promise>COMPLETE</promise>` - All beads tasks closed (bd ready shows 0)
- `<promise>BLOCKED</promise>` - Stuck, needs manual intervention

## Source Files Used

- `AGENTS.md` — agent conventions and beads workflow

## Current Tasks (at generation time)

- Total: 8  |  Ready: 2  |  Blocked: 6
