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.

9 stars

Best use case

ralph-loop is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using ralph-loop should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/ralph-loop/SKILL.md --create-dirs "https://raw.githubusercontent.com/andrelandgraf/fullstackrecipes/main/skills/ralph-loop/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/ralph-loop/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How ralph-loop Compares

Feature / Agentralph-loopStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this 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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# 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):

### 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.

```bash
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.

```bash
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.

```bash
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.

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

Related Skills

ralph-setup

9
from andrelandgraf/fullstackrecipes

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.

url-state-management

9
from andrelandgraf/fullstackrecipes

Sync React state to URL query parameters for shareable filters, search, and deep-linkable dialogs with nuqs.

testing

9
from andrelandgraf/fullstackrecipes

Complete testing setup with Neon database branching, Playwright browser tests, integration tests, and unit tests. Isolated branches with automatic TTL cleanup.

stripe-subscriptions

9
from andrelandgraf/fullstackrecipes

Complete subscription billing system with Stripe integration, feature flags for plan gating, webhook handling, and billing portal.

observability-monitoring

9
from andrelandgraf/fullstackrecipes

Complete observability stack with structured logging, error tracking, and web analytics.

env-management

9
from andrelandgraf/fullstackrecipes

Complete better-env workflow: typed config schema, Vercel sync, and prebuild validation.

base-app-setup

9
from andrelandgraf/fullstackrecipes

Complete setup guide for a Next.js app with Shadcn UI, Neon Postgres, Drizzle ORM, and AI SDK.

authentication

9
from andrelandgraf/fullstackrecipes

Complete authentication system with Better Auth, email verification, password reset, protected routes, and account management.

ai-chat

9
from andrelandgraf/fullstackrecipes

Build a complete AI chat application with database persistence, chat list management, and automatic title generation.

ai-agent-workflow

9
from andrelandgraf/fullstackrecipes

Build resumable multi-agent workflows with durable execution, tool loops, and automatic stream recovery on client reconnection.

workflow-setup

9
from andrelandgraf/fullstackrecipes

Install and configure the Workflow Development Kit for resumable, durable AI agent workflows with step-level persistence, stream resumption, and agent orchestration.

web-design-guidelines

9
from andrelandgraf/fullstackrecipes

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".