Converts a PRD or plan markdown file into prd.json format for ralph-json-start-loop to execute autonomously. Use when user wants to convert a PRD or plan to JSON stories.
View on GitHubrichtabor/agent-skills
rt
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/richtabor/agent-skills/blob/main/skills/ralph-json-create-issues/SKILL.md -a claude-code --skill ralph-json-create-issuesInstallation paths:
.claude/skills/ralph-json-create-issues/# Create PRD JSON Convert a Product Requirements Document or plan file into JSON for Ralph. ## Input Check these locations in order: 1. **`.claude/plans/`** — Where plan mode saves approved plans. Primary source. 2. **`plans/`** — Project-level plans directory. 3. **`prds/`** — Standalone PRDs not generated from plan mode. If files exist in multiple locations, list all and ask which to convert. If only one file is found, use it directly. **If no files are found in any location, ask the user for the path to their PRD/plan file.** ## Conversion Rules ### Story Sizing (Critical) Each story MUST complete in ONE Ralph iteration (one context window). **Right-sized:** - Add a database column - Create a single UI component - Add one API endpoint - Add form validation - Update a server action **Too large (must split):** ``` ❌ "Build entire auth system" ✅ "Add login form" ✅ "Add email validation" ✅ "Add auth server action" ``` ### Dependency Ordering Stories execute sequentially by priority: 1. Database/schema changes 2. Backend logic 3. API endpoints 4. UI components ### Cross-PRD Dependencies (Critical) Ralph respects `dependsOn` to sequence PRDs. Before generating JSON: 1. **Scan existing PRDs** — Read all `prds/*.json` to know what features exist 2. **Detect dependencies** — Look for references in the markdown PRD: - Explicit: "See `elevenlabs-integration.md`", "Depends on morning brief" - Implicit: Story notes mentioning other features - Technical: Uses tables/APIs defined in another PRD 3. **Populate `dependsOn`** — Array of PRD names (without `.json` extension) **Examples of dependency detection:** ```markdown # In evening-ritual.md: "See `elevenlabs-integration.md` for shared infrastructure" → dependsOn: ["elevenlabs-integration"] "Depends on morning brief feature for regeneration" → dependsOn: ["elevenlabs-integration", "morning-brief"] ``` **If no dependencies detected:** ```json "dependsOn": [] ``` ### Acceptance Criteria (Critical) Mus