ralphmania

AI agent orchestration for iterative spec-driven development

$deno run -A jsr:@cdaringe/ralphmania -i 10

Why ralphmania?

A task runner that thinks for itself โ€” and checks its own work.

๐Ÿ”„

Iterative

Runs AI agents in a loop over your specification, making progress on each scenario until completion.

โœ“

Validated

Each scenario is verified before being marked done. Failed validation triggers targeted rework.

๐Ÿ“ˆ

Escalating

Configurable escalation strategies let you widen search or retry with different agents on failure.

๐Ÿงฉ

Extensible

Plugin hooks let you intercept every stage โ€” before, during, and after each scenario run.

How it works

Five steps from spec to shipped.

1

Write a specification

Author a markdown table of scenarios in specification.md.

2

Run ralphmania

Execute deno run -A jsr:@cdaringe/ralphmania -i 10 to start the loop.

3

Agent works each scenario

An AI agent is dispatched per scenario, running in an isolated git worktree.

4

Validation & rework

Completed scenarios are validated. Failures are flagged NEEDS_REWORK and retried.

5

Progress tracked in progress.md

A living progress.md file records every scenario's status throughout the run.

Ready to automate your workflow?

Get started in under a minute.