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.