ralph

Automates software feature implementation by executing user stories from PRD.json.

10|2|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/januarfonti/opencode-template-configured --skill ralph-januarfonti
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/januarfonti/opencode-template-configured/tree/main/skills/ralph
Command: npx skills add https://github.com/januarfonti/opencode-template-configured --skill ralph-januarfonti

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the process of implementing software features end-to-end by breaking them into user stories and executing them autonomously.

Core Features & Use Cases

  • Autonomous Loop: Executes features by automating the process of breaking down user stories and executing them.
  • User Story Management: Generates and manages prd.json files to track user stories and their completion status.
  • Progress Tracking: Keeps a progress.txt file for learnings and memory persistence via git.

Quick Start

Run ~/skills/ralph/scripts/ralph.sh in the project root directory.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate feature implementation from user stories?

Autonomous feature implementation works by breaking down user stories and executing them end-to-end. This skill manages the process using a PRD.json file to track story completion and a progress.txt file to persist learnings across iterations.

How does an autonomous agent handle software development iteration?

Software development iteration is handled by automating the breakdown of user stories into actionable steps. It executes database changes, backend logic, and UI components, while ensuring typechecks pass and verifying changes directly in the browser.

What do I need to run autonomous user story execution in my project?

To run autonomous user story execution, you need to execute the ralph.sh script in your project root directory. The system operates autonomously without external dependencies, relying on PRD.json for tracking and git for memory persistence.

How is user story progress tracked during autonomous feature implementation?

User story progress is tracked using a generated PRD.json file that manages story status. Additionally, a progress.txt file captures learnings and memory persistence, committing context via git to maintain state across development loops.

Does the autonomous agent verify database changes and UI components?

Yes, the autonomous agent verifies database changes and UI components by executing them as steps within the implementation loop. It focuses on ensuring typechecks pass and actively verifies the applied changes within the browser environment.

What are the limitations of using an autonomous loop for feature implementation?

The autonomous loop focuses on breaking down user stories and executing specific steps like backend logic and UI components. It relies on PRD.json and progress.txt for state management, meaning complex logic outside these defined steps may require manual intervention.