ralph

Convert Markdown PRDs into Ralph prd.json with branch names and user stories.

22|7|Updated Nov 1, 2018
One-click install
npx skills add https://github.com/vechain/inspector-app --skill ralph-vechain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/vechain/inspector-app/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/vechain/inspector-app --skill ralph-vechain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts product PRDs written in Markdown into Ralph-ready prd.json format so automated agents can execute defined work.

Core Features & Use Cases

  • Parses a PRD markdown document and emits a Ralph prd.json with project, branchName, description, and userStories.
  • Generates a clean, deployable branch name (ralph/<feature-name>) and a corresponding prd.json suitable for version control.
  • Produces structured user stories from PRD sections, including acceptance criteria and typecheck guidance.

Quick Start

Drop a PRD markdown file into the Ralph PRD Converter and run the tool to produce prd.json.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a PRD markdown document into a structured JSON format?

To convert a PRD markdown document into JSON, you parse the markdown sections to generate a structured prd.json file containing project, branchName, description, and userStories fields for automated execution.

What is a prd.json file used for in automated user story execution?

A prd.json file is used to define project parameters and structured user stories so that automated agents can autonomously execute the development work defined in the original PRD.

How do I generate a branch name from a PRD for version control deployment?

You generate a branch name from a PRD by applying a naming convention like ralph/<feature-name>, producing a clean, deployable branch identifier suitable for version control integration.

Does converting product requirements into user stories require typecheck validation?

Yes, converting product requirements into user stories requires typecheck validation, as each generated user story must include acceptance criteria and specific guidance to ensure typecheck passes during execution.

Can I use an existing PRD to produce a Ralph-ready JSON file for autonomous execution?

Yes, you can use an existing PRD to produce a Ralph-ready JSON file by applying conversion rules that map the markdown content into the required prd.json structure for autonomous execution.

What is the best way to structure user stories from PRD sections for automated agents?

The best way to structure user stories from PRD sections is to parse the markdown content and produce structured user stories that explicitly include acceptance criteria and typecheck guidance for deployment.