ralph

Ralph is an autonomous AI agent loop that runs repeatedly until all PRD items are complete.

23 articles 16.3k View on GitHub ↗
23 articles
What Causes Poor Code Generation in Ralph Iterations and How to Prevent It

Fix poor Ralph code generation. Learn how context overflow, stale knowledge, and state issues cause problems and keep your iterations clean by mastering atomic stories and quality checks.

how-to-guide
Apr 13, 2026
How to Set Up the Claude Code Marketplace Plugin for Ralph Skills: A Complete Guide

Easily set up the Claude Code marketplace plugin for Ralph skills with two CLI commands. Install PRD generation and conversion skills instantly from snarktank/ralph without external configuration.

how-to-guide
Apr 13, 2026
What Is the .last-branch File? Ralph Branch Tracking Explained

Discover the .last-branch file and how Ralph branch tracking works. Ralph automatically archives previous work when you switch Git branches for seamless feature development.

internals
Apr 13, 2026
How to Configure Ralph to Use Claude Code Instead of Amp

Easily configure Ralph to use Claude Code instead of Amp. Simply use the --tool claude flag or edit the script's default setting for a seamless switch.

how-to-guide
Apr 13, 2026
How Ralph Ensures CI Remains Green Across Iterations

Learn how Ralph keeps CI green with a feedback-loop-first architecture. Pass local quality checks automatically before committing code to prevent broken builds.

how-to-guide
Apr 13, 2026
Ralph Quality Gates: The Three Mandatory Checks Before Committing Changes

Discover the three essential Ralph quality gates typechecking linting and testing ensuring successful commits and preventing failed code changes.

best-practices
Apr 13, 2026
How to Use the PRD Skill to Generate Detailed Requirements Documents in Ralph

Learn how to use the PRD skill in Ralph to generate detailed requirements documents quickly. Invoke the skill, answer questions, and retrieve your PRD from tasks/prd-[feature-name].md.

how-to-guide
Apr 13, 2026
Understanding the progress.txt Format and How to Structure Learnings in Ralph

Learn the progress.txt format and structure your learnings effectively for the snarktank/ralph AI agent. Discover how this markdown log persists patterns and insights between iterations.

how-to-guide
Apr 13, 2026
How Ralph Tracks and Switches Between Feature Branches During Execution

Learn how Ralph tracks and switches feature branches during execution by comparing prd.json with .last-branch, archiving old states, and updating the tracker automatically.

internals
Apr 13, 2026
What Happens When Max Iterations Is Reached Before All Stories Pass in Ralph?

Ralph terminates with exit code 1 when max iterations is reached before all stories pass. Learn how it preserves state and what to do next.

internals
Apr 13, 2026
How to Install Ralph Skills Globally for Multiple Projects

Install Ralph skills globally and make prd and ralph slash commands available across all your projects. Save time and streamline your workflow by following this simple installation guide.

how-to-guide
Apr 13, 2026
What Is `amp.experimental.autoHandoff` in the Ralph Workflow and When Should You Enable It?

Learn what amp.experimental.autoHandoff does in Ralph workflows. This flag prevents context limit exceeded errors during long-running iterations by automatically spawning new instances.

deep-dive
Apr 13, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →