ralph-claude-code/sample-prd.md
frankbria 76a80220da Add ralph-import command for PRD conversion using Claude Code
🚀 New Feature: ralph-import
- Converts existing PRDs/specs to Ralph format using Claude Code intelligence
- Supports multiple formats: Markdown, text, JSON, Word docs, PDFs
- Creates complete Ralph project with PROMPT.md, @fix_plan.md, specs/
- Leverages Claude Code for intelligent requirement parsing and conversion

🔧 Implementation:
- ralph_import.sh: Core conversion script with Claude Code integration
- Global installation: ralph-import command available system-wide
- Smart conversion prompt that extracts goals, priorities, and technical specs
- Auto-generates proper Ralph project structure from any source format

📚 Enhanced Documentation:
- New "Importing Existing Requirements" section in README
- Option A (import PRD) vs Option B (manual setup) in Quick Start
- Comprehensive format support and usage examples
- Command reference updated with ralph-import

🎯 Benefits:
- Eliminates manual conversion from PRDs to Ralph format
- Leverages Claude Code's intelligence for requirement interpretation
- Dramatically reduces onboarding friction for existing projects
- Maintains all original requirement context while making it actionable

Sample PRD included for testing and demonstration purposes.
2025-08-27 10:01:57 -07:00

1.6 KiB

Task Management Web App - Product Requirements Document

Overview

Build a modern task management web application similar to Todoist/Asana for small teams and individuals.

Core Features

User Management

  • User registration and authentication
  • User profiles with avatars
  • Team/workspace creation and management

Task Management

  • Create, edit, and delete tasks
  • Task prioritization (High, Medium, Low)
  • Due dates and reminders
  • Task categories/projects
  • Task assignment to team members
  • Comments and attachments on tasks

Organization

  • Project-based organization
  • Kanban board view
  • List view with filtering and sorting
  • Calendar view for due dates
  • Dashboard with overview metrics

Technical Requirements

Frontend

  • React.js with TypeScript
  • Modern UI with responsive design
  • Real-time updates for collaborative features
  • PWA capabilities for mobile use

Backend

  • Node.js with Express
  • PostgreSQL database
  • RESTful API design
  • WebSocket for real-time features
  • JWT authentication

Infrastructure

  • Docker containerization
  • Environment-based configuration
  • Automated testing (unit and integration)
  • CI/CD pipeline ready

Success Criteria

  • Users can create and manage tasks efficiently
  • Team collaboration features work seamlessly
  • App loads quickly (<2s initial load)
  • Mobile-responsive design works on all devices
  • 95%+ uptime once deployed

Priority

  1. Phase 1: Basic task CRUD, user auth, simple UI
  2. Phase 2: Team features, real-time updates, advanced views
  3. Phase 3: Notifications, mobile PWA, advanced filtering

Timeline

Target MVP completion in 4-6 weeks of development.