groom-project

Convert markdown PRDs into Ralph-compatible prd.json with user stories.

Updated Dec 18, 2025

Search Tags:#automation #branching #PRD #prd.json #ralph #story-splitting #grooming

Ready to run

npx skills add https://github.com/seekayel/agent-skills --skill groom-project

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: groom-project
Source: https://github.com/seekayel/agent-skills/tree/main/plugins/ralph-plugin/groom-project
Command: npx skills add https://github.com/seekayel/agent-skills --skill groom-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates converting an existing project PRD into Ralph's prd.json format, enabling structured, testable work items for autonomous agents.

Core Features & Use Cases

PRD grooming: transform markdown PRDs into Ralph-compatible JSON with standardized fields.
Storyboarding: split large PRDs into discrete Ralph user stories following the one-iteration constraint.
Branching and versioning: derive a ralph/ branch name from the project and feature name.
Validation: ensure Typecheck passes and tests where applicable; provide guidance per Ralph workflow.

Quick Start

Use the groom-project skill to convert a markdown PRD titled "Task Status Feature" into a prd.json in the Ralph workflow (branch ralph/task-status).

Frequently Asked Questions about groom-project

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

FAQPage Schema

How do I convert a markdown PRD into prd.json for Ralph autonomous execution?▼

Converting a markdown PRD into prd.json requires transforming project briefs into Ralph-compatible JSON with standardized fields, ensuring each story represents one iteration with verifiable acceptance criteria and test guidance.

How do I split a large project brief into small testable Ralph user stories?▼

Splitting large PRDs into Ralph user stories involves breaking the document into discrete iterations that enforce the one-iteration constraint, generating verifiable acceptance criteria with Typecheck and Tests guidance for autonomous agent execution.

What is PRD grooming for autonomous agent workflows?▼

PRD grooming for autonomous agent workflows is the process of transforming plain text project briefs into structured JSON that enforces required schemas, enabling autonomous agents to execute testable work items under a dedicated branch.

Does Ralph require a specific branch naming convention for prd.json files?▼

Ralph requires organizing work under a ralph/ branch name derived from the project and feature name, ensuring the generated prd.json is correctly versioned and structured for the autonomous agent workflow.

How to ensure Typecheck passes and tests are included when converting PRDs to Ralph format?▼

Ensuring Typecheck passes and tests are included requires validating the converted prd.json against Ralph's required schema, producing verifiable acceptance criteria with explicit Typecheck and Tests guidance for each user story iteration.

Can I use plain text project briefs as input for Ralph story splitting?▼

Plain text project briefs can be used as input for Ralph story splitting, where the grooming process transforms them into standardized prd.json files with discrete user stories and verifiable acceptance criteria.