Ralph Builder

Ralph Builder

A toolkit for creating solid PRDs and running autonomous Claude Code loops.

Based on [Geoff Huntley's Ralph](https://ghuntley.com/ralph/) - fresh context each iteration, no bloat, tasks until done.

What It Does

1. Setup Phase: Claude interviews you about your project, then generates a PRD with atomic tasks
2. Execution Phase: Bash loop runs Claude iteratively with fresh context until complete

The Planning Interview

When you start setup, Claude walks you through:

• Project definition - What are you building? Who is it for?
• Tech stack - Language, framework, testing (Claude recommends defaults if unsure)
• External services - APIs, databases, credentials needed
• Feature breakdown - Breaking features into atomic, verifiable tasks

The output is a structured `plan.md` with tasks that Ralph can execute one at a time.

Quick Start

# 1. Clone ralph-builder (keep this copy for updates)
git clone https://github.com/digitalsamba/ralph-builder.git

# 2. Create your project and copy ralph-builder into it
mkdir my-project && cd my-project
git init
cp -r ../ralph-builder . && rm -rf ralph-builder/.git

# 3. Start Claude Code
claude

# 4. Ask Claude to set up your project
> Help me set up this project using Ralph Builder

# 5. Claude will guide you through PRD creation and generate files

# 6. Run the loop
./ralph-builder/ralph.sh

Prerequisites

Required

• Claude Code CLI installed and authenticated

Strongly Recommended

• Context7 MCP for up-to-date library documentation

Without Context7, Ralph relies on training knowledge which may use outdated patterns.

Generated Files

After setup, your project will have:

my-project/                       ← your project root
├── .claude/settings.json         ← tool permissions (generated)
├── .env                          ← your credentials (you create)
├── CLAUDE