A Cursor-compatible adaptation of the PRP (Product Requirement Prompt) Framework for agentic engineering development.

PRP = PRD + curated codebase intelligence + agent/runbook

The PRP framework enables AI agents to ship production-ready code on the first pass by providing:

• Comprehensive context with documentation, examples, and gotchas
• Validation loops with executable tests and quality gates
• Template-based methodology for consistent implementation
• Progressive enhancement from simple to complex features

# Clone the repository
git clone https://github.com/CuulCat/PRPs-cursor-development.git
cd PRPs-cursor-development

# Install dependencies (if using Python helpers)
pip install -e .
# or with uv
uv sync

1. Open the project in Cursor

   • The .cursorrules file automatically provides framework context
   • Cursor will understand PRP methodology and patterns

2. Create a PRP

   # Using the script
   python scripts/prp_runner.py create my-feature --type base --interactive
   
   # Or ask Cursor directly
   # "Use the prp_base.md template to create a PRP for user authentication"

3. Execute the PRP

   # Script-based execution
   python scripts/prp_runner.py execute PRPs/my-feature.md --validate
   
   # Or with Cursor
   # "Execute this PRP following the implementation blueprint"

• Base Template (prp_base.md): General Python/FastAPI development
• TypeScript Template (prp_base_typescript.md): React/TypeScript components
• Planning Template (prp_planning.md): Architecture and system design

1. Syntax & Style: Linting, formatting, type checking
2. Unit Tests: Comprehensive test coverage (80%+)
3. Integration Tests: End-to-end functionality
4. System Integration: Production readiness

• Automatic Context: .cursorrules provides framework awareness
• One-Pass Implementation: Comprehensive context enables first-pass success
• Progressive Enhancement: Start simple, add complexity iteratively

• PRP Runner: Create, execute, and validate PRPs
• Parallel Development: Multiple approaches simultaneously
• Quality Gates: Automated validation loops

PRPs-cursor-development/
├── .cursorrules              # Primary Cursor context
├── CURSOR.md                 # Comprehensive usage guide
├── PRPs/
│   ├── templates/            # PRP templates
│   │   ├── prp_base.md
│   │   ├── prp_base_typescript.md
│   │   └── prp_planning.md
│   ├── cursor_docs/          # Framework documentation
│   └── examples/             # Example PRPs
├── scripts/
│   ├── prp_runner.py         # Main execution script
│   ├── validation_runner.py  # Validation automation
│   └── cursor_helpers.py     # Cursor utilities
├── cursor_examples/          # Complete examples
│   └── CURSOR-PYTHON.md      # Python development example
└── pyproject.toml            # Dependency management

See cursor_examples/CURSOR-PYTHON.md for a complete example of implementing JWT authentication with:

• User registration and login
• Token management
• Comprehensive testing
• Security best practices

Use the prp_base_typescript.md template for:

• React component development
• TypeScript integration
• State management
• Testing with React Testing Library

Use the prp_planning.md template for:

• Technology stack evaluation
• System design
• Risk assessment
• Implementation roadmap

• Comprehensive context reduces iteration cycles
• Validation loops catch issues early
• Template structure ensures completeness

• Document patterns and gotchas
• Share implementation strategies
• Build institutional knowledge

• Template-based approach reduces setup time
• Automated validation saves debugging time
• Parallel development explores multiple approaches

• Multi-level validation ensures quality
• Security patterns built-in
• Performance considerations included

If you're familiar with the original Claude Code PRP framework:

1. Follow PRP Structure: Use the mandatory template format
2. Include Context: Provide comprehensive context and validation
3. Test with Cursor: Verify examples work in Cursor
4. Update Documentation: Keep guides current
5. Share Patterns: Document successful approaches

• CURSOR.md: Comprehensive usage guide
• Templates: Core PRP templates
• Examples: Complete implementation examples
• Project Summary: Detailed project metrics

• Issues: GitHub Issues
• Documentation: Comprehensive guides in this repository
• Examples: Working examples with explanations

MIT License - see LICENSE for details.

Remember: The goal is one-pass implementation success through comprehensive context and validation. Every PRP should contain the exact context needed for Cursor to successfully implement working code in a single pass.