PRP - Product Requirement Prompts

Bootstrap context-driven development workflow based on Product Requirement Prompts (PRPs) and orchestrate execution with LOOP MODE

By Vasilisa Versus

What is PRP?

PRP is both a methodology and a CLI tool that revolutionizes how you approach software development:

• 📋 PRP Methodology - Context-driven development using Product Requirement Prompts as living documents
• 🔄 LOOP MODE - Continuous agent iteration guided by signals and progress tracking
• 🤖 Agent Orchestration - AI agents collaborate through standardized PRPs with emotional signals
• ⚡ Signal System - Track progress and emotional state with 14+ signals (ATTENTION, BLOCKED, ENCANTADO, etc.)
• 🚀 Project Scaffolding - Bootstrap new projects with best practices and complete infrastructure

The PRP Workflow (Autonomous Orchestration)

Key Principle: AI Orchestrator makes decisions autonomously. Humans are subordinate agents, not decision makers.

Every development task follows this cycle:

1. 📖 Read ALL PRPs - Load context across entire project
2. 🔍 Analyze ALL Signals - Identify highest priority signal (10→1)
3. ⚡ React to Strongest Signal - Work on highest priority across ALL PRPs
4. 🔨 Execute Work - Implement changes, write code, solve problems
5. 💬 Update Progress - Leave detailed comment in progress log
6. 🎯 Leave Signal - Express current state (TIRED, CONFIDENT, BLOCKED, etc.)
7. 🔄 Loop - Continue until DoD met or checkpoint reached

Orchestrator Rules:

• ❌ NO QUESTIONS to humans for decisions
• ✅ DECIDE AUTONOMOUSLY based on signal analysis
• ✅ DOCUMENT decisions in PRP progress log
• ✅ EXECUTE immediately without waiting
• ⚠️NUDGE only for critical blocks (Priority 10)

Quick Start with PRPs:

# List all PRPs
ls PRPs/
# Start working on a PRP# 1. Read the PRP file# 2. Check Progress Log for latest signal# 3. Follow signal's algorithm (see AGENTS.md)# 4. Do work# 5. Update Progress Log with your signal

Signal Examples:

• 🔴 ATTENTION (10) - New work or need user input (triggers NUDGE system)
• 🚫 BLOCKED (9) - Can't proceed, need external help
• ✅ CONFIDENT (3) - Work done, ready for review
• 🏁 COMPLETED (1) - PRP finished, DoD met

For detailed workflow instructions, see AGENTS.mdFor contributing guidelines, see CONTRIBUTING.md

Project Scaffolding Features

• 🚀 Interactive CLI with beautiful TUI powered by Ink (React for terminal)
• 🎨 Multiple Templates - FastAPI, NestJS, React, TypeScript libraries, and more
• 📝 Complete Project Setup - LICENSE, README, CONTRIBUTING, Code of Conduct, and more
• 🤖 AI Integration - Optional AI-powered code generation (OpenAI, Anthropic, Google)
• 🔧 GitHub Actions - Pre-configured CI/CD workflows
• 📦 Dependency Management - Auto-install with npm, yarn, or pnpm
• 🐳 Docker Support - Optional Dockerfile and docker-compose configuration
• ⚙️ Configurable - Choose exactly what to include in your project

Quick Start

Using npx (no installation required)

npx @dcversus/prp

Global Installation

npm install -g @dcversus/prp
prp

Local Installation

npm install @dcversus/prp
npx prp

Usage

Interactive Mode (Default)

Simply run the command and follow the prompts:

prp

The interactive CLI will guide you through:

1. Project metadata (name, description, author)
2. Template selection (FastAPI, NestJS, React, etc.)
3. Feature selection (LICENSE, Code of Conduct, GitHub Actions, etc.)
4. AI integration options (optional)

Non-Interactive Mode

Pass all options via command-line arguments:

prp \
--name my-project \
--description "My awesome project" \
--author "Your Name" \
--email "you@example.com" \
--template react \
--license MIT \
--no-interactive

Command-Line Options

Options:
-n, --name <name> Project name
-d, --description <desc> Project description
-a, --author <author> Author name
-e, --email <email> Author email
-t, --template <template> Template (fastapi, nestjs, react, typescript-lib, none)
--no-interactive Run in non-interactive mode
--yes Use default values for all options
--license <license> License type (default: MIT)
--no-git Skip git initialization
--no-install Skip dependency installation
-h, --help Display help
-V, --version Display version

Supported Templates

Template	Description	Tech Stack
none	Minimal setup with docs only	N/A
fastapi	FastAPI Python web service	Python, FastAPI, Uvicorn
nestjs	NestJS TypeScript backend	TypeScript, NestJS, Node.js
react	React web application	TypeScript, React, Vite
typescript-lib	TypeScript library/package	TypeScript, Node.js
express	Express.js backend	TypeScript, Express, Node.js

More templates coming soon!

What Gets Generated

Core Project Files

• README.md - Project documentation with badges and sections
• LICENSE - Your chosen license (default: MIT)
• .gitignore - Language/framework-specific ignores
• package.json / requirements.txt - Dependency management
• .editorconfig - Consistent coding styles

Open Source Best Practices

• CONTRIBUTING.md - Contribution guidelines
• CODE_OF_CONDUCT.md - Contributor Covenant
• SECURITY.md - Security policy and vulnerability reporting
• CHANGELOG.md - Keep a Changelog format

GitHub Templates

• .github/ISSUE_TEMPLATE/ - Bug reports and feature requests
• .github/PULL_REQUEST_TEMPLATE.md - PR checklist
• .github/workflows/ci.yml - CI/CD workflows

Development Tools

• ESLint configuration (for JS/TS projects)
• Prettier configuration (for JS/TS projects)
• TypeScript configuration (for TS projects)
• Jest/pytest configuration (testing)
• Docker configuration (optional)

AI Integration

PRP can optionally integrate with AI coding assistants to generate boilerplate code:

Supported Providers

• OpenAI (GPT-4, Codex) - OPENAI_API_KEY
• Anthropic (Claude) - ANTHROPIC_API_KEY
• Google (Gemini) - GOOGLE_API_KEY

Configuration

Set your API key as an environment variable:

export OPENAI_API_KEY="your-api-key"
prp

Or create a .prprc file in your home directory:

{
"aiProvider": "openai",
"apiKey": "your-api-key"
}

Development

Prerequisites

• Node.js >= 20.0.0
• npm >= 10.0.0

Setup

# Clone the repository
git clone https://github.com/dcversus/prp.git
cd prp
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build
npm run build
# Run tests
npm test# Lint and format
npm run lint
npm run format

Project Structure

prp/
├── src/
│ ├── cli.ts # CLI entry point
│ ├── index.ts # Main module
│ ├── types.ts # TypeScript types
│ ├── ui/ # Ink UI components
│ │ ├── App.tsx
│ │ └── components/
│ ├── generators/ # Template generators
│ ├── templates/ # Template files
│ ├── ai/ # AI integration
│ └── utils/ # Helper functions
├── tests/ # Test files
├── dist/ # Compiled output
└── docs/ # Documentation

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE file for details.

Credits

Inspired by:

• Yeoman
• Cookiecutter
• create-react-app
• Telefonica Open Source Scaffold

Built with:

• Ink - React for CLIs
• Commander.js - Command-line framework
• TypeScript - Type-safe JavaScript

Links

• GitHub Repository
• npm Package
• Issue Tracker
• Changelog

---

Made with ❤️ by dcversus