ralph-add

Merge new user stories into prd.json while preserving existing statuses.

3|1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/edfenton/claude-skills --skill ralph-add
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-add
Source: https://github.com/edfenton/claude-skills/tree/main/shared/ralph-add
Command: npx skills add https://github.com/edfenton/claude-skills --skill ralph-add

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams extend their PRD with new user stories without resetting the progress of existing stories.

Core Features & Use Cases

  • Reads the existing prd.json, merges new stories with preserved statuses, and writes updates.
  • Validates against duplicate story IDs and assigns new priorities after the current maximum.
  • Supports both file-based PRD inputs and inline definitions for quick expansion.

Quick Start

Provide a PRD markdown file containing only the new stories to merge.

Frequently Asked Questions about ralph-add

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

FAQPage Schema
How do I append new user stories to prd.json without resetting existing statuses?

To append new user stories to prd.json without resetting statuses, provide a PRD markdown file or inline definitions of the new stories. The skill reads the existing file, merges the additions, preserves completed progress, and writes the updated data.

What happens to story priorities when merging new entries into an existing PRD?

When merging new entries into an existing PRD, the skill assigns new priorities sequentially after the highest existing priority value. This ensures newly added features and bug fixes are ordered correctly without disrupting the current priority structure.

Can I add inline user stories to a PRD or do I need a separate file?

You can add inline user stories directly without needing a separate file. The skill supports both file-based PRD inputs and inline definitions, allowing quick expansion of your ongoing project with new features and enhancements.

Does the PRD merge process check for duplicate story IDs?

Yes, the PRD merge process validates against duplicate story IDs automatically. Before writing the updated prd.json, the skill checks the existing entries to prevent redundant stories from being added to your ongoing project workflow.

What is the best way to update an ongoing project with new PRD features?

The best way to update an ongoing project with new PRD features is using an automated merge process that preserves existing statuses. This approach reads your current prd.json, validates duplicates, assigns priorities, and writes the combined file safely.