Skip to content

Update feature_issue.md template to PRD structure #59

@rtibbles

Description

@rtibbles

This issue is not open for contribution. Visit Contributing guidelines to learn about the contributing process and how to find suitable issues.

Description

The feature_issue.md template should be updated to use a robust PRD structure. The current template has sections that overlap with other templates and is missing key sections for scoping and risk management.

Changes

Remove: Contributors, Target Quarter and Due date, Product Issues

Replace Overview/Goals/User Stories with PRD structure:

  • Requirements (What problem are we solving? / Why this? Why now?)
  • Outcomes
  • Constraints
  • Dependencies
  • Assumptions
  • Risks
  • Timeline
  • Out of Scope
  • Context (Relevant Feedback, Technical Context, Reference Links)

Keep: Frontmatter, AI usage section with DEEP guidelines

Proposed Template

---
name: Feature issue
about: Create an issue for a whole project
title: "[Release name or version]: [Project Name]"
labels: ["Feature"]
type: Tracking Issue
---

## Requirements

### What problem are we solving?

### Why this? Why now?

## Outcomes

- [Specific, measurable outcome]

## Constraints

- [Budget, deadline, technical limitation]

## Dependencies

- [What this project blocks or is blocked by]

## Assumptions

- [Things treated as true without proof]

## Risks

- [What could derail this project]

## Timeline

- [Milestone]: [Date]

## Out of Scope

- [Explicit exclusion]

## Context

### Relevant Feedback

- [Feedback from partners, users, clearinghouse, teammates]

### Technical Context

- [Relevant systems, prior art, technical considerations]

### Reference Links

- [Link]

<!-- AI USAGE - DEEP guidelines ... -->

## AI usage

Acceptance Criteria

  • feature_issue.md contains all PRD sections listed above
  • Contributors, Target Quarter, and Product Issues sections are removed
  • AI usage section with DEEP guidelines is preserved
  • Frontmatter (name, about, title, labels, type) is preserved

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions