Pair
Launch ralph-pair (coder + deterministic verifier)
Claude CodeGeneric
---
description: Launch ralph-pair (coder + deterministic verifier)
argument-hint: '[max_iterations]'
---
# /pair — Ralph with Deterministic Verification
Runs `ralph-pair.sh`, which is ralph.sh with an added verification step after each coder iteration.
## What it does
1. **Coder phase** — same as ralph: pipe PRD + CLAUDE.md to the agent
2. **Verifier phase** — runs `verifyCommand` for every unpassed story
3. Auto-marks stories as `passes: true` when their verifyCommand succeeds
4. When verify story VN passes, also marks paired implement story SN
5. Repeats until ALL stories verified or max iterations reached
## Routing
When `/pair` is invoked, execute:
```bash
bash ralph/ralph-pair.sh run
Usage
# Default: 10 iterations with claude
bash ralph/ralph-pair.sh run
# Custom: 3 iterations
bash ralph/ralph-pair.sh run 3
# With a different tool
bash ralph/ralph-pair.sh run --tool codex
# Check status
bash ralph/ralph-pair.sh status
bash ralph/ralph-pair.sh status --watch
How it differs from ralph.sh
| ralph.sh | ralph-pair.sh | |
|---|---|---|
| Completion check | Trusts <promise>COMPLETE</promise> |
Runs verifyCommand per story |
| Verification | None | Deterministic (pytest, etc.) |
| Auto-marking | Coder must update prd_state.json | Verifier auto-marks on pass |
| ``` |
Maintain Pair?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[Pair on getagentictools](https://getagentictools.com/loops/jleechanorg-pair-ralph-with-deterministic-verification?ref=badge) Related loops
Fix Run typechecking, linting, and formatting checks, then spawn parallel agents to fix all issues
Conductor Archive Archive completed tracks
Slack Scan Deep scan Slack channels and DMs for evidence involving a specific person or project. Extracts every touchpoint with timestamps f…
Archive Archive a completed OpenSpec change after all beads issues are closed.
Loop Start an autonomous Ralph loop for the given change-id and task.
Delegate Issues Delegate multiple GitHub issues in parallel, each to its own autonomous worker via /delegate-issue