digitalsamba

Ralph Builder — AI skill for Claude Code

AI community

Structured wrapper for autonomous AI coding with Claude Code.

How to install Ralph Builder

This entry records only its repository, not the path inside it, so there is no exact command to give. Open digitalsamba/ralph-builder and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ralph Builder does

Structured wrapper for autonomous AI coding with Claude Code. PRD-driven task planning, atomic verification, and bash loop execution.

Alternatives in AI

Ralph For Claude Code — by Frank Bria - An autonomous AI development framework that enables Claude Code to work iteratively on project 8k ★
Osaurus — Own your AI. The native macOS harness for AI agents -- any model, persistent memory, autonomous execution, cry 5.1k ★
PRD: Agent Builder — Create Your Own Sub-Agent — Your ecosystem, your rules 1.9k ★

README

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

Setup Phase: Claude interviews you about your project, then generates a PRD with atomic tasks
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