prd-templates

Draft structured PRDs, PRFAQs, and success metrics for product planning cycles.

4|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/AI-Foundry-Core/ril-agents --skill prd-templates-ai-foundry-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prd-templates
Source: https://github.com/AI-Foundry-Core/ril-agents/tree/main/plugins/product-planning/skills/prd-templates
Command: npx skills add https://github.com/AI-Foundry-Core/ril-agents --skill prd-templates-ai-foundry-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

A PRD (Product Requirements Document) is the contract between Product and Development for a cycle. A weak PRD produces ambiguous builds, rework, and missed metrics. A strong PRD makes clear what's being built, why, what done looks like, and what's explicitly out of scope.

When to Use This Skill

  • Writing a PRD for an upcoming development cycle
  • Defining success metrics for a product initiative
  • Scoping a cycle against engineering capacity
  • Writing a PRFAQ (press release / FAQ) for a new product direction
  • Reviewing a PRD for completeness before planning

PRD Structure

Minimal Viable PRD (for small cycles)

# PRD: [Feature Name]

## Problem Statement
[1-2 sentences: what user problem are we solving? Who has this problem?]

## Proposed Solution
[What we're building. Not implementation details — the user-facing change.]

## Success Metrics
- Primary: [The one metric that determines if this worked]
- Secondary: [Supporting metrics to watch]
- Guardrails: [Metrics that must NOT get worse]

## Scope

### In Scope
- [Feature or behavior 1]
- [Feature or behavior 2]

### Out of Scope
- [Explicitly excluded items — especially things stakeholders might assume are included]

## Constraints
- Timeline: [Hard deadline if any]
- Technical: [Known technical constraints]
- Regulatory: [Compliance requirements if any]

## Open Questions
- [ ] [Question that needs answering before or during build]

Full PRD (for large or high-stakes cycles)

# PRD: [Feature or Initiative Name]

**Author:** [Name]
**Status:** Draft / In Review / Approved
**Cycle:** [Quarter / Sprint range]
**Last updated:** [Date]

---

## 1. Problem Statement

### User Problem
[Who is affected, what's the situation, what's the pain or unmet need]

### Business Problem
[Why this matters from a business perspective — revenue, retention, competitive position]

### Evidence
- [Research finding 1 — with source]
- [Data point 1 — with source]
- [Quote or observation from user research]

---

## 2. Goals and Non-Goals

### Goals
- [What this initiative is trying to achieve]

### Non-Goals
- [What this initiative explicitly does NOT address]

---

## 3. Proposed Solution

### Summary
[2-3 sentence description of what we're building]

### User Experience Overview
[High-level description of what the user will experience. Not a spec — a narrative.]

---

## 4. Success Metrics

| Metric | Baseline | Target | Measurement Method |
|--------|---------|--------|--------------------|
| [Primary metric] | [Current value] | [Target] | [How measured] |
| [Secondary metric] | [Current value] | [Target] | [How measured] |
| [Guardrail metric] | [Current value] | Must not decrease | [How measured] |

**Measurement window:** [How long after launch before evaluating?]

---

## 5. Feature Backlog

Stack-ranked list of features for this cycle. Each item has: description, user story, and priority tier.

### Must Have (blocks launch)
| # | Feature | User Story |
|---|---------|-----------|
| 1 | [Feature] | As a [user type], I want [capability] so that [outcome] |

### Should Have (strong preference, deprioritize if capacity is tight)
| # | Feature | User Story |
|---|---------|-----------|

### Could Have (nice to have, cut if needed)
| # | Feature | User Story |
|---|---------|-----------|

### Won't Have This Cycle (explicitly deferred)
| Feature | Reason for Deferral |
|---------|-------------------|

---

## 6. Constraints and Dependencies

### Technical Constraints
- [Constraint 1]

### External Dependencies
- [Team / Service / API we depend on]

### Timeline Constraints
- [Hard dates and why they're hard]

---

## 7. Assumptions

| Assumption | Validation Status | Risk if Wrong |
|-----------|------------------|---------------|
| [Assumption 1] | Validated / Unvalidated | [Impact] |
| [Assumption 2] | Validated / Unvalidated | [Impact] |

---

## 8. Open Questions

- [ ] [Question] — Owner: [Name] — Due: [Date]

## PRFAQ Format

The PRFAQ (Press Release / FAQ) is Amazon's method for defining a product by writing the announcement first. It forces clarity about customer benefit before diving into requirements.

```markdown
# Press Release: [Product/Feature Name]

**FOR IMMEDIATE RELEASE**

**[Company] Launches [Feature], Enabling [Customer Benefit]**

[City, Date] — [Company] today announced [Feature], a new capability that [one-sentence value proposition]. Starting today, [user type] can [key action], [outcome].

"[Quote from a hypothetical satisfied customer describing the benefit in their words]"

[Feature] addresses [the problem] that [affected users] have faced with [current state]. With [Feature], users can now [key capability 1] and [key capability 2], resulting in [measurable outcome].

[Feature] is available [to whom, when, how].

---

# Frequently Asked Questions

**Q: Who is this for?**
A: [Target user description]

**Q: What problem does it solve?**
A: [Problem statement in user language]

**Q: How does it work?**
A: [User-facing explanation, no technical jargon]

**Q: What does it NOT do?**
A: [Explicit scope limitations]

**Q: How will users find and start using it?**
A: [Discovery and activation path]

**Q: How will we know if it's working?**
A: [Success metrics in plain language]

Success Metric Definition

Metric Hierarchy

North Star Metric
└── Primary Success Metric (for this initiative)
    ├── Leading Indicator (early signal, visible within days/weeks)
    └── Lagging Indicator (confirms success, weeks/months)
        └── Guardrail Metrics (must not degrade)

Metric Quality Checklist

A well-defined metric is:

  • [ ] Measurable: Can be tracked with existing or addable instrumentation
  • [ ] Attributable: Can be connected to this feature specifically (not confounded)
  • [ ] Time-bound: Has a defined measurement window
  • [ ] Baselined: Has a current value to compare against
  • [ ] Targeted: Has an explicit success threshold

Common Metric Mistakes

| Mistake | Example | Fix | |---------|---------|-----| | Vanity metric | "Increase page views" | Tie to a business outcome: "Increase checkout conversion" | | Unmeasurable | "Improve user happiness" | Define: "Increase NPS from 32 to 40" | | Too broad | "Improve retention" | Scope to cycle: "Increase 30-day retention for new users acquired via organic search" | | No baseline | "Achieve 70% task completion" | Always document current baseline |

Best Practices

  1. Write the out-of-scope section first — it's the hardest and most important part
  2. Define guardrail metrics — the things that must not get worse are as important as the success metrics
  3. Open questions are features too — unresolved questions in the PRD become rework during the cycle
  4. PRD is a living document — update it as decisions are made; it's the record of what was agreed
  5. Write for development agents as the audience — if something would require a clarifying question during build, it's not specific enough

Frequently Asked Questions about prd-templates

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a product requirements document for a small development cycle?

A minimal viable product requirements document for small cycles includes a problem statement, proposed solution, success metrics, explicit scope, constraints, and open questions to align product and engineering teams.

What is a PRFAQ and when should I use it for product planning?

A PRFAQ is a press release and FAQ format that defines a product by writing the announcement first, forcing clarity about customer benefit before diving into technical requirements for new product directions.

How do I define success metrics for a product initiative?

Define success metrics by establishing a primary metric to determine if the initiative worked, secondary supporting metrics, and guardrail metrics that must not degrade, ensuring each is measurable, attributable, and baselined.

What should I include in the out-of-scope section of a PRD?

The out-of-scope section of a PRD should explicitly exclude items stakeholders might assume are included, alongside deferred features with their reasons for deferral, to prevent ambiguous builds and scope creep.

Can I use these PRD templates for large scale software initiatives?

Yes, a full PRD template for large or high-stakes cycles adds goals, non-goals, a stack-ranked feature backlog, assumptions with validation status, and detailed dependencies to constrain scope and alignment.

What are common mistakes when defining product success metrics?

Common metric mistakes include using vanity metrics without business outcomes, defining unmeasurable goals like user happiness, setting overly broad scopes, and failing to document current baselines for comparison.