product-playbook 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (291) hide show
  1. package/LICENSE +21 -0
  2. package/README.es.md +518 -0
  3. package/README.ja.md +519 -0
  4. package/README.ko.md +518 -0
  5. package/README.md +520 -0
  6. package/README.zh-CN.md +518 -0
  7. package/README.zh-TW.md +518 -0
  8. package/SKILL.md +244 -0
  9. package/commands/product-build.md +13 -0
  10. package/commands/product-dev.md +21 -0
  11. package/commands/product-full.md +13 -0
  12. package/commands/product-prd.md +14 -0
  13. package/commands/product-quick.md +13 -0
  14. package/commands/product-report.md +12 -0
  15. package/commands/product-revision.md +13 -0
  16. package/i18n/en/SKILL.md +245 -0
  17. package/i18n/en/commands/product-build.md +13 -0
  18. package/i18n/en/commands/product-dev.md +21 -0
  19. package/i18n/en/commands/product-full.md +13 -0
  20. package/i18n/en/commands/product-prd.md +14 -0
  21. package/i18n/en/commands/product-quick.md +13 -0
  22. package/i18n/en/commands/product-report.md +12 -0
  23. package/i18n/en/commands/product-revision.md +13 -0
  24. package/i18n/en/references/00-opportunity-check.md +44 -0
  25. package/i18n/en/references/01-strategy.md +90 -0
  26. package/i18n/en/references/02a-persona.md +57 -0
  27. package/i18n/en/references/02b-jtbd.md +125 -0
  28. package/i18n/en/references/02c-ost-journey.md +65 -0
  29. package/i18n/en/references/03-define.md +118 -0
  30. package/i18n/en/references/04a-prfaq.md +112 -0
  31. package/i18n/en/references/04b-solutions.md +269 -0
  32. package/i18n/en/references/04c-mvp.md +21 -0
  33. package/i18n/en/references/05a-northstar-aha.md +93 -0
  34. package/i18n/en/references/05b-pmf-gtm.md +102 -0
  35. package/i18n/en/references/05c-validation-spec.md +117 -0
  36. package/i18n/en/references/06-html-report.md +128 -0
  37. package/i18n/en/references/07a-handoff-core.md +152 -0
  38. package/i18n/en/references/07b-tasks-tickets.md +215 -0
  39. package/i18n/en/references/07c-architecture-setup.md +197 -0
  40. package/i18n/en/references/08-security-checklist.md +221 -0
  41. package/i18n/en/references/rules-build.md +152 -0
  42. package/i18n/en/references/rules-change-propagation.md +74 -0
  43. package/i18n/en/references/rules-commands.md +98 -0
  44. package/i18n/en/references/rules-context.md +291 -0
  45. package/i18n/en/references/rules-custom.md +63 -0
  46. package/i18n/en/references/rules-document-tools.md +126 -0
  47. package/i18n/en/references/rules-end-of-flow.md +150 -0
  48. package/i18n/en/references/rules-export-document.md +346 -0
  49. package/i18n/en/references/rules-file-integration.md +65 -0
  50. package/i18n/en/references/rules-full.md +66 -0
  51. package/i18n/en/references/rules-import-document.md +261 -0
  52. package/i18n/en/references/rules-product-type.md +14 -0
  53. package/i18n/en/references/rules-progress.md +60 -0
  54. package/i18n/en/references/rules-quick.md +29 -0
  55. package/i18n/en/references/rules-revision.md +64 -0
  56. package/i18n/es/SKILL.md +245 -0
  57. package/i18n/es/commands/product-build.md +13 -0
  58. package/i18n/es/commands/product-dev.md +21 -0
  59. package/i18n/es/commands/product-full.md +13 -0
  60. package/i18n/es/commands/product-prd.md +14 -0
  61. package/i18n/es/commands/product-quick.md +13 -0
  62. package/i18n/es/commands/product-report.md +12 -0
  63. package/i18n/es/commands/product-revision.md +13 -0
  64. package/i18n/es/references/00-opportunity-check.md +44 -0
  65. package/i18n/es/references/01-strategy.md +90 -0
  66. package/i18n/es/references/02a-persona.md +57 -0
  67. package/i18n/es/references/02b-jtbd.md +125 -0
  68. package/i18n/es/references/02c-ost-journey.md +65 -0
  69. package/i18n/es/references/03-define.md +118 -0
  70. package/i18n/es/references/04a-prfaq.md +114 -0
  71. package/i18n/es/references/04b-solutions.md +269 -0
  72. package/i18n/es/references/04c-mvp.md +21 -0
  73. package/i18n/es/references/05a-northstar-aha.md +93 -0
  74. package/i18n/es/references/05b-pmf-gtm.md +102 -0
  75. package/i18n/es/references/05c-validation-spec.md +117 -0
  76. package/i18n/es/references/06-html-report.md +138 -0
  77. package/i18n/es/references/07a-handoff-core.md +152 -0
  78. package/i18n/es/references/07b-tasks-tickets.md +215 -0
  79. package/i18n/es/references/07c-architecture-setup.md +197 -0
  80. package/i18n/es/references/08-security-checklist.md +221 -0
  81. package/i18n/es/references/rules-build.md +152 -0
  82. package/i18n/es/references/rules-change-propagation.md +74 -0
  83. package/i18n/es/references/rules-commands.md +98 -0
  84. package/i18n/es/references/rules-context.md +291 -0
  85. package/i18n/es/references/rules-custom.md +63 -0
  86. package/i18n/es/references/rules-document-tools.md +126 -0
  87. package/i18n/es/references/rules-end-of-flow.md +150 -0
  88. package/i18n/es/references/rules-export-document.md +346 -0
  89. package/i18n/es/references/rules-file-integration.md +65 -0
  90. package/i18n/es/references/rules-full.md +66 -0
  91. package/i18n/es/references/rules-import-document.md +261 -0
  92. package/i18n/es/references/rules-product-type.md +14 -0
  93. package/i18n/es/references/rules-progress.md +60 -0
  94. package/i18n/es/references/rules-quick.md +29 -0
  95. package/i18n/es/references/rules-revision.md +64 -0
  96. package/i18n/ja/SKILL.md +245 -0
  97. package/i18n/ja/commands/product-build.md +13 -0
  98. package/i18n/ja/commands/product-dev.md +21 -0
  99. package/i18n/ja/commands/product-full.md +13 -0
  100. package/i18n/ja/commands/product-prd.md +14 -0
  101. package/i18n/ja/commands/product-quick.md +13 -0
  102. package/i18n/ja/commands/product-report.md +12 -0
  103. package/i18n/ja/commands/product-revision.md +13 -0
  104. package/i18n/ja/references/00-opportunity-check.md +44 -0
  105. package/i18n/ja/references/01-strategy.md +90 -0
  106. package/i18n/ja/references/02a-persona.md +57 -0
  107. package/i18n/ja/references/02b-jtbd.md +125 -0
  108. package/i18n/ja/references/02c-ost-journey.md +65 -0
  109. package/i18n/ja/references/03-define.md +118 -0
  110. package/i18n/ja/references/04a-prfaq.md +111 -0
  111. package/i18n/ja/references/04b-solutions.md +269 -0
  112. package/i18n/ja/references/04c-mvp.md +21 -0
  113. package/i18n/ja/references/05a-northstar-aha.md +93 -0
  114. package/i18n/ja/references/05b-pmf-gtm.md +102 -0
  115. package/i18n/ja/references/05c-validation-spec.md +117 -0
  116. package/i18n/ja/references/06-html-report.md +126 -0
  117. package/i18n/ja/references/07a-handoff-core.md +152 -0
  118. package/i18n/ja/references/07b-tasks-tickets.md +215 -0
  119. package/i18n/ja/references/07c-architecture-setup.md +197 -0
  120. package/i18n/ja/references/08-security-checklist.md +221 -0
  121. package/i18n/ja/references/rules-build.md +152 -0
  122. package/i18n/ja/references/rules-change-propagation.md +74 -0
  123. package/i18n/ja/references/rules-commands.md +98 -0
  124. package/i18n/ja/references/rules-context.md +291 -0
  125. package/i18n/ja/references/rules-custom.md +63 -0
  126. package/i18n/ja/references/rules-document-tools.md +126 -0
  127. package/i18n/ja/references/rules-end-of-flow.md +150 -0
  128. package/i18n/ja/references/rules-export-document.md +346 -0
  129. package/i18n/ja/references/rules-file-integration.md +65 -0
  130. package/i18n/ja/references/rules-full.md +66 -0
  131. package/i18n/ja/references/rules-import-document.md +261 -0
  132. package/i18n/ja/references/rules-product-type.md +14 -0
  133. package/i18n/ja/references/rules-progress.md +60 -0
  134. package/i18n/ja/references/rules-quick.md +29 -0
  135. package/i18n/ja/references/rules-revision.md +64 -0
  136. package/i18n/ko/SKILL.md +245 -0
  137. package/i18n/ko/commands/product-build.md +13 -0
  138. package/i18n/ko/commands/product-dev.md +21 -0
  139. package/i18n/ko/commands/product-full.md +13 -0
  140. package/i18n/ko/commands/product-prd.md +14 -0
  141. package/i18n/ko/commands/product-quick.md +13 -0
  142. package/i18n/ko/commands/product-report.md +12 -0
  143. package/i18n/ko/commands/product-revision.md +13 -0
  144. package/i18n/ko/references/00-opportunity-check.md +44 -0
  145. package/i18n/ko/references/01-strategy.md +90 -0
  146. package/i18n/ko/references/02a-persona.md +57 -0
  147. package/i18n/ko/references/02b-jtbd.md +125 -0
  148. package/i18n/ko/references/02c-ost-journey.md +65 -0
  149. package/i18n/ko/references/03-define.md +118 -0
  150. package/i18n/ko/references/04a-prfaq.md +112 -0
  151. package/i18n/ko/references/04b-solutions.md +269 -0
  152. package/i18n/ko/references/04c-mvp.md +21 -0
  153. package/i18n/ko/references/05a-northstar-aha.md +93 -0
  154. package/i18n/ko/references/05b-pmf-gtm.md +102 -0
  155. package/i18n/ko/references/05c-validation-spec.md +117 -0
  156. package/i18n/ko/references/06-html-report.md +126 -0
  157. package/i18n/ko/references/07a-handoff-core.md +152 -0
  158. package/i18n/ko/references/07b-tasks-tickets.md +215 -0
  159. package/i18n/ko/references/07c-architecture-setup.md +197 -0
  160. package/i18n/ko/references/08-security-checklist.md +221 -0
  161. package/i18n/ko/references/rules-build.md +152 -0
  162. package/i18n/ko/references/rules-change-propagation.md +74 -0
  163. package/i18n/ko/references/rules-commands.md +98 -0
  164. package/i18n/ko/references/rules-context.md +291 -0
  165. package/i18n/ko/references/rules-custom.md +63 -0
  166. package/i18n/ko/references/rules-document-tools.md +126 -0
  167. package/i18n/ko/references/rules-end-of-flow.md +150 -0
  168. package/i18n/ko/references/rules-export-document.md +346 -0
  169. package/i18n/ko/references/rules-file-integration.md +65 -0
  170. package/i18n/ko/references/rules-full.md +66 -0
  171. package/i18n/ko/references/rules-import-document.md +261 -0
  172. package/i18n/ko/references/rules-product-type.md +14 -0
  173. package/i18n/ko/references/rules-progress.md +60 -0
  174. package/i18n/ko/references/rules-quick.md +29 -0
  175. package/i18n/ko/references/rules-revision.md +64 -0
  176. package/i18n/zh-CN/SKILL.md +245 -0
  177. package/i18n/zh-CN/commands/product-build.md +13 -0
  178. package/i18n/zh-CN/commands/product-dev.md +21 -0
  179. package/i18n/zh-CN/commands/product-full.md +13 -0
  180. package/i18n/zh-CN/commands/product-prd.md +14 -0
  181. package/i18n/zh-CN/commands/product-quick.md +13 -0
  182. package/i18n/zh-CN/commands/product-report.md +12 -0
  183. package/i18n/zh-CN/commands/product-revision.md +13 -0
  184. package/i18n/zh-CN/references/00-opportunity-check.md +44 -0
  185. package/i18n/zh-CN/references/01-strategy.md +90 -0
  186. package/i18n/zh-CN/references/02a-persona.md +57 -0
  187. package/i18n/zh-CN/references/02b-jtbd.md +125 -0
  188. package/i18n/zh-CN/references/02c-ost-journey.md +65 -0
  189. package/i18n/zh-CN/references/03-define.md +118 -0
  190. package/i18n/zh-CN/references/04a-prfaq.md +106 -0
  191. package/i18n/zh-CN/references/04b-solutions.md +269 -0
  192. package/i18n/zh-CN/references/04c-mvp.md +21 -0
  193. package/i18n/zh-CN/references/05a-northstar-aha.md +93 -0
  194. package/i18n/zh-CN/references/05b-pmf-gtm.md +102 -0
  195. package/i18n/zh-CN/references/05c-validation-spec.md +117 -0
  196. package/i18n/zh-CN/references/06-html-report.md +123 -0
  197. package/i18n/zh-CN/references/07a-handoff-core.md +152 -0
  198. package/i18n/zh-CN/references/07b-tasks-tickets.md +215 -0
  199. package/i18n/zh-CN/references/07c-architecture-setup.md +197 -0
  200. package/i18n/zh-CN/references/08-security-checklist.md +221 -0
  201. package/i18n/zh-CN/references/rules-build.md +152 -0
  202. package/i18n/zh-CN/references/rules-change-propagation.md +74 -0
  203. package/i18n/zh-CN/references/rules-commands.md +98 -0
  204. package/i18n/zh-CN/references/rules-context.md +291 -0
  205. package/i18n/zh-CN/references/rules-custom.md +63 -0
  206. package/i18n/zh-CN/references/rules-document-tools.md +126 -0
  207. package/i18n/zh-CN/references/rules-end-of-flow.md +150 -0
  208. package/i18n/zh-CN/references/rules-export-document.md +346 -0
  209. package/i18n/zh-CN/references/rules-file-integration.md +65 -0
  210. package/i18n/zh-CN/references/rules-full.md +66 -0
  211. package/i18n/zh-CN/references/rules-import-document.md +261 -0
  212. package/i18n/zh-CN/references/rules-product-type.md +14 -0
  213. package/i18n/zh-CN/references/rules-progress.md +60 -0
  214. package/i18n/zh-CN/references/rules-quick.md +29 -0
  215. package/i18n/zh-CN/references/rules-revision.md +64 -0
  216. package/i18n/zh-TW/SKILL.md +244 -0
  217. package/i18n/zh-TW/commands/product-build.md +13 -0
  218. package/i18n/zh-TW/commands/product-dev.md +21 -0
  219. package/i18n/zh-TW/commands/product-full.md +13 -0
  220. package/i18n/zh-TW/commands/product-prd.md +14 -0
  221. package/i18n/zh-TW/commands/product-quick.md +13 -0
  222. package/i18n/zh-TW/commands/product-report.md +12 -0
  223. package/i18n/zh-TW/commands/product-revision.md +13 -0
  224. package/i18n/zh-TW/references/00-opportunity-check.md +44 -0
  225. package/i18n/zh-TW/references/01-strategy.md +90 -0
  226. package/i18n/zh-TW/references/02a-persona.md +57 -0
  227. package/i18n/zh-TW/references/02b-jtbd.md +125 -0
  228. package/i18n/zh-TW/references/02c-ost-journey.md +65 -0
  229. package/i18n/zh-TW/references/03-define.md +118 -0
  230. package/i18n/zh-TW/references/04a-prfaq.md +106 -0
  231. package/i18n/zh-TW/references/04b-solutions.md +269 -0
  232. package/i18n/zh-TW/references/04c-mvp.md +21 -0
  233. package/i18n/zh-TW/references/05a-northstar-aha.md +93 -0
  234. package/i18n/zh-TW/references/05b-pmf-gtm.md +102 -0
  235. package/i18n/zh-TW/references/05c-validation-spec.md +117 -0
  236. package/i18n/zh-TW/references/06-html-report.md +123 -0
  237. package/i18n/zh-TW/references/07a-handoff-core.md +152 -0
  238. package/i18n/zh-TW/references/07b-tasks-tickets.md +215 -0
  239. package/i18n/zh-TW/references/07c-architecture-setup.md +197 -0
  240. package/i18n/zh-TW/references/08-security-checklist.md +221 -0
  241. package/i18n/zh-TW/references/rules-build.md +152 -0
  242. package/i18n/zh-TW/references/rules-change-propagation.md +74 -0
  243. package/i18n/zh-TW/references/rules-commands.md +98 -0
  244. package/i18n/zh-TW/references/rules-context.md +291 -0
  245. package/i18n/zh-TW/references/rules-custom.md +63 -0
  246. package/i18n/zh-TW/references/rules-document-tools.md +126 -0
  247. package/i18n/zh-TW/references/rules-end-of-flow.md +150 -0
  248. package/i18n/zh-TW/references/rules-export-document.md +346 -0
  249. package/i18n/zh-TW/references/rules-file-integration.md +65 -0
  250. package/i18n/zh-TW/references/rules-full.md +66 -0
  251. package/i18n/zh-TW/references/rules-import-document.md +261 -0
  252. package/i18n/zh-TW/references/rules-product-type.md +14 -0
  253. package/i18n/zh-TW/references/rules-progress.md +60 -0
  254. package/i18n/zh-TW/references/rules-quick.md +29 -0
  255. package/i18n/zh-TW/references/rules-revision.md +64 -0
  256. package/install.sh +418 -0
  257. package/package.json +41 -0
  258. package/references/00-opportunity-check.md +44 -0
  259. package/references/01-strategy.md +90 -0
  260. package/references/02a-persona.md +57 -0
  261. package/references/02b-jtbd.md +125 -0
  262. package/references/02c-ost-journey.md +65 -0
  263. package/references/03-define.md +118 -0
  264. package/references/04a-prfaq.md +106 -0
  265. package/references/04b-solutions.md +269 -0
  266. package/references/04c-mvp.md +21 -0
  267. package/references/05a-northstar-aha.md +93 -0
  268. package/references/05b-pmf-gtm.md +102 -0
  269. package/references/05c-validation-spec.md +117 -0
  270. package/references/06-html-report.md +123 -0
  271. package/references/07a-handoff-core.md +152 -0
  272. package/references/07b-tasks-tickets.md +215 -0
  273. package/references/07c-architecture-setup.md +197 -0
  274. package/references/08-security-checklist.md +221 -0
  275. package/references/rules-build.md +152 -0
  276. package/references/rules-change-propagation.md +74 -0
  277. package/references/rules-commands.md +98 -0
  278. package/references/rules-context.md +291 -0
  279. package/references/rules-custom.md +63 -0
  280. package/references/rules-document-tools.md +126 -0
  281. package/references/rules-end-of-flow.md +150 -0
  282. package/references/rules-export-document.md +346 -0
  283. package/references/rules-file-integration.md +65 -0
  284. package/references/rules-full.md +66 -0
  285. package/references/rules-import-document.md +261 -0
  286. package/references/rules-product-type.md +14 -0
  287. package/references/rules-progress.md +60 -0
  288. package/references/rules-quick.md +29 -0
  289. package/references/rules-revision.md +64 -0
  290. package/references/templates/prd-style.css +464 -0
  291. package/references/templates/report-style.css +114 -0
