Ralph prd

Skill joaquimscosta/arkhe-claude-plugins/plugins/ralph/skills/ralph-prd

Supercharge Claude Code with 109 specialized components — 22 agents, 32 commands, 55 skills across 13 modular plugins. Deep reasoning, autonomous dev loops, DDD architecture, design system enforcement, git automation, and more.

Install

npx -y skills add joaquimscosta/arkhe-claude-plugins --skill ralph-prd

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Create Product Requirements Document (PRD) and setup for Ralph autonomous loop. Use when user runs /create-prd command, wants to set up a project for Ralph, mentions "ralph setup", "create prd", "product requirements", or needs to generate tasks for autonomous development.

SKILL.md

4.5 KB, as published. Nobody here has run it

Ralph PRD Creation

Interactive wizard to create Product Requirements Document and Ralph project setup with task sets.

Quick Start

/create-prd                    # Start interactive wizard
/create-prd "Build a todo app" # Start with description

What It Creates

project/
├── PROMPT.md                          # Instructions for each iteration
├── ralph.sh                           # Loop runner (executable)
└── .ralph/
    ├── current-taskset -> tasksets/initial  # Symlink to active taskset
    └── tasksets/
        └── initial/                   # Your task set (named during setup)
            ├── tasks.json             # Task list (JSON)
            ├── prd.md                 # Requirements (Markdown)
            ├── memories.md            # Persistent learnings
            ├── config.json            # Ralph settings
            └── activity.log           # Iteration log (empty)

Discovery Questions

Ask these discovery questions:

Task Set Name - What should this collection be called? (default: "initial")
Problem - What problem are you solving?
Audience - Who is the target user?
Features - What are the 3-5 core features?
Tech Stack - What technologies to use?
Architecture - Monolith, microservices, etc.?
UI/UX - Visual requirements and preferences?
Auth - Authentication needs?
Integrations - Third-party services?
Success Criteria - How do we know it's done?

Question Specificity for Destructive Operations

When discovery questions involve deleting files, removing dependencies, or other destructive changes:

Always include full paths of items being deleted or modified
State size/scope — file count, line count, component count
Explicitly state what will NOT be affected
Frame as confirmation, not open question — "Deleting X, Y, Z. Proceed?" not "What should be deleted?"

See EXAMPLES.md for vague-vs-specific anti-patterns.

Task Generation

Convert features into atomic tasks with categories: setup, feature, integration, styling, testing, verification. See WORKFLOW.md for task format and categories.

Final verification task: Always include a final task with verificationTier: "visual" (UI projects) or "api" (API-only projects) that verifies the complete application works end-to-end. This catches issues that individual task verification misses.

Workflow

See WORKFLOW.md for detailed discovery flow.

Examples

See EXAMPLES.md for PRD examples.

Troubleshooting

See TROUBLESHOOTING.md for common issues.

Templates (MANDATORY)

You MUST read and use these templates when generating output files. Do NOT write simplified versions from memory — the loop depends on exact field names and signal formats.

prompt.md.template - CRITICAL: Contains the RALPH_COMPLETE: signal in Step 5. Read this template with the Read tool and fill in {{placeholders}}. Never hand-write PROMPT.md.
tasks.json.template - CRITICAL: Tasks use "passes": false / "passes": true (NOT "status": "pending" / "status": "done"). The completion signal checks passes.
prd.md.template - PRD document structure
config.json.template - Ralph configuration
memories.md.template - Learnings file

Why This Matters

The ralph.sh loop script checks for RALPH_COMPLETE: in the output to stop. The prompt.md.template Step 5 tells Ralph to emit this signal when all tasks have passes: true. If PROMPT.md is hand-written without Step 5, or tasks.json uses a different field name, the loop runs forever.

ralph.sh

Always copy ralph.sh from this plugin's scripts/ralph.sh directory. It contains required flags (--dangerously-skip-permissions, --disallowedTools) that are essential for non-interactive execution.

After Setup

./ralph.sh 20    # Start autonomous loop

Creating Additional Task Sets

After initial setup, create more task sets:

/ralph taskset new "auth-feature"    # Create new task set
/ralph taskset list                  # See all task sets
/ralph taskset switch "auth-feature" # Switch to it