whiteport-design-studio 0.2.2 → 0.3.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 (582) hide show
  1. package/README.md +51 -67
  2. package/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md +0 -1
  3. package/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md +0 -1
  4. package/docs/getting-started/installation.md +1 -1
  5. package/docs/getting-started/quick-start.md +1 -1
  6. package/docs/getting-started/where-to-go-next.md +8 -8
  7. package/docs/learn/00-course-overview/00-course-overview.md +239 -0
  8. package/docs/{learn-wds → learn}/00-course-overview/00-getting-started-overview.md +1 -1
  9. package/docs/{learn-wds → learn}/00-course-overview/01-prerequisites.md +2 -2
  10. package/docs/{learn-wds → learn}/00-course-overview/02-learning-paths.md +6 -6
  11. package/docs/{learn-wds → learn}/00-course-overview/03-support.md +1 -1
  12. package/docs/{learn-wds → learn}/Webinars/2024-12-22-WDS-Sessions-1-Say-Hello-to-WDS.md +2 -2
  13. package/docs/{learn-wds → learn}/Webinars/2025-10-22-Webinar-WDS-v4.md +1 -1
  14. package/docs/{learn-wds → learn}/Webinars/2026-01-15-WDS-Sessions-2-Strategy-in-Practice.md +2 -2
  15. package/docs/{learn-wds → learn}/module-01-why-wds-matters/lesson-01-the-problem.md +4 -2
  16. package/docs/learn/module-01-why-wds-matters/lesson-02-designer-as-strategic-thinker.md +483 -0
  17. package/docs/{learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md → learn/module-01-why-wds-matters/lesson-03-the-solution.md} +5 -3
  18. package/docs/{learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md → learn/module-01-why-wds-matters/lesson-04-the-path-forward.md} +9 -6
  19. package/docs/{learn-wds → learn}/module-01-why-wds-matters/module-01-overview.md +22 -4
  20. package/docs/{learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md → learn/module-02-installation-setup/lesson-01-git-setup.md} +12 -11
  21. package/docs/{learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md → learn/module-02-installation-setup/lesson-02-ide-installation.md} +8 -7
  22. package/docs/{learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md → learn/module-02-installation-setup/lesson-03-git-cloning.md} +10 -9
  23. package/docs/learn/module-02-installation-setup/lesson-04-wds-initialization.md +133 -0
  24. package/docs/learn/module-02-installation-setup/module-02-overview.md +59 -0
  25. package/docs/learn/module-02-installation-setup/tutorial-02.md +158 -0
  26. package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-01-understanding-alignment.md +6 -2
  27. package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-02-creating-alignment-document.md +5 -1
  28. package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md +6 -2
  29. package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-04-external-contracts.md +7 -3
  30. package/docs/{learn-wds → learn}/module-03-alignment-signoff/lesson-05-internal-signoff.md +7 -3
  31. package/docs/{learn-wds → learn}/module-03-alignment-signoff/module-03-overview.md +4 -4
  32. package/docs/{learn-wds → learn}/module-03-alignment-signoff/tutorial-03.md +7 -7
  33. package/docs/{learn-wds → learn}/module-04-product-brief/lesson-01-chaos-problem.md +2 -0
  34. package/docs/{learn-wds → learn}/module-04-product-brief/lesson-02-five-questions.md +2 -0
  35. package/docs/{learn-wds → learn}/module-04-product-brief/lesson-03-document-structure.md +3 -1
  36. package/docs/{learn-wds → learn}/module-04-product-brief/lesson-04-wds-advantage.md +4 -2
  37. package/docs/{learn-wds → learn}/module-04-product-brief/lesson-05-using-brief.md +2 -0
  38. package/docs/{learn-wds → learn}/module-04-product-brief/lesson-06-additional-documents.md +3 -1
  39. package/docs/{learn-wds → learn}/module-04-product-brief/module-04-overview.md +4 -4
  40. package/docs/{learn-wds → learn}/module-04-product-brief/tutorial-04.md +10 -8
  41. package/docs/learn/module-05-platform-requirements/lesson-01-why-boundaries-matter.md +232 -0
  42. package/docs/learn/module-05-platform-requirements/lesson-02-defining-platform-requirements.md +416 -0
  43. package/docs/learn/module-05-platform-requirements/module-05-platform-requirements-overview.md +186 -0
  44. package/docs/learn/module-05-platform-requirements/tutorial-05.md +377 -0
  45. package/docs/{learn-wds/module-05-trigger-mapping → learn/module-06-trigger-mapping}/lesson-01-missing-link.md +7 -4
  46. package/docs/{learn-wds/module-05-trigger-mapping → learn/module-06-trigger-mapping}/lesson-02-heritage-evolution.md +20 -42
  47. package/docs/{learn-wds/module-05-trigger-mapping → learn/module-06-trigger-mapping}/lesson-03-five-workshops-overview.md +7 -5
  48. package/docs/learn/module-06-trigger-mapping/lesson-04-workshop-1-business-goals.md +319 -0
  49. package/docs/learn/module-06-trigger-mapping/lesson-05-workshop-2-target-groups.md +557 -0
  50. package/docs/{learn-wds/module-05-trigger-mapping → learn/module-06-trigger-mapping}/lesson-06-workshop-3-driving-forces.md +120 -83
  51. package/docs/learn/module-06-trigger-mapping/lesson-07-workshop-4-prioritization.md +373 -0
  52. package/docs/learn/module-06-trigger-mapping/lesson-08-workshop-5-feature-impact.md +543 -0
  53. package/docs/learn/module-06-trigger-mapping/lesson-09-positive-negative-drivers.md +507 -0
  54. package/docs/{learn-wds/module-05-trigger-mapping → learn/module-06-trigger-mapping}/lesson-10-visual-trigger-map.md +6 -4
  55. package/docs/{learn-wds/module-05-trigger-mapping → learn/module-06-trigger-mapping}/lesson-11-feature-impact-scoring.md +5 -3
  56. package/docs/{learn-wds/module-05-trigger-mapping/module-05-overview.md → learn/module-06-trigger-mapping/module-06-overview.md} +8 -20
  57. package/docs/{learn-wds/module-05-trigger-mapping/tutorial-05.md → learn/module-06-trigger-mapping/tutorial-06.md} +14 -12
  58. package/docs/{learn-wds/module-05-trigger-mapping/tutorial-05c-documentation-synthesis.md → learn/module-06-trigger-mapping/tutorial-06c-documentation-synthesis.md} +11 -9
  59. package/docs/learn/module-07-design-phase/lesson-01-entering-design.md +251 -0
  60. package/docs/learn/module-07-design-phase/lesson-02-why-specifications-matter.md +836 -0
  61. package/docs/learn/module-07-design-phase/lesson-03-meet-freya.md +200 -0
  62. package/docs/learn/module-07-design-phase/module-07-design-phase-overview.md +148 -0
  63. package/docs/learn/module-08-outline-scenarios/lesson-01-design-experiences-not-screens.md +559 -0
  64. package/docs/learn/module-08-outline-scenarios/lesson-02-from-trigger-map-to-scenarios.md +667 -0
  65. package/docs/learn/module-08-outline-scenarios/lesson-03-mapping-the-journey.md +347 -0
  66. package/docs/learn/module-08-outline-scenarios/module-08-outline-scenarios-overview.md +298 -0
  67. package/docs/learn/module-08-outline-scenarios/tutorial-08.md +397 -0
  68. package/docs/learn/module-09-conceptual-sketching/lesson-01-visualize-first.md +286 -0
  69. package/docs/learn/module-09-conceptual-sketching/lesson-02-sketching-techniques.md +270 -0
  70. package/docs/learn/module-09-conceptual-sketching/lesson-03-why-hand-sketching.md +250 -0
  71. package/docs/learn/module-09-conceptual-sketching/lesson-04-image-sketching-best-practices.md +272 -0
  72. package/docs/learn/module-09-conceptual-sketching/lesson-05-sketch-text-strategy.md +509 -0
  73. package/docs/learn/module-09-conceptual-sketching/lesson-06-ai-wireframe-generation.md +211 -0
  74. package/docs/learn/module-09-conceptual-sketching/module-09-conceptual-sketching-overview.md +243 -0
  75. package/docs/learn/module-09-conceptual-sketching/tutorial-09.md +381 -0
  76. package/docs/learn/module-10-storyboarding/lesson-01-transformations.md +392 -0
  77. package/docs/learn/module-10-storyboarding/lesson-02-storyboard-format.md +410 -0
  78. package/docs/learn/module-10-storyboarding/module-10-storyboarding-overview.md +290 -0
  79. package/docs/learn/module-10-storyboarding/tutorial-10.md +405 -0
  80. package/docs/learn/module-11-conceptual-specifications/lesson-01-design-is-specification.md +593 -0
  81. package/docs/learn/module-11-conceptual-specifications/lesson-02-section-widget-specifications.md +704 -0
  82. package/docs/learn/module-11-conceptual-specifications/lesson-03-element-state-specifications.md +950 -0
  83. package/docs/learn/module-11-conceptual-specifications/lesson-04-spacing-objects.md +192 -0
  84. package/docs/learn/module-11-conceptual-specifications/lesson-05-typography-tokens.md +157 -0
  85. package/docs/learn/module-11-conceptual-specifications/module-11-conceptual-specifications-overview.md +497 -0
  86. package/docs/learn/module-11-conceptual-specifications/storyboards/password-field.md +32 -0
  87. package/docs/learn/module-11-conceptual-specifications/storyboards/submit-button.md +26 -0
  88. package/docs/learn/module-11-conceptual-specifications/tutorial-11.md +509 -0
  89. package/docs/learn/module-12-functional-components/components/button.md +41 -0
  90. package/docs/learn/module-12-functional-components/components/card.md +40 -0
  91. package/docs/learn/module-12-functional-components/components/input.md +42 -0
  92. package/docs/learn/module-12-functional-components/lesson-01-patterns-emerge.md +263 -0
  93. package/docs/learn/module-12-functional-components/lesson-02-component-anatomy.md +332 -0
  94. package/docs/learn/module-12-functional-components/module-12-functional-components-overview.md +384 -0
  95. package/docs/learn/module-12-functional-components/tutorial-12.md +405 -0
  96. package/docs/learn/module-13-design-system/lesson-01-understanding-modes.md +274 -0
  97. package/docs/learn/module-13-design-system/module-13-design-system-overview.md +157 -0
  98. package/docs/learn/module-13-design-system/tutorial-13.md +344 -0
  99. package/docs/learn/module-14-agentic-development/lesson-01-iterative-building.md +182 -0
  100. package/docs/learn/module-14-agentic-development/lesson-02-documenting-decisions.md +188 -0
  101. package/docs/learn/module-14-agentic-development/lesson-03-when-you-get-stuck.md +213 -0
  102. package/docs/learn/module-14-agentic-development/lesson-04-working-with-code.md +304 -0
  103. package/docs/learn/module-14-agentic-development/lesson-05-git-discipline.md +349 -0
  104. package/docs/learn/module-14-agentic-development/module-14-agentic-development-overview.md +249 -0
  105. package/docs/learn/module-14-agentic-development/tutorial-14.md +339 -0
  106. package/docs/learn/module-15-visual-design/lesson-01-making-it-visible.md +216 -0
  107. package/docs/learn/module-15-visual-design/lesson-02-visual-techniques.md +334 -0
  108. package/docs/learn/module-15-visual-design/module-15-visual-design-overview.md +338 -0
  109. package/docs/learn/module-15-visual-design/tutorial-15.md +377 -0
  110. package/docs/learn/module-16-design-delivery/lesson-01-validation-packaging.md +340 -0
  111. package/docs/learn/module-16-design-delivery/module-16-design-delivery-overview.md +178 -0
  112. package/docs/learn/module-16-design-delivery/tutorial-16.md +411 -0
  113. package/docs/learn/module-17-usability-testing/lesson-01-spec-verification.md +243 -0
  114. package/docs/learn/module-17-usability-testing/lesson-02-test-results.md +240 -0
  115. package/docs/learn/module-17-usability-testing/lesson-03-acting-on-findings.md +253 -0
  116. package/docs/learn/module-17-usability-testing/module-17-usability-testing-overview.md +231 -0
  117. package/docs/learn/module-17-usability-testing/tutorial-17.md +301 -0
  118. package/docs/learn/module-18-product-evolution/lesson-01-continuous-improvement.md +255 -0
  119. package/docs/learn/module-18-product-evolution/lesson-02-update-spec-project-code.md +229 -0
  120. package/docs/learn/module-18-product-evolution/module-18-product-evolution-overview.md +253 -0
  121. package/docs/learn/module-18-product-evolution/tutorial-18.md +293 -0
  122. package/docs/learn/widgets/W01-task-list.md +31 -0
  123. package/docs/learn/widgets/W02-calendar.md +31 -0
  124. package/docs/learn/widgets/W02-product-card.md +31 -0
  125. package/docs/learn/widgets/W03-quick-add.md +31 -0
  126. package/docs/method/content-creation-philosophy.md +3 -3
  127. package/docs/method/content-purpose-guide.md +4 -4
  128. package/docs/method/phase-1-product-exploration-guide.md +36 -9
  129. package/docs/method/phase-2-trigger-mapping-guide.md +44 -2
  130. package/docs/method/phase-3-prd-platform-guide.md +3 -282
  131. package/docs/method/phase-3-ux-scenarios-guide.md +193 -0
  132. package/docs/method/phase-4-ux-design-guide.md +146 -158
  133. package/docs/method/value-trigger-chain-guide.md +6 -469
  134. package/docs/method/wds-method-guide.md +139 -129
  135. package/docs/models/action-mapping.md +1 -1
  136. package/docs/models/customer-awareness-cycle.md +1 -15
  137. package/docs/models/golden-circle.md +2 -3
  138. package/docs/models/impact-effect-mapping.md +5 -6
  139. package/docs/models/kathy-sierra-badass-users.md +1 -1
  140. package/docs/models/models-guide.md +1 -2
  141. package/docs/models/smart-goals-model.md +2 -2
  142. package/docs/tools/excalidraw.md +384 -0
  143. package/docs/tools/wds-tools-guide.md +16 -8
  144. package/package.json +2 -2
  145. package/src/agents/freya-ux.agent.yaml +16 -15
  146. package/src/agents/saga-analyst.agent.yaml +11 -0
  147. package/src/data/agent-guides/freya/agentic-development.md +26 -27
  148. package/src/data/agent-guides/freya/content-creation.md +7 -7
  149. package/src/data/agent-guides/freya/strategic-design.md +4 -6
  150. package/src/data/agent-guides/saga/discovery-conversation.md +20 -0
  151. package/src/data/agent-guides/saga/dream-up-approach.md +132 -7
  152. package/src/data/agent-guides/saga/strategic-documentation.md +4 -6
  153. package/src/data/agent-guides/saga/trigger-mapping.md +7 -7
  154. package/src/data/presentations/freya-presentation.md +1 -1
  155. package/src/data/presentations/freya-workflows-guide.md +1 -1
  156. package/src/data/presentations/idunn-presentation.md +1 -1
  157. package/src/data/presentations/saga-presentation.md +1 -1
  158. package/src/module-help.csv +3 -3
  159. package/src/skills/freya.activation.md +14 -15
  160. package/src/skills/idunn.activation.md +12 -13
  161. package/src/skills/saga.activation.md +13 -14
  162. package/src/workflows/0-alignment-signoff/data/02-explore-sections-routing.md +12 -12
  163. package/src/workflows/0-alignment-signoff/data/03-synthesize-present-routing.md +2 -3
  164. package/src/workflows/0-alignment-signoff/steps-c/step-01a-understand-situation.md +1 -1
  165. package/src/workflows/0-alignment-signoff/steps-c/step-01b-determine-if-needed.md +1 -1
  166. package/src/workflows/0-alignment-signoff/steps-c/step-01c-offer-extract.md +1 -1
  167. package/src/workflows/0-alignment-signoff/steps-c/step-01d-extract-info.md +1 -1
  168. package/src/workflows/0-alignment-signoff/steps-c/step-01e-detect-starting-point.md +1 -1
  169. package/src/workflows/0-alignment-signoff/steps-c/step-02a-explore-realization.md +1 -1
  170. package/src/workflows/0-alignment-signoff/steps-c/step-02b-explore-solution.md +1 -1
  171. package/src/workflows/0-alignment-signoff/steps-c/step-02c-explore-why-it-matters.md +1 -1
  172. package/src/workflows/0-alignment-signoff/steps-c/step-02d-explore-how-we-see-it-working.md +1 -1
  173. package/src/workflows/0-alignment-signoff/steps-c/step-02e-explore-paths-we-explored.md +1 -1
  174. package/src/workflows/0-alignment-signoff/steps-c/step-02f-explore-recommended-solution.md +1 -1
  175. package/src/workflows/0-alignment-signoff/steps-c/step-02g-explore-path-forward.md +1 -1
  176. package/src/workflows/0-alignment-signoff/steps-c/step-02h-explore-value-we-create.md +1 -1
  177. package/src/workflows/0-alignment-signoff/steps-c/step-02i-explore-cost-of-inaction.md +1 -1
  178. package/src/workflows/0-alignment-signoff/steps-c/step-02j-explore-our-commitment.md +1 -1
  179. package/src/workflows/0-alignment-signoff/steps-c/step-02k-explore-summary.md +1 -1
  180. package/src/workflows/0-alignment-signoff/steps-c/step-03a-reflect-back.md +1 -1
  181. package/src/workflows/0-alignment-signoff/steps-c/step-03b-synthesize-document.md +3 -3
  182. package/src/workflows/0-alignment-signoff/steps-c/step-03d-present-approval.md +2 -2
  183. package/src/workflows/0-alignment-signoff/steps-c/step-04a-offer-signoff.md +1 -1
  184. package/src/workflows/0-alignment-signoff/steps-c/step-04b-determine-business-model.md +1 -1
  185. package/src/workflows/0-alignment-signoff/steps-c/step-05a-contract-overview.md +1 -1
  186. package/src/workflows/0-alignment-signoff/steps-c/step-05b-contract-business-model.md +1 -1
  187. package/src/workflows/0-alignment-signoff/steps-c/step-05c-contract-scope.md +1 -1
  188. package/src/workflows/0-alignment-signoff/steps-c/step-05d-contract-payment.md +1 -1
  189. package/src/workflows/0-alignment-signoff/steps-c/step-05e-contract-timeline.md +1 -1
  190. package/src/workflows/0-alignment-signoff/steps-c/step-05f-contract-availability.md +1 -1
  191. package/src/workflows/0-alignment-signoff/steps-c/step-05g-contract-confidentiality.md +1 -1
  192. package/src/workflows/0-alignment-signoff/steps-c/step-05h-contract-not-to-exceed.md +1 -1
  193. package/src/workflows/0-alignment-signoff/steps-c/step-05i-contract-work-initiation.md +1 -1
  194. package/src/workflows/0-alignment-signoff/steps-c/step-05j-contract-terms.md +1 -1
  195. package/src/workflows/0-alignment-signoff/steps-c/step-05k-contract-approval.md +1 -1
  196. package/src/workflows/0-alignment-signoff/steps-c/step-05l-finalize-contract.md +1 -1
  197. package/src/workflows/0-alignment-signoff/steps-c/step-06a-build-internal-signoff.md +1 -1
  198. package/src/workflows/0-alignment-signoff/workflow.md +2 -6
  199. package/src/workflows/0-project-setup/steps/step-01-welcome.md +1 -1
  200. package/src/workflows/0-project-setup/steps/step-02-structure.md +3 -3
  201. package/src/workflows/0-project-setup/templates/folder-guides/00-design-log.template.md +59 -0
  202. package/src/workflows/0-project-setup/templates/folder-guides/00-design-system.template.md +150 -1
  203. package/src/workflows/0-project-setup/templates/folder-guides/00-trigger-map.template.md +0 -1
  204. package/src/workflows/0-project-setup/workflow.md +2 -2
  205. package/src/workflows/1-project-brief/data/positioning-reflect-confirm.md +2 -2
  206. package/src/workflows/1-project-brief/data/positioning-synthesize.md +3 -3
  207. package/src/workflows/1-project-brief/data/vision-synthesize.md +1 -1
  208. package/src/workflows/1-project-brief/steps-c/step-00-simplified-brief.md +1 -1
  209. package/src/workflows/1-project-brief/steps-c/step-01-init.md +4 -4
  210. package/src/workflows/1-project-brief/steps-c/step-02-vision.md +1 -1
  211. package/src/workflows/1-project-brief/steps-c/step-03-positioning.md +5 -5
  212. package/src/workflows/1-project-brief/steps-c/step-05-business-model.md +4 -4
  213. package/src/workflows/1-project-brief/steps-c/step-06-business-customers.md +8 -2
  214. package/src/workflows/1-project-brief/steps-c/step-07-target-users.md +10 -4
  215. package/src/workflows/1-project-brief/steps-c/step-07a-product-concept.md +9 -3
  216. package/src/workflows/1-project-brief/steps-c/step-08-success-criteria.md +3 -3
  217. package/src/workflows/1-project-brief/steps-c/step-09-competitive-landscape.md +3 -3
  218. package/src/workflows/1-project-brief/steps-c/step-10-constraints.md +1 -1
  219. package/src/workflows/1-project-brief/steps-c/step-10a-platform-strategy.md +3 -3
  220. package/src/workflows/1-project-brief/steps-c/step-11-tone-of-voice.md +4 -4
  221. package/src/workflows/1-project-brief/steps-c/{step-12-synthesize.md → step-12-create-product-brief.md} +6 -6
  222. package/src/workflows/1-project-brief/steps-c/step-13-content-init.md +3 -3
  223. package/src/workflows/1-project-brief/steps-c/step-14-personality.md +3 -3
  224. package/src/workflows/1-project-brief/steps-c/step-15-tone.md +3 -3
  225. package/src/workflows/1-project-brief/steps-c/step-16-languages.md +3 -3
  226. package/src/workflows/1-project-brief/steps-c/step-17-seo-keywords.md +3 -3
  227. package/src/workflows/1-project-brief/steps-c/step-17a-content-structure.md +2 -2
  228. package/src/workflows/1-project-brief/steps-c/{step-18-content-synthesize.md → step-18-create-content-document.md} +7 -7
  229. package/src/workflows/1-project-brief/steps-c/step-19-inspiration-workshop.md +3 -3
  230. package/src/workflows/1-project-brief/steps-c/step-20-visual-init.md +3 -3
  231. package/src/workflows/1-project-brief/steps-c/step-21-existing-brand.md +3 -3
  232. package/src/workflows/1-project-brief/steps-c/step-22-references.md +3 -3
  233. package/src/workflows/1-project-brief/steps-c/step-23-design-style.md +3 -3
  234. package/src/workflows/1-project-brief/steps-c/step-24-layout-effects.md +3 -3
  235. package/src/workflows/1-project-brief/steps-c/step-25-imagery.md +4 -4
  236. package/src/workflows/1-project-brief/steps-c/{step-26-visual-synthesize.md → step-26-create-visual-document.md} +3 -3
  237. package/src/workflows/1-project-brief/steps-c/step-27-platform-init.md +3 -3
  238. package/src/workflows/1-project-brief/steps-c/step-28-tech-stack.md +3 -3
  239. package/src/workflows/1-project-brief/steps-c/step-29-integrations.md +3 -3
  240. package/src/workflows/1-project-brief/steps-c/step-30-contact-strategy.md +3 -3
  241. package/src/workflows/1-project-brief/steps-c/step-31-multilingual.md +4 -4
  242. package/src/workflows/1-project-brief/steps-c/{step-32-platform-synthesize.md → step-32-create-platform-document.md} +3 -3
  243. package/src/workflows/1-project-brief/steps-c/step-33-analyze-brief.md +1 -1
  244. package/src/workflows/1-project-brief/steps-c/step-34-create-summary.md +1 -1
  245. package/src/workflows/1-project-brief/steps-c/step-35-update-design-log.md +4 -4
  246. package/src/workflows/1-project-brief/steps-v/step-01-brief-completeness.md +2 -2
  247. package/src/workflows/1-project-brief/steps-v/{step-02-vtc-consistency.md → step-02-trigger-map-consistency.md} +27 -27
  248. package/src/workflows/1-project-brief/steps-v/step-03-seo-strategy.md +2 -2
  249. package/src/workflows/1-project-brief/steps-v/step-04-content-language.md +1 -1
  250. package/src/workflows/1-project-brief/steps-v/step-05-visual-direction.md +1 -1
  251. package/src/workflows/1-project-brief/steps-v/step-06-platform-requirements.md +1 -1
  252. package/src/workflows/1-project-brief/templates/00-project-info.template.md +1 -2
  253. package/src/workflows/1-project-brief/templates/pitch.template.md +5 -13
  254. package/src/workflows/1-project-brief/templates/project-brief-dialog/USAGE.md +7 -92
  255. package/src/workflows/1-project-brief/templates/project-brief.template.md +5 -11
  256. package/src/workflows/1-project-brief/workflow-validate.md +3 -5
  257. package/src/workflows/1-project-brief/workflow.md +6 -10
  258. package/src/workflows/2-trigger-mapping/steps-c/step-01-overview.md +10 -10
  259. package/src/workflows/2-trigger-mapping/steps-c/step-07a-generate-hub.md +36 -0
  260. package/src/workflows/2-trigger-mapping/steps-c/step-09a-finalize-hub.md +18 -2
  261. package/src/workflows/2-trigger-mapping/steps-c/step-09e-update-design-log.md +3 -3
  262. package/src/workflows/2-trigger-mapping/workflow-validate.md +2 -5
  263. package/src/workflows/2-trigger-mapping/workflow.md +2 -4
  264. package/src/workflows/3-scenarios/data/quality-checklist.md +10 -6
  265. package/src/workflows/3-scenarios/data/scenario-outline-template.md +45 -32
  266. package/src/workflows/3-scenarios/steps-c/step-01-load-context.md +2 -2
  267. package/src/workflows/3-scenarios/steps-c/step-02-analyze-scope.md +5 -5
  268. package/src/workflows/3-scenarios/steps-c/{step-03-build-vtcs.md → step-03-build-strategic-context.md} +32 -32
  269. package/src/workflows/3-scenarios/steps-c/step-04-suggest-scenarios.md +4 -4
  270. package/src/workflows/3-scenarios/steps-c/step-05-outline-scenario.md +177 -64
  271. package/src/workflows/3-scenarios/steps-c/step-06-generate-overview.md +1 -1
  272. package/src/workflows/3-scenarios/steps-c/step-07-quality-review.md +1 -1
  273. package/src/workflows/3-scenarios/steps-c/step-08-update-design-log.md +2 -2
  274. package/src/workflows/3-scenarios/steps-c/step-09-handover.md +8 -8
  275. package/src/workflows/3-scenarios/steps-v/step-01-scenario-coverage.md +23 -23
  276. package/src/workflows/3-scenarios/workflow-validate.md +2 -5
  277. package/src/workflows/3-scenarios/workflow.md +4 -6
  278. package/src/workflows/4-ux-design/data/guides/DESIGN-LOOP-GUIDE.md +179 -0
  279. package/src/workflows/4-ux-design/data/guides/NANO-BANANA-PROMPT-GUIDE.md +1 -1
  280. package/src/workflows/4-ux-design/data/page-creation-flows/flow-b-verbal.md +1 -1
  281. package/src/workflows/4-ux-design/data/page-creation-flows/flow-e-html.md +2 -2
  282. package/src/workflows/4-ux-design/data/page-creation-flows/lightweight-page-template.md +1 -1
  283. package/src/workflows/4-ux-design/data/page-creation-flows/page-init-lightweight.md +1 -1
  284. package/src/workflows/4-ux-design/data/page-creation-flows/placeholder-templates.md +3 -3
  285. package/src/workflows/4-ux-design/data/quality-guide.md +1 -1
  286. package/src/workflows/4-ux-design/data/scenario-init/06-shortest-path.md +2 -2
  287. package/src/workflows/4-ux-design/data/scenario-init/07-reference-trigger-map.md +80 -0
  288. package/src/workflows/4-ux-design/data/scenario-init/scenario-init-guide.md +4 -4
  289. package/src/workflows/4-ux-design/data/specification-audit-workflow.md +29 -4
  290. package/src/workflows/4-ux-design/steps-c/step-01-exploration.md +230 -98
  291. package/src/workflows/4-ux-design/steps-m/step-01-review-current.md +2 -2
  292. package/src/workflows/4-ux-design/steps-m/step-02-define-component.md +1 -1
  293. package/src/workflows/4-ux-design/steps-m/step-03-validate-usage.md +2 -2
  294. package/src/workflows/4-ux-design/steps-p/step-07-validation.md +3 -3
  295. package/src/workflows/4-ux-design/steps-p/step-08-spacing-typography.md +210 -0
  296. package/src/workflows/4-ux-design/steps-p/{step-08-generate-spec.md → step-09-generate-spec.md} +19 -25
  297. package/src/workflows/4-ux-design/steps-s/step-01-core-feature.md +3 -2
  298. package/src/workflows/4-ux-design/steps-s/step-02-entry-point.md +3 -2
  299. package/src/workflows/4-ux-design/steps-s/step-03-mental-state.md +3 -2
  300. package/src/workflows/4-ux-design/steps-s/step-04-mutual-success.md +3 -2
  301. package/src/workflows/4-ux-design/steps-s/step-05-shortest-path.md +3 -2
  302. package/src/workflows/4-ux-design/steps-s/step-06-scenario-name.md +3 -2
  303. package/src/workflows/4-ux-design/steps-s/step-07-create-scenario-folder.md +8 -7
  304. package/src/workflows/4-ux-design/steps-s/step-08-page-context.md +3 -2
  305. package/src/workflows/4-ux-design/steps-s/step-09-page-name.md +3 -2
  306. package/src/workflows/4-ux-design/steps-s/step-10-page-purpose.md +3 -2
  307. package/src/workflows/4-ux-design/steps-s/step-11-entry-point.md +3 -2
  308. package/src/workflows/4-ux-design/steps-s/step-12-mental-state.md +3 -2
  309. package/src/workflows/4-ux-design/steps-s/step-13-desired-outcome.md +3 -2
  310. package/src/workflows/4-ux-design/steps-s/step-14-variants.md +3 -2
  311. package/src/workflows/4-ux-design/steps-s/step-15-create-page-structure.md +32 -13
  312. package/src/workflows/4-ux-design/steps-v/step-03-page-overview.md +1 -1
  313. package/src/workflows/4-ux-design/steps-w/step-01-visual-approach.md +1 -2
  314. package/src/workflows/4-ux-design/steps-w/step-02-generate-visual.md +1 -1
  315. package/src/workflows/4-ux-design/steps-w/step-02w-nb-compose-prompt.md +13 -22
  316. package/src/workflows/4-ux-design/steps-w/step-03-review-integrate.md +4 -4
  317. package/src/workflows/4-ux-design/templates/audit-report.template.md +2 -2
  318. package/src/workflows/4-ux-design/templates/page-specification.template.md +86 -0
  319. package/src/workflows/4-ux-design/workflow-conceptualize.md +9 -15
  320. package/src/workflows/4-ux-design/workflow-design-system.md +20 -8
  321. package/src/workflows/4-ux-design/workflow-dream.md +104 -13
  322. package/src/workflows/4-ux-design/workflow-handover.md +4 -8
  323. package/src/workflows/4-ux-design/workflow-sketch.md +2 -9
  324. package/src/workflows/4-ux-design/workflow-specify.md +6 -11
  325. package/src/workflows/4-ux-design/workflow-suggest.md +70 -21
  326. package/src/workflows/4-ux-design/workflow-validate.md +6 -10
  327. package/src/workflows/4-ux-design/workflow-visual.md +5 -10
  328. package/src/workflows/4-ux-design/workflow.md +110 -39
  329. package/src/workflows/5-agentic-development/data/guides/FILE-INDEX.md +1 -1
  330. package/src/workflows/5-agentic-development/steps-a/step-01-define-question.md +1 -1
  331. package/src/workflows/5-agentic-development/steps-a/step-02-scan-codebase.md +1 -1
  332. package/src/workflows/5-agentic-development/steps-a/step-03-map-architecture.md +1 -1
  333. package/src/workflows/5-agentic-development/steps-a/step-04-document-findings.md +2 -2
  334. package/src/workflows/5-agentic-development/steps-d/step-01-scope-and-plan.md +1 -1
  335. package/src/workflows/5-agentic-development/steps-d/step-02-setup-environment.md +1 -1
  336. package/src/workflows/5-agentic-development/steps-d/step-03-implement.md +1 -1
  337. package/src/workflows/5-agentic-development/steps-d/step-04-verify.md +1 -1
  338. package/src/workflows/5-agentic-development/steps-d/step-05-finalize.md +1 -1
  339. package/src/workflows/5-agentic-development/steps-e/step-01-scope-change.md +1 -1
  340. package/src/workflows/5-agentic-development/steps-e/step-02-analyze-impact.md +1 -1
  341. package/src/workflows/5-agentic-development/steps-e/step-03-plan-implementation.md +1 -1
  342. package/src/workflows/5-agentic-development/steps-e/step-04-implement.md +1 -1
  343. package/src/workflows/5-agentic-development/steps-e/step-05-verify-and-document.md +1 -1
  344. package/src/workflows/5-agentic-development/steps-f/step-01-reproduce.md +1 -1
  345. package/src/workflows/5-agentic-development/steps-f/step-02-investigate.md +1 -1
  346. package/src/workflows/5-agentic-development/steps-f/step-03-fix.md +1 -1
  347. package/src/workflows/5-agentic-development/steps-f/step-04-verify.md +1 -1
  348. package/src/workflows/5-agentic-development/steps-f/step-05-document.md +1 -1
  349. package/src/workflows/5-agentic-development/steps-p/1-prototype-setup.md +1 -1
  350. package/src/workflows/5-agentic-development/steps-p/2-scenario-analysis.md +1 -1
  351. package/src/workflows/5-agentic-development/steps-p/3-logical-view-breakdown.md +1 -1
  352. package/src/workflows/5-agentic-development/steps-p/4a-announce-and-gather.md +1 -1
  353. package/src/workflows/5-agentic-development/steps-p/4b-create-story-file.md +1 -1
  354. package/src/workflows/5-agentic-development/steps-p/4c-implement-section.md +1 -1
  355. package/src/workflows/5-agentic-development/steps-p/4d-present-for-testing.md +1 -1
  356. package/src/workflows/5-agentic-development/steps-p/4e-handle-issue.md +1 -1
  357. package/src/workflows/5-agentic-development/steps-p/4f-handle-improvement.md +1 -1
  358. package/src/workflows/5-agentic-development/steps-p/4g-section-approved.md +2 -2
  359. package/src/workflows/5-agentic-development/steps-p/5-finalization.md +1 -1
  360. package/src/workflows/5-agentic-development/steps-r/step-01-identify-target.md +1 -1
  361. package/src/workflows/5-agentic-development/steps-r/step-02-explore-and-capture.md +1 -1
  362. package/src/workflows/5-agentic-development/steps-r/step-03-generate-specs.md +1 -1
  363. package/src/workflows/5-agentic-development/steps-r/step-04-extract-design-system.md +1 -1
  364. package/src/workflows/5-agentic-development/steps-t/step-01-prepare.md +1 -1
  365. package/src/workflows/5-agentic-development/steps-t/step-02-execute.md +1 -1
  366. package/src/workflows/5-agentic-development/steps-t/step-03-document-issues.md +1 -1
  367. package/src/workflows/5-agentic-development/steps-t/step-04-report.md +1 -1
  368. package/src/workflows/5-agentic-development/steps-t/step-05-iterate.md +1 -1
  369. package/src/workflows/5-agentic-development/workflow-acceptance-testing.md +33 -8
  370. package/src/workflows/5-agentic-development/workflow-analysis.md +5 -8
  371. package/src/workflows/5-agentic-development/workflow-bugfixing.md +5 -8
  372. package/src/workflows/5-agentic-development/workflow-development.md +17 -8
  373. package/src/workflows/5-agentic-development/workflow-evolution.md +5 -8
  374. package/src/workflows/5-agentic-development/workflow-prototyping.md +26 -8
  375. package/src/workflows/5-agentic-development/workflow-reverse-engineering.md +5 -8
  376. package/src/workflows/5-agentic-development/workflow.md +5 -8
  377. package/src/workflows/6-asset-generation/data/00-purpose-examples.md +4 -4
  378. package/src/workflows/6-asset-generation/data/03-action-filter-example.md +1 -1
  379. package/src/workflows/6-asset-generation/data/04-example-empowerment-frame.md +1 -1
  380. package/src/workflows/6-asset-generation/data/05-example-golden-circle.md +1 -1
  381. package/src/workflows/6-asset-generation/data/05-golden-circle-guide.md +1 -1
  382. package/src/workflows/6-asset-generation/data/06-example-hairdresser-newsletter.md +1 -1
  383. package/src/workflows/6-asset-generation/data/06-generation-instructions.md +1 -1
  384. package/src/workflows/6-asset-generation/data/content-creation-workshop-guide.md +9 -10
  385. package/src/workflows/6-asset-generation/steps-c/step-00-define-purpose.md +3 -3
  386. package/src/workflows/6-asset-generation/steps-c/step-01-load-trigger-map-context.md +147 -0
  387. package/src/workflows/6-asset-generation/steps-c/step-02-awareness-strategy.md +5 -5
  388. package/src/workflows/6-asset-generation/steps-c/step-03-action-filter.md +7 -7
  389. package/src/workflows/6-asset-generation/steps-c/step-04-empowerment-frame.md +1 -1
  390. package/src/workflows/6-asset-generation/steps-c/step-05-structural-order.md +2 -2
  391. package/src/workflows/6-asset-generation/steps-c/step-06-generate-content.md +3 -3
  392. package/src/workflows/6-asset-generation/templates/content-output.template.md +5 -5
  393. package/src/workflows/6-asset-generation/workflow-content.md +4 -7
  394. package/src/workflows/6-asset-generation/workflow-figma.md +2 -5
  395. package/src/workflows/6-asset-generation/workflow-icons.md +2 -5
  396. package/src/workflows/6-asset-generation/workflow-images.md +2 -5
  397. package/src/workflows/6-asset-generation/workflow-page-designs.md +2 -5
  398. package/src/workflows/6-asset-generation/workflow-stitch.md +5 -9
  399. package/src/workflows/6-asset-generation/workflow-ui-elements.md +2 -5
  400. package/src/workflows/6-asset-generation/workflow-videos.md +2 -5
  401. package/src/workflows/6-asset-generation/workflow-wireframes.md +2 -5
  402. package/src/workflows/6-asset-generation/workflow.md +3 -5
  403. package/src/workflows/7-design-system/steps-c/step-01-scan-existing.md +2 -2
  404. package/src/workflows/7-design-system/steps-c/step-02-compare-attributes.md +2 -2
  405. package/src/workflows/7-design-system/steps-c/step-03-calculate-similarity.md +2 -2
  406. package/src/workflows/7-design-system/steps-c/step-04-identify-opportunities.md +2 -2
  407. package/src/workflows/7-design-system/steps-c/step-05-identify-risks.md +2 -2
  408. package/src/workflows/7-design-system/steps-c/step-06-present-decision.md +2 -2
  409. package/src/workflows/7-design-system/steps-c/step-07-execute-decision.md +2 -2
  410. package/src/workflows/7-design-system/steps-c/step-08a-initialize-design-system.md +2 -2
  411. package/src/workflows/7-design-system/steps-c/step-08b-create-new-component.md +2 -2
  412. package/src/workflows/7-design-system/steps-c/step-08c-update-component.md +2 -2
  413. package/src/workflows/7-design-system/steps-c/step-08d-add-variant.md +2 -2
  414. package/src/workflows/7-design-system/steps-c/step-08e-generate-catalog.md +1 -1
  415. package/src/workflows/7-design-system/workflow-browse.md +2 -5
  416. package/src/workflows/7-design-system/workflow-create.md +2 -5
  417. package/src/workflows/7-design-system/workflow-edit.md +2 -5
  418. package/src/workflows/7-design-system/workflow-import.md +2 -5
  419. package/src/workflows/7-design-system/workflow-view.md +2 -5
  420. package/src/workflows/7-design-system/workflow.md +9 -11
  421. package/src/workflows/8-product-evolution/steps-a/step-01-identify.md +4 -4
  422. package/src/workflows/8-product-evolution/steps-p/step-01-create-delivery.md +1 -1
  423. package/src/workflows/8-product-evolution/workflow-analyze.md +2 -5
  424. package/src/workflows/8-product-evolution/workflow-deploy.md +3 -6
  425. package/src/workflows/8-product-evolution/workflow-design.md +2 -5
  426. package/src/workflows/8-product-evolution/workflow-implement.md +2 -5
  427. package/src/workflows/8-product-evolution/workflow-scope.md +2 -5
  428. package/src/workflows/8-product-evolution/workflow-test.md +2 -5
  429. package/src/workflows/8-product-evolution/workflow.md +7 -9
  430. package/tools/cli/commands/install.js +1 -1
  431. package/tools/cli/installers/lib/ide/_base-ide.js +263 -0
  432. package/tools/cli/installers/lib/ide/antigravity.js +34 -0
  433. package/tools/cli/installers/lib/ide/auggie.js +42 -0
  434. package/tools/cli/installers/lib/ide/claude-code.js +114 -0
  435. package/tools/cli/installers/lib/ide/cline.js +116 -0
  436. package/tools/cli/installers/lib/ide/codex.js +43 -0
  437. package/tools/cli/installers/lib/ide/crush.js +42 -0
  438. package/tools/cli/installers/lib/ide/cursor.js +116 -0
  439. package/tools/cli/installers/lib/ide/gemini.js +50 -0
  440. package/tools/cli/installers/lib/ide/github-copilot.js +106 -0
  441. package/tools/cli/installers/lib/ide/iflow.js +42 -0
  442. package/tools/cli/installers/lib/ide/kilo.js +55 -0
  443. package/tools/cli/installers/lib/ide/kiro-cli.js +44 -0
  444. package/tools/cli/installers/lib/ide/manager.js +218 -0
  445. package/tools/cli/installers/lib/ide/opencode.js +44 -0
  446. package/tools/cli/installers/lib/ide/qwen.js +50 -0
  447. package/tools/cli/installers/lib/ide/roo.js +43 -0
  448. package/tools/cli/installers/lib/ide/rovo-dev.js +43 -0
  449. package/tools/cli/installers/lib/ide/trae.js +42 -0
  450. package/tools/cli/installers/lib/ide/windsurf.js +106 -0
  451. package/tools/cli/lib/compiler.js +10 -2
  452. package/tools/cli/lib/ide-configs.js +2 -4
  453. package/tools/cli/lib/installer.js +115 -206
  454. package/tools/cli/lib/ui.js +191 -54
  455. package/docs/getting-started/agent-activation/wds-mimir.md +0 -78
  456. package/docs/learn-wds/00-course-overview.md +0 -211
  457. package/docs/learn-wds/Webinars/2024-12-22-WDS-Jam-1-Say-Hello-to-AI-Agent-Framework.md +0 -0
  458. package/docs/learn-wds/course-explainers/Module 00-transcript.srt +0 -635
  459. package/docs/learn-wds/course-explainers/Module 02-transcript.srt +0 -807
  460. package/docs/learn-wds/course-explainers/Module-00-notebook-lm-prompt.md +0 -250
  461. package/docs/learn-wds/course-explainers/Module-00-thumbnail-prompt.md +0 -33
  462. package/docs/learn-wds/course-explainers/Module-00-youtube-show-notes.md +0 -78
  463. package/docs/learn-wds/course-explainers/Module-01-notebook-lm-prompt.md +0 -418
  464. package/docs/learn-wds/course-explainers/Module-01-thumbnail-prompt.md +0 -33
  465. package/docs/learn-wds/course-explainers/Module-01-transcript.srt +0 -731
  466. package/docs/learn-wds/course-explainers/Module-02-notebook-lm-prompt.md +0 -342
  467. package/docs/learn-wds/course-explainers/Module-02-thumbnail-prompt.md +0 -34
  468. package/docs/learn-wds/course-explainers/Module-03-notebook-lm-prompt.md +0 -745
  469. package/docs/learn-wds/course-explainers/Module-03-thumbnail-prompt.md +0 -33
  470. package/docs/learn-wds/course-explainers/Module-03-transcript.srt +0 -595
  471. package/docs/learn-wds/course-explainers/Module-04-notebook-lm-prompt.md +0 -163
  472. package/docs/learn-wds/course-explainers/Module-04-thumbnail-prompt.md +0 -36
  473. package/docs/learn-wds/course-explainers/Module-04-youtube-show-notes.md +0 -95
  474. package/docs/learn-wds/course-explainers/Module-05-notebook-lm-prompt.md +0 -274
  475. package/docs/learn-wds/course-explainers/Module-05-thumbnail-prompt.md +0 -40
  476. package/docs/learn-wds/course-explainers/Module-05-youtube-show-notes.md +0 -65
  477. package/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md +0 -75
  478. package/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md +0 -86
  479. package/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md +0 -82
  480. package/docs/learn-wds/course-explainers/trigger-map-example.jpg +0 -0
  481. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md +0 -63
  482. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md +0 -124
  483. package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md +0 -87
  484. package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md +0 -203
  485. package/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md +0 -70
  486. package/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md +0 -40
  487. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md +0 -48
  488. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md +0 -88
  489. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md +0 -48
  490. package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md +0 -48
  491. package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md +0 -149
  492. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md +0 -51
  493. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md +0 -111
  494. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md +0 -51
  495. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/checklist.md +0 -41
  496. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/tutorial.md +0 -159
  497. package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md +0 -93
  498. package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md +0 -217
  499. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md +0 -73
  500. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md +0 -206
  501. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md +0 -206
  502. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md +0 -73
  503. package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md +0 -79
  504. package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md +0 -244
  505. package/docs/learn-wds/module-02-installation-setup/module-02-overview.md +0 -77
  506. package/docs/learn-wds/module-05-map-triggers-outcomes/tutorial-04.md +0 -460
  507. package/docs/learn-wds/module-05-trigger-mapping/lesson-04-workshop-1-business-goals.md +0 -274
  508. package/docs/learn-wds/module-05-trigger-mapping/lesson-05-workshop-2-target-groups.md +0 -504
  509. package/docs/learn-wds/module-05-trigger-mapping/lesson-07-workshop-4-prioritization.md +0 -313
  510. package/docs/learn-wds/module-05-trigger-mapping/lesson-08-workshop-5-feature-impact.md +0 -474
  511. package/docs/learn-wds/module-05-trigger-mapping/lesson-09-positive-negative-drivers.md +0 -348
  512. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05b-value-trigger-chain.md +0 -393
  513. package/docs/learn-wds/module-06-platform-architecture/tutorial-06.md +0 -358
  514. package/docs/learn-wds/module-08-initialize-scenario/tutorial-08.md +0 -521
  515. package/docs/learn-wds/module-09-design-system/tutorial-09.md +0 -515
  516. package/docs/learn-wds/module-10-design-delivery/tutorial-10.md +0 -604
  517. package/docs/learn-wds/module-12-conceptual-specs/tutorial-12.md +0 -734
  518. package/src/agents/mimir-orchestrator.agent.yaml +0 -45
  519. package/src/data/agent-guides/mimir/emotional-intelligence.md +0 -295
  520. package/src/data/agent-guides/mimir/teaching-styles.md +0 -286
  521. package/src/data/agent-guides/mimir/wds-overview.md +0 -377
  522. package/src/data/presentations/mimir-getting-started.md +0 -52
  523. package/src/data/presentations/mimir-presentation.md +0 -123
  524. package/src/gems/eira-visual-designer.md +0 -571
  525. package/src/workflows/0-alignment-signoff/steps-c/step-03c-create-vtc.md +0 -148
  526. package/src/workflows/0-project-setup/templates/folder-guides/00-progress.template.md +0 -56
  527. package/src/workflows/1-project-brief/steps-c/step-04-create-vtc.md +0 -120
  528. package/src/workflows/1-project-brief/steps-c/step-11a-create-vtc.md +0 -181
  529. package/src/workflows/1-project-brief/templates/vtc-template.yaml +0 -210
  530. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-01a-define-business-goal.md +0 -137
  531. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-01b-load-trigger-map.md +0 -127
  532. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-02a-identify-solution.md +0 -133
  533. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-02b-select-business-goal.md +0 -138
  534. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-03a-describe-user.md +0 -147
  535. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-03b-select-user.md +0 -142
  536. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-04a-positive-driving-forces.md +0 -163
  537. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-04b-select-driving-forces.md +0 -154
  538. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-05a-negative-driving-forces.md +0 -195
  539. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-05b-define-solution.md +0 -117
  540. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-06a-customer-awareness.md +0 -216
  541. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-06b-customer-awareness.md +0 -123
  542. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-07a-review-and-save.md +0 -250
  543. package/src/workflows/1-project-brief/vtc-workshop/steps-c/step-07b-review-and-save.md +0 -191
  544. package/src/workflows/1-project-brief/vtc-workshop/workflow.md +0 -209
  545. package/src/workflows/4-ux-design/data/scenario-init/07-create-vtc.md +0 -132
  546. package/src/workflows/6-asset-generation/steps-c/step-01-load-vtc-context.md +0 -150
  547. package/src/workflows/_agent-dialogs/conversation-persistence/check-conversations.md +0 -162
  548. package/src/workflows/_agent-dialogs/conversation-persistence/conversation-template.md +0 -70
  549. package/src/workflows/_agent-dialogs/conversation-persistence/persistence-guide.md +0 -81
  550. package/src/workflows/_agent-dialogs/conversation-persistence/save-conversation.md +0 -146
  551. package/src/workflows/_agent-dialogs/project-analysis/01-instructions.md +0 -79
  552. package/src/workflows/_agent-dialogs/project-analysis/02-project-analysis-router.md +0 -99
  553. package/src/workflows/_agent-dialogs/project-analysis/03-context-aware-activation.md +0 -99
  554. package/src/workflows/_agent-dialogs/project-analysis/04-task-reflection.md +0 -303
  555. package/src/workflows/_agent-dialogs/project-analysis/05-agent-handoff-guide.md +0 -233
  556. package/src/workflows/_agent-dialogs/project-analysis/agent-domains/freya-domain.md +0 -144
  557. package/src/workflows/_agent-dialogs/project-analysis/agent-domains/idunn-domain.md +0 -112
  558. package/src/workflows/_agent-dialogs/project-analysis/agent-domains/saga-domain.md +0 -132
  559. package/src/workflows/_agent-dialogs/project-analysis/analysis-types/empty-project-response.md +0 -207
  560. package/src/workflows/_agent-dialogs/project-analysis/analysis-types/folder-based-analysis.md +0 -135
  561. package/src/workflows/_agent-dialogs/project-analysis/analysis-types/new-project-response.md +0 -235
  562. package/src/workflows/_agent-dialogs/project-analysis/analysis-types/outline-based-analysis.md +0 -238
  563. package/src/workflows/_agent-dialogs/project-analysis/analysis-types/unknown-structure-response.md +0 -216
  564. package/src/workflows/_agent-dialogs/project-analysis/validation/deep-validation-before-work.md +0 -235
  565. package/src/workflows/_agent-dialogs/project-analysis/work-types/strategy-work.md +0 -88
  566. package/src/workflows/_agent-dialogs/step-completion-protocol.md +0 -175
  567. package/src/workflows/_agent-dialogs/steps/step-01-initialize-dialog.md +0 -244
  568. package/src/workflows/_agent-dialogs/steps/step-02-analyze-scope.md +0 -195
  569. package/src/workflows/_agent-dialogs/steps/step-03-create-steps.md +0 -186
  570. package/src/workflows/_agent-dialogs/steps/step-04-execute-steps.md +0 -250
  571. package/src/workflows/_agent-dialogs/steps/step-05-complete-dialog.md +0 -177
  572. package/src/workflows/_agent-dialogs/templates/agent-dialog.template.md +0 -115
  573. package/src/workflows/_agent-dialogs/templates/dialog-capture.template.md +0 -75
  574. package/src/workflows/_agent-dialogs/templates/dialog-types/INDEX.md +0 -142
  575. package/src/workflows/_agent-dialogs/templates/dialog-types/bug-fix.template.md +0 -164
  576. package/src/workflows/_agent-dialogs/templates/dialog-types/design-exploration.template.md +0 -180
  577. package/src/workflows/_agent-dialogs/templates/dialog-types/prototype-implementation.template.md +0 -292
  578. package/src/workflows/_agent-dialogs/templates/dialog-types/stitch-generation.template.md +0 -311
  579. package/src/workflows/_agent-dialogs/templates/dialog.template.md +0 -200
  580. package/src/workflows/_agent-dialogs/templates/dream-up-agent-dialog.template.md +0 -271
  581. package/src/workflows/_agent-dialogs/templates/step.template.md +0 -138
  582. package/src/workflows/_agent-dialogs/workflow.md +0 -193
