setup-ralph

Set up Ralph autonomous coding loop scaffolding with PRD-driven user stories.

3|3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/twikus/claude-configuration --skill setup-ralph-twikus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-ralph
Source: https://github.com/twikus/claude-configuration/tree/main/claude-code-config/skills/ralph-loop
Command: npx skills add https://github.com/twikus/claude-configuration --skill setup-ralph-twikus

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill provides a ready-to-use scaffold for the Ralph autonomous AI coding loop, enabling teams to initialize the loop structure in any project without manual setup steps.

Core Features & Use Cases

  • Creates the .claude/ralph directory structure in your project and prepares the run-time assets.
  • Generates and tracks PRD-driven user stories as prd.json, plus a progress log for iterative learning.
  • Supports interactive PRD brainstorming via the step-01 process and a PRD-to-stories workflow.
  • Provides clear run instructions and guards to ensure the user runs Ralph themselves (no automatic execution).

Quick Start

Run /setup-ralph -i to brainstorm PRD interactively, or /setup-ralph -f <feature-name> to set up a feature scaffold. After setup, run bun run .claude/ralph/ralph.sh -f <feature-name> to start Ralph. You can customize PRD.md and prd.json under .claude/ralph/tasks/<feature-name> before running Ralph.

Frequently Asked Questions about setup-ralph

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

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

Setting up an autonomous coding loop involves creating a .claude/ralph directory structure and generating PRD-driven user stories as prd.json, providing a scaffold for iterative execution.

How do I generate user stories from a PRD for AI execution?▼

Generating user stories from a PRD uses an interactive brainstorming process via step-01, converting your product requirements into a tracked prd.json file for iterative AI execution.

Do I need jq installed to use the Ralph AI loop scaffolding?▼

Yes, you need jq installed to use the Ralph AI loop scaffolding, as it is a required dependency for processing the JSON data structures used in the PRD-driven workflow.

What is the best way to start an interactive PRD brainstorming session?▼

The best way to start interactive PRD brainstorming is running the setup command with the interactive flag, which guides you through the step-01 process to define your feature requirements.

Does the Ralph autonomous coding loop execute automatically after setup?▼

No, the Ralph autonomous coding loop does not execute automatically after setup; it provides explicit guards and run instructions to ensure the user initiates Ralph manually.