ralph

Convert Markdown PRDs into structured prd.json files for agent systems.

Updated Feb 15, 2026
One-click install
npx skills add https://github.com/LumaKernel/formal-logic-pad --skill ralph-lumakernel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/LumaKernel/formal-logic-pad/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/LumaKernel/formal-logic-pad --skill ralph-lumakernel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the conversion of Product Requirement Documents (PRDs) into a structured prd.json format, enabling autonomous agent systems like Ralph to process and act upon them efficiently.

Core Features & Use Cases

  • PRD to JSON Conversion: Transforms human-readable PRDs into a machine-readable JSON format.
  • Structured Story Generation: Breaks down requirements into user stories with clear acceptance criteria, priorities, and branching strategies.
  • Use Case: You have a detailed PRD for a new feature. Use this Skill to convert it into a prd.json file that Ralph can use to generate code, tests, and documentation, ensuring adherence to architectural principles and test coverage.

Quick Start

Use the ralph skill to convert the attached document 'feature_spec.md' into ralph format.

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 agents?

To convert a PRD to JSON for autonomous agents, you parse Markdown requirement documents to generate structured user stories, branch names, and acceptance criteria. This enforces test-driven development and code separation principles for agent execution.

What is the best way to structure user stories from a Markdown feature spec?

The best way to structure user stories from a Markdown feature spec is to iteratively size them with clear priorities and branching strategies. This ensures autonomous agents can process the generated JSON while adhering to formatting and architectural guidelines.

Can I use this PRD to JSON conversion tool for test-driven development workflows?

Yes, you can use this PRD to JSON conversion tool for test-driven development workflows. It enforces TDD principles, pure and impure code separation, and iterative story sizing within the generated output for autonomous agent systems.

How does Markdown PRD parsing handle branch naming for agent execution?

Markdown PRD parsing handles branch naming by extracting requirements and defining specific branch names directly within the structured JSON output. This ensures autonomous agents follow correct version control and formatting guidelines during execution.

What are the limitations of automating PRD conversion into structured JSON?

A limitation of automating PRD conversion into structured JSON is that it requires detailed Markdown documents with clear requirements to function correctly. Without properly structured input PRDs, the generated user stories and acceptance criteria may lack necessary context for agent execution.