prd-creation

PRD Creation Skill

Goal

To guide an AI assistant in creating a single, comprehensive Product Requirements Document (PRD) in Markdown format. This document will serve as both a high-level brief for project context and a detailed, actionable guide for implementation.

Activation Triggers

• User asks to "create a PRD", "write requirements", or "define a feature"
• Starting a new feature that needs requirements definition
• User says "docs first" or "requirements first"

Bundled Resources

This skill includes:

• scripts/generate-prd.sh - Shell script to create PRD file with proper naming
• templates/prd-template.md - Standard PRD template

Process

1. Receive Initial Prompt

The user provides a brief description or request for a new feature.

2. Detect Existing PRDs

Check if PRDs already exist:

ls -la features/*prd*.md 2>/dev/null || ls -la docs/prds/*.md 2>/dev/null || echo "NO_EXISTING_PRDS"

3. Ask Clarifying Questions

Before writing the PRD, you must ask clarifying questions to gather sufficient detail. Group related questions and provide numbered options for easy responses.

Problem & Goal

• "What is the core problem this feature solves for the user?"
• "What is the main goal we want to achieve?"
• "Why is this important now?"

Target User

• "Who is the primary user of this feature?"
• "Are there secondary users or stakeholders?"

Core Functionality

• "What are the key actions a user must be able to perform?"
• "What does success look like for this feature?"

User Stories

• "Could you provide a few user stories? (e.g., As a [user], I want to [action] so that [benefit].)"

Scope Boundaries

• "What's explicitly out of scope for this version?"

Edge Cases & Failures

• "What happens when things go wrong?"
• "Are there any business rules that must never be violated?"

4. Generate PRD

Use the template structure to create the PRD:

# Generate next PRD number
NEXT_NUM=$(ls features/*prd*.md 2>/dev/null | wc -l)
NEXT_NUM=$((NEXT_NUM + 1))
PADDED_NUM=$(printf "%04d" $NEXT_NUM)