ralph

Convert markdown or text PRDs into Ralph's prd.json schema.

1|Updated Jul 11, 2019
One-click install
npx skills add https://github.com/crsiebler/dotfiles --skill ralph-crsiebler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/crsiebler/dotfiles/tree/main/ai/opencode/skills/ralph
Command: npx skills add https://github.com/crsiebler/dotfiles --skill ralph-crsiebler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph's PRD converter turns unstructured Product Requirement Documents into Ralph-friendly prd.json, enabling automated execution by Ralph's autonomous agent.

Core Features & Use Cases

  • Converts markdown or text PRDs into Ralph's prd.json schema.
  • Generates a structured set of user stories and a clean branchName for versioning.
  • Validates output against the required JSON schema to ensure reliable automation.

Quick Start

Provide a PRD in markdown or text and run the PRD converter to generate prd.json in your Ralph directory.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a markdown PRD into JSON for autonomous AI agent execution?

You can convert a markdown PRD into JSON for autonomous execution by providing the text or markdown document to the converter. It outputs a structured prd.json file that enforces the required schema for reliable AI agent automation.

What is the required JSON schema for a PRD to run autonomously?

The required JSON schema for autonomous PRD execution includes structured user stories, a clean branchName for versioning, and validated field presence. This structure ensures the autonomous agent can reliably parse and execute the requirements.

Can I use a plain text PRD to generate structured user stories for automation?

Yes, you can use a plain text PRD to generate structured user stories for automation. The converter accepts both markdown and text formats, extracting requirements and translating them into the validated JSON schema needed for autonomous runs.

How do I validate a PRD JSON structure before running an autonomous agent?

To validate a PRD JSON structure before running an autonomous agent, the converter automatically checks the output against the required schema. It validates field presence and structure during generation to prevent execution failures.

Does the PRD to JSON converter generate a branch name for version control?

Yes, the PRD to JSON converter generates a clean branchName for version control. This is included directly in the validated prd.json file alongside the structured user stories to support isolated autonomous execution.