---
mode: subagent
---

<!-- SPDX-License-Identifier: MIT -->
<!-- SPDX-FileCopyrightText: 2025-2026 Marcus Quinn -->
# Product Requirements Document: {Feature Name}

Based on [ai-dev-tasks](https://github.com/snarktank/ai-dev-tasks) PRD format, with time tracking.

<!--TOON:prd{id,feature,author,status,est,est_ai,est_test,est_read,logged}:
prd-{slug},{Feature Name},{Author},draft,{est},{est_ai},{est_test},{est_read},{YYYY-MM-DDTHH:MMZ}
-->

## Overview

**Feature:** {Feature name}
**Author:** {Author}
**Date:** {YYYY-MM-DD}
**Status:** Draft | Review | Approved
**Estimate:** ~{total} (ai:{ai_time} test:{test_time} read:{read_time})

### Problem Statement

{What problem does this feature solve? Who experiences this problem?}

### Goal

{What is the desired outcome? How will we know when this is successful?}

## User Stories

### Primary User Story

As a {user type}, I want to {action} so that {benefit}.

### Additional User Stories

- As a {user type}, I want to {action} so that {benefit}.
- As a {user type}, I want to {action} so that {benefit}.

## Functional Requirements

### Core Requirements

1. **{Requirement 1}**: {Description}
2. **{Requirement 2}**: {Description}
3. **{Requirement 3}**: {Description}

### Secondary Requirements

4. **{Requirement 4}**: {Description}
5. **{Requirement 5}**: {Description}

## Non-Goals (Out of Scope)

- {What this feature will NOT do}
- {Explicitly excluded functionality}
- {Future considerations not in this version}

## Design Considerations

### User Interface

{UI/UX requirements, mockups, or references to existing patterns}

### User Experience

{Flow description, interaction patterns}

## Technical Considerations

### Architecture

{How this fits into existing architecture}

### Dependencies

- {Dependency 1}: {Why needed}
- {Dependency 2}: {Why needed}

### Constraints

- {Technical constraint 1}
- {Technical constraint 2}

### Security Considerations

- {Security requirement 1}
- {Security requirement 2}

## Time Estimate Breakdown

| Phase | AI Time | Test Time | Read Time | Total |
|-------|---------|-----------|-----------|-------|
| Research | {Xh} | - | {Xh} | {Xh} |
| Implementation | {Xh} | {Xh} | {Xm} | {Xh} |
| Documentation | {Xm} | {Xm} | {Xm} | {Xh} |
| **Total** | **{Xh}** | **{Xh}** | **{Xh}** | **{Xh}** |

<!--TOON:time_breakdown[3]{phase,ai,test,read,total}:
research,{Xh},,{Xh},{Xh}
implementation,{Xh},{Xh},{Xm},{Xh}
documentation,{Xm},{Xm},{Xm},{Xh}
-->

## Success Metrics

| Metric | Target | Measurement Method |
|--------|--------|-------------------|
| {Metric 1} | {Target value} | {How measured} |
| {Metric 2} | {Target value} | {How measured} |

## Open Questions

- [ ] {Question 1}
- [ ] {Question 2}
- [ ] {Question 3}

## Appendix

### Related Documents

- {Link to related PRD}
- {Link to design doc}
- {Link to technical spec}

### Revision History

| Date | Author | Changes |
|------|--------|---------|
| {YYYY-MM-DD} | {Author} | Initial draft |
