From 15ba8d217f6584fddf40df0a08c92b1f84bf31d7 Mon Sep 17 00:00:00 2001
From: Nicole Zhu <nicole@menlo.ai>
Date: Mon, 11 Aug 2025 17:39:37 +0800
Subject: [PATCH] docs: Update 3-epic.md

---
 .github/ISSUE_TEMPLATE/3-epic.md | 23 +++++++++++++++++++----
 1 file changed, 19 insertions(+), 4 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/3-epic.md b/.github/ISSUE_TEMPLATE/3-epic.md
index afffc6b5c..3e05d8dd6 100644
--- a/.github/ISSUE_TEMPLATE/3-epic.md
+++ b/.github/ISSUE_TEMPLATE/3-epic.md
@@ -1,12 +1,27 @@
 ---
 name: 🌟 Epic
-about: Major building block that advances Jan's goals
+about: User stories and specs
 title: 'epic: '
 type: Epic
 ---
 
-## Goal
+## User Stories
 
-## Tasklist
+- As a [user type], I can [do something] so that [outcome]
 
-## Out of scope
+## Not in scope
+
+- 
+
+## User Flows & Designs
+
+- Key user flows
+- Figma link
+- Edge cases
+- Error states
+
+## Engineering Decisions
+
+- **Technical Approach:** Brief outline of the solution.
+- **Key Trade-offs:** What’s been considered/rejected and why.
+- **Dependencies:** APIs, services, libraries, teams.