ralph-tui-create-json

Convert PRD markdown into a flat prd.json for ralph-tui.

20|3|Updated Aug 16, 2016
One-click install
npx skills add https://github.com/heyJordanParker/dotfiles --skill ralph-tui-create-json-heyjordanparker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-tui-create-json
Source: https://github.com/heyJordanParker/dotfiles/tree/main/claude/.claude/skills/ralph-tui-create-json
Command: npx skills add https://github.com/heyJordanParker/dotfiles --skill ralph-tui-create-json-heyjordanparker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PRD-to-task creation is error-prone and time-consuming. This skill converts PRDs into a ready-to-run prd.json payload for ralph-tui, ensuring a consistent, machine-parseable structure for automated task generation.

Core Features & Use Cases

  • Converts a PRD into a flat JSON object containing name, branchName, description, and a userStories array.
  • Parses user stories, acceptance criteria, and dependencies, and appends quality gates to each story for deterministic execution.
  • Ideal for automating the handoff from product requirements to engineering tasks that can be executed by ralph-tui.

Quick Start

Run the skill on your PRD markdown to produce ./tasks/prd.json and integrate with ralph-tui.

Frequently Asked Questions about ralph-tui-create-json

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

FAQPage Schema
How do I convert a PRD markdown into a JSON file for automated task generation?

To convert a PRD markdown into a JSON file, this skill parses user stories, acceptance criteria, and dependencies to generate a flat prd.json payload. It outputs a ready-to-run file containing name, branchName, description, and userStories arrays.

How does parsing PRD user stories and acceptance criteria into prd.json work?

Parsing PRD user stories and acceptance criteria works by extracting requirements from markdown or text and mapping them into a flat JSON schema. The process appends quality gates to each story for deterministic execution by ralph-tui.

Can I use PRD text extracts to create a branch-specific task payload for ralph-tui?

Yes, you can use PRD text extracts to create a branch-specific task payload. The skill processes text extracts to generate a standard root-level JSON structure including branchName and userStories, ready for ralph-tui execution.

What's the best way to automate the handoff from product requirements to engineering tasks?

The best way to automate the handoff from product requirements to engineering tasks is converting PRDs into a machine-parseable prd.json structure. This ensures consistent automated task generation when you run ralph-tui with the generated file.

Does ralph-tui require a flat JSON schema for PRD task execution?

Yes, ralph-tui requires a flat JSON schema for PRD task execution. The schema enforces specific root-level fields: name, branchName, description, and userStories, ensuring the payload is immediately consumable via the ralph-tui run command.

Why append quality gates to user stories during PRD to JSON conversion?

Appending quality gates to user stories during PRD to JSON conversion ensures deterministic execution. This process adds specific validation criteria to each story within the prd.json file, enabling reliable automated task handling by ralph-tui.