ralph

Convert Markdown or text PRDs into Ralph's prd.json format.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/sethdavis512/maggies-mental-load --skill ralph-sethdavis512
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/sethdavis512/maggies-mental-load/tree/main/.agents/skills/ralph
Command: npx skills add https://github.com/sethdavis512/maggies-mental-load --skill ralph-sethdavis512

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PRDs are often informal and hard to feed into Ralph's autonomous agent workflows. This skill translates a PRD into Ralph's expected prd.json format so agents can autonomously execute the planned work.

Core Features & Use Cases

  • Converts Markdown or plain-text PRDs into the Ralph prd.json structure in the Ralph directory.
  • Produces a structured JSON with fields like project, branchName, description, and userStories suitable for automated iteration.
  • Supports a straightforward PRD-to-JSON transformation for feature-level planning and tool-assisted development.

Quick Start

Convert a PRD into prd.json in the Ralph directory by using the Ralph PRD Converter on your Markdown or text PRD.

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 to JSON for autonomous agent execution?

Converting a PRD to JSON for autonomous agent execution requires transforming Markdown or plain-text input into a deterministic prd.json structure with fields like project, branchName, description, and userStories for automated iteration.

What is the prd.json format needed for AI-agent workflow automation?

The prd.json format for AI-agent workflow automation is a deterministic JSON structure containing project, branchName, description, and userStories keys that enables autonomous agents to execute planned development work.

Can I use plain text PRDs to generate structured JSON for automated workflows?

Yes, you can use plain text PRDs to generate structured JSON for automated workflows. The conversion process accepts both Markdown and plain-text inputs and applies a one-PRD-to-one-JSON transformation.

How do I structure user stories in JSON for feature-level planning?

To structure user stories in JSON for feature-level planning, the PRD output places them inside a userStories key within a deterministic prd.json file, enabling tool-assisted development and automated iteration.

Does the PRD to JSON conversion support one-to-one mapping for multiple features?

The PRD to JSON conversion enforces a strict one-PRD-to-one-JSON mapping workflow, meaning each Markdown or text PRD generates a single prd.json file in the Ralph directory for autonomous execution.

What are the limitations of converting PRDs into a deterministic JSON structure?

A key limitation of converting PRDs into a deterministic JSON structure is the strict one-to-one conversion workflow, which limits processing to a single PRD at a time without batch transformation capabilities.