ralph

The Ralph PRD converter is an essential skill for developers and product managers utilizing the Ralph autonomous agent framework. This tool bridges the gap between high-level project requirements and actionable, machine-readable instructions. By parsing Markdown-formatted PRDs, it generates a JSON task list that satisfies the rigid input requirements of Ralph's loop, ensuring each user story is properly scoped for a single AI context window.

Designed specifically for autonomous coding workflows, the skill enforces best practices such as dependency ordering, atomic story sizing, and verifiable acceptance criteria. It automatically assigns unique identifiers, determines appropriate feature branch naming conventions, and ensures that critical validation steps like type-checking and browser-based verification are included in the task list. This transformation allows agents like Amp or Claude Code to execute development tasks systematically without losing track of project objectives or hitting context limitations.

• Converts raw text or Markdown PRDs into a normalized prd.json schema.
• Automatically creates sequential user story IDs (e.g., US-001) for clear progress tracking.
• Enforces strict story sizing to prevent context window overflows during agent execution.
• Categorizes stories by dependency order to ensure backend infrastructure precedes frontend implementation.
• Mandates verifiable acceptance criteria, including automated checks like type-checking and manual browser verification steps.
• Streamlines the handoff between project planning and autonomous development environments.
• Use this skill whenever you have a finalized feature design and need to prepare it for implementation via an autonomous agent.
• Ensure your input PRD clearly separates features; if a feature is too large, use this skill to help break it down into modular, testable components.
• Always include a type-check criterion in your output to maintain codebase health throughout the automated iteration process.
• The tool is fully compatible with Claude Code marketplaces and can be installed as a plugin for cross-project utility.