ralph-plan

This skill is an interactive planning assistant that helps users author well-structured "ralph-loop" commands through collaborative conversation. It solves the problem of turning a vague goal into a focused, actionable, and verifiable plan by guiding the user step by step rather than producing a full command in one shot.

The skill defines a fixed ralph command structure with background, setup, tasks, and testing sections plus a completion promise, and it drives a five-step planning process: understand the goal, define the background and persona, plan setup steps, break the goal into concrete numbered tasks ordered by dependency, and define testing and success criteria. It emphasizes being inquisitive (probing for edge cases and assumptions), identifying gaps, and proactively researching the codebase to fill knowledge gaps so tasks can reference specific file paths, function names, and existing patterns. It includes an example conversation flow and an output format note advising against double quotes and backticks in the final command to avoid copy/paste issues. The skill is pinned to a specific Claude model in its front matter.

The target users are developers working within the Mastra project (or similar setups) who use the ralph-loop workflow to drive autonomous or semi-autonomous coding tasks and want help scoping and structuring those runs. Use cases include planning a new feature, breaking a large task into a focused command, and ensuring a plan includes the research and testing steps needed to be executed reliably. It is a planning and prompt-authoring helper with no execution side effects of its own.