ralph-it

Automate PRD-based user story handling from merged PRs to implementation.

4|Updated Feb 18, 2026
One-click install
npx skills add https://github.com/apocohq/skills --skill ralph-it
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-it
Source: https://github.com/apocohq/skills/tree/main/skills/ralph-it
Command: npx skills add https://github.com/apocohq/skills --skill ralph-it

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the end-to-end handling of PRD-based user stories by analyzing merged PRs, identifying the next actionable item, and orchestrating planning, implementation, and PR linkage.

Core Features & Use Cases

  • Gather context from PRDs and merged PRs to surface findings.
  • Identify the next actionable user story based on dependencies and completed work.
  • Propose a concise implementation plan and gather confirmation before proceeding.
  • Implement the chosen user story and generate a PR linked to the PRD.
  • Update the PRD issue to reflect progress and completion.
  • Include guardrails and safety checks to prevent scope creep or unsafe changes.

Quick Start

Provide a GitHub PRD issue URL or number to begin the workflow.

Frequently Asked Questions about ralph-it

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

FAQPage Schema
How do I automate PRD-driven user story implementation from merged PRs?

Automating PRD-driven user story implementation involves analyzing merged PRs to identify the next actionable item, then orchestrating planning, implementation, and PR linkage. This workflow uses GitHub repositories to track PRD-driven user stories and apply structured metadata.

How does PRD-based user story automation work with GitHub issue tracking?

PRD-based user story automation works by gathering context from PRDs and merged PRs to surface findings. It identifies the next actionable user story based on dependencies, proposes an implementation plan, and updates the PRD issue via the gh CLI.

What's the best way to link a generated pull request to a PRD issue?

The best way to link a generated pull request to a PRD issue is by using the gh CLI. The automation implements the chosen user story, generates a PR, and updates the PRD issue to reflect progress and completion with structured metadata.

Can I use gh CLI to automatically update GitHub issues after implementing a user story?

Yes, you can use the gh CLI to automatically update GitHub issues after implementing a user story. The workflow satisfies requirements for issue updates by reflecting progress and completion on the PRD issue once the implementation PR is generated.

Does this user story automation include safety checks to prevent scope creep?

Yes, user story automation includes guardrails and safety checks to prevent scope creep or unsafe changes. Before proceeding with implementation, it proposes a concise plan and gathers confirmation to ensure boundaries are maintained.

What do I need to start automating GitHub user story workflows?

To start automating GitHub user story workflows, you need to provide a GitHub PRD issue URL or number. This serves as the entry point for the automation to begin gathering context, generating plans, and implementing the next task.