ralphy

🥇Gold

Ralphy is an autonomous bash script that runs multiple AI agents in a loop to complete product requirements documents. It benefits operations teams by automating the coding process. It connects to Claude Code, Codex, OpenCode, Cursor agent, Qwen, and Droid.

2,6972580Updated 1w ago

Intermediate30min to implementautomation

Saves ~240 min per use

Quick InstallView Source

git clone https://github.com/michaelshimeles/ralphy.git

Works with:

Claude

Overview

About This Skill

https://github.com/michaelshimeles/ralphy

How to Use

["Prepare your inputs: Gather [PRODUCT_NAME], [FEATURE_LIST], [USER_STORIES], [TECHNICAL_CONSTRAINTS], and [ACCEPTANCE_CRITERIA].","Select agents: Choose from [Claude Code, Codex, OpenCode, Cursor agent, Qwen, Droid] based on your project needs. For complex integrations, include both code-generation and testing agents.","Run Ralphy: Execute the bash script with your inputs. Example: `./ralphy.sh --product \"Smart Inventory Tracker\" --features \"barcode scanning, low stock alerts\" --agents \"claude,codex\"`","Review output: Ralphy will generate a PRD in Markdown. Validate the document against your original requirements and adjust inputs if needed.","Iterate: Use Ralphy's loop feature to refine the PRD. Example: `./ralphy.sh --refine \"improve acceptance criteria for multi-store support\"`"]

Use Cases

Automate the addition of new features by simply specifying tasks like 'add login button'.

Process a list of tasks from a PRD file, ensuring each task is completed in sequence or parallel.

Configure project-specific rules and commands to guide AI behavior during task execution.

Integrate with GitHub to sync task progress and manage issues directly from the command line.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/michaelshimeles/ralphy

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use Ralphy to generate a product requirements document (PRD) for [PRODUCT_NAME]. The PRD should include: [FEATURE_LIST], [USER_STORIES], [TECHNICAL_CONSTRAINTS], and [ACCEPTANCE_CRITERIA]. Run Ralphy with the following agents: [AGENT_LIST]. Provide the final PRD in Markdown format with clear sections for each requirement.

Example Output

```markdown
# Product Requirements Document: Smart Inventory Tracker

## Overview
The Smart Inventory Tracker is a web-based application designed to automate stock management for retail businesses. It integrates with existing POS systems and provides real-time alerts for low stock levels.

## Core Features
- **Automated Stock Tracking**: AI-powered barcode scanning and inventory updates via OCR.
- **Low Stock Alerts**: Email and SMS notifications when inventory drops below predefined thresholds.
- **Multi-Store Support**: Dashboard for managing inventory across multiple retail locations.
- **Supplier Integration**: Automated reordering when stock levels hit critical thresholds.

## User Stories
1. **Store Manager**: "As a store manager, I want to receive low stock alerts so I can reorder products before they run out."
2. **Cashier**: "As a cashier, I want to quickly scan barcodes to update inventory levels in real-time."
3. **Supplier**: "As a supplier, I want to receive automated purchase orders when my products are running low."

## Technical Constraints
- Must support RESTful API integration with existing POS systems.
- Frontend must be responsive and work on tablets and desktops.
- Database must handle 10,000+ SKUs with sub-second query performance.
- Must comply with GDPR for data storage and user privacy.

## Acceptance Criteria
| Feature | Criteria |
|---------|----------|
| Barcode Scanning | OCR accuracy >95% for standard barcodes |
| Low Stock Alerts | Alerts triggered within 5 minutes of threshold breach |
| Multi-Store Dashboard | Load time <2 seconds for 100 stores |
| Supplier Integration | Purchase orders generated within 1 hour of alert |

## Next Steps
1. Prototype barcode scanning module using OpenCV.
2. Develop API endpoints for POS system integration.
3. Implement real-time alert system with Twilio for SMS notifications.
```