ralph-tui-create-json

To convert a PRD into prd.json for Ralph-tui, you parse the markdown to extract user stories, acceptance criteria, and dependencies, then flatten them into a root-level JSON object with branchName, description, and a populated userStories array.

The correct prd.json schema for Ralph-tui is a flat root-level structure containing top-level fields: name, branchName, description, and a flattened userStories array, where each story includes acceptance criteria, quality gates, and dependsOn relationships.

Yes, you can automatically generate quality gates and dependencies from text by parsing a PRD to extract these elements and preserving their relationships via the dependsOn field within the flattened userStories array.

Your manually created prd.json may fail because it lacks the required flat root-level structure or is missing mandatory fields like branchName, description, or the fully populated userStories array with quality gates needed for execution.

No, Ralph-tui does not support nested user story hierarchies in the prd.json input. The required schema uses a flattened userStories array at the root level, preserving relationships through the dependsOn field rather than nesting.