@@ -0,0 +1,112 @@
1
+ # Phase 3: Develop — PR-FAQ (Working Backwards)
2
+
3
+ ## 3.1 Amazon's Working Backwards Method (PR-FAQ)
4
+
5
+ Start by writing the product press release — it forces you to work backwards from the customer outcome:
6
+
7
+ ```
8
+ ## [Product Name] Press Release
9
+
10
+ **Headline**: [What can the user achieve? One sentence.]
11
+ **Subheadline**: [What problem does it solve, and for whom?]
12
+
13
+ **Opening Paragraph (Aha Moment)**:
14
+ [Describe the moment the user experiences the product's core value — the "Wow!" moment]
15
+
16
+ **Pain Point Description**:
17
+ [What problem are users facing today? Why aren't current solutions good enough?]
18
+
19
+ **Solution Description**:
20
+ [How does our product solve this problem? (Describe the experience — don't list features)]
21
+
22
+ **Customer Quote**:
23
+ "[A quote from a target user that represents a genuine emotional reaction]"
24
+
25
+ **FAQ (The Hardest Questions)**:
26
+ Q: [The hardest question to answer]
27
+ A: [An honest answer]
28
+ ```
29
+
30
+ > If you can't write a press release that excites people, the product direction may be flawed — go back and redefine the problem.
31
+
32
+ ### 📝 PR-FAQ Quality Checklist
33
+
34
+ Claude must mark each item ✅ or ❌ after producing the PR-FAQ; ❌ items must include how to improve:
35
+ - [ ] Is the headline written from the user's perspective? ("Users can now do X" vs. "We launched feature Y")
36
+ - [ ] Can a reader understand "why this matters" within 10 seconds of reading the first paragraph?
37
+ - [ ] Does the pain point description come from a real user scenario?
38
+ - [ ] Does the first sentence of the solution section lead with the user's experience/scenario (not a feature verb)?
39
+ - [ ] Does the customer quote sound like something a real person would say?
40
+ - [ ] Does the FAQ include a pointed comparison against existing tools?
41
+
42
+ **Execution Rules (Hard Gate):**
43
+ - Must identify at least 1 "internal tension" or "area worth iterating on" — cannot mark all ✅ and call it done
44
+ - If all items pass, additionally state "What is the most fragile assumption in this PR-FAQ?"
45
+ - The quality bar for Amazon's PR-FAQ comes from finding problems, not confirming there are none
46
+ - ❌ Common issues: headline reads like a product announcement instead of news, solution section turns into a feature list, FAQs are all softball questions
47
+
48
+ ---
49
+
50
+ ### ✍️ Solution Section (Body) Writing Rules
51
+
52
+ **The first sentence of the solution section must NOT start with a feature description.**
53
+
54
+ ❌ Prohibited examples:
55
+ - "MealPrep lets you input a menu with one click and auto-calculates ingredients"
56
+ - "The system automatically generates a procurement list based on the menu"
57
+ - "Click the 'Generate List' button to complete your prep planning"
58
+
59
+ ✅ Correct examples:
60
+ - "Now, Chef Chen only needs 10 minutes on Friday afternoon to confirm every detail for the weekend's prep"
61
+ - "Manager Zhang no longer has to flip through three Excel sheets to figure out whether there's enough inventory"
62
+
63
+ **Formula**: Lead with the user's experience / specific scenario → then say "This is possible because [product mechanism]" to introduce the feature.
64
+
65
+ ---
66
+
67
+ ### ❓ FAQ Sharp-Question Standard
68
+
69
+ **At least 1 FAQ must be: "Why not just keep using [existing tool]?"**
70
+
71
+ Answer format requirements:
72
+ 1. **First, acknowledge the strengths of the existing tool** (don't dismiss it)
73
+ 2. **Then explain the gap** (not a feature gap, but a fundamental scenario gap)
74
+
75
+ ❌ Prohibited answer pattern: "Existing tools lack features — ours is more powerful"
76
+ ✅ Correct answer pattern:
77
+ > "Excel can absolutely track numbers, and chefs already know how to use it. The issue is that every weekend the calculations need to be rebuilt — re-entered, re-converted — and the hour it takes isn't because anyone's bad at spreadsheets, it's because the problem really is that complex. MealPrep doesn't save you Excel skills — it saves you the mental burden of starting from scratch every single time."
78
+
79
+ **Example (fictional product — Mortgage Calculator App):**
80
+
81
+ ```
82
+ ## MortgageSnap Helps First-Time Buyers Understand What They Can Afford in 3 Minutes
83
+
84
+ **Subheadline**: No bank visits, no waiting for rate quotes — figure out your monthly payments with your partner, even at midnight
85
+
86
+ **Opening Paragraph (Aha Moment)**:
87
+ After scrolling through Zillow late at night, Alex spots a house he loves but has no idea if he can
88
+ actually afford it. He opens MortgageSnap, screenshots the listing page, and the app automatically
89
+ extracts the price and square footage. Within 30 seconds, it shows monthly payments across three
90
+ loan scenarios. He shares the results with his wife, and for the first time, they're looking at the
91
+ same numbers together.
92
+
93
+ **Pain Point Description**:
94
+ First-time homebuyers comparing mortgage options have to manually enter terms across multiple bank
95
+ websites and wait for responses. When you want to run the numbers late at night, there's no
96
+ convenient tool — so people end up hacking together an Excel sheet or just giving up.
97
+
98
+ **Solution Description**:
99
+ MortgageSnap lets you snap any property listing, automatically extracts key data, instantly compares
100
+ options across lenders, and generates a shareable report so your family can discuss together.
101
+
102
+ **Customer Quote**:
103
+ "I finally don't have to wait for the bank to call back at midnight. Three minutes and I can tell
104
+ my wife exactly how much we'd pay each month."
105
+
106
+ **FAQ**:
107
+ Q: There are already tons of mortgage calculators out there — what's different?
108
+ A: Existing calculators require you to input interest rates, loan terms, and other parameters, but
109
+ most first-time buyers don't even know those numbers. MortgageSnap's difference is that it
110
+ automatically pulls in real offers from various lenders — all you need to provide is the price and
111
+ your down payment.
112
+ ```
@@ -0,0 +1,269 @@
1
+ # Stage 3: Develop — Solution Design & Prioritization
2
+
3
+ ## 3.2 Parallel Prototyping Principle
4
+
5
+ Develop multiple parallel approaches simultaneously — don't design a single solution and rush to execute:
6
+
7
+ ```
8
+ | HMW Question | Solution A (Conservative/Incremental) | Solution B (Balanced) | Solution C (Bold/Disruptive) |
9
+ |---|---|---|---|
10
+ | [HMW1] | | | |
11
+ ```
12
+
13
+ Three solution quality gates:
14
+ - Is Solution A clearly better than the current approach?
15
+ - Does Solution C actually solve the core JTBD?
16
+ - Are the three solutions genuinely different, or just variations of the same idea?
17
+
18
+ ## 3.3 Shreyas Doshi's Pre-mortem
19
+
20
+ **Applicable: Medium/high completeness / audience is engineers/internal planning**
21
+
22
+ Before committing to a solution, assume it has already failed:
23
+
24
+ ```
25
+ Assume: We chose Solution X and declared failure after [time period]. Why did it fail?
26
+
27
+ | Failure Reason | Likelihood (High/Med/Low) | Preventability (High/Med/Low) | Preventive Measure |
28
+ |----------------|--------------------------|-------------------------------|-------------------|
29
+ | | | | |
30
+ ```
31
+
32
+ **Security failure scenarios** (must consider at least one, especially for products handling user data):
33
+
34
+ ```
35
+ | Security Risk | Likelihood | Preventability | Preventive Measure |
36
+ |---------------|-----------|----------------|-------------------|
37
+ | User data breach (database intrusion, unauthorized API access) | | | |
38
+ | Mass account takeover (brute force, credential stuffing) | | | |
39
+ | API abuse (no rate limiting, mass scraping) | | | |
40
+ | XSS / CSRF attacks harming users | | | |
41
+ | Accidental exposure of sensitive data (secrets in version control, passwords in logs) | | | |
42
+ ```
43
+
44
+ > If the product doesn't involve user authentication or sensitive data, mark as "Not applicable" and explain why.
45
+
46
+ ## 3.4 Gibson Biddle's GEM Prioritization Model (Netflix)
47
+
48
+ ```
49
+ | Feature | G (Growth) | E (Engagement) | M (Monetization) | Overall Priority |
50
+ |---------|-----------|----------------|------------------|-----------------|
51
+ | | | | | |
52
+ ```
53
+
54
+ **Impact / Effort Matrix:**
55
+
56
+ ```
57
+ | Feature / Solution | Impact (High/Med/Low) | Effort Required (High/Med/Low) | Quadrant |
58
+ |---|---|---|---|
59
+ | | | | Quick Win / Strategic / Fill-in / Avoid |
60
+ ```
61
+
62
+ ## 3.5 RICE Quantitative Prioritization
63
+
64
+ **Applicable: High completeness / audience is data scientists/executives**
65
+
66
+ ```
67
+ RICE Score = (Reach × Impact × Confidence) / Effort
68
+
69
+ | Feature | Reach (users impacted/mo) | Impact (0.25/0.5/1/2/3) | Confidence (%) | Effort (person-months) | RICE Score |
70
+ |---------|--------------------------|------------------------|----------------|----------------------|------------|
71
+ | | | | | | |
72
+ ```
73
+
74
+ **Impact Scale Definitions:**
75
+ | Score | Level | Criteria |
76
+ |-------|-------|----------|
77
+ | 3 | Massive | Fundamentally changes the user experience; directly solves the core JTBD |
78
+ | 2 | High | Significantly improves user experience; clear positive impact on the North Star Metric |
79
+ | 1 | Medium | Noticeable improvement; helpful for some users or some scenarios |
80
+ | 0.5 | Low | Minor improvement; nice-to-have |
81
+ | 0.25 | Minimal | Barely noticeable difference; maintenance-level work |
82
+
83
+ **Confidence Judgment Reference:**
84
+ - 100%: Supported by quantitative data (A/B tests, user data)
85
+ - 80%: Supported by qualitative data (user interviews, competitive validation)
86
+ - 50%: Reasonable hypothesis but unvalidated
87
+ - 20%: Pure intuition or guesswork
88
+
89
+ > "Don't prioritize features — prioritize problems. Features are solutions, and they only matter after you've confirmed the priority of the problems." — Shreyas Doshi
90
+
91
+ ## 3.6 User Story Table
92
+
93
+ **Applicable: Audience is engineers**
94
+
95
+ ```
96
+ | # | User Story | Acceptance Criteria | Priority |
97
+ |---|---|---|---|
98
+ | US1 | As a [Persona], I want to [action], so that [value] | | |
99
+ ```
100
+
101
+ ---
102
+
103
+ ## 📄 PRD Output Format (Used when the audience is engineers)
104
+
105
+ When the user says "produce a PRD" or "produce a document for engineers," consolidate all relevant preceding steps and produce the following complete format:
106
+
107
+ ```
108
+ # [Product Name] Product Requirements Document
109
+
110
+ **Version**: v[X.X] **Date**: [Date] **Author**: [PM Name]
111
+ **Status**: Draft / Under Review / Approved
112
+
113
+ ---
114
+
115
+ ## 1. Background & Objectives
116
+
117
+ **Problem Statement**: [Transformed from HMW question — one paragraph explaining what problem is solved for whom]
118
+ **Target Persona**: [Which Persona]
119
+ **Core JTBD**: [Target Customer] + wants to [Job] + in the context of [Job Context]
120
+ **Success Metrics**: [North Star Metric + Hero Metric]
121
+
122
+ ---
123
+
124
+ ## 2. Solution Overview (from PR-FAQ)
125
+
126
+ **Product One-liner**: [PR-FAQ headline]
127
+ **Aha Moment**: When the user completes [action], they experience the core value
128
+ **Product Positioning**: [April Dunford positioning summary, if completed]
129
+
130
+ ---
131
+
132
+ ## 3. Feature Scope
133
+
134
+ ### MVP Must-Haves
135
+ | Feature | Description | Priority | Notes |
136
+ |---------|------------|----------|-------|
137
+ | | | P0 | |
138
+
139
+ ### V2 Additions
140
+ | Feature | Description | Priority | Notes |
141
+ |---------|------------|----------|-------|
142
+ | | | P1 | |
143
+
144
+ ### Explicitly Not Doing (Not Doing List)
145
+ | Not Doing | Reason |
146
+ |-----------|--------|
147
+ | | |
148
+
149
+ ---
150
+
151
+ ## 4. User Stories
152
+
153
+ | # | As a... | I want to... | So that... | Acceptance Criteria | Priority |
154
+ |---|---------|-------------|------------|---------------------|----------|
155
+ | US-001 | [Persona] | [Action] | [Value] | - [ ] Condition 1 | P0 |
156
+
157
+ ---
158
+
159
+ ## 5. Feature Specifications
160
+
161
+ > For each P0 feature, document the following:
162
+
163
+ ### [Feature Name]
164
+ - **Description**: [What this feature does]
165
+ - **Trigger Condition**: [When it's triggered]
166
+ - **Happy Path**: [Step 1 → 2 → 3]
167
+ - **Edge Cases**: [Error scenarios, boundary conditions]
168
+ - **Acceptance Criteria**:
169
+ - [ ] [Specific testable condition]
170
+ - [ ] [Specific testable condition]
171
+
172
+ ---
173
+
174
+ ## 6. Technical Considerations
175
+
176
+ **Known Technical Constraints**: [Constraints engineers need to know]
177
+ **Dependencies**: [Third-party services, APIs, prerequisites from other features]
178
+ **Performance Requirements**: [Load times, concurrency, etc., if applicable]
179
+ **Security Requirements**: [Data protection, permissions, etc., if applicable]
180
+
181
+ ---
182
+
183
+ ## 7. Risks & Assumptions (from Pre-mortem)
184
+
185
+ | Risk | Likelihood | Impact | Preventive Measure |
186
+ |------|-----------|--------|-------------------|
187
+ | | High/Med/Low | High/Med/Low | |
188
+
189
+ **Core Assumptions**: [Assumptions that need validation — if proven wrong, the direction needs reassessment]
190
+
191
+ ---
192
+
193
+ ## 8. Milestones & Timeline
194
+
195
+ | Milestone | Target Date | Includes |
196
+ |-----------|------------|----------|
197
+ | Alpha | | [Minimum testable version] |
198
+ | Beta | | [Limited user testing] |
199
+ | Launch | | [Official release] |
200
+
201
+ ---
202
+
203
+ ## 9. Open Questions
204
+
205
+ | Question | Owner | Expected Resolution Date |
206
+ |----------|-------|------------------------|
207
+ | | | |
208
+ ```
209
+
210
+ ---
211
+
212
+ ## 🗂️ Development Artifacts (Triggered on demand)
213
+
214
+ ### Flowchart (Mermaid syntax)
215
+
216
+ When the user says "produce a flowchart," generate a Mermaid flowchart based on User Stories and feature specs:
217
+
218
+ ```mermaid
219
+ flowchart TD
220
+ A[User enters] --> B{Logged in?}
221
+ B -- Yes --> C[Show main screen]
222
+ B -- No --> D[Redirect to login]
223
+ C --> E[Complete core action]
224
+ E --> F[Reach Aha Moment]
225
+ ```
226
+
227
+ Include: Main user flow / Key decision branches / Error scenarios
228
+
229
+ ### DB Schema (Mermaid ERD syntax)
230
+
231
+ When the user says "produce a DB schema," generate a Mermaid erDiagram based on the MVP feature scope:
232
+
233
+ ```mermaid
234
+ erDiagram
235
+ USER {
236
+ int id PK
237
+ string name
238
+ string email
239
+ datetime created_at
240
+ }
241
+ PRODUCT {
242
+ int id PK
243
+ string name
244
+ int owner_id FK
245
+ }
246
+ USER ||--o{ PRODUCT : "owns"
247
+ ```
248
+
249
+ Include: Main entities / Relationships / Key fields (FKs, index recommendations)
250
+
251
+ ### UI Wireframe (HTML wireframe)
252
+
253
+ When the user says "produce a UI wireframe," output a low-fidelity wireframe in HTML + inline CSS, including:
254
+ - Core pages (determine page count based on User Stories)
255
+ - Grayscale color scheme, no brand colors
256
+ - Annotate each element's functional purpose
257
+ - Annotate where the Aha Moment occurs
258
+
259
+ ---
260
+
261
+ ## 📎 File Integration Tips for This Stage
262
+
263
+ | Uploaded Content | Integrate Into | Integration Action |
264
+ |-----------------|----------------|-------------------|
265
+ | Existing PRD / requirements doc | 3.7 MVP | Extract existing feature list as reference for MVP boundary decisions |
266
+ | Technical architecture doc | 3.5 RICE (Effort) | Use real technical complexity to assess Effort scores |
267
+ | Design mockups / wireframes | 3.2 Parallel Prototyping + UI Wireframe | Use as visual reference for solutions; identify existing vs. new design needs |
268
+ | Engineering estimation doc | 3.5 RICE + 3.7 MVP | Replace assumed Effort with real estimates; adjust MVP scope |
269
+ | Past version postmortems | 3.3 Pre-mortem | Supplement risk list with historical failure lessons |
@@ -0,0 +1,21 @@
1
+ # Stage 3: Develop — MVP Scope Definition
2
+
3
+ ## 3.7 MVP Scope Definition
4
+
5
+ MVP decision criteria: **Can it validate the core hypothesis? Can it let target users fully experience the Primary JTBD?**
6
+
7
+ ```
8
+ | Category | MVP Must-Have | Add in V2 | Future Consideration |
9
+ |---|---|---|---|
10
+ | Core Features | | | |
11
+ | User Experience | | | |
12
+ | Technical Requirements | | | |
13
+ ```
14
+
15
+ **Not Doing List (Equally important):**
16
+
17
+ ```
18
+ | Not Doing | Reason |
19
+ |-----------|--------|
20
+ | | |
21
+ ```
@@ -0,0 +1,93 @@
1
+ # Phase 4: Deliver — North Star + Aha Moment
2
+
3
+ ## 4.1 Marty Cagan's Empowered Teams Principles
4
+
5
+ **Applicable when: high completeness / deliverable audience is leadership or cross-functional teams**
6
+
7
+ > 4.1 Empowered Teams is only shown when the deliverable audience is leadership or cross-functional teams; otherwise skip.
8
+
9
+ ```
10
+ | Dimension | Feature Team (Avoid) | Empowered Team (Goal) |
11
+ |-----------|---------------------|----------------------|
12
+ | Assigned | Feature list (Output) | Problem to solve (Outcome) |
13
+ | Success defined as | Delivering features on time | Achieving user and business metrics |
14
+ | PM's role | Requirements gatherer and project manager | Problem explorer and solution validator |
15
+ | Engineers' role | Execute specs | Participate in problem exploration and solution design |
16
+ ```
17
+
18
+ > "True product discovery is done **together** with engineers and designers, not by the PM alone handing off completed work." — Marty Cagan
19
+
20
+ **Lenny's Three PM Responsibilities:**
21
+ - **Shape**: Synthesize user insights, data, and market intelligence to decide what to build
22
+ - **Ship**: Ensure a high-quality product launches on time, with no surprises
23
+ - **Synchronize**: Keep all stakeholders aligned on vision, strategy, goals, and roadmap
24
+
25
+ ## 4.2 Success Metrics Framework (North Star + Three-Layer Signals)
26
+
27
+ A North Star metric must satisfy:
28
+ - Reflects the real value users receive (not a vanity metric)
29
+ - Can grow continuously (doesn't hit a natural ceiling)
30
+ - Aligns the entire team around a single objective
31
+
32
+ ```
33
+ | Company | North Star Metric | Why This Metric |
34
+ |---------|-------------------|-----------------|
35
+ | Airbnb | Nights booked | Represents value delivered to both hosts and guests |
36
+ | Spotify | Monthly listening hours | Represents users genuinely using and enjoying music |
37
+ | Facebook | DAU / MAU ratio | Represents habitual return visits |
38
+ | Slack | Messages sent per week | Represents teams genuinely collaborating |
39
+ | Salesforce | Active customer ACV (Annual Contract Value) | Represents customers continuously deriving business value (B2B) |
40
+ ```
41
+
42
+ **Your North Star Metric:**
43
+ ```
44
+ North Star Metric: [A single number representing the core value created for users and the product]
45
+ Definition: [Precise calculation method]
46
+ Why this metric: [Explain why it represents real user value, not just a business outcome]
47
+ ```
48
+
49
+ ### 📝 North Star Quality Checklist
50
+ - ✅ Does it reflect the value users receive? (Not revenue, not DAU)
51
+ - ✅ Can it grow continuously? (Doesn't hit a natural ceiling)
52
+ - ✅ Does everyone on the team know what to do when they see this metric?
53
+ - ✅ Can it be gamed? (If yes, guardrail metrics are needed)
54
+ - ✅ B2B products: Does it reflect value at the organizational level, not just individual users?
55
+ - ❌ Common issues: using revenue as the North Star (revenue is an outcome, not a driver), metric is too composite to act on
56
+
57
+ **Three-Layer Signal System (must be achieved in order):**
58
+
59
+ ```
60
+ | Layer | Metric Type | Definition | B2C Target | B2B Target |
61
+ |---|---|---|---|---|
62
+ | Layer 1 (Prerequisite) | Core Action Success Rate | Did the user complete the product's core action? | 30–40%+ | 60–80%+ (users are more motivated) |
63
+ | Layer 2 (Value Proxy) | D14 / D28 Retention Rate | Do users keep coming back? | Consumer products 15–20%+ | Logo retention 90%+; Net Revenue Retention 100%+ |
64
+ | Layer 3 (Passion Signal) | Sean Ellis Score | "If you could no longer use this product, how disappointed would you be?" | 40%+ answer "very disappointed" | 40%+ answer "very disappointed" |
65
+ | Guardrail Metrics | Prevent over-optimization | Ensure other important dimensions aren't harmed | Depends on context | Depends on context |
66
+ ```
67
+
68
+ Note: Layer 1 is the prerequisite for Layer 2. If the core action success rate is very low, retention data is meaningless because users never had the chance to experience the product's value.
69
+
70
+ ## 4.4 Aha Moment Design
71
+
72
+ ```
73
+ Aha Moment Definition:
74
+ When a user completes [specific behavior], they have experienced this product's core value.
75
+ Goal: Get users to this moment within [X minutes / X steps] of entering the product.
76
+
77
+ Aha Moment Reach Rate: [target %]
78
+ Current Barriers: [What prevents users from reaching the Aha Moment faster?]
79
+ Improvement Plan: [How to remove the barriers?]
80
+ ```
81
+
82
+ **Examples:**
83
+ | Product | Aha Moment | Time Target |
84
+ |---------|-----------|-------------|
85
+ | Slack | Team sends its 2,000th message | First two weeks |
86
+ | Dropbox | First file synced to a second device | Within 10 minutes of first use |
87
+ | Zoom | First one-click join with smooth video | First use |
88
+
89
+ ### 📝 Aha Moment Quality Checklist
90
+ - ✅ Is it a specific, trackable behavior? (Not "feels like the product is useful")
91
+ - ✅ Is it directly tied to the JTBD's functional job?
92
+ - ✅ Is the time target reasonable? (B2C should be within first use; B2B may be within the trial period)
93
+ - ✅ Can onboarding be designed to help users reach it faster?
@@ -0,0 +1,102 @@
1
+ # Stage 4: Deliver — PMF + GTM + Business Model
2
+
3
+ ## 4.3 Todd Jackson's (First Round Capital) Four-Level PMF Framework
4
+
5
+ ```
6
+ | Level | Name | Characteristics | Your Task | Typical Company Stage |
7
+ |-------|------|----------------|-----------|----------------------|
8
+ | Level 1 | Nascent PMF | Found 3-5 customers willing to pay for the solution | Deeply serve these early users, find a repeatable pattern | Pre-seed / Seed |
9
+ | Level 2 | Developing PMF | Word-of-mouth starting, but growth is still unstable | Find a scalable acquisition channel, improve retention | Seed / Series A |
10
+ | Level 3 | Strong PMF | "Fish are jumping into the boat" — referrals become the main growth driver | Build scalable demand channels, improve efficiency metrics | Series A / B |
11
+ | Level 4 | Extreme PMF | Metrics are robust, company exceeds 100 people, considering TAM expansion | Enter new markets or launch new products | Series C+ |
12
+ ```
13
+
14
+ **Four P's (Key questions for finding PMF at Level 1-2):**
15
+ 1. Problem: Is the problem you're solving truly urgent and important enough?
16
+ 2. Promise: What promise does your product make to users? Do they believe it?
17
+ 3. Product: Does your product actually deliver on that promise?
18
+ 4. Pitch: How do you get target users to discover and believe in your product?
19
+
20
+ ## 4.7 GTM Strategy (Go-to-Market)
21
+
22
+ **Applicable: Full mode / high completeness / audience is executives/sales/marketing**
23
+
24
+ Once the product is built, how do you get target users to know about it and start using it?
25
+
26
+ ### Acquisition Channel Selection
27
+
28
+ ```
29
+ | Channel Type | Best For | Typical Methods | Key Metrics |
30
+ |-------------|----------|----------------|-------------|
31
+ | Product-Led Growth (PLG) | Products where users can self-serve to experience value | Free trial, Freemium, viral invite | Signup conversion, activation rate, invite rate |
32
+ | Content & Community | Target users share common information needs or community | Blog, SEO, community building, KOL | Traffic, content conversion rate, community engagement |
33
+ | Paid Acquisition | Need fast validation or clear ROI | SEM, social ads, retargeting | CAC, ROAS, LTV/CAC |
34
+ | Sales-Led | B2B high ACV, requires demo and negotiation | SDR, AE, Demo, enterprise contracts | Pipeline, close rate, ACV |
35
+ | Partnerships | Target users concentrated on specific platforms or ecosystems | API integration, revenue sharing, co-marketing | Partner channel conversion rate, partner count |
36
+ ```
37
+
38
+ ### First 100 Users Acquisition Plan
39
+
40
+ ```
41
+ Target user profile: [From Persona]
42
+ Where to find them: [Online/offline places where they gather]
43
+ What hook to attract them: [From PR-FAQ's Aha Moment]
44
+ How to get them to try: [Methods to lower the barrier]
45
+ Initial target: [X users trying the product within Y days]
46
+ ```
47
+
48
+ ### Launch Strategy
49
+
50
+ | Strategy | Description | Best For |
51
+ |----------|------------|----------|
52
+ | Closed Beta | Manually invite 10-50 people, collect deep feedback | PMF Level 1, product still being refined |
53
+ | Open Beta | Public but labeled Beta, managing expectations | PMF Level 1-2, need more data |
54
+ | Soft Launch | Low-key launch in a specific market or channel | Need real-world testing without full exposure |
55
+ | Full Launch | Full-channel official release | PMF Level 2-3, product is stable |
56
+
57
+ ## 4.8 Business Model & Pricing
58
+
59
+ **Applicable: Full mode / high completeness / audience is executives/sales**
60
+
61
+ ### Revenue Model Selection
62
+
63
+ ```
64
+ | Model | How It Works | Best For | Key Metrics |
65
+ |-------|-------------|----------|-------------|
66
+ | Freemium | Free basic tier + paid premium | Products with large user base, free tier demonstrates value | Free-to-paid conversion rate (target 2-5%) |
67
+ | Subscription | Monthly/annual subscription | Tools or services that provide ongoing value | MRR/ARR, churn rate |
68
+ | Usage-based | Pay for what you use | APIs, cloud services, transaction platforms | Average spend per user, usage growth rate |
69
+ | One-time purchase | Buy outright | Tool software, courses | Average order value, repurchase rate |
70
+ | Transaction fee | Percentage per transaction | Platforms, marketplaces | GMV, take rate |
71
+ | Per-seat | Charge per user | B2B collaboration tools | Average seats per account, expansion rate |
72
+ ```
73
+
74
+ ### Value-Based Pricing Alignment
75
+
76
+ ```
77
+ Core pricing questions:
78
+ 1. How much does your product save or earn for users? (Value anchor)
79
+ 2. How much do users currently pay for alternatives? (Competitive reference)
80
+ 3. Is your pricing proportional to the value users receive? (Fairness perception)
81
+
82
+ Pricing strategy:
83
+ - Model choice: [Freemium / Subscription / Usage-based / ...]
84
+ - Price range: [Based on value anchor and competitive reference]
85
+ - What the free tier includes: [Enough to reach the Aha Moment, but not enough for advanced needs]
86
+ - Paid trigger point: [What usage behavior or volume triggers an upgrade?]
87
+
88
+ ⚠️ Common pricing mistakes:
89
+ - Pricing too low (signals "not worth much")
90
+ - Free tier too generous (no upgrade motivation)
91
+ - Price-value misalignment (feature-based pricing vs. value-based pricing)
92
+ - B2B without annual contract discounts (missing out on cash flow stability)
93
+ ```
94
+
95
+ ---
96
+
97
+ ## 📎 File Integration Tips for This Stage
98
+
99
+ | Uploaded Content | Integrate Into | Integration Action |
100
+ |-----------------|----------------|-------------------|
101
+ | Financial data / revenue reports | 4.8 Business Model | Replace assumptions with real revenue structure, evaluate pricing reasonability |
102
+ | Marketing channel data | 4.7 GTM | Use real CAC, conversion rates, and other data to evaluate channel selection |