ralph-loop

Q: How do I install ralph-loop?

Run npx skills add https://github.com/andrelandgraf/fullstackrecipes --skill ralph-loop in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ralph-loop/ (personal) or .claude/skills/ralph-loop/ (project).

by andrelandgrafAI & Agents

Complete setup for automated agent-driven development. Define features as user stories with testable acceptance criteria, then run AI agents in a loop until all stories pass.

Installs: 3.5K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/andrelandgraf/fullstackrecipes --skill ralph-loop

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads ralph-loop automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Ralph Loop

Complete setup for automated agent-driven development. Define features as user stories with testable acceptance criteria, then run AI agents in a loop until all stories pass.

Prerequisites

Complete these recipes first (in order):

Code Health, Linting & Formatting

Configure Prettier for formatting, TypeScript for typechecking, and Fallow for code health (dead code, duplication, complexity, architecture drift). Skips ESLint/Biome to avoid config complexity.

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/code-health-setup

AI Coding Agent Configuration

Configure AI coding agents like Cursor, GitHub Copilot, or Claude Code with project-specific patterns, coding guidelines, and MCP servers for consistent AI-assisted development.

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/agent-setup

Cookbook - Complete These Recipes in Order

User Stories Setup

Create a structured format for documenting feature requirements as user stories. JSON files with testable acceptance criteria that AI agents can verify and track.

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/user-stories-setup

Working with User Stories

Document and track feature implementation with user stories. Workflow for authoring stories, building features, and marking acceptance criteria as passing.

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/using-user-stories

Ralph Agent Loop

Set up automated agent-driven development with Ralph. Run AI agents in a loop to implement features from user stories, verify acceptance criteria, and log progress for the next agent.

curl -H "Accept: text/markdown" https://fullstackrecipes.com/api/recipes/ralph-setup

FAQ

What does the ralph-loop skill do?

Complete setup for automated agent-driven development. Define features as user stories with testable acceptance criteria, then run AI agents in a loop until all stories pass.

How do I install ralph-loop?

Run npx skills add https://github.com/andrelandgraf/fullstackrecipes --skill ralph-loop in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ralph-loop/ (personal) or .claude/skills/ralph-loop/ (project).

Which AI agents can use ralph-loop?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ralph-loop safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ralph-loop?

It is published by andrelandgraf in andrelandgraf/fullstackrecipes. It has 3,475 recorded installs.