Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/snarktank/ralph/llms.txt

Use this file to discover all available pages before exploring further.

Ralph includes two powerful skills that work together to help you plan and execute features autonomously:
  • PRD Generator (/prd) - Create detailed Product Requirements Documents
  • Ralph Converter (/ralph) - Convert PRDs to the prd.json format for autonomous execution
These skills work with both Amp and Claude Code.

​
What Are Skills?

Skills are specialized prompts that guide AI coding tools to perform specific tasks consistently. They provide:
  • Structured workflows - Step-by-step instructions for complex tasks
  • Consistent output - Standardized formats and quality
  • Reusability - Use the same skill across all your projects
  • Auto-invocation - Skills trigger automatically based on your natural language requests

​
The Ralph Workflow

Ralph’s skills follow a three-step workflow:
1

Generate a PRD

Use the /prd skill to create a detailed requirements document. The skill asks clarifying questions and generates a structured markdown PRD saved to tasks/prd-[feature-name].md.
Load the prd skill and create a PRD for user authentication
2

Convert to Ralph format

Use the /ralph skill to convert the markdown PRD into prd.json. This JSON format structures user stories for autonomous execution with proper dependencies and acceptance criteria.
Load the ralph skill and convert tasks/prd-user-auth.md to prd.json
3

Run Ralph

Execute the Ralph loop to autonomously implement all user stories:
# Using Amp (default)
./scripts/ralph/ralph.sh

# Using Claude Code
./scripts/ralph/ralph.sh --tool claude

​
Why Two Skills?

The workflow is split into two skills for flexibility:
  1. PRD Generator is human-readable and great for planning, discussion, and documentation
  2. Ralph Converter creates machine-readable JSON optimized for autonomous execution with strict size constraints and dependency ordering
You can edit the markdown PRD with stakeholders, then convert it when you’re ready for implementation.

​
Key Features

​
PRD Generator

  • Interactive planning - Asks 3-5 clarifying questions with multiple-choice answers
  • Structured output - Consistent sections: goals, user stories, acceptance criteria
  • Small stories - Breaks features into implementable chunks
  • Documentation-ready - Output is suitable for sharing with team members

​
Ralph Converter

  • Dependency ordering - Ensures stories execute in the correct sequence (schema → backend → UI)
  • Size validation - Splits large stories that won’t fit in one context window
  • Verifiable criteria - Converts vague requirements into testable acceptance criteria
  • Auto-archiving - Preserves previous runs when starting new features

​
Automatic Invocation

Both skills are automatically invoked when you use certain trigger phrases:
PRD skill triggers: “create a prd”, “write prd for”, “plan this feature”, “requirements for”, “spec out”Ralph skill triggers: “convert this prd”, “turn this into ralph format”, “create prd.json from this”, “ralph json”
You can also explicitly load skills: 
Load the prd skill and [your request]
Load the ralph skill and [your request]

​
What’s Next?

Learn how to install and use each skill:

Build docs developers (and LLMs) love

Get started for freeTalk to us