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
package/i18n/es/references/06-html-report.md ADDED
@@ -0,0 +1,138 @@
1
+ # Output de Reporte HTML de Planificación de Producto
2
+
3
+ Se activa cuando el usuario dice "produce un reporte" o confirma que el contenido de la última etapa es correcto.
4
+
5
+ ## Especificaciones de Diseño
6
+
7
+ Usa un **estilo de diseño moderno** — un único archivo HTML (CSS y JS completamente inline), asegurando que sea legible sin conexión.
8
+
9
+ **Estilo General:**
10
+ - Sección Hero con fondo degradado (con etiquetas de modo, audiencia, fecha)
11
+ - Diseño basado en tarjetas (bordes redondeados + sombras), cada sección como una tarjeta de información independiente
12
+ - Jerarquía tipográfica clara y espaciado de lectura cómodo
13
+ - Diseño responsive, lectura fluida en móvil
14
+
15
+ **Paleta de Colores:**
16
+ - Primario: Azul profundo `#1a1a2e` → `#16213e` → `#0f3460`
17
+ - Acento: `#e94560` o `#533483`
18
+ - Fondo de área de contenido: `#f8f9fa`, tarjetas: blanco con `box-shadow`
19
+
20
+ **Fuente:** Cargar Inter de Google Fonts CDN primero, fallback a fuentes del sistema:
21
+ ```css
22
+ /* En <head> */
23
+ <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;700&display=swap" rel="stylesheet">
24
+
25
+ /* En CSS */
26
+ font-family: "Inter", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
27
+ ```
28
+ > Esta es la única dependencia CDN externa permitida. Si Google Fonts no está disponible, la página se renderizará correctamente de todos modos.
29
+
30
+ ## Estructura de Página (Renderizado dinámico basado en etapas completadas)
31
+
32
+ ```
33
+ ┌──────────────────────────────────────────────────────────────┐
34
+ │ Sección Hero (Nombre del producto, descripción, modo, │
35
+ │ audiencia, fecha) │
36
+ ├──────────────────────────────────────────────────────────────┤
37
+ │ Navegación de Tabla de Contenidos (Sticky, solo muestra │
38
+ │ completadas) │
39
+ ├──────────────────────────────────────────────────────────────┤
40
+ │ 🧭 Sección de Estrategia (si se completó) │
41
+ │ ├─ Diagrama de jerarquía Strategy Blocks │
42
+ │ ├─ Kernel de Buena Estrategia de Rumelt (Diagnóstico/ │
43
+ │ │ Política/Acciones) │
44
+ │ └─ Tres Niveles de Trabajo de Producto de Shreyas │
45
+ │ ✅ Sección de Evaluación de Oportunidad (si se completó) │
46
+ │ 🔍 Sección de Descubrimiento (si se completó) │
47
+ │ ├─ Tabla de Personas (tabla estilo tarjeta) │
48
+ │ ├─ Tarjetas de Persona (una por persona) │
49
+ │ ├─ Tabla de Análisis JTBD (cuatro tipos) │
50
+ │ ├─ Opportunity Solution Tree (árbol visual) │
51
+ │ └─ User Journey Map (resumen + accordion de detalle) │
52
+ │ 🎯 Sección de Definición (si se completó) │
53
+ │ ├─ Tabla de Resumen de Puntos de Dolor │
54
+ │ ├─ Tarjeta de Framework de Posicionamiento April Dunford │
55
+ │ ├─ Tarjetas de Preguntas HMW (con etiquetas de tipo JTBD)│
56
+ │ └─ Tabla de Evaluación de Oportunidades (vista costo de │
57
+ │ oportunidad) │
58
+ │ 💡 Sección de Desarrollo (si se completó) │
59
+ │ ├─ Tarjeta PR-FAQ (formato simulado de comunicado de │
60
+ │ │ prensa) │
61
+ │ ├─ Ideación de Soluciones (tres columnas de tarjetas │
62
+ │ │ paralelas) │
63
+ │ ├─ Tabla de Riesgos Pre-mortem (código de color │
64
+ │ │ Alto/Medio riesgo) │
65
+ │ ├─ Matriz GEM + Cuadrante de Impacto/Esfuerzo │
66
+ │ ├─ Tabla de Priorización RICE (si se completó) │
67
+ │ ├─ Tabla de User Stories (si se completó) │
68
+ │ └─ Alcance MVP (tarjetas de tres columnas + Lista de │
69
+ │ No Hacer) │
70
+ │ 🚀 Sección de Entrega (si se completó) │
71
+ │ ├─ Tarjeta de Definición del Aha Moment (prominente) │
72
+ │ ├─ Tarjeta de North Star Metric │
73
+ │ ├─ Tabla de Métricas de Señales de Tres Capas │
74
+ │ ├─ Evaluación de Nivel PMF (visual de cuatro niveles + │
75
+ │ │ marcador de posición actual) │
76
+ │ ├─ Estrategia GTM (selección de canal + plan primeros │
77
+ │ │ 100 usuarios, si se completó) │
78
+ │ ├─ Modelo de Negocio y Precios (modelo de ingresos + │
79
+ │ │ estrategia de precios, si se completó) │
80
+ │ ├─ Tabla del Plan de Validación de Hipótesis (si se │
81
+ │ │ completó) │
82
+ │ └─ Resumen de Spec de Producto (estructura de tres │
83
+ │ secciones: Resumen de Decisiones / Límites de │
84
+ │ Ejecución / Referencia Profunda) │
85
+ │ ⭐ Análisis del Mejor Punto de Entrada (visual de cadena │
86
+ │ lógica completa) │
87
+ ├──────────────────────────────────────────────────────────────┤
88
+ │ Footer: Fecha de output + modo + atribución de frameworks │
89
+ └──────────────────────────────────────────────────────────────┘
90
+ ```
91
+
92
+ ## Detalles de Diseño por Sección
93
+
94
+ **Estilo de Tablas:** Rayas zebra, encabezado oscuro, bordes redondeados, resaltado al hover
95
+
96
+ **Tarjetas de Persona:** Una tarjeta por Persona, puntos de dolor con borde izquierdo rojo, JTBD enfatizado con bloques de color azul/morado
97
+
98
+ **Opportunity Solution Tree:** Usar CSS o SVG ligero para dibujar la estructura de árbol, mostrando claramente la jerarquía Objetivo → Oportunidad → Solución
99
+
100
+ **Gráfico de Nivel PMF:** Usar barra de progreso o diagrama de pasos mostrando cuatro niveles, marcando la posición actual del usuario
101
+
102
+ **Tarjeta PR-FAQ:** Formato simulado de comunicado de prensa con titular, subtítulo, párrafo inicial — visualmente parecido a un documento real
103
+
104
+ **Tabla de Riesgos Pre-mortem:** Ítems de alto riesgo en alerta roja, riesgo medio en amarillo
105
+
106
+ **Cadena Lógica del Mejor Punto de Entrada:** Visualizar la cadena de razonamiento completa, cada nodo como una pequeña tarjeta, conectados por flechas
107
+
108
+ ## Efectos Interactivos
109
+
110
+ - `scroll-behavior: smooth` — Scroll suave al hacer clic en TOC
111
+ - Intersection Observer — Resaltar sección actual en TOC mientras se hace scroll
112
+ - Micro-elevación de tarjeta al hover (`transform: translateY(-2px)` + `transition`)
113
+ - Expandir/colapsar accordion (etapas del User Journey Map, `<details>/<summary>`)
114
+ - `@media print` — Ocultar elementos interactivos al imprimir, asegurar que las tablas no se trunquen
115
+
116
+ ## Notas Importantes
117
+
118
+ - Todo CSS y JS inline en HTML — sin dependencias externas excepto Google Fonts CDN para Inter
119
+ - Si una etapa no se completó, no renderizar una sección vacía — simplemente omitirla
120
+ - La sección Hero muestra el "Modo" y "Audiencia" para que los lectores entiendan inmediatamente el contexto del documento
121
+ - La página puede ser muy larga — la navegación TOC es crítica para saltar rápidamente
122
+
123
+ ## Atribución de Frameworks y Lecturas Adicionales (en footer)
124
+
125
+ | Pensador | Contribución Clave | Fuente |
126
+ |----------|-------------------|--------|
127
+ | Teresa Torres | Descubrimiento Continuo, Opportunity Solution Tree | Lenny's Podcast + *Continuous Discovery Habits* |
128
+ | Shreyas Doshi | Framework LNO, Pre-mortem, Tres Niveles de Trabajo de Producto, Pensamiento de Costo de Oportunidad | Lenny's Podcast Ep.3 |
129
+ | Gibson Biddle | Modelo DHM, Priorización GEM | Lenny's Podcast |
130
+ | April Dunford | Framework de Posicionamiento | Lenny's Podcast + *Obviously Awesome* |
131
+ | Todd Jackson | Framework de Cuatro Niveles de PMF, Cuatro P's | Lenny's Podcast (First Round Capital) |
132
+ | Richard Rumelt | Buena Estrategia / Mala Estrategia, Kernel de Buena Estrategia | Lenny's Podcast + *Good Strategy Bad Strategy* |
133
+ | Marty Cagan | Empowered Teams, Descubrimiento de Producto | Lenny's Podcast + *Inspired*, *Empowered* |
134
+ | Chandra Janakiraman | Strategy Blocks | Lenny's Newsletter (Headspace / Meta) |
135
+ | Clayton Christensen | Jobs to Be Done | *Competing Against Luck* |
136
+ | Amazon | Working Backwards / PR-FAQ | *Working Backwards* |
137
+ | Sean Ellis | Sean Ellis Score, ICE Scoring | *Hacking Growth* |
138
+ | Lenny Rachitsky | Shape / Ship / Synchronize, Pensamiento North Star | Lenny's Newsletter + Podcast |
package/i18n/es/references/07a-handoff-core.md ADDED
@@ -0,0 +1,152 @@
1
+ # Handoff de Desarrollo — Paquete de Handoff Principal
2
+
3
+ > Se activa cuando el usuario dice "iniciar desarrollo," "produce un paquete de handoff de desarrollo," "configura mi proyecto," o "conectar con Claude Code."
4
+ > Lee este archivo, consolida los outputs de todo el proceso de planificación de producto, y genera un paquete de handoff de desarrollo que puede usarse directamente en el CLI de Claude Code.
5
+
6
+ ## Restricciones del Entorno y Estrategia de Handoff
7
+
8
+ **Hecho clave: Claude Chat / Cowork y Claude Code son entornos de ejecución separados — no puedes lanzar Claude Code desde dentro de Chat.**
9
+
10
+ La estrategia de handoff es por lo tanto: **Producir un paquete de handoff de desarrollo estructurado (un conjunto de archivos)** que el usuario descarga, coloca en su carpeta de proyecto, y puede iniciar todo el flujo de desarrollo con un solo prompt en Claude Code.
11
+
12
+ El método de handoff depende del entorno del usuario:
13
+
14
+ | Entorno del Usuario | Método de Handoff |
15
+ |--------------------|------------------|
16
+ | **Claude Chat (Web/App)** | Producir un archivo zip para descargar; el usuario extrae al directorio del proyecto luego abre Claude Code |
17
+ | **Claude Cowork (Desktop)** | Igual que arriba, pero puede escribir archivos directamente a una ruta local especificada por el usuario |
18
+ | **Ya en Claude Code** | Crear todos los archivos directamente en el directorio del proyecto (en este escenario, este skill probablemente se referencia desde CLAUDE.md) |
19
+
20
+ ---
21
+
22
+ ## Contenido del Paquete de Handoff de Desarrollo
23
+
24
+ Produce el siguiente conjunto de archivos, todos colocados en la raíz del proyecto:
25
+
26
+ ```
27
+ [nombre-del-proyecto]/
28
+ ├── .gitignore # Exclusiones de control de versiones (.env, secretos, archivos de progreso, etc. — plantilla en references/07c-architecture-setup.md)
29
+ ├── CLAUDE.md # Memoria de proyecto de Claude Code: contexto de producto + guías de desarrollo
30
+ ├── TASKS.md # Desglose de funcionalidades + hitos por Fase + criterios de aceptación por Tarea
31
+ ├── TICKETS.md # Contenido de tickets: título, descripción, criterios de aceptación por ticket — PM puede crear tickets directamente
32
+ ├── docs/
33
+ │ ├── PRD.md # PRD completo (consolidado del formato de output de 04-develop.md)
34
+ │ ├── ARCHITECTURE.md # Arquitectura técnica: estructura de directorios + esquema BD + endpoints API + arquitectura de seguridad
35
+ │ └── PRODUCT-SPEC.md # Resumen de Spec de Producto (consolidado de 05-deliver.md → 4.6)
36
+ └── scripts/
37
+ └── setup.sh # Script de inicialización en un solo comando (crear directorios + instalar dependencias)
38
+ ```
39
+
40
+ ---
41
+
42
+ ## 📄 Plantilla CLAUDE.md
43
+
44
+ CLAUDE.md es el archivo de memoria de proyecto de Claude Code — Claude Code lo lee automáticamente en cada inicio. Debe incluir:
45
+
46
+ ```markdown
47
+ # [Nombre del Producto] — Guía del Proyecto
48
+
49
+ ## Contexto del Producto
50
+
51
+ **Descripción en una línea**: [Titular del PR-FAQ]
52
+ **Usuarios Objetivo**: [Persona en una oración]
53
+ **JTBD Central**: [Cliente Objetivo] quiere [Job] en el contexto de [Contexto del Job]
54
+ **Aha Moment**: Cuando el usuario completa [acción], experimenta el valor central
55
+ **North Star Metric**: [Nombre de la métrica + definición]
56
+
57
+ ## Stack Tecnológico
58
+
59
+ - **Frontend**: [Framework + versión]
60
+ - **Backend**: [Framework + versión]
61
+ - **Base de Datos**: [Tipo + versión]
62
+ - **Despliegue**: [Plataforma]
63
+ - **Gestor de Paquetes**: [Herramienta]
64
+
65
+ ## Guías de Desarrollo
66
+
67
+ - Desarrollar en [lenguaje]
68
+ - Seguir [guía de estilo / reglas de lint]
69
+ - Formato de commit message: `[type]: [description]` (type: feat / fix / refactor / docs / test)
70
+ - Estrategia de ramas: [main / develop / feature-xxx]
71
+ - Cada funcionalidad debe referenciar su número de User Story (ver TASKS.md)
72
+
73
+ ## Límites del MVP
74
+
75
+ **Imprescindibles (P0)**:
76
+ - [Funcionalidad 1]
77
+ - [Funcionalidad 2]
78
+ - [Funcionalidad 3]
79
+
80
+ **Explícitamente No Hacer**:
81
+ - [Exclusión 1] — Razón: [justificación]
82
+ - [Exclusión 2] — Razón: [justificación]
83
+
84
+ ## Registro de Decisiones Clave
85
+
86
+ | Decisión | Elección | Justificación | Fecha |
87
+ |----------|---------|---------------|-------|
88
+ | [p.ej., Selección de base de datos] | [PostgreSQL] | [Necesita consultas relacionales + soporte JSON] | [Fecha] |
89
+
90
+ ## Alertas de Riesgo (del Pre-mortem)
91
+
92
+ - ⚠️ [Riesgo 1]: [Medida preventiva]
93
+ - ⚠️ [Riesgo 2]: [Medida preventiva]
94
+
95
+ ## Notas de Seguridad
96
+
97
+ > Lista completa de seguridad en `references/08-security-checklist.md`. Abajo están las decisiones clave de seguridad de este producto:
98
+
99
+ - Autenticación: [JWT / Session / OAuth]
100
+ - Política CORS: [Orígenes permitidos]
101
+ - Rate Limiting: [Resumen de estrategia]
102
+ - Datos sensibles: [Enfoque de manejo]
103
+
104
+ ## Flujo de Trabajo de Desarrollo
105
+
106
+ Sigue el orden de Fases en `TASKS.md`. Después de completar cada Fase:
107
+ 1. Verifica que todos los criterios de aceptación de las Tareas pasen
108
+ 2. Pregunta al usuario si desea proceder a la siguiente Fase
109
+ 3. Si surgen preguntas de arquitectura, consulta `docs/ARCHITECTURE.md`
110
+ ```
111
+
112
+ ---
113
+
114
+ ## Flujo de Confirmación de Stack Tecnológico
115
+
116
+ Antes de producir el paquete de handoff, el stack tecnológico debe confirmarse. Si el usuario no lo ha especificado, pregunta en este orden:
117
+
118
+ ### Obligatorio (Afecta todos los outputs)
119
+
120
+ ```
121
+ 1. ¿Qué tipo de aplicación es esta?
122
+ □ App Web (navegador)
123
+ □ App Móvil (iOS / Android / multiplataforma)
124
+ □ App de Escritorio
125
+ □ API / Servicio Backend
126
+ □ Herramienta CLI
127
+ □ Otro
128
+
129
+ 2. ¿Tienes un stack tecnológico preferido?
130
+ (Si no, recomendaré uno basado en las características del producto)
131
+ ```
132
+
133
+ ### Lógica de Recomendación (Cuando el usuario no ha especificado)
134
+
135
+ | Tipo de Aplicación | Stack Recomendado | Justificación |
136
+ |-------------------|-------------------|---------------|
137
+ | App Web (validación rápida de MVP) | Next.js + Tailwind + Supabase | Full-stack en uno, despliegue fácil, Auth integrado |
138
+ | App Web (lógica backend compleja) | React + Node.js/Express + PostgreSQL | Alta flexibilidad, ecosistema maduro |
139
+ | App Web (equipo Python) | React + FastAPI/Django + PostgreSQL | Ecosistema Python, Django tiene Admin integrado |
140
+ | App Móvil (multiplataforma) | React Native / Flutter | Un solo codebase cubre ambas plataformas |
141
+ | Servicio API | FastAPI / Express / Go | Ligero, alto rendimiento |
142
+
143
+ > Claude debe explicar la justificación al recomendar y recordar al usuario que puede cambiar la recomendación.
144
+
145
+ ### Opcional (Seguimiento basado en necesidades del producto)
146
+
147
+ ```
148
+ 3. ¿Necesitas autenticación de usuarios? (Afecta selección de enfoque Auth)
149
+ 4. ¿Algún requisito en tiempo real? (WebSocket / SSE)
150
+ 5. ¿Necesitas subir/procesar archivos? (Afecta elección de almacenamiento)
151
+ 6. ¿Dónde planeas desplegar? (Vercel / Railway / AWS / self-hosted)
152
+ ```
package/i18n/es/references/07b-tasks-tickets.md ADDED
@@ -0,0 +1,215 @@
1
+ # Handoff de Desarrollo — TASKS.md + TICKETS.md
2
+
3
+ ## 📄 Plantilla TASKS.md
4
+
5
+ Principios fundamentales para desglose de funcionalidades:
6
+ - Comienza desde los imprescindibles del MVP (funcionalidades P0)
7
+ - Cada Tarea mapea a una User Story
8
+ - Las Fases tienen dependencias claras: Fase N+1 depende de outputs de Fase N
9
+ - Cada Tarea incluye criterios de aceptación que Claude Code puede auto-verificar
10
+
11
+ ```markdown
12
+ # [Nombre del Producto] — Lista de Tareas de Desarrollo
13
+
14
+ ## Fase 0: Inicialización del Proyecto
15
+ > Meta: Establecer un esqueleto de proyecto en blanco ejecutable
16
+
17
+ - [ ] **T0.1** Inicializar proyecto (`scripts/setup.sh` o manual)
18
+ - Aceptación:
19
+ - [ ] `npm run dev` / `python manage.py runserver` o comando equivalente inicia exitosamente
20
+ - [ ] `.gitignore` creado, incluye `.env`, `.env.local`, `node_modules/`, `.product-playbook-progress.md`, y otros archivos sensibles
21
+ - [ ] `.env.example` creado (solo nombres de claves, sin valores reales)
22
+ - [ ] **T0.2** Configurar linter + formatter
23
+ - Aceptación: lint pasa sin errores
24
+ - [ ] **T0.3** Configurar base de datos + ejecutar migración inicial
25
+ - Aceptación: Base de datos es conectable, tablas base están creadas
26
+ - [ ] **T0.4** Configurar estructura de rutas base
27
+ - Aceptación: Todas las rutas principales de páginas son accesibles (retornar páginas en blanco está bien)
28
+
29
+ ## Fase 1: Flujo Central (Ruta del Aha Moment)
30
+ > Meta: Permitir que los usuarios completen la ruta más corta desde la entrada hasta el Aha Moment
31
+ > Corresponde a User Stories: [US-001, US-002, ...]
32
+
33
+ - [ ] **T1.1** [Nombre de funcionalidad]
34
+ - User Story: Como [Persona], quiero [acción], para poder [valor]
35
+ - Criterios de Aceptación:
36
+ - [ ] [Condición específica comprobable 1]
37
+ - [ ] [Condición específica comprobable 2]
38
+ - Notas Técnicas: [APIs requeridas / servicios de terceros / lógica especial]
39
+
40
+ - [ ] **T1.2** [Nombre de funcionalidad]
41
+ - User Story: ...
42
+ - Criterios de Aceptación: ...
43
+
44
+ > **Checkpoint de Finalización Fase 1**: El usuario puede completar [acción del Aha Moment]. Si no, no proceder a Fase 2.
45
+
46
+ ## Fase 2: Completar el MVP
47
+ > Meta: Llenar todas las funcionalidades P0 restantes no cubiertas en Fase 1
48
+ > Corresponde a User Stories: [US-003, US-004, ...]
49
+
50
+ - [ ] **T2.1** [Nombre de funcionalidad]
51
+ - ...
52
+
53
+ > **Checkpoint de Finalización Fase 2**: Todos los criterios de aceptación de User Stories P0 pasan.
54
+
55
+ ## Fase 3: Calidad y Experiencia
56
+ > Meta: Manejo de errores, casos límite, estados de carga, seguridad básica
57
+
58
+ - [ ] **T3.1** Manejo global de errores
59
+ - [ ] **T3.2** Validación de formularios + casos límite
60
+ - [ ] **T3.3** Estados de carga + estados vacíos
61
+ - [ ] **T3.4** Verificación de seguridad (verificar cada ítem según `references/08-security-checklist.md`)
62
+ - Aceptación:
63
+ - [ ] Ítems relacionados con OWASP Top 10 atendidos (validación de input, autenticación, protección XSS, protección CSRF)
64
+ - [ ] Cabeceras de seguridad configuradas (CSP, X-Frame-Options, HSTS, etc.)
65
+ - [ ] Política CORS configurada (sin wildcard *)
66
+ - [ ] Endpoints API sensibles tienen rate limiting
67
+ - [ ] Respuestas de error API no filtran información interna
68
+ - [ ] **T3.5** Diseño responsive (si es Web)
69
+
70
+ ## Fase 4: Despliegue
71
+ > Meta: Hacer la app accesible para usuarios externos
72
+
73
+ - [ ] **T4.1** Gestión de variables de entorno
74
+ - [ ] **T4.2** Configuración de despliegue
75
+ - [ ] **T4.3** Monitoreo básico + logging
76
+ ```
77
+
78
+ ---
79
+
80
+ ## 📄 Plantilla TICKETS.md
81
+
82
+ TICKETS.md toma el desglose de funcionalidades de TASKS.md y produce contenido estructurado que puede usarse directamente para crear tickets en herramientas de gestión de proyectos. Cada ticket contiene toda la información que un PM necesita.
83
+
84
+ > **Meta de diseño**: Los PMs pueden copiar el contenido de cada ticket directamente a Jira / Asana / Linear u otras herramientas para crear tickets. Versiones futuras soportarán creación automática de tickets vía API.
85
+
86
+ ```markdown
87
+ # [Nombre del Producto] — Lista de Tickets
88
+
89
+ > Generado: [timestamp]
90
+ > Corresponde a versión de TASKS.md: [versión/timestamp]
91
+ > Total: [N] tickets
92
+
93
+ ---
94
+
95
+ ## Resumen de Tickets
96
+
97
+ | # Ticket | Título | Fase | Prioridad | Horas Estimadas | Dependencias |
98
+ |----------|--------|------|----------|----------------|-------------|
99
+ | TKT-001 | [Título] | Fase 0 | P0 | [X]h | — |
100
+ | TKT-002 | [Título] | Fase 1 | P0 | [X]h | TKT-001 |
101
+ | ... | | | | | |
102
+
103
+ ---
104
+
105
+ ## TKT-001: [Título]
106
+
107
+ **Fase**: Fase 0 — Inicialización del Proyecto
108
+ **Tarea Correspondiente**: T0.1
109
+ **Prioridad**: P0
110
+ **Horas Estimadas**: [X] horas
111
+ **Dependencias**: Ninguna
112
+ **Asignado a**: [Rol/equipo, p.ej., Ingeniero Backend]
113
+
114
+ ### Descripción
115
+
116
+ [1-3 párrafos describiendo lo que este ticket logra, incluyendo contexto de negocio y metas técnicas]
117
+
118
+ ### User Story
119
+
120
+ Como [Persona], quiero [acción], para poder [valor]
121
+
122
+ ### Criterios de Aceptación
123
+
124
+ - [ ] [Condición específica comprobable 1]
125
+ - [ ] [Condición específica comprobable 2]
126
+ - [ ] [Condición específica comprobable 3]
127
+
128
+ ### Notas Técnicas
129
+
130
+ - [Consideraciones de implementación]
131
+ - [APIs requeridas / servicios de terceros]
132
+ - [Rutas de archivos o módulos relacionados]
133
+
134
+ ### Etiquetas Sugeridas
135
+
136
+ `[Fase 0]` `[backend]` `[setup]`
137
+
138
+ ---
139
+
140
+ ## TKT-002: [Título]
141
+
142
+ [Mismo formato, expandido para cada ticket]
143
+ ```
144
+
145
+ ### Reglas de Ticketing
146
+
147
+ 1. **Mapeo ticket-a-tarea**: Cada Tarea en TASKS.md mapea a un ticket (TKT-001 ↔ T0.1); Tareas demasiado grandes pueden dividirse en múltiples tickets
148
+ 2. **Herencia de prioridad**: Fases 0-1 por defecto P0, Fase 2 por defecto P1, Fases 3-4 por defecto P2 — ajustable según puntuaciones RICE
149
+ 3. **Dependencias**: Marcar explícitamente dependencias ticket-a-ticket para prevenir que los ingenieros salten pasos
150
+ 4. **Horas estimadas**: Basado en el principio de granularidad de Tareas (1-4 horas), proporcionar estimaciones razonables
151
+ 5. **Etiquetas sugeridas**: Incluir Fase, dominio técnico (frontend / backend / base de datos / infraestructura), módulo de funcionalidad
152
+
153
+ ### Integración con Herramientas de Gestión de Proyectos (Reservado)
154
+
155
+ > Lo siguiente es un diseño de interfaz reservado para ticketing automático futuro. La versión actual solo produce TICKETS.md para creación manual de tickets por el PM.
156
+
157
+ El formato estructurado de TICKETS.md reserva los siguientes campos para importación futura por API:
158
+
159
+ | Campo | Mapeo Jira | Mapeo Asana | Mapeo Linear |
160
+ |-------|-----------|------------|-------------|
161
+ | # Ticket | Issue Key | Task ID | Issue ID |
162
+ | Título | Summary | Task Name | Title |
163
+ | Descripción | Description | Description | Description |
164
+ | Prioridad | Priority | Custom Field | Priority |
165
+ | Horas Estimadas | Story Points / Time Estimate | Custom Field | Estimate |
166
+ | Dependencias | Linked Issues | Dependencies | Relations |
167
+ | Etiquetas | Labels + Components | Tags | Labels |
168
+ | Fase | Epic | Section | Project |
169
+ | Asignado a | Assignee | Assignee | Assignee |
170
+ | Criterios de Aceptación | Acceptance Criteria (Description) | Subtasks | Sub-issues |
171
+
172
+ ---
173
+
174
+ ## Lógica de Desglose de Funcionalidades
175
+
176
+ Reglas para convertir funcionalidades MVP en Tareas:
177
+
178
+ ### Principios de División de Fases
179
+
180
+ ```
181
+ Fase 0: Esqueleto del proyecto (requerido para todos los modos)
182
+ → Inicialización, linter, BD, rutas base
183
+
184
+ Fase 1: Ruta más corta al Aha Moment (más importante)
185
+ → Funcionalidades mínimas necesarias desde la entrada del usuario hasta el Aha Moment
186
+ → Solo incluye funcionalidades P0 en esta ruta
187
+
188
+ Fase 2: Completar el MVP
189
+ → Llenar funcionalidades P0 restantes no cubiertas en Fase 1
190
+ → Flujos secundarios, páginas de soporte
191
+
192
+ Fase 3: Calidad y Experiencia
193
+ → Manejo de errores, casos límite, estados de carga/vacíos
194
+ → Seguridad básica, diseño responsive
195
+
196
+ Fase 4: Despliegue
197
+ → Variables de entorno, configuración de despliegue, monitoreo
198
+ ```
199
+
200
+ ### Principio de Granularidad de Tareas
201
+
202
+ - Cada Tarea debería completarse en **1-4 horas**
203
+ - Demasiado grande → Dividir en sub-Tareas (T1.1a, T1.1b)
204
+ - Demasiado pequeña → Fusionar con una Tarea relacionada
205
+ - Cada Tarea debe tener al menos un criterio de aceptación comprobable
206
+
207
+ ### Mapeo User Story → Tarea
208
+
209
+ ```
210
+ Una sola User Story puede mapear a 1-3 Tareas:
211
+ US-001: Como nuevo usuario, quiero registrar una cuenta, para poder comenzar a usar el producto
212
+ → T1.1: UI de página de registro
213
+ → T1.2: API de registro + validación de datos
214
+ → T1.3: Flujo de verificación de email (si es necesario para MVP)
215
+ ```