ralph-init

Generate a canonical PRD and Ralph progress ledger from a project description.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/pextacy/stellar --skill ralph-init-pextacy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/pextacy/stellar/tree/main/skills/ralph-init
Command: npx skills add https://github.com/pextacy/stellar --skill ralph-init-pextacy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize a PRD (Product Requirements Document) for structured Ralph-loop execution, creating a canonical plan and a progress ledger to support repeatable, goal-driven product iterations.

Core Features & Use Cases

  • Generate a canonical PRD at .omx/plans/prd-{slug}.md with sections for problem statement, goals and non-goals, acceptance criteria, technical constraints, and implementation phases.
  • Link the PRD to Ralph so that /ralph can use it as its completion criteria.
  • Initialize/ensure a canonical progress ledger at .omx/state/{scope}/ralph-progress.json (session scope if an active session exists).
  • Provide compatibility notes for migrating from legacy inputs (.omx/prd.json, .omx/progress.txt).

Quick Start

Provide a project or feature description to generate the canonical PRD and initialize Ralph progress tracking.

Frequently Asked Questions about ralph-init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Product Requirements Document for iterative product planning?

To create a Product Requirements Document for iterative product planning, provide a project description to generate a canonical PRD with problem statements, goals, acceptance criteria, and implementation phases at .omx/plans/prd-{slug}.md.

What is a Ralph-loop in product management workflows?

A Ralph-loop in product management is a structured, goal-driven iteration cycle that uses a canonical PRD as completion criteria and tracks execution via a progress ledger at .omx/state/{scope}/ralph-progress.json.

How do I track PRD progress during structured product iterations?

You track PRD progress during structured product iterations by initializing a canonical progress ledger at .omx/state/{scope}/ralph-progress.json, which records session scope and links directly to your PRD completion criteria.

Can I migrate legacy PRD files to the new .omx plan format?

Yes, you can migrate legacy PRD files to the new .omx plan format. The initialization process provides compatibility notes for migrating from legacy inputs like .omx/prd.json and .omx/progress.txt.

Does PRD initialization work without an active session scope?

Yes, PRD initialization works without an active session scope. It generates the canonical PRD file and initializes the ralph-progress.json ledger using the session scope if an active session exists.

What sections are included in a generated PRD for goal-driven iterations?

A generated PRD for goal-driven iterations includes sections for the problem statement, goals and non-goals, acceptance criteria, technical constraints, and implementation phases to guide structured execution.