ralph-tui-create-json_skill

Overview

This skill converts product requirement documents (PRDs) into a ralph-tui compatible prd.json file. It extracts quality gates, parses user stories and acceptance criteria, sets dependencies and priorities, and outputs a flat JSON ready for autonomous execution. The JSON adheres to ralph-tui schema rules so the agent can run stories iteratively.

How this skill works

The skill scans the PRD for a Quality Gates section and pulls universal and UI-specific gates. It parses each user story into a single JSON entry (US-001, US-002, ...), appends quality gates to acceptance criteria, assigns priority based on dependency order, and emits a flat root-level object with name, branchName, description, and userStories. It validates against schema anti-patterns (no wrappers, no tasks array, uses passes boolean) and writes the file to ./tasks/prd.json by default.

When to use it

• You have a PRD in markdown or plain text and want a runnable prd.json for ralph-tui
• You need consistent acceptance criteria with project-wide quality gates appended
• You want user stories sized for single-agent iterations
• You need dependency ordering (schema → backend → UI) encoded for ralph-tui
• You want a ready-to-run file for ralph-tui run --prd ./tasks/prd.json

Best practices

• Keep each user story small enough to finish in one agent iteration (2–3 sentence scope)
• Include a clear Quality Gates section in the PRD or provide commands when asked
• Derive branchName from the feature in kebab-case and prefix with ralph/
• Use explicit, verifiable acceptance criteria — avoid vague language
• Order stories by technical dependency and set dependsOn arrays accordingly

Example use cases

• Convert a feature PRD into prd.json so ralph-tui can implement database, API, and UI stories sequentially
• Append CI/lint/typecheck gates to all stories to enforce build quality during automation
• Split a large feature into right-sized stories and generate IDs/priorities automatically
• Produce a prd.json for a UI-heavy feature that also includes browser verification gates
• Create a tasks/prd.json file next to PRD markdown for immediate ralph-tui execution