Loading source
Pulling the file list, source metadata, and syntax-aware rendering for this listing.
Source from repo
Generate comprehensive, production-grade Product Requirements Documents with user stories and technical specs.
Files
Skill
Size
Entrypoint
Format
Open file
Syntax-highlighted preview of this file as included in the skill package.
SKILL.md
1---2name: prd3description: 'Generate high-quality Product Requirements Documents (PRDs) for software systems and AI-powered features. Includes executive summaries, user stories, technical specifications, and risk analysis.'4license: MIT5---67# Product Requirements Document (PRD)89## Overview1011Design comprehensive, production-grade Product Requirements Documents (PRDs) that bridge the gap between business vision and technical execution. This skill works for modern software systems, ensuring that requirements are clearly defined.1213## When to Use1415Use this skill when:1617- Starting a new product or feature development cycle18- Translating a vague idea into a concrete technical specification19- Defining requirements for AI-powered features20- Stakeholders need a unified "source of truth" for project scope21- User asks to "write a PRD", "document requirements", or "plan a feature"2223---2425## Operational Workflow2627### Phase 1: Discovery (The Interview)2829Before writing a single line of the PRD, you **MUST** interrogate the user to fill knowledge gaps. Do not assume context.3031**Ask about:**3233- **The Core Problem**: Why are we building this now?34- **Success Metrics**: How do we know it worked?35- **Constraints**: Budget, tech stack, or deadline?3637### Phase 2: Analysis & Scoping3839Synthesize the user's input. Identify dependencies and hidden complexities.4041- Map out the **User Flow**.42- Define **Non-Goals** to protect the timeline.4344### Phase 3: Technical Drafting4546Generate the document using the **Strict PRD Schema** below.4748---4950## PRD Quality Standards5152### Requirements Quality5354Use concrete, measurable criteria. Avoid "fast", "easy", or "intuitive".5556```diff57# Vague (BAD)58- The search should be fast and return relevant results.59- The UI must look modern and be easy to use.6061# Concrete (GOOD)62+ The search must return results within 200ms for a 10k record dataset.63+ The search algorithm must achieve >= 85% Precision@10 in benchmark evals.64+ The UI must follow the 'Vercel/Next.js' design system and achieve 100% Lighthouse Accessibility score.65```6667---6869## Strict PRD Schema7071You **MUST** follow this exact structure for the output:7273### 1. Executive Summary7475- **Problem Statement**: 1-2 sentences on the pain point.76- **Proposed Solution**: 1-2 sentences on the fix.77- **Success Criteria**: 3-5 measurable KPIs.7879### 2. User Experience & Functionality8081- **User Personas**: Who is this for?82- **User Stories**: `As a [user], I want to [action] so that [benefit].`83- **Acceptance Criteria**: Bulleted list of "Done" definitions for each story.84- **Non-Goals**: What are we NOT building?8586### 3. AI System Requirements (If Applicable)8788- **Tool Requirements**: What tools and APIs are needed?89- **Evaluation Strategy**: How to measure output quality and accuracy.9091### 4. Technical Specifications9293- **Architecture Overview**: Data flow and component interaction.94- **Integration Points**: APIs, DBs, and Auth.95- **Security & Privacy**: Data handling and compliance.9697### 5. Risks & Roadmap9899- **Phased Rollout**: MVP -> v1.1 -> v2.0.100- **Technical Risks**: Latency, cost, or dependency failures.101102---103104## Implementation Guidelines105106### DO (Always)107108- **Define Testing**: For AI systems, specify how to test and validate output quality.109- **Iterate**: Present a draft and ask for feedback on specific sections.110111### DON'T (Avoid)112113- **Skip Discovery**: Never write a PRD without asking at least 2 clarifying questions first.114- **Hallucinate Constraints**: If the user didn't specify a tech stack, ask or label it as `TBD`.115116---117118## Example: Intelligent Search System119120### 1. Executive Summary121122**Problem**: Users struggle to find specific documentation snippets in massive repositories.123**Solution**: An intelligent search system that provides direct answers with source citations.124**Success**:125126- Reduce search time by 50%.127- Citation accuracy >= 95%.128129### 2. User Stories130131- **Story**: As a developer, I want to ask natural language questions so I don't have to guess keywords.132- **AC**:133- Supports multi-turn clarification.134- Returns code blocks with "Copy" button.135136### 3. AI System Architecture137138- **Tools Required**: `codesearch`, `grep`, `webfetch`.139140### 4. Evaluation141142- **Benchmark**: Test with 50 common developer questions.143- **Pass Rate**: 90% must match expected citations.144