whiteport-design-studio 0.1.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 (686) hide show
  1. package/LICENSE +27 -0
  2. package/README.md +196 -0
  3. package/docs/getting-started/MANUAL-INIT-GUIDE.md +251 -0
  4. package/docs/getting-started/about-wds.md +86 -0
  5. package/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md +28 -0
  6. package/docs/getting-started/agent-activation/activation/step-02-check-conversations.md +43 -0
  7. package/docs/getting-started/agent-activation/activation/step-03-check-activation-context.md +42 -0
  8. package/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md +30 -0
  9. package/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md +27 -0
  10. package/docs/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md +34 -0
  11. package/docs/getting-started/agent-activation/activation/step-05-standard-analysis.md +26 -0
  12. package/docs/getting-started/agent-activation/agent-launchers.md +134 -0
  13. package/docs/getting-started/agent-activation/wds-freya-ux.md +67 -0
  14. package/docs/getting-started/agent-activation/wds-idunn-pm.md +67 -0
  15. package/docs/getting-started/agent-activation/wds-mimir.md +78 -0
  16. package/docs/getting-started/agent-activation/wds-saga-analyst.md +65 -0
  17. package/docs/getting-started/getting-started-overview.md +112 -0
  18. package/docs/getting-started/installation.md +62 -0
  19. package/docs/getting-started/quick-start.md +125 -0
  20. package/docs/getting-started/where-to-go-next.md +137 -0
  21. package/docs/learn-wds/00-course-overview/00-getting-started-overview.md +66 -0
  22. package/docs/learn-wds/00-course-overview/01-prerequisites.md +98 -0
  23. package/docs/learn-wds/00-course-overview/02-learning-paths.md +99 -0
  24. package/docs/learn-wds/00-course-overview/03-support.md +128 -0
  25. package/docs/learn-wds/00-course-overview.md +211 -0
  26. package/docs/learn-wds/Webinars/2024-12-22-WDS-Jam-1-Say-Hello-to-AI-Agent-Framework.md +0 -0
  27. package/docs/learn-wds/Webinars/2024-12-22-WDS-Sessions-1-Say-Hello-to-WDS.md +174 -0
  28. package/docs/learn-wds/Webinars/2025-10-22-Webinar-WDS-v4.md +181 -0
  29. package/docs/learn-wds/Webinars/2026-01-15-WDS-Sessions-2-Strategy-in-Practice.md +159 -0
  30. package/docs/learn-wds/course-explainers/Module 00-transcript.srt +635 -0
  31. package/docs/learn-wds/course-explainers/Module 02-transcript.srt +807 -0
  32. package/docs/learn-wds/course-explainers/Module-00-notebook-lm-prompt.md +250 -0
  33. package/docs/learn-wds/course-explainers/Module-00-thumbnail-prompt.md +33 -0
  34. package/docs/learn-wds/course-explainers/Module-00-youtube-show-notes.md +78 -0
  35. package/docs/learn-wds/course-explainers/Module-01-notebook-lm-prompt.md +418 -0
  36. package/docs/learn-wds/course-explainers/Module-01-thumbnail-prompt.md +33 -0
  37. package/docs/learn-wds/course-explainers/Module-01-transcript.srt +731 -0
  38. package/docs/learn-wds/course-explainers/Module-02-notebook-lm-prompt.md +342 -0
  39. package/docs/learn-wds/course-explainers/Module-02-thumbnail-prompt.md +34 -0
  40. package/docs/learn-wds/course-explainers/Module-03-notebook-lm-prompt.md +745 -0
  41. package/docs/learn-wds/course-explainers/Module-03-thumbnail-prompt.md +33 -0
  42. package/docs/learn-wds/course-explainers/Module-03-transcript.srt +595 -0
  43. package/docs/learn-wds/course-explainers/Module-04-notebook-lm-prompt.md +163 -0
  44. package/docs/learn-wds/course-explainers/Module-04-thumbnail-prompt.md +36 -0
  45. package/docs/learn-wds/course-explainers/Module-04-youtube-show-notes.md +95 -0
  46. package/docs/learn-wds/course-explainers/Module-05-notebook-lm-prompt.md +274 -0
  47. package/docs/learn-wds/course-explainers/Module-05-thumbnail-prompt.md +40 -0
  48. package/docs/learn-wds/course-explainers/Module-05-youtube-show-notes.md +65 -0
  49. package/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md +75 -0
  50. package/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md +86 -0
  51. package/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md +82 -0
  52. package/docs/learn-wds/course-explainers/trigger-map-example.jpg +0 -0
  53. package/docs/learn-wds/module-01-why-wds-matters/lesson-01-the-problem.md +113 -0
  54. package/docs/learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md +75 -0
  55. package/docs/learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md +94 -0
  56. package/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md +109 -0
  57. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md +124 -0
  58. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md +63 -0
  59. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md +124 -0
  60. package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md +87 -0
  61. package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md +203 -0
  62. package/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md +70 -0
  63. package/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md +40 -0
  64. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md +48 -0
  65. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md +88 -0
  66. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md +88 -0
  67. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md +48 -0
  68. package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md +48 -0
  69. package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md +149 -0
  70. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md +51 -0
  71. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md +111 -0
  72. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md +111 -0
  73. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md +51 -0
  74. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/checklist.md +41 -0
  75. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/tutorial.md +159 -0
  76. package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md +93 -0
  77. package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md +217 -0
  78. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md +73 -0
  79. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md +206 -0
  80. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md +206 -0
  81. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md +73 -0
  82. package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md +79 -0
  83. package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md +244 -0
  84. package/docs/learn-wds/module-02-installation-setup/module-02-overview.md +77 -0
  85. package/docs/learn-wds/module-03-alignment-signoff/lesson-01-understanding-alignment.md +175 -0
  86. package/docs/learn-wds/module-03-alignment-signoff/lesson-02-creating-alignment-document.md +289 -0
  87. package/docs/learn-wds/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md +115 -0
  88. package/docs/learn-wds/module-03-alignment-signoff/lesson-04-external-contracts.md +201 -0
  89. package/docs/learn-wds/module-03-alignment-signoff/lesson-05-internal-signoff.md +189 -0
  90. package/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md +170 -0
  91. package/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md +344 -0
  92. package/docs/learn-wds/module-04-product-brief/lesson-01-chaos-problem.md +193 -0
  93. package/docs/learn-wds/module-04-product-brief/lesson-02-five-questions.md +364 -0
  94. package/docs/learn-wds/module-04-product-brief/lesson-03-document-structure.md +388 -0
  95. package/docs/learn-wds/module-04-product-brief/lesson-04-wds-advantage.md +402 -0
  96. package/docs/learn-wds/module-04-product-brief/lesson-05-using-brief.md +491 -0
  97. package/docs/learn-wds/module-04-product-brief/lesson-06-additional-documents.md +645 -0
  98. package/docs/learn-wds/module-04-product-brief/module-04-overview.md +194 -0
  99. package/docs/learn-wds/module-04-product-brief/tutorial-04.md +400 -0
  100. package/docs/learn-wds/module-05-map-triggers-outcomes/tutorial-04.md +460 -0
  101. package/docs/learn-wds/module-05-trigger-mapping/lesson-01-missing-link.md +237 -0
  102. package/docs/learn-wds/module-05-trigger-mapping/lesson-02-heritage-evolution.md +364 -0
  103. package/docs/learn-wds/module-05-trigger-mapping/lesson-03-five-workshops-overview.md +459 -0
  104. package/docs/learn-wds/module-05-trigger-mapping/lesson-04-workshop-1-business-goals.md +274 -0
  105. package/docs/learn-wds/module-05-trigger-mapping/lesson-05-workshop-2-target-groups.md +504 -0
  106. package/docs/learn-wds/module-05-trigger-mapping/lesson-06-workshop-3-driving-forces.md +458 -0
  107. package/docs/learn-wds/module-05-trigger-mapping/lesson-07-workshop-4-prioritization.md +313 -0
  108. package/docs/learn-wds/module-05-trigger-mapping/lesson-08-workshop-5-feature-impact.md +474 -0
  109. package/docs/learn-wds/module-05-trigger-mapping/lesson-09-positive-negative-drivers.md +348 -0
  110. package/docs/learn-wds/module-05-trigger-mapping/lesson-10-visual-trigger-map.md +411 -0
  111. package/docs/learn-wds/module-05-trigger-mapping/lesson-11-feature-impact-scoring.md +403 -0
  112. package/docs/learn-wds/module-05-trigger-mapping/module-05-overview.md +283 -0
  113. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05.md +595 -0
  114. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05b-value-trigger-chain.md +393 -0
  115. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05c-documentation-synthesis.md +475 -0
  116. package/docs/learn-wds/module-06-platform-architecture/tutorial-06.md +358 -0
  117. package/docs/learn-wds/module-08-initialize-scenario/tutorial-08.md +521 -0
  118. package/docs/learn-wds/module-09-design-system/tutorial-09.md +515 -0
  119. package/docs/learn-wds/module-10-design-delivery/tutorial-10.md +604 -0
  120. package/docs/learn-wds/module-12-conceptual-specs/tutorial-12.md +734 -0
  121. package/docs/method/content-creation-philosophy.md +311 -0
  122. package/docs/method/content-purpose-guide.md +436 -0
  123. package/docs/method/phase-1-product-exploration-guide.md +178 -0
  124. package/docs/method/phase-2-trigger-mapping-guide.md +399 -0
  125. package/docs/method/phase-3-prd-platform-guide.md +284 -0
  126. package/docs/method/phase-4-ux-design-guide.md +388 -0
  127. package/docs/method/phase-5-design-system-guide.md +916 -0
  128. package/docs/method/phase-6-prd-finalization-guide.md +510 -0
  129. package/docs/method/tone-of-voice-guide.md +466 -0
  130. package/docs/method/value-trigger-chain-guide.md +474 -0
  131. package/docs/method/wds-method-guide.md +378 -0
  132. package/docs/models/action-mapping.md +681 -0
  133. package/docs/models/customer-awareness-cycle.md +530 -0
  134. package/docs/models/golden-circle.md +532 -0
  135. package/docs/models/gtd-getting-things-done.md +193 -0
  136. package/docs/models/impact-effect-mapping.md +600 -0
  137. package/docs/models/kathy-sierra-badass-users.md +672 -0
  138. package/docs/models/models-guide.md +297 -0
  139. package/docs/models/smart-goals-model.md +294 -0
  140. package/docs/tools/cursor-windsurf.md +190 -0
  141. package/docs/tools/figma-mcp.md +453 -0
  142. package/docs/tools/figma.md +212 -0
  143. package/docs/tools/git.md +285 -0
  144. package/docs/tools/html-to-design.md +185 -0
  145. package/docs/tools/nanobanana.md +240 -0
  146. package/docs/tools/prepare-for-figma-export.md +690 -0
  147. package/docs/tools/wds-tools-guide.md +115 -0
  148. package/package.json +114 -0
  149. package/src/agents/freya-ux.agent.yaml +128 -0
  150. package/src/agents/idunn-pm.agent.yaml +94 -0
  151. package/src/agents/mimir-orchestrator.agent.yaml +139 -0
  152. package/src/agents/saga-analyst.agent.yaml +128 -0
  153. package/src/data/agent-guides/freya/agentic-development.md +200 -0
  154. package/src/data/agent-guides/freya/content-creation.md +270 -0
  155. package/src/data/agent-guides/freya/design-system.md +336 -0
  156. package/src/data/agent-guides/freya/meta-content-guide.md +483 -0
  157. package/src/data/agent-guides/freya/specification-quality.md +250 -0
  158. package/src/data/agent-guides/freya/strategic-design.md +118 -0
  159. package/src/data/agent-guides/idunn/design-handoffs.md +411 -0
  160. package/src/data/agent-guides/idunn/platform-requirements.md +351 -0
  161. package/src/data/agent-guides/mimir/emotional-intelligence.md +295 -0
  162. package/src/data/agent-guides/mimir/teaching-styles.md +286 -0
  163. package/src/data/agent-guides/mimir/wds-overview.md +369 -0
  164. package/src/data/agent-guides/saga/discovery-conversation.md +245 -0
  165. package/src/data/agent-guides/saga/strategic-documentation.md +456 -0
  166. package/src/data/agent-guides/saga/trigger-mapping.md +403 -0
  167. package/src/data/design-system/component-boundaries.md +318 -0
  168. package/src/data/design-system/figma-component-structure.md +697 -0
  169. package/src/data/design-system/naming-conventions.md +200 -0
  170. package/src/data/design-system/state-management.md +93 -0
  171. package/src/data/design-system/token-architecture.md +474 -0
  172. package/src/data/design-system/validation-patterns.md +74 -0
  173. package/src/data/presentations/freya-intro.md +275 -0
  174. package/src/data/presentations/freya-presentation.md +78 -0
  175. package/src/data/presentations/idunn-intro.md +231 -0
  176. package/src/data/presentations/idunn-presentation.md +80 -0
  177. package/src/data/presentations/mimir-presentation.md +123 -0
  178. package/src/data/presentations/saga-intro.md +285 -0
  179. package/src/data/presentations/saga-presentation.md +75 -0
  180. package/src/gems/eira-visual-designer.md +571 -0
  181. package/src/module.yaml +111 -0
  182. package/src/templates/design-delivery.template.yaml +104 -0
  183. package/src/templates/platform-requirements.template.yaml +69 -0
  184. package/src/templates/test-scenario.template.yaml +192 -0
  185. package/src/workflows/00-system/FILE-NAMING-CONVENTIONS.md +286 -0
  186. package/src/workflows/00-system/INSTRUCTION-FILE-GUIDELINES.md +284 -0
  187. package/src/workflows/00-system/SPECIFICATION-FORMATTING-STANDARDS.md +516 -0
  188. package/src/workflows/00-system/language-configuration-guide.md +472 -0
  189. package/src/workflows/00-system/language-flow-diagram.md +446 -0
  190. package/src/workflows/00-system/wds-workflow-status-template.yaml +106 -0
  191. package/src/workflows/1-project-brief/alignment-signoff/contract.template.md +297 -0
  192. package/src/workflows/1-project-brief/alignment-signoff/pitch.template.md +101 -0
  193. package/src/workflows/1-project-brief/alignment-signoff/section-guide.md +212 -0
  194. package/src/workflows/1-project-brief/alignment-signoff/service-agreement.template.md +277 -0
  195. package/src/workflows/1-project-brief/alignment-signoff/signoff.template.md +188 -0
  196. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-01-start.md +81 -0
  197. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-01.5-extract-communications.md +78 -0
  198. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-02-explore-sections.md +159 -0
  199. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-03-synthesize.md +48 -0
  200. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-03.5-generate-contract.md +87 -0
  201. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-04-present-for-approval.md +89 -0
  202. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md +27 -0
  203. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/02-determine-if-needed.md +32 -0
  204. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/03-offer-extract-communications.md +31 -0
  205. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/04-extract-info.md +39 -0
  206. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/05-detect-starting-point.md +34 -0
  207. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/06-explore-realization.md +45 -0
  208. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/07-explore-solution.md +25 -0
  209. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/08-explore-why-it-matters.md +33 -0
  210. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/09-explore-how-we-see-it-working.md +29 -0
  211. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/10-explore-paths-we-explored.md +28 -0
  212. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/11-explore-recommended-solution.md +26 -0
  213. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/12-explore-path-forward.md +38 -0
  214. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/13-explore-value-we-create.md +40 -0
  215. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/14-explore-cost-of-inaction.md +37 -0
  216. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/15-explore-our-commitment.md +33 -0
  217. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/16-explore-summary.md +26 -0
  218. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/17-reflect-back.md +33 -0
  219. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18-synthesize-document.md +41 -0
  220. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18.5-create-vtc.md +76 -0
  221. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/19-present-for-approval.md +44 -0
  222. package/src/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/20-offer-signoff-document.md +38 -0
  223. package/src/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/21-determine-business-model.md +50 -0
  224. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/22-build-section-01-project-overview.md +29 -0
  225. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/23-build-section-02-business-model.md +66 -0
  226. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/24-build-section-03-scope-of-work.md +46 -0
  227. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/25-build-section-04-payment-terms.md +81 -0
  228. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/26-build-section-05-timeline.md +31 -0
  229. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/27-build-section-06-availability.md +38 -0
  230. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/28-build-section-07-confidentiality.md +42 -0
  231. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/29-build-section-08-not-to-exceed.md +54 -0
  232. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/30-build-section-09-work-initiation.md +41 -0
  233. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/31-build-section-10-terms-and-conditions.md +38 -0
  234. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/32-build-section-11-approval.md +36 -0
  235. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/33-finalize-contract.md +40 -0
  236. package/src/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/34-build-internal-signoff.md +65 -0
  237. package/src/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/35-finalize-signoff.md +39 -0
  238. package/src/workflows/1-project-brief/alignment-signoff/substeps/substeps-guide.md +81 -0
  239. package/src/workflows/1-project-brief/alignment-signoff/validation-report-alignment-signoff.md +360 -0
  240. package/src/workflows/1-project-brief/alignment-signoff/workflow.md +157 -0
  241. package/src/workflows/1-project-brief/complete/validation-report-complete.md +142 -0
  242. package/src/workflows/1-project-brief/complete/workflow.md +60 -0
  243. package/src/workflows/1-project-brief/handover/instructions.md +16 -0
  244. package/src/workflows/1-project-brief/handover/steps/step-01-analyze-brief.md +31 -0
  245. package/src/workflows/1-project-brief/handover/steps/step-02-create-summary.md +46 -0
  246. package/src/workflows/1-project-brief/handover/steps/step-03-provide-activation.md +44 -0
  247. package/src/workflows/1-project-brief/project-brief/complete/instructions.md +273 -0
  248. package/src/workflows/1-project-brief/project-brief/complete/project-brief.template.md +193 -0
  249. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-01-init.md +35 -0
  250. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-02-vision.md +43 -0
  251. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-03-positioning.md +34 -0
  252. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-04-create-vtc.md +118 -0
  253. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-05-business-model.md +26 -0
  254. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-06-business-customers.md +28 -0
  255. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-07-target-users.md +40 -0
  256. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-08-success-criteria.md +40 -0
  257. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-09-competitive-landscape.md +42 -0
  258. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-10-constraints.md +43 -0
  259. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-10a-platform-strategy.md +73 -0
  260. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-11-create-vtc.md +133 -0
  261. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-11-tone-of-voice.md +233 -0
  262. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-12-synthesize.md +44 -0
  263. package/src/workflows/1-project-brief/project-brief/complete/steps-c/substeps/11-tone-of-voice-example.md +52 -0
  264. package/src/workflows/1-project-brief/project-brief/complete/workflow.md +60 -0
  265. package/src/workflows/1-project-brief/project-brief/simplified/instructions.md +126 -0
  266. package/src/workflows/1-project-brief/project-brief/simplified/simplified-brief.template.md +44 -0
  267. package/src/workflows/1-project-brief/project-brief/validation-report-project-brief.md +343 -0
  268. package/src/workflows/1-project-brief/workflow.yaml +37 -0
  269. package/src/workflows/2-trigger-mapping/REVIEW-FINDINGS.md +160 -0
  270. package/src/workflows/2-trigger-mapping/document-generation/instructions.md +16 -0
  271. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-01-generate-hub.md +188 -0
  272. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-02-generate-business-goals.md +231 -0
  273. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03a-generate-primary-persona.md +96 -0
  274. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03b-generate-secondary-persona.md +104 -0
  275. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03c-generate-tertiary-persona.md +96 -0
  276. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-04-generate-key-insights.md +88 -0
  277. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-05-quality-check.md +68 -0
  278. package/src/workflows/2-trigger-mapping/document-generation/steps-c/substeps/04-key-insights-structure.md +222 -0
  279. package/src/workflows/2-trigger-mapping/document-generation/steps-c/substeps/05-quality-checklist.md +212 -0
  280. package/src/workflows/2-trigger-mapping/document-generation/templates/persona-document-template.md +485 -0
  281. package/src/workflows/2-trigger-mapping/document-generation/validation-report-document-generation.md +321 -0
  282. package/src/workflows/2-trigger-mapping/document-generation/workflow.md +66 -0
  283. package/src/workflows/2-trigger-mapping/handover/instructions.md +15 -0
  284. package/src/workflows/2-trigger-mapping/handover/steps/step-01-finalize-hub.md +25 -0
  285. package/src/workflows/2-trigger-mapping/handover/steps/step-02-add-cross-references.md +27 -0
  286. package/src/workflows/2-trigger-mapping/handover/steps/step-03-quality-check.md +25 -0
  287. package/src/workflows/2-trigger-mapping/handover/steps/step-04-create-handover-package.md +73 -0
  288. package/src/workflows/2-trigger-mapping/handover/steps/step-05-provide-activation.md +64 -0
  289. package/src/workflows/2-trigger-mapping/instructions.md +159 -0
  290. package/src/workflows/2-trigger-mapping/mermaid-diagram/instructions.md +28 -0
  291. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-01-initialize-structure.md +84 -0
  292. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-02-format-business-goals.md +86 -0
  293. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-03-format-platform.md +94 -0
  294. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-04-format-target-groups.md +113 -0
  295. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-05-format-driving-forces.md +118 -0
  296. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-06-create-connections.md +136 -0
  297. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-07-apply-styling.md +171 -0
  298. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-08-quality-check.md +183 -0
  299. package/src/workflows/2-trigger-mapping/mermaid-diagram/validation-report-mermaid-diagram.md +185 -0
  300. package/src/workflows/2-trigger-mapping/mermaid-diagram/workflow.md +70 -0
  301. package/src/workflows/2-trigger-mapping/micro-instructions-mermaid-diagram.md +262 -0
  302. package/src/workflows/2-trigger-mapping/templates/feature-impact.template.md +47 -0
  303. package/src/workflows/2-trigger-mapping/templates/trigger-map.template.md +169 -0
  304. package/src/workflows/2-trigger-mapping/workflow.yaml +55 -0
  305. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/instructions.md +140 -0
  306. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-01-business-goals.md +124 -0
  307. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-02-target-groups.md +143 -0
  308. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-03-driving-forces.md +133 -0
  309. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-04-prioritization.md +130 -0
  310. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-05-gap-analysis.md +141 -0
  311. package/src/workflows/2-trigger-mapping/workshops/1-business-goals/instructions.md +106 -0
  312. package/src/workflows/2-trigger-mapping/workshops/2-target-groups/instructions.md +106 -0
  313. package/src/workflows/2-trigger-mapping/workshops/3-driving-forces/instructions.md +130 -0
  314. package/src/workflows/2-trigger-mapping/workshops/4-prioritization/instructions.md +203 -0
  315. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/instructions.md +24 -0
  316. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-01-extract-features.md +52 -0
  317. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-02-confirm-assessment.md +41 -0
  318. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-03-make-assessment.md +84 -0
  319. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-04-generate-document.md +81 -0
  320. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-05-wrap-up.md +55 -0
  321. package/src/workflows/3-prd-platform/handover/instructions.md +16 -0
  322. package/src/workflows/3-prd-platform/handover/steps/step-01-compile-deliverables.md +38 -0
  323. package/src/workflows/3-prd-platform/handover/steps/step-02-extract-epic-structure.md +30 -0
  324. package/src/workflows/3-prd-platform/handover/steps/step-03-prepare-prd-materials.md +31 -0
  325. package/src/workflows/3-prd-platform/handover/steps/step-04-create-handover-package.md +57 -0
  326. package/src/workflows/3-prd-platform/handover/steps/step-05-provide-activation.md +68 -0
  327. package/src/workflows/3-prd-platform/instructions.md +1161 -0
  328. package/src/workflows/3-prd-platform/templates/experimental-endpoints.template.md +221 -0
  329. package/src/workflows/3-prd-platform/templates/platform-architecture.template.md +159 -0
  330. package/src/workflows/3-prd-platform/templates/technical-constraints.template.md +191 -0
  331. package/src/workflows/3-prd-platform/workflow.yaml +39 -0
  332. package/src/workflows/4-ux-design/ARCHITECTURE.md +275 -0
  333. package/src/workflows/4-ux-design/COMPONENT-FILE-STRUCTURE.md +742 -0
  334. package/src/workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md +557 -0
  335. package/src/workflows/4-ux-design/CONTENT-PLACEMENT-GUIDE.md +552 -0
  336. package/src/workflows/4-ux-design/CROSS-PAGE-CONSISTENCY.md +301 -0
  337. package/src/workflows/4-ux-design/DOCUMENTATION-ARCHITECTURE.md +161 -0
  338. package/src/workflows/4-ux-design/HTML-VS-VISUAL-STYLES.md +243 -0
  339. package/src/workflows/4-ux-design/IMAGE-SKETCHING-BEST-PRACTICES.md +272 -0
  340. package/src/workflows/4-ux-design/PROACTIVE-TRANSLATION-WORKFLOW.md +447 -0
  341. package/src/workflows/4-ux-design/SKETCH-FIRST-IMPLEMENTATION-PLAN.md +617 -0
  342. package/src/workflows/4-ux-design/SKETCH-TEXT-ANALYSIS-GUIDE.md +532 -0
  343. package/src/workflows/4-ux-design/SKETCH-TEXT-QUICK-REFERENCE.md +222 -0
  344. package/src/workflows/4-ux-design/SKETCH-TEXT-STRATEGY.md +509 -0
  345. package/src/workflows/4-ux-design/STORYBOARD-INTEGRATION.md +714 -0
  346. package/src/workflows/4-ux-design/TRANSLATION-ORGANIZATION-GUIDE.md +513 -0
  347. package/src/workflows/4-ux-design/WDS-SPECIFICATION-PATTERN.md +436 -0
  348. package/src/workflows/4-ux-design/agentic-development/guides/AGENTIC-DEVELOPMENT-GUIDE.md +380 -0
  349. package/src/workflows/4-ux-design/agentic-development/guides/CREATION-GUIDE.md +1148 -0
  350. package/src/workflows/4-ux-design/agentic-development/guides/FILE-INDEX.md +212 -0
  351. package/src/workflows/4-ux-design/agentic-development/guides/PROTOTYPE-ANALYSIS.md +832 -0
  352. package/src/workflows/4-ux-design/agentic-development/guides/PROTOTYPE-INITIATION-DIALOG.md +409 -0
  353. package/src/workflows/4-ux-design/agentic-development/steps-c/1-prototype-setup.md +95 -0
  354. package/src/workflows/4-ux-design/agentic-development/steps-c/2-scenario-analysis.md +174 -0
  355. package/src/workflows/4-ux-design/agentic-development/steps-c/3-logical-view-breakdown.md +197 -0
  356. package/src/workflows/4-ux-design/agentic-development/steps-c/4a-announce-and-gather.md +69 -0
  357. package/src/workflows/4-ux-design/agentic-development/steps-c/4b-create-story-file.md +144 -0
  358. package/src/workflows/4-ux-design/agentic-development/steps-c/4c-implement-section.md +113 -0
  359. package/src/workflows/4-ux-design/agentic-development/steps-c/4d-present-for-testing.md +68 -0
  360. package/src/workflows/4-ux-design/agentic-development/steps-c/4e-handle-issue.md +85 -0
  361. package/src/workflows/4-ux-design/agentic-development/steps-c/4f-handle-improvement.md +104 -0
  362. package/src/workflows/4-ux-design/agentic-development/steps-c/4g-section-approved.md +146 -0
  363. package/src/workflows/4-ux-design/agentic-development/steps-c/5-finalization.md +158 -0
  364. package/src/workflows/4-ux-design/agentic-development/templates/PROTOTYPE-ROADMAP-template.md +382 -0
  365. package/src/workflows/4-ux-design/agentic-development/templates/components/DEV-MODE-GUIDE.md +189 -0
  366. package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.css +164 -0
  367. package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.html +18 -0
  368. package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.js +430 -0
  369. package/src/workflows/4-ux-design/agentic-development/templates/demo-data-template.json +63 -0
  370. package/src/workflows/4-ux-design/agentic-development/templates/page-template.html +465 -0
  371. package/src/workflows/4-ux-design/agentic-development/templates/story-file-template.md +167 -0
  372. package/src/workflows/4-ux-design/agentic-development/templates/work-file-template.yaml +264 -0
  373. package/src/workflows/4-ux-design/agentic-development/validation-report-agentic-development.md +251 -0
  374. package/src/workflows/4-ux-design/agentic-development/workflow.md +631 -0
  375. package/src/workflows/4-ux-design/excalidraw-integration/guides/ai-collaboration.md +565 -0
  376. package/src/workflows/4-ux-design/excalidraw-integration/guides/excalidraw-guide.md +320 -0
  377. package/src/workflows/4-ux-design/excalidraw-integration/guides/excalidraw-setup.md +529 -0
  378. package/src/workflows/4-ux-design/excalidraw-integration/guides/export-workflow.md +563 -0
  379. package/src/workflows/4-ux-design/excalidraw-integration/guides/sketching-guide.md +693 -0
  380. package/src/workflows/4-ux-design/excalidraw-integration/validation-report-excalidraw-integration.md +208 -0
  381. package/src/workflows/4-ux-design/excalidraw-integration/workflow.md +226 -0
  382. package/src/workflows/4-ux-design/handover/instructions.md +15 -0
  383. package/src/workflows/4-ux-design/handover/steps/step-01-analyze-scenarios.md +32 -0
  384. package/src/workflows/4-ux-design/handover/steps/step-01-identify-delivery-scope.md +61 -0
  385. package/src/workflows/4-ux-design/handover/steps/step-02-create-summary.md +59 -0
  386. package/src/workflows/4-ux-design/handover/steps/step-02-extract-technical-needs.md +33 -0
  387. package/src/workflows/4-ux-design/handover/steps/step-03-create-delivery-package.md +79 -0
  388. package/src/workflows/4-ux-design/handover/steps/step-03-provide-activation.md +47 -0
  389. package/src/workflows/4-ux-design/handover/steps/step-04-log-delivery.md +41 -0
  390. package/src/workflows/4-ux-design/handover/steps/step-05-provide-activation.md +75 -0
  391. package/src/workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md +71 -0
  392. package/src/workflows/4-ux-design/modular-architecture/00-foundation/agent-designer-collaboration.md +488 -0
  393. package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/complexity-detection.md +123 -0
  394. package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/content-placement-rules.md +144 -0
  395. package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/three-tier-overview.md +144 -0
  396. package/src/workflows/4-ux-design/modular-architecture/02-workflows/01-what-are-storyboards.md +70 -0
  397. package/src/workflows/4-ux-design/modular-architecture/02-workflows/01-when-to-use.md +68 -0
  398. package/src/workflows/4-ux-design/modular-architecture/02-workflows/02-file-structure.md +86 -0
  399. package/src/workflows/4-ux-design/modular-architecture/02-workflows/complexity-router-workflow.md +155 -0
  400. package/src/workflows/4-ux-design/modular-architecture/02-workflows/page-specification-workflow.md +312 -0
  401. package/src/workflows/4-ux-design/modular-architecture/02-workflows/storyboards-guide.md +75 -0
  402. package/src/workflows/4-ux-design/modular-architecture/03-quick-refs/benefits.md +128 -0
  403. package/src/workflows/4-ux-design/modular-architecture/03-quick-refs/decision-tree.md +67 -0
  404. package/src/workflows/4-ux-design/modular-architecture/validation-report-modular-architecture.md +220 -0
  405. package/src/workflows/4-ux-design/modular-architecture/workflow.md +289 -0
  406. package/src/workflows/4-ux-design/object-types/COMPLEXITY-ROUTER.md +842 -0
  407. package/src/workflows/4-ux-design/object-types/ROUTER-FLOW-DIAGRAM.md +275 -0
  408. package/src/workflows/4-ux-design/object-types/TEXT-DETECTION-PRIORITY.md +391 -0
  409. package/src/workflows/4-ux-design/object-types/object-router.md +349 -0
  410. package/src/workflows/4-ux-design/object-types/templates/button.md +345 -0
  411. package/src/workflows/4-ux-design/object-types/templates/heading-text.md +549 -0
  412. package/src/workflows/4-ux-design/object-types/templates/image.md +165 -0
  413. package/src/workflows/4-ux-design/object-types/templates/link.md +167 -0
  414. package/src/workflows/4-ux-design/object-types/templates/text-input.md +463 -0
  415. package/src/workflows/4-ux-design/object-types/validation-report-object-types.md +295 -0
  416. package/src/workflows/4-ux-design/object-types/workflow.md +439 -0
  417. package/src/workflows/4-ux-design/page-specification-quality/data/validation-standards.md +215 -0
  418. package/src/workflows/4-ux-design/page-specification-quality/instructions.md +32 -0
  419. package/src/workflows/4-ux-design/page-specification-quality/quality-guide.md +653 -0
  420. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-01-page-metadata.md +55 -0
  421. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-02-navigation.md +54 -0
  422. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-03-page-overview.md +47 -0
  423. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-04-page-sections.md +58 -0
  424. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-05-section-order.md +59 -0
  425. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-06-object-registry.md +52 -0
  426. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-07-design-system-separation.md +64 -0
  427. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-08-final-validation.md +92 -0
  428. package/src/workflows/4-ux-design/page-specification-quality/templates/diagnostic-report-template.md +227 -0
  429. package/src/workflows/4-ux-design/page-specification-quality/validation-report-page-specification-quality.md +357 -0
  430. package/src/workflows/4-ux-design/page-specification-quality/workflow.md +146 -0
  431. package/src/workflows/4-ux-design/scenario-init/SCENARIO-INIT-DIALOG.md +538 -0
  432. package/src/workflows/4-ux-design/scenario-init/SCENARIO-INIT-PROCESS.md +221 -0
  433. package/src/workflows/4-ux-design/scenario-init/steps-c/00-SCENARIO-INIT-GUIDE.md +76 -0
  434. package/src/workflows/4-ux-design/scenario-init/steps-c/01-platform-confirmation.md +167 -0
  435. package/src/workflows/4-ux-design/scenario-init/steps-c/02-feature-selection.md +70 -0
  436. package/src/workflows/4-ux-design/scenario-init/steps-c/03-entry-point.md +67 -0
  437. package/src/workflows/4-ux-design/scenario-init/steps-c/04-mental-state.md +74 -0
  438. package/src/workflows/4-ux-design/scenario-init/steps-c/05-mutual-success.md +69 -0
  439. package/src/workflows/4-ux-design/scenario-init/steps-c/06-shortest-path.md +92 -0
  440. package/src/workflows/4-ux-design/scenario-init/steps-c/07-create-vtc.md +132 -0
  441. package/src/workflows/4-ux-design/scenario-init/steps-c/examples/booking-example.md +64 -0
  442. package/src/workflows/4-ux-design/scenario-init/steps-c/examples/ecommerce-example.md +64 -0
  443. package/src/workflows/4-ux-design/scenario-init/steps-c/examples/saas-example.md +64 -0
  444. package/src/workflows/4-ux-design/scenario-init/validation-report-scenario-init.md +290 -0
  445. package/src/workflows/4-ux-design/scenario-init/workflow.md +117 -0
  446. package/src/workflows/4-ux-design/specification-audit-workflow.md +697 -0
  447. package/src/workflows/4-ux-design/steps/step-01-init.md +116 -0
  448. package/src/workflows/4-ux-design/steps/step-02-setup-scenario-structure.md +67 -0
  449. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/page-init-lightweight.md +355 -0
  450. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-01-page-context.md +61 -0
  451. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-02-page-name.md +26 -0
  452. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-03-page-purpose.md +25 -0
  453. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-04-entry-point.md +27 -0
  454. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-05-mental-state.md +22 -0
  455. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-06-desired-outcome.md +22 -0
  456. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-07-variants.md +29 -0
  457. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-08-create-page-structure.md +141 -0
  458. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-c-placeholder-pages.md +406 -0
  459. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-page-creation.md +578 -0
  460. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-page-process.md +333 -0
  461. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-01-core-feature.md +26 -0
  462. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-02-entry-point.md +26 -0
  463. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-03-mental-state.md +24 -0
  464. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-04-mutual-success.md +27 -0
  465. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-05-shortest-path.md +39 -0
  466. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-06-scenario-name.md +24 -0
  467. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-07-create-scenario-folder.md +145 -0
  468. package/src/workflows/4-ux-design/steps/step-02-substeps/substeps-guide.md +110 -0
  469. package/src/workflows/4-ux-design/steps/step-03-design-page.md +189 -0
  470. package/src/workflows/4-ux-design/steps/step-04-complete-scenario.md +59 -0
  471. package/src/workflows/4-ux-design/steps/step-05-next-steps.md +76 -0
  472. package/src/workflows/4-ux-design/stitch-generation/stitch-prompt.template.md +174 -0
  473. package/src/workflows/4-ux-design/stitch-generation/workflow.md +288 -0
  474. package/src/workflows/4-ux-design/substeps/4a-exploration.md +106 -0
  475. package/src/workflows/4-ux-design/substeps/4b-sketch-analysis.md +536 -0
  476. package/src/workflows/4-ux-design/substeps/4c-01-page-basics.md +59 -0
  477. package/src/workflows/4-ux-design/substeps/4c-02-layout-sections.md +66 -0
  478. package/src/workflows/4-ux-design/substeps/4c-03-components-objects.md +154 -0
  479. package/src/workflows/4-ux-design/substeps/4c-04-content-languages.md +83 -0
  480. package/src/workflows/4-ux-design/substeps/4c-05-interactions.md +82 -0
  481. package/src/workflows/4-ux-design/substeps/4c-06-states.md +125 -0
  482. package/src/workflows/4-ux-design/substeps/4c-07-validation.md +124 -0
  483. package/src/workflows/4-ux-design/substeps/4c-08-generate-spec.md +105 -0
  484. package/src/workflows/4-ux-design/substeps/4d-prototype.md +282 -0
  485. package/src/workflows/4-ux-design/substeps/4e-prd-update.md +139 -0
  486. package/src/workflows/4-ux-design/templates/audit-report.template.md +430 -0
  487. package/src/workflows/4-ux-design/templates/instructions/accessibility-audit.workflow.md +166 -0
  488. package/src/workflows/4-ux-design/templates/instructions/accessibility.instructions.md +102 -0
  489. package/src/workflows/4-ux-design/templates/instructions/data-api.instructions.md +69 -0
  490. package/src/workflows/4-ux-design/templates/instructions/form-validation.instructions.md +54 -0
  491. package/src/workflows/4-ux-design/templates/instructions/meta-content.instructions.md +37 -0
  492. package/src/workflows/4-ux-design/templates/instructions/open-questions.instructions.md +164 -0
  493. package/src/workflows/4-ux-design/templates/instructions/responsive.instructions.md +64 -0
  494. package/src/workflows/4-ux-design/templates/page-specification.template.md +227 -0
  495. package/src/workflows/4-ux-design/templates/scenario-overview.template.md +159 -0
  496. package/src/workflows/4-ux-design/templates/storyboard-specification.template.md +94 -0
  497. package/src/workflows/4-ux-design/ux-design-guide.md +223 -0
  498. package/src/workflows/4-ux-design/workflow-new.yaml +18 -0
  499. package/src/workflows/4-ux-design/workflow.md +61 -0
  500. package/src/workflows/4-ux-design/workflow.yaml +18 -0
  501. package/src/workflows/5-design-system/assessment/01-scan-existing.md +166 -0
  502. package/src/workflows/5-design-system/assessment/02-compare-attributes.md +287 -0
  503. package/src/workflows/5-design-system/assessment/03-calculate-similarity.md +357 -0
  504. package/src/workflows/5-design-system/assessment/04-identify-opportunities.md +339 -0
  505. package/src/workflows/5-design-system/assessment/05-identify-risks.md +357 -0
  506. package/src/workflows/5-design-system/assessment/06-present-decision.md +435 -0
  507. package/src/workflows/5-design-system/assessment/07-execute-decision.md +523 -0
  508. package/src/workflows/5-design-system/design-system-guide.md +353 -0
  509. package/src/workflows/5-design-system/design-system-router.md +370 -0
  510. package/src/workflows/5-design-system/figma-integration/INTEGRATION-SUMMARY.md +458 -0
  511. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-connection-check.md +118 -0
  512. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-01-plugin-installation.md +37 -0
  513. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-02-activate-plugin.md +37 -0
  514. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-03-verify-mcp.md +51 -0
  515. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-02-identify-export-type.md +161 -0
  516. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-prepare-specifications.md +138 -0
  517. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-01-analyze-code.md +62 -0
  518. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-02-generate-ids.md +69 -0
  519. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-03-create-spec.md +98 -0
  520. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-04-review-spec.md +86 -0
  521. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-04-generate-validate.md +207 -0
  522. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-05-execute-export.md +229 -0
  523. package/src/workflows/5-design-system/figma-integration/code-to-figma/workflow.md +64 -0
  524. package/src/workflows/5-design-system/figma-integration/figma-to-code/README.md +0 -0
  525. package/src/workflows/5-design-system/figma-integration/figma-to-code/figma-integration-guide.md +37 -0
  526. package/src/workflows/5-design-system/figma-integration/reference/figma-designer-guide.md +687 -0
  527. package/src/workflows/5-design-system/figma-integration/reference/figma-mcp-integration.md +661 -0
  528. package/src/workflows/5-design-system/figma-integration/reference/mcp-server-integration.md +922 -0
  529. package/src/workflows/5-design-system/figma-integration/reference/prototype-to-figma-workflow.md +933 -0
  530. package/src/workflows/5-design-system/figma-integration/reference/tools-reference.md +665 -0
  531. package/src/workflows/5-design-system/figma-integration/reference/when-to-extract-decision-guide.md +663 -0
  532. package/src/workflows/5-design-system/operations/add-variant.md +490 -0
  533. package/src/workflows/5-design-system/operations/create-new-component.md +711 -0
  534. package/src/workflows/5-design-system/operations/generate-catalog.md +686 -0
  535. package/src/workflows/5-design-system/operations/initialize-design-system.md +467 -0
  536. package/src/workflows/5-design-system/operations/update-component.md +600 -0
  537. package/src/workflows/5-design-system/templates/catalog.template.html +363 -0
  538. package/src/workflows/5-design-system/templates/component-library-config.template.md +65 -0
  539. package/src/workflows/5-design-system/templates/component.template.md +134 -0
  540. package/src/workflows/5-design-system/templates/design-tokens.template.md +168 -0
  541. package/src/workflows/5-design-system/workflow.yaml +22 -0
  542. package/src/workflows/6-design-deliveries/design-deliveries-guide.md +489 -0
  543. package/src/workflows/6-design-deliveries/steps/step-6.1-detect-completion.md +131 -0
  544. package/src/workflows/6-design-deliveries/steps/step-6.2-create-delivery.md +156 -0
  545. package/src/workflows/6-design-deliveries/steps/step-6.2-create-delivery.md.bak +309 -0
  546. package/src/workflows/6-design-deliveries/steps/step-6.3-create-test-scenario.md +155 -0
  547. package/src/workflows/6-design-deliveries/steps/step-6.3-create-test-scenario.md.bak +432 -0
  548. package/src/workflows/6-design-deliveries/steps/step-6.4-handoff-dialog.md +441 -0
  549. package/src/workflows/6-design-deliveries/steps/step-6.5-hand-off.md +327 -0
  550. package/src/workflows/6-design-deliveries/steps/step-6.6-continue.md +414 -0
  551. package/src/workflows/6-design-deliveries/workflow.md +67 -0
  552. package/src/workflows/7-testing/steps/step-7.1-receive-notification.md +261 -0
  553. package/src/workflows/7-testing/steps/step-7.2-prepare-testing.md +399 -0
  554. package/src/workflows/7-testing/steps/step-7.3-run-tests.md +683 -0
  555. package/src/workflows/7-testing/steps/step-7.4-create-issues.md +517 -0
  556. package/src/workflows/7-testing/steps/step-7.5-create-report.md +441 -0
  557. package/src/workflows/7-testing/steps/step-7.6-send-to-bmad.md +392 -0
  558. package/src/workflows/7-testing/steps/step-7.7-iterate-or-approve.md +596 -0
  559. package/src/workflows/7-testing/testing-guide.md +613 -0
  560. package/src/workflows/7-testing/workflow.md +79 -0
  561. package/src/workflows/8-ongoing-development/existing-product-guide.md +929 -0
  562. package/src/workflows/8-ongoing-development/steps/step-8.1-identify-opportunity.md +497 -0
  563. package/src/workflows/8-ongoing-development/steps/step-8.2-gather-context.md +380 -0
  564. package/src/workflows/8-ongoing-development/steps/step-8.3-design-update.md +495 -0
  565. package/src/workflows/8-ongoing-development/steps/step-8.4-create-delivery.md +402 -0
  566. package/src/workflows/8-ongoing-development/steps/step-8.5-hand-off.md +163 -0
  567. package/src/workflows/8-ongoing-development/steps/step-8.6-validate.md +265 -0
  568. package/src/workflows/8-ongoing-development/steps/step-8.7-monitor.md +432 -0
  569. package/src/workflows/8-ongoing-development/steps/step-8.8-iterate.md +547 -0
  570. package/src/workflows/8-ongoing-development/workflow.md +302 -0
  571. package/src/workflows/9-agent-dialogs/steps/step-01-initialize-dialog.md +244 -0
  572. package/src/workflows/9-agent-dialogs/steps/step-02-analyze-scope.md +195 -0
  573. package/src/workflows/9-agent-dialogs/steps/step-03-create-steps.md +186 -0
  574. package/src/workflows/9-agent-dialogs/steps/step-04-execute-steps.md +250 -0
  575. package/src/workflows/9-agent-dialogs/steps/step-05-complete-dialog.md +177 -0
  576. package/src/workflows/9-agent-dialogs/templates/dialog-capture.template.md +75 -0
  577. package/src/workflows/9-agent-dialogs/templates/dialog-types/INDEX.md +142 -0
  578. package/src/workflows/9-agent-dialogs/templates/dialog-types/bug-fix.template.md +164 -0
  579. package/src/workflows/9-agent-dialogs/templates/dialog-types/design-exploration.template.md +180 -0
  580. package/src/workflows/9-agent-dialogs/templates/dialog-types/prototype-implementation.template.md +292 -0
  581. package/src/workflows/9-agent-dialogs/templates/dialog-types/stitch-generation.template.md +311 -0
  582. package/src/workflows/9-agent-dialogs/templates/dialog.template.md +200 -0
  583. package/src/workflows/9-agent-dialogs/templates/step.template.md +118 -0
  584. package/src/workflows/9-agent-dialogs/workflow.md +401 -0
  585. package/src/workflows/PROJECT-STRUCTURE-SYSTEM.md +226 -0
  586. package/src/workflows/VALIDATION-SUMMARY-REPORT.md +329 -0
  587. package/src/workflows/paths/design-system-only.yaml +62 -0
  588. package/src/workflows/paths/digital-strategy.yaml +39 -0
  589. package/src/workflows/paths/feature-enhancement.yaml +93 -0
  590. package/src/workflows/paths/full-product.yaml +96 -0
  591. package/src/workflows/paths/landing-page.yaml +54 -0
  592. package/src/workflows/paths/quick-prototype.yaml +39 -0
  593. package/src/workflows/project-analysis/AGENT-INITIATION-FLOW.md +295 -0
  594. package/src/workflows/project-analysis/LINK-VERIFICATION.md +179 -0
  595. package/src/workflows/project-analysis/ROUTER-ARCHITECTURE.md +224 -0
  596. package/src/workflows/project-analysis/SYSTEM-GUIDE.md +105 -0
  597. package/src/workflows/project-analysis/agent-domains/freya-domain.md +144 -0
  598. package/src/workflows/project-analysis/agent-domains/idunn-domain.md +112 -0
  599. package/src/workflows/project-analysis/agent-domains/saga-domain.md +132 -0
  600. package/src/workflows/project-analysis/agent-handoff-guide.md +233 -0
  601. package/src/workflows/project-analysis/analysis-types/empty-project-response.md +141 -0
  602. package/src/workflows/project-analysis/analysis-types/folder-based-analysis.md +135 -0
  603. package/src/workflows/project-analysis/analysis-types/new-project-response.md +194 -0
  604. package/src/workflows/project-analysis/analysis-types/outline-based-analysis.md +207 -0
  605. package/src/workflows/project-analysis/analysis-types/unknown-structure-response.md +216 -0
  606. package/src/workflows/project-analysis/context-aware-activation.md +99 -0
  607. package/src/workflows/project-analysis/conversation-persistence/check-conversations.md +162 -0
  608. package/src/workflows/project-analysis/conversation-persistence/conversation-template.md +70 -0
  609. package/src/workflows/project-analysis/conversation-persistence/persistence-guide.md +81 -0
  610. package/src/workflows/project-analysis/conversation-persistence/save-conversation.md +146 -0
  611. package/src/workflows/project-analysis/instructions.md +30 -0
  612. package/src/workflows/project-analysis/project-analysis-router.md +76 -0
  613. package/src/workflows/project-analysis/task-reflection.md +303 -0
  614. package/src/workflows/project-analysis/validation/deep-validation-before-work.md +235 -0
  615. package/src/workflows/project-analysis/work-types/strategy-work.md +88 -0
  616. package/src/workflows/project-analysis/workflow.yaml +82 -0
  617. package/src/workflows/shared/content-creation-workshop/content-creation-workshop-guide.md +320 -0
  618. package/src/workflows/shared/content-creation-workshop/content-output.template.md +349 -0
  619. package/src/workflows/shared/content-creation-workshop/steps-c/OPTIMIZATION-COMPLETE.md +143 -0
  620. package/src/workflows/shared/content-creation-workshop/steps-c/step-00-define-purpose.md +196 -0
  621. package/src/workflows/shared/content-creation-workshop/steps-c/step-01-load-vtc-context.md +126 -0
  622. package/src/workflows/shared/content-creation-workshop/steps-c/step-02-awareness-strategy.md +245 -0
  623. package/src/workflows/shared/content-creation-workshop/steps-c/step-03-action-filter.md +230 -0
  624. package/src/workflows/shared/content-creation-workshop/steps-c/step-04-empowerment-frame.md +248 -0
  625. package/src/workflows/shared/content-creation-workshop/steps-c/step-05-structural-order.md +227 -0
  626. package/src/workflows/shared/content-creation-workshop/steps-c/step-06-generate-content.md +247 -0
  627. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/00-purpose-examples.md +131 -0
  628. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/03-action-filter-example.md +97 -0
  629. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-badass-users-principles.md +159 -0
  630. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-example-empowerment-frame.md +88 -0
  631. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-example-golden-circle.md +96 -0
  632. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-golden-circle-guide.md +160 -0
  633. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-example-hairdresser-newsletter.md +136 -0
  634. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-generation-instructions.md +95 -0
  635. package/src/workflows/shared/content-creation-workshop/steps-c/workflow.md +41 -0
  636. package/src/workflows/shared/content-creation-workshop/validation-report-content-creation-workshop.md +303 -0
  637. package/src/workflows/shared/content-creation-workshop/workflow.md +87 -0
  638. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-01-define-business-goal.md +115 -0
  639. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-02-identify-solution.md +105 -0
  640. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-03-describe-user.md +131 -0
  641. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-04-positive-driving-forces.md +150 -0
  642. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-05-negative-driving-forces.md +190 -0
  643. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-06-customer-awareness.md +256 -0
  644. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-07-review-and-save.md +233 -0
  645. package/src/workflows/shared/vtc-workshop/creation-steps-c/workflow.md +43 -0
  646. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-01-load-trigger-map.md +81 -0
  647. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-02-select-business-goal.md +84 -0
  648. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-03-select-user.md +88 -0
  649. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-04-select-driving-forces.md +100 -0
  650. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-05-define-solution.md +59 -0
  651. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-06-customer-awareness.md +75 -0
  652. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-07-review-and-save.md +151 -0
  653. package/src/workflows/shared/vtc-workshop/selection-steps-c/workflow.md +48 -0
  654. package/src/workflows/shared/vtc-workshop/validation-report-vtc-workshop.md +269 -0
  655. package/src/workflows/shared/vtc-workshop/vtc-creation-workshop.md +457 -0
  656. package/src/workflows/shared/vtc-workshop/vtc-selection-workshop.md +557 -0
  657. package/src/workflows/shared/vtc-workshop/vtc-template.yaml +210 -0
  658. package/src/workflows/shared/vtc-workshop/vtc-workshop-guide.md +418 -0
  659. package/src/workflows/shared/vtc-workshop/vtc-workshop-router.md +146 -0
  660. package/src/workflows/shared/vtc-workshop/workflow.md +174 -0
  661. package/src/workflows/workflow-init/COMPLETE-SYSTEM-SUMMARY.md +314 -0
  662. package/src/workflows/workflow-init/FINAL-SYSTEM-SUMMARY.md +321 -0
  663. package/src/workflows/workflow-init/PROJECT-OUTLINE-SYSTEM.md +240 -0
  664. package/src/workflows/workflow-init/excalidraw-setup-prompt.md +365 -0
  665. package/src/workflows/workflow-init/instructions.md +22 -0
  666. package/src/workflows/workflow-init/methodology-instructions/custom-methodology-template.md +299 -0
  667. package/src/workflows/workflow-init/methodology-instructions/methodology-guide.md +252 -0
  668. package/src/workflows/workflow-init/methodology-instructions/wds-v6-instructions.md +221 -0
  669. package/src/workflows/workflow-init/methodology-instructions/wps2c-v4-instructions.md +231 -0
  670. package/src/workflows/workflow-init/project-config.template.yaml +87 -0
  671. package/src/workflows/workflow-init/project-initiation-conversation.md +957 -0
  672. package/src/workflows/workflow-init/project-outline.template.yaml +429 -0
  673. package/src/workflows/workflow-init/project-type-selection.md +318 -0
  674. package/src/workflows/workflow-init/steps/step-02-project-structure.md +54 -0
  675. package/src/workflows/workflow-init/steps/step-03-delivery-config.md +76 -0
  676. package/src/workflows/workflow-init/steps/step-04-phases-selection.md +180 -0
  677. package/src/workflows/workflow-init/workflow.yaml +32 -0
  678. package/src/workflows/workflow-status/instructions.md +143 -0
  679. package/src/workflows/workflow-status/workflow.yaml +25 -0
  680. package/tools/cli/commands/install.js +34 -0
  681. package/tools/cli/lib/compiler.js +407 -0
  682. package/tools/cli/lib/ide-configs.js +104 -0
  683. package/tools/cli/lib/installer.js +257 -0
  684. package/tools/cli/lib/ui.js +127 -0
  685. package/tools/cli/wds-cli.js +43 -0
  686. package/tools/wds-npx-wrapper.js +37 -0
