ralph-loop

Scaffold .claude/ralph assets and guide user-run iterative coding loops.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/zuzu59/z-skills --skill ralph-loop-zuzu59
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/zuzu59/z-skills/tree/main/skills/ralph-loop
Command: npx skills add https://github.com/zuzu59/z-skills --skill ralph-loop-zuzu59

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, claude, bun, and includes scripts (resource) components.

What problem does it solve?

Setup and orchestration of the Ralph autonomous coding loop in a project, enabling iterative AI-driven feature work while ensuring commands are executed by the user rather than automatically.

Core Features & Use Cases

  • Scaffolds the .claude/ralph structure (ralph.sh, prompt.md) and task templates (PRD.md, prd.json, progress.txt) for a new feature.
  • Provides a repeatable workflow to brainstorm PRDs, transform them into user stories, and guide iterative coding loops without auto-execution.
  • Use cases include starting Ralph in a new project, resuming interrupted loops, and guiding safe, user-run automation for feature development.

Quick Start

Execute the setup script to generate Ralph's scaffold in your project, then run the generated ralph.sh workflow with the provided command.

Frequently Asked Questions about ralph-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an autonomous AI coding loop for iterative feature development?

To set up an autonomous AI coding loop, execute the local script-based setup to generate the .claude/ralph scaffold and task templates. You then guide iterative feature development by running the generated ralph.sh workflow yourself, ensuring safe user-run automation.

Do I need jq and bun to run the Ralph autonomous coding loop?

Yes, you need jq, bun, and claude installed, as they are required dependencies for the Ralph autonomous coding loop. These tools provide the foundational environment necessary to execute the scaffolding scripts and orchestrate the iterative coding workflow.

What is the best way to scaffold PRDs and user stories for AI-driven coding?

The best way to scaffold PRDs and user stories is to use a setup script that generates the .claude/ralph structure. This creates PRD.md, prd.json, and progress.txt templates, providing a repeatable workflow to brainstorm PRDs and transform them into user stories.

Can I resume an interrupted AI coding loop in my repository?

Yes, you can resume an interrupted AI coding loop in your repository. The scaffolded .claude/ralph structure and task templates support resuming loops, allowing you to pick up iterative feature development exactly where you left off across various repo layouts.

Why does the Ralph AI coding loop require manual command execution instead of automatic runs?

The Ralph AI coding loop requires manual command execution to ensure safe, user-run automation for feature development. This design prevents uncontrolled automatic execution, giving developers direct oversight and control over the iterative AI-driven coding process.