PRD Check

Run PRD validation on demand to check story quality, test coverage, and structure before starting the autonomous loop.

Instructions

When the user runs /prd-check, validate their PRD file.

Step 1: Check PRD Exists

ls -la .ralph/prd.json 2>/dev/null || echo "NOT_FOUND"

If no PRD exists, tell the user:

No PRD found at .ralph/prd.json. Generate one first with /idea or /prd.

STOP if no PRD found.

Step 2: Run Validation (dry-run)

Run validation without auto-fix so you can present results and let the user decide:

npx ralph prd-check --dry-run 2>&1

Step 3: Present Results

Show the validation output to the user. If there are issues, summarize them clearly.

If issues were found, ask:

"Would you like me to fix these issues in the PRD?"

STOP and wait for user response.

If the user says yes, read .ralph/prd.json, fix the issues following PRD best practices (executable testSteps with curl/pytest/playwright, apiContract for backends, testUrl for frontends, security criteria for auth stories, pagination for list endpoints), and write the fixed file back.

Notes

• This is the same validation that runs automatically at ralph run startup
• --dry-run skips auto-fix so you have control over what changes
• Custom checks in .ralph/checks/prd/ are also evaluated
• Run this before ralph run to catch and fix issues interactively