@@ -0,0 +1,491 @@
1
+ # Module 04: Product Brief
2
+
3
+ ## Lesson 5: Using Your Product Brief
4
+
5
+ **How this document powers your entire project**
6
+
7
+ ---
8
+
9
+ ## Not Filed Away, Actively Referenced
10
+
11
+ The Product Brief isn't a document you create and forget. It's your active reference throughout the project - the single source of truth that guides every decision.
12
+
13
+ **The difference:**
14
+
15
+ **Filed Away (Useless):**
16
+ - Created once, never opened again
17
+ - Stored somewhere nobody remembers
18
+ - Outdated within weeks
19
+ - Ignored when making decisions
20
+
21
+ **Actively Referenced (Powerful):**
22
+ - Opened multiple times per week
23
+ - Linked in all project documentation
24
+ - Updated when assumptions change
25
+ - Consulted before major decisions
26
+
27
+ **The goal:** Make the brief so useful that people naturally reference it.
28
+
29
+ ---
30
+
31
+ ## How Designers Use It
32
+
33
+ Designers reference the Product Brief to make confident decisions without constant stakeholder approval.
34
+
35
+ ### Making Design Decisions
36
+
37
+ **The Question:** "Should we add this feature?"
38
+
39
+ **Without the Brief:**
40
+ - Designer guesses based on intuition
41
+ - Asks stakeholders (delays decision)
42
+ - Builds it and hopes it's right
43
+ - Discovers later it doesn't fit
44
+
45
+ **With the Brief:**
46
+ 1. Check the vision - does this align?
47
+ 2. Check target users - do they need this?
48
+ 3. Check success criteria - does this contribute?
49
+ 4. Check constraints - is this feasible?
50
+ 5. Make confident decision
51
+
52
+ **Example:**
53
+
54
+ Designer considering social sharing features:
55
+ - Vision: "Family coordination for dog care" → Social sharing doesn't align
56
+ - Target users: "Parents managing household" → They need coordination, not social
57
+ - Success criteria: "Reduce coordination stress" → Social features add complexity
58
+ - Decision: No, doesn't fit the brief
59
+
60
+ **Time saved:** No meeting needed, confident decision made in minutes.
61
+
62
+ ### Validating Design Solutions
63
+
64
+ **The Question:** "Is this design on the right track?"
65
+
66
+ **Without the Brief:**
67
+ - Designer relies on personal taste
68
+ - Unclear if it serves the right users
69
+ - Uncertain if it meets success criteria
70
+ - Validation happens late (expensive)
71
+
72
+ **With the Brief:**
73
+ 1. Does it serve primary users?
74
+ 2. Does it solve the core problem?
75
+ 3. Does it respect constraints?
76
+ 4. Does it differentiate us?
77
+ 5. Will it contribute to success criteria?
78
+
79
+ **Example:**
80
+
81
+ Designer reviewing interface complexity:
82
+ - Target users: "Tech-comfortable parents" → Can handle moderate complexity
83
+ - Success criteria: "Task completion < 2 minutes" → Must be fast
84
+ - Constraints: "Family-friendly, organized, calm" → Can't be overwhelming
85
+ - Decision: Simplify, optimize for speed
86
+
87
+ ### Staying Aligned During Iteration
88
+
89
+ **The Challenge:** Design evolves through iteration. How do you know if you're still on track?
90
+
91
+ **The Brief as North Star:**
92
+ - Vision doesn't change (unless project pivots)
93
+ - Target users don't change (unless you discover new insights)
94
+ - Success criteria don't change (unless you learn they're wrong)
95
+ - Constraints don't change (unless business reality shifts)
96
+
97
+ **When iterating:**
98
+ - Reference the brief at start of each sprint
99
+ - Check alignment after major design changes
100
+ - Validate that iterations serve the vision
101
+ - Update brief if fundamental assumptions change
102
+
103
+ ---
104
+
105
+ ## How Developers Use It
106
+
107
+ Developers reference the Product Brief to understand the "why" behind requirements and make technical decisions that serve the vision.
108
+
109
+ ### Understanding the "Why"
110
+
111
+ **The Problem:** Developers get requirements without context. They build what's specified, not what's needed.
112
+
113
+ **The Brief Provides Context:**
114
+
115
+ **Without the Brief:**
116
+ - "Build a calendar feature" → Builds generic calendar
117
+ - No understanding of user needs
118
+ - No context for technical decisions
119
+ - Builds to spec, not to purpose
120
+
121
+ **With the Brief:**
122
+ - Reads vision: "Family coordination for dog care"
123
+ - Reads target users: "Parents managing household responsibilities"
124
+ - Reads success criteria: "Task completion < 2 minutes"
125
+ - Understands: This needs to be fast and family-focused, not feature-rich
126
+ - Builds accordingly
127
+
128
+ ### Making Technical Decisions
129
+
130
+ **The Question:** "Which technical approach should we use?"
131
+
132
+ **Without the Brief:**
133
+ - Developer chooses based on personal preference
134
+ - Might over-engineer or under-engineer
135
+ - Unclear what performance matters
136
+ - Uncertain about future requirements
137
+
138
+ **With the Brief:**
139
+ 1. Check constraints - what's required?
140
+ 2. Check success criteria - what performance matters?
141
+ 3. Check vision - what's the long-term direction?
142
+ 4. Make informed technical decision
143
+
144
+ **Example:**
145
+
146
+ Developer choosing database approach:
147
+ - Constraints: "Offline core features required" → Need local storage
148
+ - Success criteria: "< 2s load time" → Need fast queries
149
+ - Vision: "Family coordination" → Need sync across devices
150
+ - Decision: Local-first architecture with sync
151
+
152
+ ### Prioritizing Technical Work
153
+
154
+ **The Question:** "What should we build first?"
155
+
156
+ **Without the Brief:**
157
+ - Build in order received
158
+ - Unclear what's critical vs nice-to-have
159
+ - Risk building wrong things first
160
+ - Discover priorities late
161
+
162
+ **With the Brief:**
163
+ 1. What serves primary users?
164
+ 2. What contributes to success criteria?
165
+ 3. What's required by constraints?
166
+ 4. What enables the vision?
167
+
168
+ **Example:**
169
+
170
+ Developer prioritizing features:
171
+ - Success criteria: "90% task completion rate" → Core task flow is critical
172
+ - Constraints: "6-month timeline to MVP" → Must focus on essentials
173
+ - Target users: "Parents managing household" → Notifications are important
174
+ - Priority: Task flow, then notifications, then nice-to-haves
175
+
176
+ ---
177
+
178
+ ## How Stakeholders Use It
179
+
180
+ Stakeholders reference the Product Brief to track progress, make informed decisions, and prevent scope creep.
181
+
182
+ ### Tracking Progress
183
+
184
+ **The Question:** "Is the project on track?"
185
+
186
+ **Without the Brief:**
187
+ - Subjective assessment
188
+ - Unclear what "on track" means
189
+ - Debates about what matters
190
+ - Anxiety about progress
191
+
192
+ **With the Brief:**
193
+ 1. Check success criteria - are we hitting metrics?
194
+ 2. Check timeline constraints - are we on schedule?
195
+ 3. Check vision - are we building what we said?
196
+ 4. Make objective assessment
197
+
198
+ **Example:**
199
+
200
+ Stakeholder reviewing progress:
201
+ - Success criteria: "1,000 active users by month 6" → Currently at 800 (month 5)
202
+ - Timeline: "6-month MVP" → On schedule for launch
203
+ - Vision: "Family coordination" → Features align
204
+ - Assessment: On track, slight user acquisition concern
205
+
206
+ ### Making Informed Decisions
207
+
208
+ **The Question:** "Should we approve this change?"
209
+
210
+ **Without the Brief:**
211
+ - Decision based on opinion
212
+ - Unclear if change aligns with vision
213
+ - Risk of scope creep
214
+ - Inconsistent decision-making
215
+
216
+ **With the Brief:**
217
+ 1. Does it align with vision?
218
+ 2. Does it serve target users?
219
+ 3. Does it contribute to success criteria?
220
+ 4. Is it feasible within constraints?
221
+
222
+ **Example:**
223
+
224
+ Stakeholder evaluating feature request:
225
+ - Request: "Add social features"
226
+ - Vision: "Family coordination" → Social doesn't align
227
+ - Success criteria: "Reduce coordination stress" → Social adds complexity
228
+ - Constraints: "6-month timeline" → No time for scope expansion
229
+ - Decision: No, doesn't fit the brief
230
+
231
+ ### Preventing Scope Creep
232
+
233
+ **The Challenge:** Everyone has ideas. How do you say no without seeming negative?
234
+
235
+ **The Brief as Shield:**
236
+
237
+ **Without the Brief:**
238
+ - "Can we add this?" → "I don't know, maybe?"
239
+ - No clear criteria for yes/no
240
+ - Scope grows unchecked
241
+ - Timeline and budget suffer
242
+
243
+ **With the Brief:**
244
+ - "Can we add this?" → "Let's check the brief"
245
+ - Vision: Does it align?
246
+ - Users: Do they need it?
247
+ - Criteria: Does it contribute?
248
+ - Constraints: Do we have time/budget?
249
+ - Clear yes/no with justification
250
+
251
+ **Example:**
252
+
253
+ Stakeholder suggesting enterprise features:
254
+ - Target users: "Parents managing household" → Not enterprise users
255
+ - Constraints: "Bootstrap budget, 6-month timeline" → No resources for enterprise
256
+ - Vision: "Family coordination" → Consumer focus
257
+ - Response: "Great idea for phase 2, but doesn't fit MVP brief"
258
+
259
+ ---
260
+
261
+ ## How Product Managers Use It
262
+
263
+ Product managers reference the Product Brief to create roadmaps, write user stories, and measure success.
264
+
265
+ ### Creating Roadmaps
266
+
267
+ **The Question:** "What should we build next?"
268
+
269
+ **Without the Brief:**
270
+ - Roadmap based on requests
271
+ - Unclear prioritization criteria
272
+ - Risk of building wrong things
273
+ - Reactive instead of strategic
274
+
275
+ **With the Brief:**
276
+ 1. What serves the vision?
277
+ 2. What moves success criteria?
278
+ 3. What target users need most?
279
+ 4. What's feasible within constraints?
280
+
281
+ **Example:**
282
+
283
+ PM planning Q2 roadmap:
284
+ - Success criteria: "70% weekly active users" → Focus on retention
285
+ - Target users: "Parents managing household" → Need reminders, notifications
286
+ - Constraints: "Small team" → Must be achievable
287
+ - Roadmap: Notification system, recurring tasks, mobile improvements
288
+
289
+ ### Writing User Stories
290
+
291
+ **The Question:** "How should we describe this feature?"
292
+
293
+ **Without the Brief:**
294
+ - Generic user stories
295
+ - Unclear user context
296
+ - Missing success criteria
297
+ - Developers guess at intent
298
+
299
+ **With the Brief:**
300
+ - Reference target users for "As a..."
301
+ - Reference vision for "I want to..."
302
+ - Reference success criteria for "So that..."
303
+ - Clear, contextualized stories
304
+
305
+ **Example:**
306
+
307
+ Writing story for task assignment:
308
+ - Target users: "Parents managing household responsibilities"
309
+ - Vision: "Eliminate coordination confusion"
310
+ - Success criteria: "Task completion < 2 minutes"
311
+ - Story: "As a parent managing household responsibilities, I want to quickly assign tasks to family members so that everyone knows their responsibilities without confusion or back-and-forth communication"
312
+
313
+ ### Measuring Success
314
+
315
+ **The Question:** "Are we successful?"
316
+
317
+ **Without the Brief:**
318
+ - Success is subjective
319
+ - Debates about what matters
320
+ - Moving goalposts
321
+ - Unclear when to celebrate
322
+
323
+ **With the Brief:**
324
+ - Success criteria are defined
325
+ - Metrics are measurable
326
+ - Goalposts are fixed
327
+ - Clear success indicators
328
+
329
+ **Example:**
330
+
331
+ PM measuring launch success:
332
+ - User success: "80% report reduced stress" → Survey shows 82% ✅
333
+ - Business success: "1,000 active families by month 6" → Hit 1,200 ✅
334
+ - Technical success: "99.9% uptime" → Achieved 99.95% ✅
335
+ - Design success: "SUS score > 75" → Scored 78 ✅
336
+ - Result: Successful launch, all criteria met
337
+
338
+ ---
339
+
340
+ ## When to Update the Brief
341
+
342
+ The Product Brief is a living document, but not everything requires an update.
343
+
344
+ ### When to Update
345
+
346
+ **✅ Update when:**
347
+
348
+ **Fundamental Assumptions Change:**
349
+ - Market research reveals different user needs
350
+ - Competitive landscape shifts significantly
351
+ - Business constraints change (budget, timeline, resources)
352
+ - Technical constraints change (platform requirements)
353
+ - Success criteria prove unrealistic or wrong
354
+
355
+ **Example:**
356
+ - Discovery: Primary users also need multi-pet support
357
+ - Impact: Changes target users, success criteria, constraints
358
+ - Action: Update brief, notify team, adjust roadmap
359
+
360
+ **Major Pivots:**
361
+ - Vision changes direction
362
+ - Target users shift
363
+ - Business model changes
364
+ - Positioning evolves
365
+
366
+ **Example:**
367
+ - Decision: Pivot from consumer to enterprise
368
+ - Impact: Changes everything
369
+ - Action: Major brief update, team alignment session
370
+
371
+ ### When NOT to Update
372
+
373
+ **❌ Don't update for:**
374
+
375
+ **Tactical Decisions:**
376
+ - Individual feature decisions
377
+ - Design iterations
378
+ - Minor technical choices
379
+ - Day-to-day prioritization
380
+
381
+ **Example:**
382
+ - Decision: Change button color
383
+ - Impact: None on strategy
384
+ - Action: No brief update needed
385
+
386
+ **Opinions and Preferences:**
387
+ - Stakeholder suggestions
388
+ - Team member ideas
389
+ - User feature requests
390
+ - Competitive feature additions
391
+
392
+ **Example:**
393
+ - Request: "Can we add dark mode?"
394
+ - Impact: Doesn't change strategy
395
+ - Action: Evaluate against brief, but don't update brief
396
+
397
+ **The Rule:** Update the brief when fundamental strategy changes, not when tactics evolve.
398
+
399
+ ---
400
+
401
+ ## Making It a Habit
402
+
403
+ The brief is only powerful if people actually use it. Here's how to make it a habit:
404
+
405
+ ### Make It Accessible
406
+
407
+ **Where to store it:**
408
+ - Project root: `/docs/A-Product-Brief/project-brief.md`
409
+ - Always in the same place
410
+ - Version controlled (Git)
411
+ - Linked from README
412
+
413
+ **How to reference it:**
414
+ - Include path in onboarding
415
+ - Link in project documentation
416
+ - Reference in meeting agendas
417
+ - Quote in decision documents
418
+
419
+ ### Make It Referenced
420
+
421
+ **In meetings:**
422
+ - Start design reviews by reading relevant sections
423
+ - Reference it when explaining decisions
424
+ - Update it when assumptions change
425
+ - End with action items linked to brief
426
+
427
+ **In documentation:**
428
+ - Link to specific sections in PRDs
429
+ - Quote it in design specs
430
+ - Reference it in user stories
431
+ - Connect roadmap items to brief
432
+
433
+ **In decisions:**
434
+ - "Let's check the brief"
435
+ - "According to our success criteria..."
436
+ - "Our target users need..."
437
+ - "Our constraints say..."
438
+
439
+ ### Make It Trusted
440
+
441
+ **Keep it accurate:**
442
+ - Update when things change
443
+ - Remove outdated information
444
+ - Validate assumptions periodically
445
+ - Correct errors immediately
446
+
447
+ **Keep it concise:**
448
+ - Remove what's not useful
449
+ - Focus on decisions, not history
450
+ - Avoid redundancy
451
+ - Stay under 3 pages
452
+
453
+ **Keep it current:**
454
+ - Review quarterly
455
+ - Update after major learnings
456
+ - Refresh when pivoting
457
+ - Don't let it go stale
458
+
459
+ ---
460
+
461
+ ## The Power of Shared Understanding
462
+
463
+ When everyone on the team references the same Product Brief:
464
+
465
+ **Designers** make confident decisions aligned with vision
466
+ **Developers** understand the "why" and build accordingly
467
+ **Stakeholders** track progress and prevent scope creep
468
+ **Product Managers** create roadmaps and measure success
469
+
470
+ **The result:**
471
+ - ✅ Faster decisions (no constant meetings)
472
+ - ✅ Better alignment (everyone working toward same goals)
473
+ - ✅ Less rework (building right things first time)
474
+ - ✅ More confidence (clear direction and criteria)
475
+ - ✅ Stronger results (coordinated effort)
476
+
477
+ **This is the power of a single source of truth.**
478
+
479
+ ---
480
+
481
+ ## What's Next
482
+
483
+ In the final lesson, we'll explore the additional strategic documents you can create as your project needs them - expanding your foundation beyond the core Product Brief.
484
+
485
+ ---
486
+
487
+ **[Continue to Lesson 6: Additional Strategic Documents →](lesson-06-additional-documents.md)**
488
+
489
+ ---
490
+
491
+ [← Back to Lesson 4](lesson-04-wds-advantage.md) | [Back to Module Overview](module-04-overview.md)