Skip to content

mega-ralph-convert-prompt.md

Latest commit

 

History

History
76 lines (52 loc) · 2.29 KB

mega-ralph-convert-prompt.md

File metadata and controls

76 lines (52 loc) · 2.29 KB

You are converting a PRD (Product Requirements Document) into Ralph's prd.json format.

Input

Read the PRD file at: {{PRD_FILE}}

Project: {{PROJECT_NAME}}

Phase: {{PHASE_NUMBER}} - {{PHASE_TITLE}}

Output Format

Create a .ralph/current/prd.json file with this exact structure:

{
  "project": "{{PROJECT_NAME}}",
  "branchName": "{{BRANCH_NAME}}",
  "description": "[Description from PRD title/intro]",
  "userStories": [
    {
      "id": "P{{PHASE_NUMBER}}-US-001",
      "title": "[Story title]",
      "description": "As a [user], I want [feature] so that [benefit]",
      "acceptanceCriteria": [
        "Criterion 1",
        "Criterion 2",
        "Typecheck passes"
      ],
      "priority": 1,
      "passes": false,
      "notes": ""
    }
  ]
}

Branch Naming

The branch name is provided by run.sh: {{BRANCH_NAME}}

Use this exact value for the branchName field in prd.json. Do NOT construct the branch name yourself.

Conversion Rules

  1. Each user story in the PRD becomes one JSON entry - do not merge or split unless a story is clearly too large for one iteration.

  2. IDs: Phase-prefixed, sequential: P{{PHASE_NUMBER}}-US-001, P{{PHASE_NUMBER}}-US-002, etc.

  3. Priority: Matches the order from the PRD (first story = priority 1). Stories must be ordered by dependency: schema/data first, then backend, then UI.

  4. All stories start with: "passes": false and "notes": ""

  5. Acceptance criteria must be verifiable - convert any vague criteria to specific, checkable ones.

  6. Always include "Typecheck passes" (or equivalent quality check) in every story's acceptance criteria.

  7. For UI stories, include "Verify in browser using dev-browser skill" in acceptance criteria.

Story Size Validation

Before writing prd.json, verify each story is small enough for one Ralph iteration:

  • Can be described in 2-3 sentences
  • Touches a focused set of files
  • Has 3-6 acceptance criteria

If any story seems too large, split it into multiple smaller stories.

Your Task

  1. Read the PRD at {{PRD_FILE}}
  2. Convert it to prd.json following the rules above
  3. Write the result to .ralph/current/prd.json
  4. Validate the JSON is well-formed

Important: Only create prd.json. Do NOT implement any code. Do NOT modify the PRD. Do NOT run run.sh.