From 587f9d62419730d51b0d80506796ff885841caf6 Mon Sep 17 00:00:00 2001 From: rtibblesbot Date: Fri, 6 Mar 2026 16:17:09 -0800 Subject: [PATCH] feat: update feature_issue.md template with PRD structure Replace Overview/Goals/User Stories with structured PRD sections: Requirements, Outcomes, Constraints, Dependencies, Assumptions, Risks, Timeline, Out of Scope, and Context. Remove Contributors, Target Quarter, and Product Issues sections. Preserve frontmatter and AI usage section with DEEP guidelines. Closes #59 Co-Authored-By: Claude Opus 4.6 --- .github/ISSUE_TEMPLATE/feature_issue.md | 61 +++++++++++++++---------- 1 file changed, 38 insertions(+), 23 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/feature_issue.md b/.github/ISSUE_TEMPLATE/feature_issue.md index 3bc573b..fef18e6 100644 --- a/.github/ISSUE_TEMPLATE/feature_issue.md +++ b/.github/ISSUE_TEMPLATE/feature_issue.md @@ -7,38 +7,53 @@ type: Tracking Issue --- -_[General guidance: When drafting a feature project, the goal is to create a reference for project scope and context. Write for our core product team. The issue should not be overly technical, and should be be comprehensible and a useful reference to devs, designers, and QA team, to build a shared source of understanding. Anyone at LE should be able to read this and more or less understand the project. If there is relevant information or context that is for the internal team only, please add that in a notion page and link it, rather than adding directly to these issues.]_ +## Requirements -## Overview +### What problem are we solving? -_[First, the project and purpose in one sentence, i.e.: Allow coaches and admins to customize quiz questions in Koilbri]_ +### Why this? Why now? -_[Then, more detail]_ -- What is this feature? What problem is it solving? -- Why are we doing this now? -- What feedback, requests, insights and/or concerns are shaping this feature? Include specific comments from partners, clearinghouse, or teammates as relevant. +## Outcomes -### Contributors -_[Fill this out as people are assigned]_ -- Technical lead: [github handle] -- Individual contributors: [list all github handles] -- Designer: [if a specific designer is leading] -- Other relevant LE team members: [optional, i.e. imps point person] +- [Specific, measurable outcome] -### Goals -- Who is this feature for? Outline user stories below, but also mention if there is a specific partner and/or deployment -- How do we know this feature is successful? +## Constraints -### User Stories or Requirements -_[Break down the main workflows thematically, but still at a high level. How are the goals of the project realized in the UI? If there isn't a UI portion of this project, what are the key outcomes or improvements? There should probably only be a few of these per project]_ +- [Budget, deadline, technical limitation] -### Target Quarter and Due date -- What is the timeline of this project? - - If there is a specific due date, especially for a contractual deliverable, include it. Otherwise, include an estimated delivery date, and what quarter(s) this will be worked on +## Dependencies -### Product Issues -_[Issues should be attached as sub issues as they are created. There will probably be 1-2 per User Story]_ +- [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]