Skip to content

PRD-NNN: [Feature Name]

Summary

[One paragraph describing what this feature does and why it matters. Should be clear and concise, suitable for executive summary.]

Background & Context

[2-3 paragraphs explaining:]

  • [What problem this solves]
  • [Why this is needed now]
  • [How it relates to existing features]
  • [Reference to related architecture/docs if relevant]

Goals

[Bulleted list of what this feature aims to achieve:]

  • [Goal 1: Clear, measurable outcome]
  • [Goal 2: User benefit or system improvement]
  • [Goal 3: Integration or compatibility goal]

Non-Goals

[Explicitly state what this feature does NOT do:]

  • [Out of scope item 1]
  • [Out of scope item 2]
  • [Future consideration that's not in this PRD]

Personas

[Describe 2-3 key user personas who will benefit from this feature:]

  • [Persona Name]: [Role/description]
  • [What they need]
  • [How this feature helps them]

  • [Persona Name]: [Role/description]

  • [What they need]
  • [How this feature helps them]

User Stories

[Format: "As [persona], I can [action] so that [benefit]."]

  • As [Persona], I can [do something] so that [benefit].
  • As [Persona], I can [do something] so that [benefit].
  • As [any operator], I can [do something] so that [benefit].

Functional Requirements

[Organize by feature area or component. Use FR1, FR1.1, FR1.2 format for hierarchical requirements.]

FR1: [Feature Area Name]

  • FR1.1: [Specific requirement with clear acceptance criteria]
  • FR1.2: [Specific requirement with clear acceptance criteria]
  • FR1.3: [Specific requirement with clear acceptance criteria]

FR2: [Another Feature Area]

  • FR2.1: [Specific requirement]
  • FR2.2: [Specific requirement]

[Continue as needed...]

Success Metrics

[Measurable criteria for success:]

  • [Metric 1: e.g., ">=95% of episodes with published transcripts complete without manual retry"]
  • [Metric 2: e.g., "Processing overhead: <20% increase in total processing time"]
  • [Metric 3: e.g., "Zero impact on existing workflows when disabled"]

Dependencies

[What this feature depends on:]

  • [PRD-XXX: Related PRD]
  • [RFC-XXX: Related RFC]
  • [External dependency or system requirement]

Constraints & Assumptions

[If applicable, document constraints and assumptions:]

Constraints:

  • [Hardware constraint, e.g., "Must run on Apple M4 Pro with 48 GB RAM"]
  • [Performance constraint, e.g., "Must complete in < 5 seconds"]
  • [Compatibility constraint, e.g., "Must be backward compatible"]

Assumptions:

  • [Assumption 1, e.g., "Users have internet connectivity"]
  • [Assumption 2, e.g., "Local models are preferred over API-based solutions"]

Design Considerations

[If applicable, document design decisions and trade-offs:]

[Design Decision Topic]

  • Option A: [Description]
  • Pros: [Benefits]
  • Cons: [Drawbacks]
  • Decision: [Which option chosen and why]

[Another Design Decision]

  • [Similar structure...]

[If applicable, describe how this feature integrates with existing features:]

[Feature Name] enhances the pipeline by:

  • [Integration Point 1]: [How it integrates]
  • [Integration Point 2]: [How it integrates]

Example Output

[If applicable, show example of what the feature produces:]

{
  "example": "output structure"
}
```json

- [Question 3: e.g., "How to handle multi-speaker transcripts in summaries?"]

## Related Work

[Links to related issues, PRDs, RFCs, UX specs:]

- Issue #XXX: [Related issue description]
- PRD-XXX: [Related PRD]
- RFC-XXX: [Related RFC]
- UXS-NNN: `docs/uxs/UXS-NNN-slug.md`  [short description]

## Release Checklist

[Checklist for release readiness:]

- [ ] PRD reviewed and approved
- [ ] RFC-XXX created with technical design
- [ ] Implementation completed
- [ ] Tests cover [key scenarios]
- [ ] Documentation updated (README, config examples)
- [ ] Integration with [related feature] verified