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
package/README.md CHANGED
@@ -1,19 +1,13 @@
1
1
  # Whiteport Design Studio (WDS)
2
2
 
3
- **Strategic design methodology for creating products users love, powered by AI agents.**
4
-
5
- [![npm version](https://img.shields.io/npm/v/whiteport-design-studio.svg)](https://www.npmjs.com/package/whiteport-design-studio)
6
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
7
-
8
- ---
9
-
10
- ## Installation
11
-
12
3
  ```bash
13
4
  npx whiteport-design-studio install
14
5
  ```
15
6
 
16
- The installer will guide you through setup: project type, experience level, and IDE configuration. Everything gets installed into a `_wds/` folder in your project.
7
+ **Strategic design methodology for creating products users love, powered by AI agents.**
8
+
9
+ [![npm version](https://img.shields.io/npm/v/whiteport-design-studio.svg)](https://www.npmjs.com/package/whiteport-design-studio)
10
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
17
11
 
18
12
  ---
19
13
 
@@ -23,46 +17,64 @@ WDS is a structured design methodology that uses AI agents to guide you through
23
17
 
24
18
  - **Strategic foundation** - Connect every design decision to business goals and user psychology
25
19
  - **Complete specifications** - Generate developer-ready page specs with all details defined
26
- - **AI-powered workflow** - Four specialized agents guide you through each phase
27
- - **IDE-native** - Works inside your AI coding tool (Claude Code, Cursor, Windsurf, and 14 more)
20
+ - **AI-powered workflow** - Two specialized agents guide you through each phase
21
+ - **IDE-native** - Works inside your AI coding tool (Claude Code, Cursor, Windsurf, and 16 more)
28
22
 
29
23
  ---
30
24
 
31
25
  ## Agents
32
26
 
33
- WDS uses four specialized AI agents (the Norse Pantheon):
27
+ WDS uses two specialized AI agents (the Norse Pantheon):
34
28
 
35
29
  | Agent | Role | What they do |
36
30
  |-------|------|-------------|
37
- | **Mimir** (Orchestrator) | Coach & Guide | Greets you, assesses your level, guides you through the entire process. Start here. |
38
- | **Saga** (Analyst) | Business & Product Analyst | Product Brief (Phase 1) and Trigger Mapping (Phase 2) |
39
- | **Idunn** (Product Manager) | Platform Requirements | Platform architecture (Phase 3) and design deliveries (Phase 6) |
40
- | **Freya** (Designer) | UX/UI Designer | UX Design (Phase 4), Design System (Phase 5), and testing (Phases 7-8) |
31
+ | **Saga** (Analyst) | Business & Product Analyst | Product Brief (Phase 1), Trigger Mapping (Phase 2). Start here. |
32
+ | **Freya** (Designer) | UX/UI Designer & Developer | UX Scenarios (Phase 3), UX Design (Phase 4), Agentic Development (Phase 5), Asset Generation (Phase 6), Design System (Phase 7), Product Evolution (Phase 8) |
41
33
 
42
34
  ### Activating an agent
43
35
 
44
36
  Tell your AI IDE:
45
37
 
46
38
  ```
47
- Read and activate the agent in _wds/agents/mimir-orchestrator.md
39
+ Read and activate _bmad/wds/agents/saga-analyst.md
48
40
  ```
49
41
 
50
- Mimir will greet you, assess your situation, and guide you to the right specialist.
42
+ Saga will greet you by name and guide you through creating your Product Brief.
51
43
 
52
44
  ---
53
45
 
54
46
  ## Design Phases
55
47
 
56
- | Phase | Focus | Output folder |
57
- |-------|-------|--------------|
58
- | 1. Product Exploration | Vision, positioning, success criteria | `docs/A-Product-Brief/` |
59
- | 2. Trigger Mapping | User psychology, business goals | `docs/B-Trigger-Map/` |
60
- | 3. Platform Architecture | Technical requirements (optional) | `docs/C-Platform-Requirements/` |
61
- | 4. UX Design | Scenarios, interactions, content structure | `docs/C-Scenarios/` |
62
- | 5. Visual Design | Brand identity, design system, components | `docs/D-Design-System/` |
63
- | 6. Design Delivery | Developer handoff, PRD finalization | `docs/E-PRD/Design-Deliveries/` |
48
+ | Phase | Focus | Agent | Output folder |
49
+ |-------|-------|-------|--------------|
50
+ | 0. Alignment & Signoff | Stakeholder alignment before starting | Saga | — |
51
+ | 1. Product Brief | Vision, positioning, success criteria | Saga | `A-Product-Brief/` |
52
+ | 2. Trigger Mapping | User psychology, business goals | Saga | `B-Trigger-Map/` |
53
+ | 3. UX Scenarios | Scenario outlines via 8-question dialog | Freya | `C-UX-Scenarios/` |
54
+ | 4. UX Design | Page specifications, interactions | Freya | `D-UX-Design/` |
55
+ | 5. Agentic Development | AI-assisted development & testing | Freya | `G-Product-Development/` |
56
+ | 6. Asset Generation | Visual and text assets from specs | Freya | — |
57
+ | 7. Design System | Component library, design tokens | Freya | `D-Design-System/` |
58
+ | 8. Product Evolution | Brownfield improvements | Freya | — |
59
+
60
+ Output folders are created inside your configured design artifacts directory (default: `design-artifacts/`).
61
+
62
+ ---
63
+
64
+ ## Supported Design Tools
65
+
66
+ WDS offers agenttic design capabilities with several visual design and prototyping services on the market:
64
67
 
65
- Agent dialogs and conversation logs are saved to `docs/F-Agent-Dialogs/`.
68
+ | Tool | What it does | MCP |
69
+ |------|-------------|-----|
70
+ | **Figma** | Professional UI design, design system management | Figma MCP |
71
+ | **Pencil (Penpot)** | Open-source design tool, AI-assisted layout | Pencil MCP |
72
+ | **Stitch** | AI screen generation from text descriptions | Stitch MCP |
73
+ | **Excalidraw** | Wireframing and sketch analysis | — |
74
+ | **html.to.design** | Import HTML prototypes into Figma | Figma plugin |
75
+ | **NanoBanana** | AI image generation for brand exploration | — |
76
+
77
+ The design loop works with any combination: wireframe in Excalidraw, generate screens with Stitch or Pencil, refine in Figma, pull back via MCP.
66
78
 
67
79
  ---
68
80
 
@@ -72,7 +84,7 @@ After installation, your project will have:
72
84
 
73
85
  ```
74
86
  your-project/
75
- ├── _wds/ # WDS system files
87
+ ├── _bmad/wds/ # WDS system files
76
88
  │ ├── agents/ # Compiled agent files (.md)
77
89
  │ ├── workflows/ # Phase workflows
78
90
  │ ├── data/ # Standards, frameworks, agent guides
@@ -82,18 +94,18 @@ your-project/
82
94
  │ └── module.yaml # Module definition
83
95
  ├── _wds-learn/ # Learning material (optional, safe to delete)
84
96
  │ ├── getting-started/
85
- │ ├── learn-wds/
97
+ │ ├── learn/
86
98
  │ ├── method/
87
99
  │ ├── models/
88
100
  │ └── tools/
89
- ├── docs/ # Design output (created by agents)
101
+ ├── design-artifacts/ # Design output (created by agents)
90
102
  │ ├── A-Product-Brief/
91
103
  │ ├── B-Trigger-Map/
92
- │ ├── C-Platform-Requirements/
93
- │ ├── C-Scenarios/
104
+ │ ├── C-UX-Scenarios/
94
105
  │ ├── D-Design-System/
95
- │ ├── E-PRD/Design-Deliveries/
96
- └── F-Agent-Dialogs/
106
+ │ ├── E-PRD/
107
+ ├── F-Testing/
108
+ │ └── G-Product-Development/
97
109
  └── .claude/instructions.md # IDE configuration (varies by IDE)
98
110
  ```
99
111
 
@@ -108,12 +120,12 @@ your-project/
108
120
 
109
121
  2. **Open your project** in your AI IDE (Claude Code, Cursor, Windsurf, etc.)
110
122
 
111
- 3. **Activate Mimir** - tell the AI:
123
+ 3. **Activate Saga** tell the AI:
112
124
  ```
113
- Read and activate the agent in _wds/agents/mimir-orchestrator.md
125
+ Read and activate _bmad/wds/agents/saga-analyst.md
114
126
  ```
115
127
 
116
- 4. **Follow Mimir's guidance** - Mimir will greet you, assess your experience level, and walk you through project setup. When you're ready for specific work, Mimir connects you to the right specialist agent.
128
+ 4. **Follow Saga's guidance** Saga will greet you by name and walk you through creating your Product Brief. When you're ready for design work, switch to Freya.
117
129
 
118
130
  ---
119
131
 
@@ -121,40 +133,12 @@ your-project/
121
133
 
122
134
  WDS works with any AI-powered IDE or coding tool:
123
135
 
124
- Claude Code, Cursor, Windsurf, Cline, GitHub Copilot, Roo Code, Codex, Gemini, Qwen, Trae, Kiro CLI, Rovo Dev, Crush, Auggie, Antigravity, iFlow, OpenCode
136
+ Atlassian Rovo Dev, Auggie CLI, Claude Code, Cline, Codex, Crush, Cursor, Gemini CLI, GitHub Copilot, Google Antigravity, iFlow CLI, Kilo Code, Kiro CLI, OpenCode, Qwen Code, Roo Code, Trae, VS Code, Windsurf
125
137
 
126
138
  The installer configures your selected IDE(s) automatically.
127
139
 
128
140
  ---
129
141
 
130
- ## Tools Integration
131
-
132
- WDS integrates with design and prototyping tools:
133
-
134
- - **Figma MCP** - Bidirectional sync between AI-generated designs and Figma
135
- - **html.to.design** - Import HTML prototypes into Figma
136
- - **NanoBanana/Eira** - AI-powered image generation for brand exploration
137
- - **Excalidraw** - Sketch analysis and wireframing
138
-
139
- ---
140
-
141
- ## Key Concepts
142
-
143
- ### UX vs Visual Design
144
-
145
- Phase 4 (UX Design) defines **how it works** - functionality, interactions, content structure.
146
- Phase 5 (Visual Design) defines **how it looks** - brand expression, design tokens, component library.
147
-
148
- Visual design can start at any time - brand identity is independent of product strategy.
149
-
150
- ### Adaptive Teaching
151
-
152
- Mimir adapts to your experience level:
153
- - **Beginner** - Detailed guidance, one step at a time
154
- - **Intermediate** - Balanced approach, builds on existing knowledge
155
- - **Expert** - Direct and efficient, respects your time
156
-
157
- ---
158
142
 
159
143
  ## Learning Material
160
144
 
@@ -12,7 +12,6 @@ Read and fully embody the persona from your agent definition file.
12
12
  - Saga: `src/modules/wds/agents/saga-analyst.agent.yaml`
13
13
  - Freya: `src/modules/wds/agents/freya-ux.agent.yaml`
14
14
  - Idunn: `src/modules/wds/agents/idunn-pm.agent.yaml`
15
- - Mimir: `src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md` (orchestrator file)
16
15
 
17
16
  **What to do**:
18
17
  1. Read the entire agent definition file
@@ -14,7 +14,6 @@ Show your full presentation even though this is a handoff.
14
14
  - Saga: `src/modules/wds/data/presentations/saga-presentation.md`
15
15
  - Freya: `src/modules/wds/data/presentations/freya-presentation.md`
16
16
  - Idunn: `src/modules/wds/data/presentations/idunn-presentation.md`
17
- - Mimir: `src/modules/wds/agents/presentations/mimir-presentation.md`
18
17
 
19
18
  **What to do**:
20
19
  1. Load and show your full presentation
@@ -45,7 +45,7 @@ You should see:
45
45
 
46
46
  - [About WDS](about-wds.md) - Understand what WDS is and why it exists
47
47
  - [Quick Start Guide](quick-start.md) - Your first 5 minutes
48
- - [Learn WDS Course](../learn-wds/00-course-overview.md) - Learn the concepts deeply
48
+ - [Learn WDS Course](../learn/00-course-overview.md) - Learn the concepts deeply
49
49
 
50
50
  ---
51
51
 
@@ -110,7 +110,7 @@ You created **conceptual specifications** in 5 minutes:
110
110
 
111
111
  ### Learn the Concepts
112
112
 
113
- [Learn WDS Course](../learn-wds/00-course-overview.md) - Deep dive into WDS methodology
113
+ [Learn WDS Course](../learn/00-course-overview.md) - Deep dive into WDS methodology
114
114
 
115
115
  ### Start Your Project
116
116
 
@@ -8,13 +8,13 @@
8
8
 
9
9
  ### 🎓 Take the Course
10
10
 
11
- **[WDS Course: From Designer to Linchpin](../learn-wds/00-course-overview.md)**
11
+ **[WDS Course: From Designer to Linchpin](../learn/00-course-overview.md)**
12
12
 
13
13
  Complete training from project brief to AI-ready specifications:
14
14
 
15
15
  **Module 01: Why WDS Matters**
16
16
  Learn how to be indispensable in the AI era. Understand the paradigm shift where design becomes specification.
17
- → [Start Module 01](../learn-wds/module-01-why-wds-matters/module-01-overview.md)
17
+ → [Start Module 01](../learn/module-01-why-wds-matters/module-01-overview.md)
18
18
 
19
19
  **Modules 02-16: Complete WDS Workflow**
20
20
  Master every phase from trigger mapping through design system to development handoff. Each module includes:
@@ -23,7 +23,7 @@ Master every phase from trigger mapping through design system to development han
23
23
  - **Tutorials** - Step-by-step hands-on guides
24
24
  - **Practice** - Apply to your own project
25
25
 
26
- → [View All Modules](../learn-wds/00-course-overview.md)
26
+ → [View All Modules](../learn/00-course-overview.md)
27
27
 
28
28
  **Best for:** Comprehensive learning with structured curriculum
29
29
 
@@ -39,11 +39,11 @@ Step-by-step workflows for:
39
39
 
40
40
  **Phase 1: Project Brief**
41
41
  Define vision, goals, stakeholders, and constraints that guide all design decisions.
42
- → [Tutorial: Create Project Brief](../learn-wds/module-04-product-brief/tutorial-04.md)
42
+ → [Tutorial: Create Project Brief](../learn/module-04-product-brief/tutorial-04.md)
43
43
 
44
44
  **Phase 2: Trigger Mapping**
45
45
  Understand WHO your users are, WHAT triggers their needs, and WHY your business exists. Create a Trigger Map that connects user psychology to business value.
46
- → [Tutorial: Map Triggers & Outcomes](../learn-wds/module-05-map-triggers-outcomes/tutorial-04.md)
46
+ → [Tutorial: Map Triggers & Outcomes](../learn/module-05-map-triggers-outcomes/tutorial-04.md)
47
47
 
48
48
  **Phase 3: Platform Requirements**
49
49
  Document technical constraints, integrations, and infrastructure needs.
@@ -51,7 +51,7 @@ Document technical constraints, integrations, and infrastructure needs.
51
51
 
52
52
  **Phase 4: UX Design**
53
53
  Transform ideas into conceptual specifications that preserve your design intent. AI agents help you think through solutions, then capture your brilliance in specifications that give your designs eternal life.
54
- → [Tutorial: Initialize Scenario](../learn-wds/module-08-initialize-scenario/tutorial-08.md) | [Tutorial: Conceptual Specs](../learn-wds/module-12-conceptual-specs/tutorial-12.md)
54
+ → [Tutorial: Initialize Scenario](../learn/module-08-initialize-scenario/tutorial-08.md) | [Tutorial: Conceptual Specs](../learn/module-12-conceptual-specs/tutorial-12.md)
55
55
 
56
56
  **Phase 5: Design System**
57
57
  Extract design tokens, create reusable components, and generate interactive HTML catalog.
@@ -123,14 +123,14 @@ Join the WDS community for:
123
123
 
124
124
  ## Quick Links
125
125
 
126
- - [Course](../learn-wds/00-course-overview.md)
126
+ - [Course](../learn/00-course-overview.md)
127
127
  - [Workflows](../wds-workflows-guide.md)
128
128
  - [Modular Architecture](../src/workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md)
129
129
  - [Conceptual Specifications](../src/workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md)
130
130
 
131
131
  ---
132
132
 
133
- **Ready to dive deeper? Start with the [Course](../learn-wds/00-course-overview.md)!**
133
+ **Ready to dive deeper? Start with the [Course](../learn/00-course-overview.md)!**
134
134
 
135
135
  ---
136
136
 
@@ -0,0 +1,239 @@
1
+ # WDS Course: From Designer to Linchpin
2
+
3
+ **Master the complete WDS methodology and become indispensable as a designer in the AI era**
4
+
5
+ [Watch the Course Introduction Video](https://www.youtube.com/watch?v=CQ5Aai_r-uo)
6
+
7
+ ---
8
+
9
+ ## Welcome to the WDS Course
10
+
11
+ This comprehensive course teaches you the complete WDS workflow through **18 practical modules** that transform how you design products.
12
+
13
+ **The paradigm shift:**
14
+
15
+ - The design becomes the specification
16
+ - The specification becomes the product
17
+ - The code is just the printout
18
+
19
+ **What you'll become:**
20
+
21
+ - The linchpin designer who makes things happen
22
+ - The gatekeeper between business goals and user needs
23
+ - The irreplaceable designer in the AI era
24
+
25
+ **Time investment:** ~10 hours total
26
+ **Result:** Complete mastery of WDS methodology from project brief to AI-ready specifications
27
+
28
+ ---
29
+
30
+ ## Who Created WDS?
31
+
32
+ **MÃ¥rten Angner** is a UX designer and founder of Whiteport, a design and development agency based in Sweden. After years of working with AI tools, MÃ¥rten observed that traditional design handoffs were breaking down. Designers would create beautiful mockups, hand them off to developers, and watch their creative intent get lost in translation.
33
+
34
+ MÃ¥rten developed WDS to solve this problem - a methodology where design thinking is preserved and amplified through AI implementation, not diluted and lost.
35
+
36
+ **The Mission:** WDS is completely free and open-source. MÃ¥rten created it as a **plugin module for BMad Method** - an open-source AI-augmented development framework - to give designers everywhere the tools they need to thrive in the AI era.
37
+
38
+ ---
39
+
40
+ ## Before You Start
41
+
42
+ **[→ Getting Started Guide](00-getting-started-overview.md)**
43
+
44
+ Review prerequisites, choose your learning path, and get support:
45
+
46
+ - **Prerequisites** - Skills, tools, time investment
47
+ - **Learning Paths** - Full immersion, quick start, or self-paced
48
+ - **Support** - Testimonials, FAQ, community
49
+
50
+ **Reading time:** ~15 minutes
51
+
52
+ ---
53
+
54
+ ## Course Structure
55
+
56
+ Each module contains:
57
+
58
+ - **Lessons** - Theory and concepts (with NotebookLM audio support)
59
+ - **Tutorial** - Step-by-step hands-on guide (for practical modules)
60
+ - **Practice** - Apply to your own project
61
+
62
+ **Learning format:**
63
+
64
+ - **Lessons** - Read as documentation or generate audio with NotebookLM
65
+ - **Tutorials** - Follow step-by-step guides with AI support
66
+ - **Practice** - Apply to real projects as you learn
67
+ - **Workshops** - Use for team training
68
+
69
+ ---
70
+
71
+ ## Course Modules
72
+
73
+ ### Foundation (Modules 1-2)
74
+
75
+ | Module | Title | Agent | Time |
76
+ |--------|-------|-------|------|
77
+ | 01 | [Why WDS Matters](../module-01-why-wds-matters/module-01-overview.md) | — | 40 min |
78
+ | 02 | [Installation & Setup](../module-02-installation-setup/module-02-overview.md) | — | 45 min |
79
+
80
+ ### Alignment (Module 3) — Optional
81
+
82
+ | Module | Title | Agent | Time |
83
+ |--------|-------|-------|------|
84
+ | 03 | [Alignment & Signoff](../module-03-alignment-signoff/module-03-overview.md) | Saga | 55-75 min |
85
+
86
+ *Skip if doing it yourself — go straight to Product Brief*
87
+
88
+ ### Strategy Phase (Modules 4-6) — Agent: Saga
89
+
90
+ | Module | Title | Agent | Time |
91
+ |--------|-------|-------|------|
92
+ | 04 | [Product Brief](../module-04-product-brief/module-04-overview.md) | Saga | 60 min |
93
+ | 05 | [Platform Requirements](../module-05-platform-requirements/module-05-platform-requirements-overview.md) | Saga | 30 min |
94
+ | 06 | [Trigger Mapping](../module-06-trigger-mapping/module-06-overview.md) | Saga | 95-125 min |
95
+
96
+ ### Design Phase (Modules 7-13) — Agent: Freya
97
+
98
+ | Module | Title | Agent | Focus | Time |
99
+ |--------|-------|-------|-------|------|
100
+ | 07 | [Design Phase Introduction](../module-07-design-phase/module-07-design-phase-overview.md) | Freya | Overview | 20 min |
101
+ | 08 | [Outline Scenarios](../module-08-outline-scenarios/module-08-outline-scenarios-overview.md) | Freya | UX | 30 min |
102
+ | 09 | [Conceptual Sketching](../module-09-conceptual-sketching/module-09-conceptual-sketching-overview.md) | Freya | UX | 60 min |
103
+ | 10 | [Storyboarding](../module-10-storyboarding/module-10-storyboarding-overview.md) | Freya | UX | 45 min |
104
+ | 11 | [Conceptual Specifications](../module-11-conceptual-specifications/module-11-conceptual-specifications-overview.md) | Freya | UX | 60 min |
105
+ | 12 | [Functional Components](../module-12-functional-components/module-12-functional-components-overview.md) | Freya | UX | 45 min |
106
+ | 13 | [Design System](../module-13-design-system/module-13-design-system-overview.md) | Freya | Systems | 30 min |
107
+
108
+ ### Build & Deliver Phase (Modules 14-16) — Agent: Freya
109
+
110
+ | Module | Title | Agent | Focus | Time |
111
+ |--------|-------|-------|-------|------|
112
+ | 14 | [Agentic Development](../module-14-agentic-development/module-14-agentic-development-overview.md) | Freya | 7-activity menu | 60 min |
113
+ | 15 | [Visual Design & Assets](../module-15-visual-design/module-15-visual-design-overview.md) | Freya | Asset pipeline | 60 min |
114
+ | 16 | [Design Delivery](../module-16-design-delivery/module-16-design-delivery-overview.md) | Freya | Handover | 45 min |
115
+
116
+ ### Validate & Evolve (Modules 17-18) — Agent: Freya
117
+
118
+ | Module | Title | Agent | Time |
119
+ |--------|-------|-------|------|
120
+ | 17 | [Usability Testing](../module-17-usability-testing/module-17-usability-testing-overview.md) | Freya | 45 min |
121
+ | 18 | [Product Evolution](../module-18-product-evolution/module-18-product-evolution-overview.md) | Freya | 30 min |
122
+
123
+ ---
124
+
125
+ ## Learning Paths
126
+
127
+ **Complete Course:** All 18 modules (~10 hours)
128
+
129
+ **Quick Start:** Modules 01, 02, 04, 06, 08, 11 (~6 hours)
130
+
131
+ **Strategy Only:** Modules 1-6 (~4 hours)
132
+
133
+ **Design Deep Dive:** Modules 7-13 (~5 hours)
134
+
135
+ **Build & Deliver:** Modules 14-16 (~3 hours)
136
+
137
+ **Phase-Specific:** Jump to any phase as needed
138
+
139
+ ---
140
+
141
+ ## The Two Agents
142
+
143
+ WDS uses two AI agents, each with a specific domain:
144
+
145
+ | Agent | Domain | Phase | Modules |
146
+ |-------|--------|-------|---------|
147
+ | **Saga** | Strategy | Strategy | 3-6 |
148
+ | **Freya** | UX, Visual Design, Development & Evolution | Design, Build & Evolve | 7-18 |
149
+
150
+ Each agent maintains focus on their domain while coordinating with the other.
151
+
152
+ **Freya's 7 activities** (Module 14): Prototyping, Development, Bugfixing, Evolution, Analysis, Reverse Engineering, and Acceptance Testing — all menu-driven from a single entry point.
153
+
154
+ ---
155
+
156
+ ## NotebookLM Integration
157
+
158
+ Each module has matching content for NotebookLM:
159
+
160
+ - Feed module lessons to NotebookLM
161
+ - Generate audio podcasts for learning on the go
162
+ - Generate video presentations for team training
163
+ - Create study guides and summaries
164
+
165
+ **All modules are optimized for AI-assisted learning.**
166
+
167
+ ---
168
+
169
+ ## Module Structure
170
+
171
+ Every module follows the same pattern:
172
+
173
+ **1. Inspiration (10 min)**
174
+
175
+ - Why this step matters
176
+ - The transformation you'll experience
177
+ - Real-world impact
178
+
179
+ **2. Teaching (20 min)**
180
+
181
+ - How to do it with confidence
182
+ - AI support at each step
183
+ - Dog Week example walkthrough
184
+
185
+ **3. Practice (10 min)**
186
+
187
+ - Apply to your own project
188
+ - Step-by-step instructions
189
+ - Success criteria
190
+
191
+ **4. Tutorial (optional)**
192
+
193
+ - Quick step-by-step guide
194
+ - "Just show me how to do it"
195
+ - For practical modules only
196
+
197
+ ---
198
+
199
+ ## After the Course
200
+
201
+ Once you've completed the modules:
202
+
203
+ 1. **[Documentation Guide](../../docs-guide.md)** - Reference documentation
204
+ 2. **[Quick Start](../../quick-start/00-start-here.md)** - Try WDS with agent
205
+ 3. **[Community](https://discord.gg/whiteport)** - Get help and share your work
206
+
207
+ ---
208
+
209
+ ## Prerequisites
210
+
211
+ **What you need:**
212
+
213
+ - Basic design thinking and UX principles
214
+ - Ability to sketch interfaces (hand-drawn or digital)
215
+ - Understanding of user needs and business goals
216
+ - Willingness to think deeply about WHY
217
+
218
+ **What you DON'T need:**
219
+
220
+ - ❌ Coding skills
221
+ - ❌ Advanced technical knowledge
222
+ - ❌ Experience with AI tools
223
+ - ❌ Formal design education
224
+
225
+ **If you can design interfaces and explain your thinking, you're ready to start.**
226
+
227
+ ---
228
+
229
+ ## Ready to Begin?
230
+
231
+ Ten hours of learning. A lifetime of being indispensable.
232
+
233
+ **[Start with Module 01: Why WDS Matters →](../module-01-why-wds-matters/module-01-overview.md)**
234
+
235
+ ---
236
+
237
+ **This course is free and open-source**
238
+ **Created by MÃ¥rten Angner and the Whiteport team**
239
+ **Integrated with BMad Method for seamless design-to-development workflow**
@@ -51,7 +51,7 @@ Once you've reviewed these sections, you're ready to begin:
51
51
 
52
52
  Or review the full course structure:
53
53
 
54
- **[← Back to Course Overview](../00-course-overview.md)**
54
+ **[← Back to Course Overview](00-course-overview.md)**
55
55
 
56
56
  ---
57
57
 
@@ -36,7 +36,7 @@
36
36
 
37
37
  **Breakdown:**
38
38
 
39
- - **Week 1-2:** Foundation modules (Why WDS, Project Brief)
39
+ - **Week 1-2:** Foundation modules (Why WDS, Product Brief)
40
40
  - **Week 3-4:** Core workflow (Trigger Mapping, Scenarios)
41
41
  - **Week 5-6:** Advanced topics (Design Systems, Handoff)
42
42
  - **Ongoing:** Practice with your own projects
@@ -95,4 +95,4 @@ You have everything you need if you can answer YES to these:
95
95
 
96
96
  ---
97
97
 
98
- [← Back to Overview](overview.md) | [Next: Learning Paths →](02-learning-paths.md)
98
+ [← Back to Overview](00-getting-started-overview.md) | [Next: Learning Paths →](02-learning-paths.md)
@@ -16,10 +16,10 @@
16
16
 
17
17
  ### Option 2: Quick Start
18
18
 
19
- - Focus on core modules (Module 01, 02, 04, 06)
19
+ - Focus on core modules (Modules 01, 02, 04, 06, 08, 11)
20
20
  - Skip advanced topics initially
21
21
  - Get started fast, learn more later
22
- - **Time:** 2-3 weeks, 3-4 hours total
22
+ - **Time:** 3-4 weeks, ~6 hours total
23
23
  - **Best for:** Designers who need results quickly
24
24
 
25
25
  ### Option 3: Self-Paced
@@ -38,7 +38,7 @@
38
38
 
39
39
  By the end of this course, you'll have created:
40
40
 
41
- **1. Complete Project Brief**
41
+ **1. Complete Product Brief**
42
42
 
43
43
  - Vision and goals clearly defined
44
44
  - Stakeholders and constraints documented
@@ -88,12 +88,12 @@ Each module contains:
88
88
 
89
89
  Choose your path and start learning:
90
90
 
91
- **[Start Module 01: Why WDS Matters ](../module-01-why-wds-matters/module-01-overview.md)**
91
+ **[Start Module 01: Why WDS Matters →](../module-01-why-wds-matters/module-01-overview.md)**
92
92
 
93
93
  Or check support resources first:
94
94
 
95
- **[Continue to Support ](03-support.md)**
95
+ **[Continue to Support →](03-support.md)**
96
96
 
97
97
  ---
98
98
 
99
- [ Back to Prerequisites](01-prerequisites.md) | [Next: Support ](03-support.md)
99
+ [← Back to Prerequisites](01-prerequisites.md) | [Next: Support →](03-support.md)
@@ -121,7 +121,7 @@ You have everything you need:
121
121
 
122
122
  Or review the full course structure:
123
123
 
124
- **[← Back to Course Overview](../00-course-overview.md)**
124
+ **[← Back to Course Overview](00-course-overview.md)**
125
125
 
126
126
  ---
127
127
 
@@ -61,7 +61,7 @@ Great products are not created in 24 hours with a couple of prompts. Designers h
61
61
  ### Core Resources
62
62
  - [WDS Framework Repository](https://github.com/whiteport-collective/whiteport-design-studio)
63
63
  - [WDS Presentation Page](https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md)
64
- - [WDS Course Overview](https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md)
64
+ - [WDS Course Overview](https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn/00-course-overview.md)
65
65
  - [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD)
66
66
  - [BMAD Masterclass](https://www.youtube.com/watch?v=LorEJPrALcg)
67
67
  - [Whiteport Website](https://whiteport.com)
@@ -150,7 +150,7 @@ WDS Presentation Page - Discover how WDS transforms designers into strategic lea
150
150
  https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md
151
151
 
152
152
  WDS Course Overview - Complete learning path from designer to linchpin, master the full methodology
153
- https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md
153
+ https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn/00-course-overview.md
154
154
 
155
155
  🛠️ Foundation & Related Tools
156
156
  BMAD Method - The open-source AI-augmented development framework that powers WDS
@@ -157,7 +157,7 @@ WDS Presentation Page - Discover how WDS transforms designers into strategic lea
157
157
  https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md
158
158
 
159
159
  WDS Course Overview - Complete learning path from designer to linchpin, master the full methodology
160
- https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md
160
+ https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn/00-course-overview.md
161
161
 
162
162
  🛠️ Foundation & Related Tools
163
163
  BMAD Method - The open-source AI-augmented development framework that powers WDS
@@ -65,7 +65,7 @@ Then we translate that into a strategy you can actually execute.
65
65
  ### Core Resources
66
66
  - [WDS Framework Repository](https://github.com/whiteport-collective/whiteport-design-studio)
67
67
  - [WDS Presentation Page](https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md)
68
- - [WDS Course Overview](https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md)
68
+ - [WDS Course Overview](https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn/00-course-overview.md)
69
69
  - [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD)
70
70
  - [BMAD Masterclass](https://www.youtube.com/watch?v=LorEJPrALcg)
71
71
  - [Whiteport Website](https://whiteport.com)
@@ -128,7 +128,7 @@ WDS Presentation Page - Discover how WDS transforms designers into strategic lea
128
128
  https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/examples/WDS-Presentation/docs/4-scenarios/1.1-wds-presentation/1.1-wds-presentation.md
129
129
 
130
130
  WDS Course Overview - Complete learning path from designer to linchpin, master the full methodology
131
- https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn-wds/00-course-overview.md
131
+ https://github.com/whiteport-collective/whiteport-design-studio/blob/main/docs/learn/00-course-overview.md
132
132
 
133
133
  🛠️ Foundation & Related Tools
134
134
  BMAD Method - The open-source AI-augmented development framework that powers WDS