generating-prd-json-from-prd-md

Convert PRD.md into structured prd.json for Ralph workflows.

2|1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/qte77/claude-code-utils-plugin --skill generating-prd-json-from-prd-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generating-prd-json-from-prd-md
Source: https://github.com/qte77/claude-code-utils-plugin/tree/main/plugins/ralph/skills/generating-prd-json-from-prd-md
Command: npx skills add https://github.com/qte77/claude-code-utils-plugin --skill generating-prd-json-from-prd-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a PRD.md requirements document into a structured prd.json used to drive Ralph loops and autonomous tasks across projects.

Core Features & Use Cases

  • Automated PRD-to-JSON conversion to enable deterministic PRD-based work items for Ralph.
  • Dependency extraction, content hashing, and state preservation to ensure traceability and reproducibility.
  • Use Case: When starting a Ralph loop or adding a new PRD.md, run the conversion to generate a consistent prd.json that maps features to stories.

Quick Start

Run the PRD-to-JSON conversion on your PRD.md file to produce ralph/docs/prd.json.

Frequently Asked Questions about generating-prd-json-from-prd-md

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

FAQPage Schema
How do I convert a PRD Markdown file to JSON for automation workflows?

Converting PRD Markdown to JSON requires Python tooling to parse PRD.md, extract dependencies, compute content_hash, and emit a structured prd.json. This process enables deterministic PRD-based work items for Ralph automation workflows.

What is a prd.json file and when do I need it for Ralph loops?

A prd.json file is a structured output generated from PRD.md that maps features to stories. You need it when initializing Ralph loops or adding new PRD Markdown to ensure traceability and reproducibility across autonomous tasks.

Does converting Markdown to JSON require Python tooling?

Yes, converting PRD Markdown to JSON requires Python tooling to parse the PRD.md file, extract dependencies, and compute content_hash. This ensures the emitted prd.json preserves state and guarantees reproducibility.

What is the best way to extract dependencies from a PRD Markdown document?

The best way to extract dependencies from a PRD Markdown document is to use a parser that computes content_hash and maps features to stories. This approach ensures traceability and state preservation when generating prd.json for Ralph.

How do I initialize a Ralph loop using a PRD.md file?

To initialize a Ralph loop, run the PRD-to-JSON conversion on your PRD.md file. This generates a consistent ralph/docs/prd.json file that drives autonomous tasks and ensures deterministic PRD-based work items across projects.