@@ -0,0 +1,557 @@
1
+ # Module 06: Trigger Mapping
2
+
3
+ ## Lesson 5: Workshop 2 - Target Groups
4
+
5
+ **Saga Helps You Identify Who Ensures Your Success**
6
+
7
+ ---
8
+
9
+ ## The Core Question Saga Explores With You
10
+
11
+ Through guided conversation, Saga helps you answer: **WHO out there in the world will make sure, with their use of the product, that you achieve your goals?**
12
+
13
+ This question contains the entire chain of value creation. Let's break it down:
14
+
15
+ ### Breaking Down the Question
16
+
17
+ **"WHO"**
18
+ - Which representative from which ICP (Ideal Customer Profile)?
19
+ - Specific behavioral and contextual profiles
20
+ - Not demographics, but real people with real contexts
21
+
22
+ **"Out there in the world"**
23
+ - These are real people whose lives your product needs to touch
24
+ - Not abstract user segments, but actual humans in specific situations
25
+ - Your product must reach and impact their reality
26
+
27
+ **"Will make sure"**
28
+ - A product needs to be used, and used in the intended way
29
+ - Usage alone isn't enough - it must be the right usage
30
+ - Their behavior drives the outcome
31
+
32
+ **"With their use of the product"**
33
+ - The product must give more value than the pain of using it
34
+ - If usage pain > value gained, they won't care
35
+ - They need motivation to engage and continue
36
+
37
+ **"That you achieve your goals"**
38
+ - The use of the product must tie to measurable business goals
39
+ - Without this connection, success isn't possible
40
+ - This completes the chain: WHO → uses product → right way → creates value → achieves goals
41
+
42
+ **This distinction is critical** and reflects throughout the entire Trigger Mapping methodology.
43
+
44
+ ---
45
+
46
+ ## Overview
47
+
48
+ Workshop 2 is where Saga guides you to identify the specific user groups whose behavior will drive your business success. Through thoughtful questions, Saga helps you create detailed personas and prioritize them by strategic value.
49
+
50
+ **Duration:** 20-25 minutes
51
+ **Format:** Guided dialog with Saga (exploring one persona at a time)
52
+ **Output:** 3-5 prioritized personas with deep context (documented by Saga)
53
+
54
+ ---
55
+
56
+ ## How the Guided Dialog Works
57
+
58
+ ### Phase 1: Saga Helps You Identify User Groups
59
+
60
+ **Saga starts with your business goals from Workshop 1:**
61
+
62
+ Saga asks who could help you achieve those specific objectives. She guides you away from demographics ("parents aged 30-45") toward behavioral and contextual profiles ("busy working parents juggling multiple schedules while afraid of dropping the ball").
63
+
64
+ **Natural conversation flow:**
65
+ > **Saga:** "Looking at your goal of achieving 5,000 active teams, who are the people whose behavior would drive that success?"
66
+ > **You:** "Well, team leaders who manage remote teams..."
67
+ > **Saga:** "Good - tell me more about these team leaders. What's their world like?"
68
+ > **You:** [You describe their context and challenges]
69
+ > **Saga:** "So they're managing distributed teams with limited visibility. What else defines this group?"
70
+
71
+ **Saga documents each group** as you identify them together. She'll guide you to 3-5 distinct groups - not more.
72
+
73
+ ### Phase 2: Saga Draws Out Deep Persona Profiles
74
+
75
+ **For each group, Saga asks about WHO they really are:**
76
+
77
+ Through natural conversation, Saga helps you build rich profiles - not surface demographics, but real context, behavioral patterns, and their current reality before your product exists.
78
+
79
+ **Dialog example:**
80
+ > **Saga:** "Let's dig into Remote Team Leads. What's their daily context?"
81
+ > **You:** "They're managing 5-10 people across different time zones..."
82
+ > **Saga:** "That sounds isolating. How do they currently handle team health?"
83
+ > **You:** "Mostly check-ins and hoping people speak up..."
84
+ > **Saga:** "And when people don't speak up?"
85
+ > **You:** "That's their fear - problems brewing that they can't see."
86
+
87
+ **Saga captures the persona profile** - context, behavioral patterns, current reality. No template forms.
88
+
89
+ **Note:** Saga focuses on WHO they are in this phase. Usage goals and fears come later when she asks: "When this persona encounters your problem space and discovers your product, what do they want? What do they fear?"
90
+
91
+ ### Phase 3: Saga Guides Strategic Prioritization
92
+
93
+ **Saga helps you rank groups by strategic value:**
94
+
95
+ Through questioning, Saga helps you think through impact on business goals, feasibility to reach, and urgency of pain. She challenges when priorities seem unclear or inconsistent with your objectives.
96
+
97
+ **Dialog example:**
98
+ > **Saga:** "We have three groups. Which has the most potential to drive your 5,000 team goal?"
99
+ > **You:** "Probably team leads - each one brings their whole team..."
100
+ > **Saga:** "Good insight. And can you reach them?"
101
+ > **You:** "Yes, through LinkedIn and management communities."
102
+ > **Saga:** "So Team Leads rank #1 for both impact and feasibility. What about Solo Workers vs Executives?"
103
+
104
+ **Saga documents the ranking** with strategic reasoning for each placement.
105
+
106
+ ---
107
+
108
+ ## Saga's Conversational Approach
109
+
110
+ ### How Saga Explores User Groups
111
+
112
+ **Saga guides, doesn't interrogate.** She asks about one group at a time, listens deeply to your insights about their world, and reflects back what she's hearing to confirm understanding.
113
+
114
+ **Opening questions about groups:**
115
+ - "Looking at [your specific business goal], who are the people whose behavior would drive that success?"
116
+ - "Tell me about the different types of users who could help achieve this."
117
+ - "Who has the power to make [your objective] happen through their use of the product?"
118
+
119
+ **Deep dive into each persona (WHO they are):**
120
+ - "Let's explore [group name]. What's their daily context?"
121
+ - "What's going on in their world right now?"
122
+ - "How do they currently handle [the problem]?"
123
+ - "What behavioral patterns do you see in this group?"
124
+ - "What's their reality before they discover your solution?"
125
+
126
+ **Exploring usage goals (when they encounter your problem space):**
127
+ - "When [persona name] faces this problem and discovers your product, what do they want to achieve?"
128
+ - "What positive outcomes are they hoping for?"
129
+ - "And what are they afraid might happen?"
130
+ - "What keeps them up at night about this?"
131
+ - "What would 'success' look like to them?"
132
+
133
+ **Prioritization questions:**
134
+ - "Of these groups, which one has the most potential to drive [your top business goal]?"
135
+ - "Can you actually reach this group? How?"
136
+ - "How urgent is their pain compared to the others?"
137
+ - "So based on impact, feasibility, and urgency, how would you rank them?"
138
+ - "Why does [group] rank higher than [other group]?"
139
+
140
+ ### Saga's Facilitation Techniques
141
+
142
+ **Like BMad v6, Saga:**
143
+ - **One persona at a time** - Doesn't overwhelm with all groups at once
144
+ - **Listens to your stories** - Your examples reveal more than abstract descriptions
145
+ - **Reflects behavioral insight** - "So they're constantly worried about missing warning signs..."
146
+ - **Challenges surface descriptions** - "But what's their actual day-to-day context?"
147
+ - **Documents rich profiles** - You describe, she captures the behavioral essence
148
+ - **Guides toward 3-5 groups** - Stops you from over-segmenting
149
+ - **Makes ranking strategic** - Links prioritization back to Workshop 1 goals
150
+
151
+ ---
152
+
153
+ ## Generic Example
154
+
155
+ ### Target Group 1: Remote Team Leads
156
+
157
+ #### Persona Profile (WHO they are)
158
+
159
+ **Context:**
160
+ - Managing 5-10 distributed team members across time zones
161
+ - Responsible for team performance and wellbeing
162
+ - Limited visibility into individual struggles
163
+
164
+ **Behavioral Patterns:**
165
+ - Checks in with team daily
166
+ - Monitors project progress closely
167
+ - Seeks early warning signs
168
+ - Values data-driven insights
169
+
170
+ #### Usage Goals (When they face our problem space)
171
+
172
+ *When Remote Team Leads discover our product, they want to...*
173
+
174
+ **Positive Drivers (what they want to achieve):**
175
+ - Keep team productive and connected
176
+ - Recognize and support struggling members early
177
+ - Demonstrate effective leadership to management
178
+
179
+ **Negative Drivers (what they want to avoid):**
180
+ - Team burnout without noticing
181
+ - Missed deadlines due to unseen problems
182
+ - Poor performance reviews
183
+ - Losing top performers
184
+ - Team becoming disconnected
185
+
186
+ **Priority:** #1 (High impact + reachable + urgent pain)
187
+
188
+ ---
189
+
190
+ ### Target Group 2: Solo Remote Workers
191
+
192
+ #### Persona Profile (WHO they are)
193
+
194
+ **Context:**
195
+ - Working alone from home without office structure
196
+ - No team to provide accountability or connection
197
+ - Struggling with boundaries and focus
198
+
199
+ **Behavioral Patterns:**
200
+ - Seeks structure and routine
201
+ - Values community connection
202
+ - Struggles with self-discipline
203
+ - Craves professional growth
204
+
205
+ #### Usage Goals (When they face our problem space)
206
+
207
+ *When Solo Remote Workers discover our product, they want to...*
208
+
209
+ **Positive Drivers (what they want to achieve):**
210
+ - Stay focused and productive
211
+ - Maintain work-life boundaries
212
+ - Feel connected to professional community
213
+ - Advance career despite isolation
214
+
215
+ **Negative Drivers (what they want to avoid):**
216
+ - Career stagnation
217
+ - Burnout from overwork
218
+ - Losing touch with industry
219
+ - Being forgotten by management
220
+ - Professional isolation
221
+
222
+ **Priority:** #2 (Large market + moderate impact)
223
+
224
+ ---
225
+
226
+ ### Target Group 3: Remote Executives
227
+
228
+ #### Persona Profile (WHO they are)
229
+
230
+ **Context:**
231
+ - Overseeing multiple distributed teams
232
+ - Responsible for organizational performance
233
+ - Limited visibility into team dynamics
234
+
235
+ **Behavioral Patterns:**
236
+ - Relies on aggregated data
237
+ - Values high-level insights
238
+ - Needs quick decision-making tools
239
+ - Focuses on organizational metrics
240
+
241
+ #### Usage Goals (When they face our problem space)
242
+
243
+ *When Remote Executives discover our product, they want to...*
244
+
245
+ **Positive Drivers (what they want to achieve):**
246
+ - Ensure organizational productivity
247
+ - Maintain company culture remotely
248
+ - Make data-driven decisions
249
+ - Retain top talent
250
+
251
+ **Negative Drivers (what they want to avoid):**
252
+ - Organizational dysfunction
253
+ - Mass turnover
254
+ - Productivity decline
255
+ - Cultural erosion
256
+ - Competitive disadvantage
257
+
258
+ **Priority:** #3 (High value but harder to reach)
259
+
260
+ ---
261
+
262
+ ## Another Generic Example: Public Transport App
263
+
264
+ This example shows how the same "customers" (travelers) have completely different needs based on their context.
265
+
266
+ ### Target Group 1: Daily Commuters
267
+
268
+ #### Persona Profile (WHO they are)
269
+
270
+ **Context:**
271
+ - Same route every workday (home ↔ work)
272
+ - Time-sensitive schedule (must arrive on time)
273
+ - Experienced with the system
274
+
275
+ **Behavioral Patterns:**
276
+ - Checks app before leaving
277
+ - Knows alternative routes
278
+ - Values real-time updates
279
+ - Wants predictability
280
+
281
+ #### Usage Goals (When they face their commute)
282
+
283
+ *When Daily Commuters open our app, they want to...*
284
+
285
+ **Positive Drivers (what they want to achieve):**
286
+ - Get to work/home efficiently
287
+ - Minimize waiting time
288
+ - Avoid delays and disruptions
289
+
290
+ **Negative Drivers (what they want to avoid):**
291
+ - Being late to work (professional consequences)
292
+ - Missing important meetings
293
+ - Unpredictable commute times
294
+
295
+ **Priority:** #1 (Highest volume, daily usage, urgent needs)
296
+
297
+ ---
298
+
299
+ ### Target Group 2: Tourists
300
+
301
+ #### Persona Profile (WHO they are)
302
+
303
+ **Context:**
304
+ - Unfamiliar with the city and transit system
305
+ - Exploring multiple destinations
306
+ - No time pressure but limited trip duration
307
+
308
+ **Behavioral Patterns:**
309
+ - Plans routes in advance
310
+ - Needs step-by-step guidance
311
+ - Values visual/map-based navigation
312
+ - Seeks reassurance at each step
313
+
314
+ #### Usage Goals (When they face navigation)
315
+
316
+ *When Tourists open our app, they want to...*
317
+
318
+ **Positive Drivers (what they want to achieve):**
319
+ - Navigate unfamiliar system confidently
320
+ - Find best routes to attractions
321
+ - Understand ticketing and payment
322
+ - Maximize sightseeing time
323
+
324
+ **Negative Drivers (what they want to avoid):**
325
+ - Wasting vacation time being lost
326
+ - Looking foolish or incompetent
327
+ - Missing key attractions
328
+ - Overpaying for tickets
329
+
330
+ **Priority:** #2 (Growing market, different needs than commuters)
331
+
332
+ ---
333
+
334
+ ### Target Group 3: Seniors
335
+
336
+ #### Persona Profile (WHO they are)
337
+
338
+ **Context:**
339
+ - May have mobility limitations
340
+ - Less familiar with digital tools
341
+ - Often traveling during off-peak hours
342
+ - May need accessibility features
343
+
344
+ **Behavioral Patterns:**
345
+ - Prefers simple, clear interfaces
346
+ - Values accessibility information
347
+ - Needs larger text and clear instructions
348
+ - May prefer human assistance options
349
+
350
+ #### Usage Goals (When they face travel planning)
351
+
352
+ *When Seniors open our app, they want to...*
353
+
354
+ **Positive Drivers (what they want to achieve):**
355
+ - Travel safely and comfortably
356
+ - Avoid physical strain (stairs, long walks)
357
+ - Feel confident using the system
358
+ - Maintain independence
359
+
360
+ **Negative Drivers (what they want to avoid):**
361
+ - Falling or getting injured
362
+ - Being stranded or unable to get help
363
+ - Losing independence
364
+ - Embarrassment from not understanding technology
365
+
366
+ **Priority:** #3 (Important for accessibility, regulatory requirements)
367
+
368
+ ---
369
+
370
+ ### Why This Example Works
371
+
372
+ **Same product (public transport app), completely different needs:**
373
+
374
+ **Commuters need:**
375
+ - Real-time delay alerts
376
+ - Quick route alternatives
377
+ - Predictability and reliability
378
+ - Speed and efficiency
379
+
380
+ **Tourists need:**
381
+ - Step-by-step navigation
382
+ - Visual/map-based guidance
383
+ - Ticketing help
384
+ - Confidence and reassurance
385
+
386
+ **Seniors need:**
387
+ - Accessibility information
388
+ - Simple, clear interfaces
389
+ - Larger text and buttons
390
+ - Safety and comfort features
391
+
392
+ **The insight:** If you designed only for commuters (speed and efficiency), you'd fail tourists and seniors. If you designed only for tourists (detailed guidance), you'd frustrate commuters who want speed. Understanding these distinct groups allows you to prioritize features strategically.
393
+
394
+ ---
395
+
396
+ ## Why Behavioral Profiles Matter
397
+
398
+ ### Not This (Demographics)
399
+
400
+ "Parents aged 30-45 with household income $75K+"
401
+
402
+ **Problem:** Doesn't tell you what drives behavior, what they need, or how to design for them.
403
+
404
+ ### This (Behavioral + Contextual)
405
+
406
+ "Busy working parents juggling multiple kids' schedules, family dog care, and full-time jobs - constantly afraid of dropping the ball on family responsibilities"
407
+
408
+ **Why it works:** You understand their world, their challenges, their fears. You can design for their actual needs.
409
+
410
+ ---
411
+
412
+ ## Prioritization Criteria
413
+
414
+ ### Impact on Business Goals
415
+
416
+ **Ask:**
417
+ - Which group's behavior most directly drives our objectives?
418
+ - Which group has the power to make our goals happen?
419
+ - Which group's success equals our success?
420
+
421
+ **Example:** Remote Team Leads rank #1 because each one brings 5-10 users (their team), has budget authority, and urgent pain.
422
+
423
+ ### Feasibility to Reach
424
+
425
+ **Ask:**
426
+ - Can we actually reach this group?
427
+ - Do we have channels to communicate with them?
428
+ - Can we serve them with our resources?
429
+ - Is the market size sufficient?
430
+
431
+ **Example:** Executives rank lower because they're harder to reach despite high value.
432
+
433
+ ### Urgency of Pain
434
+
435
+ **Ask:**
436
+ - How urgent is their problem?
437
+ - Are they actively seeking solutions?
438
+ - What's the cost of not solving this?
439
+
440
+ **Example:** Team Leads have urgent pain (team burnout risk) vs Solo Workers have chronic pain (isolation).
441
+
442
+ ---
443
+
444
+ ## What You Get from Workshop 2
445
+
446
+ ✅ **3-5 prioritized personas** - Rich behavioral profiles, not demographic categories
447
+ ✅ **Deep contextual understanding** - Saga helped you articulate each group's world
448
+ ✅ **Strategic ranking** - Clear priorities based on impact, feasibility, and urgency
449
+ ✅ **Documented profiles** - Saga captured everything as you talked
450
+ ✅ **Foundation for psychology mapping** - These personas feed Workshop 3
451
+ ✅ **Focused clarity** - You know exactly who you're designing for and why
452
+ ✅ **Behavioral insight** - You understand their context, not just their demographics
453
+
454
+ ---
455
+
456
+ ## Common Mistakes to Avoid
457
+
458
+ ### Mistake 1: Giving Saga Demographics Instead of Context
459
+
460
+ **Problem:** "Males 25-40 with college degrees"
461
+ **Why it fails:** Saga can't build behavioral profiles from demographics alone
462
+ **Fix:** When Saga asks about the group, describe their world, their context, their daily reality
463
+
464
+ ### Mistake 2: Insisting on Too Many Groups
465
+
466
+ **Problem:** "We have 10 different user types we need to include"
467
+ **Why it fails:** Saga will guide you to 3-5 for strategic focus
468
+ **Fix:** Trust Saga's guidance - you can always expand later after validating the core groups
469
+
470
+ ### Mistake 3: Refusing to Prioritize
471
+
472
+ **Problem:** "All these groups are equally important to us"
473
+ **Why it fails:** Saga needs clear priorities for Workshops 3-5 to work effectively
474
+ **Fix:** Let Saga help you make the hard choices based on strategic value
475
+
476
+ ### Mistake 4: Accepting Surface-Level Descriptions
477
+
478
+ **Problem:** "They want to be productive" (accepting generic statements)
479
+ **Why it fails:** Saga can't build deep personas from shallow descriptions
480
+ **Fix:** When Saga digs deeper with follow-ups, take time to think and elaborate
481
+
482
+ ### Mistake 5: Skipping Feasibility Discussion
483
+
484
+ **Problem:** Not being honest about which groups you can actually reach
485
+ **Why it fails:** Later roadmap won't be executable
486
+ **Fix:** Be realistic with Saga about your marketing channels and resources
487
+
488
+ ### Mistake 6: Mixing Up "Who They Are" and "What They Want"
489
+
490
+ **Problem:** Describing goals before describing the person
491
+ **Why it fails:** Saga builds personas first, usage goals come in Workshop 3
492
+ **Fix:** When Saga asks "who are they?" focus on context and behavior, not desires
493
+
494
+ ---
495
+
496
+ ## How This Feeds Into Next Workshops
497
+
498
+ **Workshop 2 sets up the psychology mapping:**
499
+
500
+ ```
501
+ Business Goals
502
+
503
+ Target Groups (prioritized personas)
504
+
505
+ Workshop 3: What drives each group's behavior?
506
+
507
+ Workshop 4: Which drivers are most powerful?
508
+
509
+ Workshop 5: Which features address top drivers?
510
+ ```
511
+
512
+ The personas you create here become the foundation for understanding psychological drivers.
513
+
514
+ ---
515
+
516
+ ## Tips for a Successful Dialog with Saga
517
+
518
+ **DO:**
519
+ - ✅ Tell stories about real people when describing groups - Saga learns from examples
520
+ - ✅ Go deep when Saga asks follow-ups - she's looking for behavioral insight
521
+ - ✅ Be honest about which groups you can actually reach and serve
522
+ - ✅ Let Saga challenge surface-level descriptions - she's helping you think deeper
523
+ - ✅ Trust Saga when she suggests narrowing to 3-5 groups - focus is strategic
524
+ - ✅ Describe WHO they are (context, behavior) before WHAT they want (goals, fears)
525
+
526
+ **DON'T:**
527
+ - ❌ Give demographics when Saga asks for behavioral profiles
528
+ - ❌ Insist on including every possible user type - dilutes strategic focus
529
+ - ❌ Say "all groups are equal" - Saga needs clear priorities for next workshops
530
+ - ❌ Accept your first description - let Saga dig for richer context
531
+ - ❌ Skip the feasibility conversation - be realistic about reach and resources
532
+ - ❌ Mix up persona descriptions with usage goals - Saga handles these in sequence
533
+
534
+ ---
535
+
536
+ ## What's Next
537
+
538
+ Workshop 3 maps the psychological drivers for each persona - both what they want to achieve (positive drivers) and what they want to avoid (negative drivers). This is where you understand the psychology that drives behavior.
539
+
540
+ ---
541
+
542
+ ## Key Takeaways
543
+
544
+ ✅ **Guided exploration** - Saga asks about one persona at a time, building depth through conversation
545
+ ✅ **Two-part structure** - First WHO they are (persona context), then what they want (usage goals)
546
+ ✅ **Behavioral not demographic** - Saga guides you to context and patterns, not age and income
547
+ ✅ **3-5 groups by design** - Saga keeps you focused on strategic value
548
+ ✅ **Strategic prioritization** - Saga helps you rank by impact + feasibility + urgency
549
+ ✅ **Stories reveal insight** - Your examples help Saga understand and document behavioral profiles
550
+ ✅ **Foundation for psychology** - These personas feed directly into Workshop 3
551
+ ✅ **Like BMad v6** - Natural dialog that draws out deeper insight than you'd write alone
552
+
553
+ ---
554
+
555
+ [← Back to Module Overview](module-06-overview.md) | [← Back to Lesson 4](lesson-04-workshop-1-business-goals.md) | [Next: Lesson 6 - Workshop 3: Driving Forces →](lesson-06-workshop-3-driving-forces.md)
556
+
557
+ *Part of Module 06: Trigger Mapping*