whiteport-design-studio 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (686) hide show
  1. package/LICENSE +27 -0
  2. package/README.md +196 -0
  3. package/docs/getting-started/MANUAL-INIT-GUIDE.md +251 -0
  4. package/docs/getting-started/about-wds.md +86 -0
  5. package/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md +28 -0
  6. package/docs/getting-started/agent-activation/activation/step-02-check-conversations.md +43 -0
  7. package/docs/getting-started/agent-activation/activation/step-03-check-activation-context.md +42 -0
  8. package/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md +30 -0
  9. package/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md +27 -0
  10. package/docs/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md +34 -0
  11. package/docs/getting-started/agent-activation/activation/step-05-standard-analysis.md +26 -0
  12. package/docs/getting-started/agent-activation/agent-launchers.md +134 -0
  13. package/docs/getting-started/agent-activation/wds-freya-ux.md +67 -0
  14. package/docs/getting-started/agent-activation/wds-idunn-pm.md +67 -0
  15. package/docs/getting-started/agent-activation/wds-mimir.md +78 -0
  16. package/docs/getting-started/agent-activation/wds-saga-analyst.md +65 -0
  17. package/docs/getting-started/getting-started-overview.md +112 -0
  18. package/docs/getting-started/installation.md +62 -0
  19. package/docs/getting-started/quick-start.md +125 -0
  20. package/docs/getting-started/where-to-go-next.md +137 -0
  21. package/docs/learn-wds/00-course-overview/00-getting-started-overview.md +66 -0
  22. package/docs/learn-wds/00-course-overview/01-prerequisites.md +98 -0
  23. package/docs/learn-wds/00-course-overview/02-learning-paths.md +99 -0
  24. package/docs/learn-wds/00-course-overview/03-support.md +128 -0
  25. package/docs/learn-wds/00-course-overview.md +211 -0
  26. package/docs/learn-wds/Webinars/2024-12-22-WDS-Jam-1-Say-Hello-to-AI-Agent-Framework.md +0 -0
  27. package/docs/learn-wds/Webinars/2024-12-22-WDS-Sessions-1-Say-Hello-to-WDS.md +174 -0
  28. package/docs/learn-wds/Webinars/2025-10-22-Webinar-WDS-v4.md +181 -0
  29. package/docs/learn-wds/Webinars/2026-01-15-WDS-Sessions-2-Strategy-in-Practice.md +159 -0
  30. package/docs/learn-wds/course-explainers/Module 00-transcript.srt +635 -0
  31. package/docs/learn-wds/course-explainers/Module 02-transcript.srt +807 -0
  32. package/docs/learn-wds/course-explainers/Module-00-notebook-lm-prompt.md +250 -0
  33. package/docs/learn-wds/course-explainers/Module-00-thumbnail-prompt.md +33 -0
  34. package/docs/learn-wds/course-explainers/Module-00-youtube-show-notes.md +78 -0
  35. package/docs/learn-wds/course-explainers/Module-01-notebook-lm-prompt.md +418 -0
  36. package/docs/learn-wds/course-explainers/Module-01-thumbnail-prompt.md +33 -0
  37. package/docs/learn-wds/course-explainers/Module-01-transcript.srt +731 -0
  38. package/docs/learn-wds/course-explainers/Module-02-notebook-lm-prompt.md +342 -0
  39. package/docs/learn-wds/course-explainers/Module-02-thumbnail-prompt.md +34 -0
  40. package/docs/learn-wds/course-explainers/Module-03-notebook-lm-prompt.md +745 -0
  41. package/docs/learn-wds/course-explainers/Module-03-thumbnail-prompt.md +33 -0
  42. package/docs/learn-wds/course-explainers/Module-03-transcript.srt +595 -0
  43. package/docs/learn-wds/course-explainers/Module-04-notebook-lm-prompt.md +163 -0
  44. package/docs/learn-wds/course-explainers/Module-04-thumbnail-prompt.md +36 -0
  45. package/docs/learn-wds/course-explainers/Module-04-youtube-show-notes.md +95 -0
  46. package/docs/learn-wds/course-explainers/Module-05-notebook-lm-prompt.md +274 -0
  47. package/docs/learn-wds/course-explainers/Module-05-thumbnail-prompt.md +40 -0
  48. package/docs/learn-wds/course-explainers/Module-05-youtube-show-notes.md +65 -0
  49. package/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md +75 -0
  50. package/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md +86 -0
  51. package/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md +82 -0
  52. package/docs/learn-wds/course-explainers/trigger-map-example.jpg +0 -0
  53. package/docs/learn-wds/module-01-why-wds-matters/lesson-01-the-problem.md +113 -0
  54. package/docs/learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md +75 -0
  55. package/docs/learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md +94 -0
  56. package/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md +109 -0
  57. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md +124 -0
  58. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md +63 -0
  59. package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md +124 -0
  60. package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md +87 -0
  61. package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md +203 -0
  62. package/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md +70 -0
  63. package/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md +40 -0
  64. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md +48 -0
  65. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md +88 -0
  66. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md +88 -0
  67. package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md +48 -0
  68. package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md +48 -0
  69. package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md +149 -0
  70. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md +51 -0
  71. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md +111 -0
  72. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md +111 -0
  73. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md +51 -0
  74. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/checklist.md +41 -0
  75. package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/tutorial.md +159 -0
  76. package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md +93 -0
  77. package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md +217 -0
  78. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md +73 -0
  79. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md +206 -0
  80. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md +206 -0
  81. package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md +73 -0
  82. package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md +79 -0
  83. package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md +244 -0
  84. package/docs/learn-wds/module-02-installation-setup/module-02-overview.md +77 -0
  85. package/docs/learn-wds/module-03-alignment-signoff/lesson-01-understanding-alignment.md +175 -0
  86. package/docs/learn-wds/module-03-alignment-signoff/lesson-02-creating-alignment-document.md +289 -0
  87. package/docs/learn-wds/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md +115 -0
  88. package/docs/learn-wds/module-03-alignment-signoff/lesson-04-external-contracts.md +201 -0
  89. package/docs/learn-wds/module-03-alignment-signoff/lesson-05-internal-signoff.md +189 -0
  90. package/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md +170 -0
  91. package/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md +344 -0
  92. package/docs/learn-wds/module-04-product-brief/lesson-01-chaos-problem.md +193 -0
  93. package/docs/learn-wds/module-04-product-brief/lesson-02-five-questions.md +364 -0
  94. package/docs/learn-wds/module-04-product-brief/lesson-03-document-structure.md +388 -0
  95. package/docs/learn-wds/module-04-product-brief/lesson-04-wds-advantage.md +402 -0
  96. package/docs/learn-wds/module-04-product-brief/lesson-05-using-brief.md +491 -0
  97. package/docs/learn-wds/module-04-product-brief/lesson-06-additional-documents.md +645 -0
  98. package/docs/learn-wds/module-04-product-brief/module-04-overview.md +194 -0
  99. package/docs/learn-wds/module-04-product-brief/tutorial-04.md +400 -0
  100. package/docs/learn-wds/module-05-map-triggers-outcomes/tutorial-04.md +460 -0
  101. package/docs/learn-wds/module-05-trigger-mapping/lesson-01-missing-link.md +237 -0
  102. package/docs/learn-wds/module-05-trigger-mapping/lesson-02-heritage-evolution.md +364 -0
  103. package/docs/learn-wds/module-05-trigger-mapping/lesson-03-five-workshops-overview.md +459 -0
  104. package/docs/learn-wds/module-05-trigger-mapping/lesson-04-workshop-1-business-goals.md +274 -0
  105. package/docs/learn-wds/module-05-trigger-mapping/lesson-05-workshop-2-target-groups.md +504 -0
  106. package/docs/learn-wds/module-05-trigger-mapping/lesson-06-workshop-3-driving-forces.md +458 -0
  107. package/docs/learn-wds/module-05-trigger-mapping/lesson-07-workshop-4-prioritization.md +313 -0
  108. package/docs/learn-wds/module-05-trigger-mapping/lesson-08-workshop-5-feature-impact.md +474 -0
  109. package/docs/learn-wds/module-05-trigger-mapping/lesson-09-positive-negative-drivers.md +348 -0
  110. package/docs/learn-wds/module-05-trigger-mapping/lesson-10-visual-trigger-map.md +411 -0
  111. package/docs/learn-wds/module-05-trigger-mapping/lesson-11-feature-impact-scoring.md +403 -0
  112. package/docs/learn-wds/module-05-trigger-mapping/module-05-overview.md +283 -0
  113. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05.md +595 -0
  114. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05b-value-trigger-chain.md +393 -0
  115. package/docs/learn-wds/module-05-trigger-mapping/tutorial-05c-documentation-synthesis.md +475 -0
  116. package/docs/learn-wds/module-06-platform-architecture/tutorial-06.md +358 -0
  117. package/docs/learn-wds/module-08-initialize-scenario/tutorial-08.md +521 -0
  118. package/docs/learn-wds/module-09-design-system/tutorial-09.md +515 -0
  119. package/docs/learn-wds/module-10-design-delivery/tutorial-10.md +604 -0
  120. package/docs/learn-wds/module-12-conceptual-specs/tutorial-12.md +734 -0
  121. package/docs/method/content-creation-philosophy.md +311 -0
  122. package/docs/method/content-purpose-guide.md +436 -0
  123. package/docs/method/phase-1-product-exploration-guide.md +178 -0
  124. package/docs/method/phase-2-trigger-mapping-guide.md +399 -0
  125. package/docs/method/phase-3-prd-platform-guide.md +284 -0
  126. package/docs/method/phase-4-ux-design-guide.md +388 -0
  127. package/docs/method/phase-5-design-system-guide.md +916 -0
  128. package/docs/method/phase-6-prd-finalization-guide.md +510 -0
  129. package/docs/method/tone-of-voice-guide.md +466 -0
  130. package/docs/method/value-trigger-chain-guide.md +474 -0
  131. package/docs/method/wds-method-guide.md +378 -0
  132. package/docs/models/action-mapping.md +681 -0
  133. package/docs/models/customer-awareness-cycle.md +530 -0
  134. package/docs/models/golden-circle.md +532 -0
  135. package/docs/models/gtd-getting-things-done.md +193 -0
  136. package/docs/models/impact-effect-mapping.md +600 -0
  137. package/docs/models/kathy-sierra-badass-users.md +672 -0
  138. package/docs/models/models-guide.md +297 -0
  139. package/docs/models/smart-goals-model.md +294 -0
  140. package/docs/tools/cursor-windsurf.md +190 -0
  141. package/docs/tools/figma-mcp.md +453 -0
  142. package/docs/tools/figma.md +212 -0
  143. package/docs/tools/git.md +285 -0
  144. package/docs/tools/html-to-design.md +185 -0
  145. package/docs/tools/nanobanana.md +240 -0
  146. package/docs/tools/prepare-for-figma-export.md +690 -0
  147. package/docs/tools/wds-tools-guide.md +115 -0
  148. package/package.json +114 -0
  149. package/src/agents/freya-ux.agent.yaml +128 -0
  150. package/src/agents/idunn-pm.agent.yaml +94 -0
  151. package/src/agents/mimir-orchestrator.agent.yaml +139 -0
  152. package/src/agents/saga-analyst.agent.yaml +128 -0
  153. package/src/data/agent-guides/freya/agentic-development.md +200 -0
  154. package/src/data/agent-guides/freya/content-creation.md +270 -0
  155. package/src/data/agent-guides/freya/design-system.md +336 -0
  156. package/src/data/agent-guides/freya/meta-content-guide.md +483 -0
  157. package/src/data/agent-guides/freya/specification-quality.md +250 -0
  158. package/src/data/agent-guides/freya/strategic-design.md +118 -0
  159. package/src/data/agent-guides/idunn/design-handoffs.md +411 -0
  160. package/src/data/agent-guides/idunn/platform-requirements.md +351 -0
  161. package/src/data/agent-guides/mimir/emotional-intelligence.md +295 -0
  162. package/src/data/agent-guides/mimir/teaching-styles.md +286 -0
  163. package/src/data/agent-guides/mimir/wds-overview.md +369 -0
  164. package/src/data/agent-guides/saga/discovery-conversation.md +245 -0
  165. package/src/data/agent-guides/saga/strategic-documentation.md +456 -0
  166. package/src/data/agent-guides/saga/trigger-mapping.md +403 -0
  167. package/src/data/design-system/component-boundaries.md +318 -0
  168. package/src/data/design-system/figma-component-structure.md +697 -0
  169. package/src/data/design-system/naming-conventions.md +200 -0
  170. package/src/data/design-system/state-management.md +93 -0
  171. package/src/data/design-system/token-architecture.md +474 -0
  172. package/src/data/design-system/validation-patterns.md +74 -0
  173. package/src/data/presentations/freya-intro.md +275 -0
  174. package/src/data/presentations/freya-presentation.md +78 -0
  175. package/src/data/presentations/idunn-intro.md +231 -0
  176. package/src/data/presentations/idunn-presentation.md +80 -0
  177. package/src/data/presentations/mimir-presentation.md +123 -0
  178. package/src/data/presentations/saga-intro.md +285 -0
  179. package/src/data/presentations/saga-presentation.md +75 -0
  180. package/src/gems/eira-visual-designer.md +571 -0
  181. package/src/module.yaml +111 -0
  182. package/src/templates/design-delivery.template.yaml +104 -0
  183. package/src/templates/platform-requirements.template.yaml +69 -0
  184. package/src/templates/test-scenario.template.yaml +192 -0
  185. package/src/workflows/00-system/FILE-NAMING-CONVENTIONS.md +286 -0
  186. package/src/workflows/00-system/INSTRUCTION-FILE-GUIDELINES.md +284 -0
  187. package/src/workflows/00-system/SPECIFICATION-FORMATTING-STANDARDS.md +516 -0
  188. package/src/workflows/00-system/language-configuration-guide.md +472 -0
  189. package/src/workflows/00-system/language-flow-diagram.md +446 -0
  190. package/src/workflows/00-system/wds-workflow-status-template.yaml +106 -0
  191. package/src/workflows/1-project-brief/alignment-signoff/contract.template.md +297 -0
  192. package/src/workflows/1-project-brief/alignment-signoff/pitch.template.md +101 -0
  193. package/src/workflows/1-project-brief/alignment-signoff/section-guide.md +212 -0
  194. package/src/workflows/1-project-brief/alignment-signoff/service-agreement.template.md +277 -0
  195. package/src/workflows/1-project-brief/alignment-signoff/signoff.template.md +188 -0
  196. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-01-start.md +81 -0
  197. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-01.5-extract-communications.md +78 -0
  198. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-02-explore-sections.md +159 -0
  199. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-03-synthesize.md +48 -0
  200. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-03.5-generate-contract.md +87 -0
  201. package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-04-present-for-approval.md +89 -0
  202. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md +27 -0
  203. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/02-determine-if-needed.md +32 -0
  204. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/03-offer-extract-communications.md +31 -0
  205. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/04-extract-info.md +39 -0
  206. package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/05-detect-starting-point.md +34 -0
  207. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/06-explore-realization.md +45 -0
  208. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/07-explore-solution.md +25 -0
  209. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/08-explore-why-it-matters.md +33 -0
  210. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/09-explore-how-we-see-it-working.md +29 -0
  211. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/10-explore-paths-we-explored.md +28 -0
  212. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/11-explore-recommended-solution.md +26 -0
  213. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/12-explore-path-forward.md +38 -0
  214. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/13-explore-value-we-create.md +40 -0
  215. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/14-explore-cost-of-inaction.md +37 -0
  216. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/15-explore-our-commitment.md +33 -0
  217. package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/16-explore-summary.md +26 -0
  218. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/17-reflect-back.md +33 -0
  219. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18-synthesize-document.md +41 -0
  220. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18.5-create-vtc.md +76 -0
  221. package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/19-present-for-approval.md +44 -0
  222. package/src/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/20-offer-signoff-document.md +38 -0
  223. package/src/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/21-determine-business-model.md +50 -0
  224. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/22-build-section-01-project-overview.md +29 -0
  225. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/23-build-section-02-business-model.md +66 -0
  226. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/24-build-section-03-scope-of-work.md +46 -0
  227. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/25-build-section-04-payment-terms.md +81 -0
  228. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/26-build-section-05-timeline.md +31 -0
  229. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/27-build-section-06-availability.md +38 -0
  230. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/28-build-section-07-confidentiality.md +42 -0
  231. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/29-build-section-08-not-to-exceed.md +54 -0
  232. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/30-build-section-09-work-initiation.md +41 -0
  233. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/31-build-section-10-terms-and-conditions.md +38 -0
  234. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/32-build-section-11-approval.md +36 -0
  235. package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/33-finalize-contract.md +40 -0
  236. package/src/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/34-build-internal-signoff.md +65 -0
  237. package/src/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/35-finalize-signoff.md +39 -0
  238. package/src/workflows/1-project-brief/alignment-signoff/substeps/substeps-guide.md +81 -0
  239. package/src/workflows/1-project-brief/alignment-signoff/validation-report-alignment-signoff.md +360 -0
  240. package/src/workflows/1-project-brief/alignment-signoff/workflow.md +157 -0
  241. package/src/workflows/1-project-brief/complete/validation-report-complete.md +142 -0
  242. package/src/workflows/1-project-brief/complete/workflow.md +60 -0
  243. package/src/workflows/1-project-brief/handover/instructions.md +16 -0
  244. package/src/workflows/1-project-brief/handover/steps/step-01-analyze-brief.md +31 -0
  245. package/src/workflows/1-project-brief/handover/steps/step-02-create-summary.md +46 -0
  246. package/src/workflows/1-project-brief/handover/steps/step-03-provide-activation.md +44 -0
  247. package/src/workflows/1-project-brief/project-brief/complete/instructions.md +273 -0
  248. package/src/workflows/1-project-brief/project-brief/complete/project-brief.template.md +193 -0
  249. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-01-init.md +35 -0
  250. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-02-vision.md +43 -0
  251. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-03-positioning.md +34 -0
  252. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-04-create-vtc.md +118 -0
  253. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-05-business-model.md +26 -0
  254. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-06-business-customers.md +28 -0
  255. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-07-target-users.md +40 -0
  256. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-08-success-criteria.md +40 -0
  257. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-09-competitive-landscape.md +42 -0
  258. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-10-constraints.md +43 -0
  259. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-10a-platform-strategy.md +73 -0
  260. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-11-create-vtc.md +133 -0
  261. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-11-tone-of-voice.md +233 -0
  262. package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-12-synthesize.md +44 -0
  263. package/src/workflows/1-project-brief/project-brief/complete/steps-c/substeps/11-tone-of-voice-example.md +52 -0
  264. package/src/workflows/1-project-brief/project-brief/complete/workflow.md +60 -0
  265. package/src/workflows/1-project-brief/project-brief/simplified/instructions.md +126 -0
  266. package/src/workflows/1-project-brief/project-brief/simplified/simplified-brief.template.md +44 -0
  267. package/src/workflows/1-project-brief/project-brief/validation-report-project-brief.md +343 -0
  268. package/src/workflows/1-project-brief/workflow.yaml +37 -0
  269. package/src/workflows/2-trigger-mapping/REVIEW-FINDINGS.md +160 -0
  270. package/src/workflows/2-trigger-mapping/document-generation/instructions.md +16 -0
  271. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-01-generate-hub.md +188 -0
  272. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-02-generate-business-goals.md +231 -0
  273. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03a-generate-primary-persona.md +96 -0
  274. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03b-generate-secondary-persona.md +104 -0
  275. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03c-generate-tertiary-persona.md +96 -0
  276. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-04-generate-key-insights.md +88 -0
  277. package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-05-quality-check.md +68 -0
  278. package/src/workflows/2-trigger-mapping/document-generation/steps-c/substeps/04-key-insights-structure.md +222 -0
  279. package/src/workflows/2-trigger-mapping/document-generation/steps-c/substeps/05-quality-checklist.md +212 -0
  280. package/src/workflows/2-trigger-mapping/document-generation/templates/persona-document-template.md +485 -0
  281. package/src/workflows/2-trigger-mapping/document-generation/validation-report-document-generation.md +321 -0
  282. package/src/workflows/2-trigger-mapping/document-generation/workflow.md +66 -0
  283. package/src/workflows/2-trigger-mapping/handover/instructions.md +15 -0
  284. package/src/workflows/2-trigger-mapping/handover/steps/step-01-finalize-hub.md +25 -0
  285. package/src/workflows/2-trigger-mapping/handover/steps/step-02-add-cross-references.md +27 -0
  286. package/src/workflows/2-trigger-mapping/handover/steps/step-03-quality-check.md +25 -0
  287. package/src/workflows/2-trigger-mapping/handover/steps/step-04-create-handover-package.md +73 -0
  288. package/src/workflows/2-trigger-mapping/handover/steps/step-05-provide-activation.md +64 -0
  289. package/src/workflows/2-trigger-mapping/instructions.md +159 -0
  290. package/src/workflows/2-trigger-mapping/mermaid-diagram/instructions.md +28 -0
  291. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-01-initialize-structure.md +84 -0
  292. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-02-format-business-goals.md +86 -0
  293. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-03-format-platform.md +94 -0
  294. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-04-format-target-groups.md +113 -0
  295. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-05-format-driving-forces.md +118 -0
  296. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-06-create-connections.md +136 -0
  297. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-07-apply-styling.md +171 -0
  298. package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-08-quality-check.md +183 -0
  299. package/src/workflows/2-trigger-mapping/mermaid-diagram/validation-report-mermaid-diagram.md +185 -0
  300. package/src/workflows/2-trigger-mapping/mermaid-diagram/workflow.md +70 -0
  301. package/src/workflows/2-trigger-mapping/micro-instructions-mermaid-diagram.md +262 -0
  302. package/src/workflows/2-trigger-mapping/templates/feature-impact.template.md +47 -0
  303. package/src/workflows/2-trigger-mapping/templates/trigger-map.template.md +169 -0
  304. package/src/workflows/2-trigger-mapping/workflow.yaml +55 -0
  305. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/instructions.md +140 -0
  306. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-01-business-goals.md +124 -0
  307. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-02-target-groups.md +143 -0
  308. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-03-driving-forces.md +133 -0
  309. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-04-prioritization.md +130 -0
  310. package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-05-gap-analysis.md +141 -0
  311. package/src/workflows/2-trigger-mapping/workshops/1-business-goals/instructions.md +106 -0
  312. package/src/workflows/2-trigger-mapping/workshops/2-target-groups/instructions.md +106 -0
  313. package/src/workflows/2-trigger-mapping/workshops/3-driving-forces/instructions.md +130 -0
  314. package/src/workflows/2-trigger-mapping/workshops/4-prioritization/instructions.md +203 -0
  315. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/instructions.md +24 -0
  316. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-01-extract-features.md +52 -0
  317. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-02-confirm-assessment.md +41 -0
  318. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-03-make-assessment.md +84 -0
  319. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-04-generate-document.md +81 -0
  320. package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-05-wrap-up.md +55 -0
  321. package/src/workflows/3-prd-platform/handover/instructions.md +16 -0
  322. package/src/workflows/3-prd-platform/handover/steps/step-01-compile-deliverables.md +38 -0
  323. package/src/workflows/3-prd-platform/handover/steps/step-02-extract-epic-structure.md +30 -0
  324. package/src/workflows/3-prd-platform/handover/steps/step-03-prepare-prd-materials.md +31 -0
  325. package/src/workflows/3-prd-platform/handover/steps/step-04-create-handover-package.md +57 -0
  326. package/src/workflows/3-prd-platform/handover/steps/step-05-provide-activation.md +68 -0
  327. package/src/workflows/3-prd-platform/instructions.md +1161 -0
  328. package/src/workflows/3-prd-platform/templates/experimental-endpoints.template.md +221 -0
  329. package/src/workflows/3-prd-platform/templates/platform-architecture.template.md +159 -0
  330. package/src/workflows/3-prd-platform/templates/technical-constraints.template.md +191 -0
  331. package/src/workflows/3-prd-platform/workflow.yaml +39 -0
  332. package/src/workflows/4-ux-design/ARCHITECTURE.md +275 -0
  333. package/src/workflows/4-ux-design/COMPONENT-FILE-STRUCTURE.md +742 -0
  334. package/src/workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md +557 -0
  335. package/src/workflows/4-ux-design/CONTENT-PLACEMENT-GUIDE.md +552 -0
  336. package/src/workflows/4-ux-design/CROSS-PAGE-CONSISTENCY.md +301 -0
  337. package/src/workflows/4-ux-design/DOCUMENTATION-ARCHITECTURE.md +161 -0
  338. package/src/workflows/4-ux-design/HTML-VS-VISUAL-STYLES.md +243 -0
  339. package/src/workflows/4-ux-design/IMAGE-SKETCHING-BEST-PRACTICES.md +272 -0
  340. package/src/workflows/4-ux-design/PROACTIVE-TRANSLATION-WORKFLOW.md +447 -0
  341. package/src/workflows/4-ux-design/SKETCH-FIRST-IMPLEMENTATION-PLAN.md +617 -0
  342. package/src/workflows/4-ux-design/SKETCH-TEXT-ANALYSIS-GUIDE.md +532 -0
  343. package/src/workflows/4-ux-design/SKETCH-TEXT-QUICK-REFERENCE.md +222 -0
  344. package/src/workflows/4-ux-design/SKETCH-TEXT-STRATEGY.md +509 -0
  345. package/src/workflows/4-ux-design/STORYBOARD-INTEGRATION.md +714 -0
  346. package/src/workflows/4-ux-design/TRANSLATION-ORGANIZATION-GUIDE.md +513 -0
  347. package/src/workflows/4-ux-design/WDS-SPECIFICATION-PATTERN.md +436 -0
  348. package/src/workflows/4-ux-design/agentic-development/guides/AGENTIC-DEVELOPMENT-GUIDE.md +380 -0
  349. package/src/workflows/4-ux-design/agentic-development/guides/CREATION-GUIDE.md +1148 -0
  350. package/src/workflows/4-ux-design/agentic-development/guides/FILE-INDEX.md +212 -0
  351. package/src/workflows/4-ux-design/agentic-development/guides/PROTOTYPE-ANALYSIS.md +832 -0
  352. package/src/workflows/4-ux-design/agentic-development/guides/PROTOTYPE-INITIATION-DIALOG.md +409 -0
  353. package/src/workflows/4-ux-design/agentic-development/steps-c/1-prototype-setup.md +95 -0
  354. package/src/workflows/4-ux-design/agentic-development/steps-c/2-scenario-analysis.md +174 -0
  355. package/src/workflows/4-ux-design/agentic-development/steps-c/3-logical-view-breakdown.md +197 -0
  356. package/src/workflows/4-ux-design/agentic-development/steps-c/4a-announce-and-gather.md +69 -0
  357. package/src/workflows/4-ux-design/agentic-development/steps-c/4b-create-story-file.md +144 -0
  358. package/src/workflows/4-ux-design/agentic-development/steps-c/4c-implement-section.md +113 -0
  359. package/src/workflows/4-ux-design/agentic-development/steps-c/4d-present-for-testing.md +68 -0
  360. package/src/workflows/4-ux-design/agentic-development/steps-c/4e-handle-issue.md +85 -0
  361. package/src/workflows/4-ux-design/agentic-development/steps-c/4f-handle-improvement.md +104 -0
  362. package/src/workflows/4-ux-design/agentic-development/steps-c/4g-section-approved.md +146 -0
  363. package/src/workflows/4-ux-design/agentic-development/steps-c/5-finalization.md +158 -0
  364. package/src/workflows/4-ux-design/agentic-development/templates/PROTOTYPE-ROADMAP-template.md +382 -0
  365. package/src/workflows/4-ux-design/agentic-development/templates/components/DEV-MODE-GUIDE.md +189 -0
  366. package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.css +164 -0
  367. package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.html +18 -0
  368. package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.js +430 -0
  369. package/src/workflows/4-ux-design/agentic-development/templates/demo-data-template.json +63 -0
  370. package/src/workflows/4-ux-design/agentic-development/templates/page-template.html +465 -0
  371. package/src/workflows/4-ux-design/agentic-development/templates/story-file-template.md +167 -0
  372. package/src/workflows/4-ux-design/agentic-development/templates/work-file-template.yaml +264 -0
  373. package/src/workflows/4-ux-design/agentic-development/validation-report-agentic-development.md +251 -0
  374. package/src/workflows/4-ux-design/agentic-development/workflow.md +631 -0
  375. package/src/workflows/4-ux-design/excalidraw-integration/guides/ai-collaboration.md +565 -0
  376. package/src/workflows/4-ux-design/excalidraw-integration/guides/excalidraw-guide.md +320 -0
  377. package/src/workflows/4-ux-design/excalidraw-integration/guides/excalidraw-setup.md +529 -0
  378. package/src/workflows/4-ux-design/excalidraw-integration/guides/export-workflow.md +563 -0
  379. package/src/workflows/4-ux-design/excalidraw-integration/guides/sketching-guide.md +693 -0
  380. package/src/workflows/4-ux-design/excalidraw-integration/validation-report-excalidraw-integration.md +208 -0
  381. package/src/workflows/4-ux-design/excalidraw-integration/workflow.md +226 -0
  382. package/src/workflows/4-ux-design/handover/instructions.md +15 -0
  383. package/src/workflows/4-ux-design/handover/steps/step-01-analyze-scenarios.md +32 -0
  384. package/src/workflows/4-ux-design/handover/steps/step-01-identify-delivery-scope.md +61 -0
  385. package/src/workflows/4-ux-design/handover/steps/step-02-create-summary.md +59 -0
  386. package/src/workflows/4-ux-design/handover/steps/step-02-extract-technical-needs.md +33 -0
  387. package/src/workflows/4-ux-design/handover/steps/step-03-create-delivery-package.md +79 -0
  388. package/src/workflows/4-ux-design/handover/steps/step-03-provide-activation.md +47 -0
  389. package/src/workflows/4-ux-design/handover/steps/step-04-log-delivery.md +41 -0
  390. package/src/workflows/4-ux-design/handover/steps/step-05-provide-activation.md +75 -0
  391. package/src/workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md +71 -0
  392. package/src/workflows/4-ux-design/modular-architecture/00-foundation/agent-designer-collaboration.md +488 -0
  393. package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/complexity-detection.md +123 -0
  394. package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/content-placement-rules.md +144 -0
  395. package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/three-tier-overview.md +144 -0
  396. package/src/workflows/4-ux-design/modular-architecture/02-workflows/01-what-are-storyboards.md +70 -0
  397. package/src/workflows/4-ux-design/modular-architecture/02-workflows/01-when-to-use.md +68 -0
  398. package/src/workflows/4-ux-design/modular-architecture/02-workflows/02-file-structure.md +86 -0
  399. package/src/workflows/4-ux-design/modular-architecture/02-workflows/complexity-router-workflow.md +155 -0
  400. package/src/workflows/4-ux-design/modular-architecture/02-workflows/page-specification-workflow.md +312 -0
  401. package/src/workflows/4-ux-design/modular-architecture/02-workflows/storyboards-guide.md +75 -0
  402. package/src/workflows/4-ux-design/modular-architecture/03-quick-refs/benefits.md +128 -0
  403. package/src/workflows/4-ux-design/modular-architecture/03-quick-refs/decision-tree.md +67 -0
  404. package/src/workflows/4-ux-design/modular-architecture/validation-report-modular-architecture.md +220 -0
  405. package/src/workflows/4-ux-design/modular-architecture/workflow.md +289 -0
  406. package/src/workflows/4-ux-design/object-types/COMPLEXITY-ROUTER.md +842 -0
  407. package/src/workflows/4-ux-design/object-types/ROUTER-FLOW-DIAGRAM.md +275 -0
  408. package/src/workflows/4-ux-design/object-types/TEXT-DETECTION-PRIORITY.md +391 -0
  409. package/src/workflows/4-ux-design/object-types/object-router.md +349 -0
  410. package/src/workflows/4-ux-design/object-types/templates/button.md +345 -0
  411. package/src/workflows/4-ux-design/object-types/templates/heading-text.md +549 -0
  412. package/src/workflows/4-ux-design/object-types/templates/image.md +165 -0
  413. package/src/workflows/4-ux-design/object-types/templates/link.md +167 -0
  414. package/src/workflows/4-ux-design/object-types/templates/text-input.md +463 -0
  415. package/src/workflows/4-ux-design/object-types/validation-report-object-types.md +295 -0
  416. package/src/workflows/4-ux-design/object-types/workflow.md +439 -0
  417. package/src/workflows/4-ux-design/page-specification-quality/data/validation-standards.md +215 -0
  418. package/src/workflows/4-ux-design/page-specification-quality/instructions.md +32 -0
  419. package/src/workflows/4-ux-design/page-specification-quality/quality-guide.md +653 -0
  420. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-01-page-metadata.md +55 -0
  421. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-02-navigation.md +54 -0
  422. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-03-page-overview.md +47 -0
  423. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-04-page-sections.md +58 -0
  424. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-05-section-order.md +59 -0
  425. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-06-object-registry.md +52 -0
  426. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-07-design-system-separation.md +64 -0
  427. package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-08-final-validation.md +92 -0
  428. package/src/workflows/4-ux-design/page-specification-quality/templates/diagnostic-report-template.md +227 -0
  429. package/src/workflows/4-ux-design/page-specification-quality/validation-report-page-specification-quality.md +357 -0
  430. package/src/workflows/4-ux-design/page-specification-quality/workflow.md +146 -0
  431. package/src/workflows/4-ux-design/scenario-init/SCENARIO-INIT-DIALOG.md +538 -0
  432. package/src/workflows/4-ux-design/scenario-init/SCENARIO-INIT-PROCESS.md +221 -0
  433. package/src/workflows/4-ux-design/scenario-init/steps-c/00-SCENARIO-INIT-GUIDE.md +76 -0
  434. package/src/workflows/4-ux-design/scenario-init/steps-c/01-platform-confirmation.md +167 -0
  435. package/src/workflows/4-ux-design/scenario-init/steps-c/02-feature-selection.md +70 -0
  436. package/src/workflows/4-ux-design/scenario-init/steps-c/03-entry-point.md +67 -0
  437. package/src/workflows/4-ux-design/scenario-init/steps-c/04-mental-state.md +74 -0
  438. package/src/workflows/4-ux-design/scenario-init/steps-c/05-mutual-success.md +69 -0
  439. package/src/workflows/4-ux-design/scenario-init/steps-c/06-shortest-path.md +92 -0
  440. package/src/workflows/4-ux-design/scenario-init/steps-c/07-create-vtc.md +132 -0
  441. package/src/workflows/4-ux-design/scenario-init/steps-c/examples/booking-example.md +64 -0
  442. package/src/workflows/4-ux-design/scenario-init/steps-c/examples/ecommerce-example.md +64 -0
  443. package/src/workflows/4-ux-design/scenario-init/steps-c/examples/saas-example.md +64 -0
  444. package/src/workflows/4-ux-design/scenario-init/validation-report-scenario-init.md +290 -0
  445. package/src/workflows/4-ux-design/scenario-init/workflow.md +117 -0
  446. package/src/workflows/4-ux-design/specification-audit-workflow.md +697 -0
  447. package/src/workflows/4-ux-design/steps/step-01-init.md +116 -0
  448. package/src/workflows/4-ux-design/steps/step-02-setup-scenario-structure.md +67 -0
  449. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/page-init-lightweight.md +355 -0
  450. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-01-page-context.md +61 -0
  451. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-02-page-name.md +26 -0
  452. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-03-page-purpose.md +25 -0
  453. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-04-entry-point.md +27 -0
  454. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-05-mental-state.md +22 -0
  455. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-06-desired-outcome.md +22 -0
  456. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-07-variants.md +29 -0
  457. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-08-create-page-structure.md +141 -0
  458. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-c-placeholder-pages.md +406 -0
  459. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-page-creation.md +578 -0
  460. package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-page-process.md +333 -0
  461. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-01-core-feature.md +26 -0
  462. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-02-entry-point.md +26 -0
  463. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-03-mental-state.md +24 -0
  464. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-04-mutual-success.md +27 -0
  465. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-05-shortest-path.md +39 -0
  466. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-06-scenario-name.md +24 -0
  467. package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-07-create-scenario-folder.md +145 -0
  468. package/src/workflows/4-ux-design/steps/step-02-substeps/substeps-guide.md +110 -0
  469. package/src/workflows/4-ux-design/steps/step-03-design-page.md +189 -0
  470. package/src/workflows/4-ux-design/steps/step-04-complete-scenario.md +59 -0
  471. package/src/workflows/4-ux-design/steps/step-05-next-steps.md +76 -0
  472. package/src/workflows/4-ux-design/stitch-generation/stitch-prompt.template.md +174 -0
  473. package/src/workflows/4-ux-design/stitch-generation/workflow.md +288 -0
  474. package/src/workflows/4-ux-design/substeps/4a-exploration.md +106 -0
  475. package/src/workflows/4-ux-design/substeps/4b-sketch-analysis.md +536 -0
  476. package/src/workflows/4-ux-design/substeps/4c-01-page-basics.md +59 -0
  477. package/src/workflows/4-ux-design/substeps/4c-02-layout-sections.md +66 -0
  478. package/src/workflows/4-ux-design/substeps/4c-03-components-objects.md +154 -0
  479. package/src/workflows/4-ux-design/substeps/4c-04-content-languages.md +83 -0
  480. package/src/workflows/4-ux-design/substeps/4c-05-interactions.md +82 -0
  481. package/src/workflows/4-ux-design/substeps/4c-06-states.md +125 -0
  482. package/src/workflows/4-ux-design/substeps/4c-07-validation.md +124 -0
  483. package/src/workflows/4-ux-design/substeps/4c-08-generate-spec.md +105 -0
  484. package/src/workflows/4-ux-design/substeps/4d-prototype.md +282 -0
  485. package/src/workflows/4-ux-design/substeps/4e-prd-update.md +139 -0
  486. package/src/workflows/4-ux-design/templates/audit-report.template.md +430 -0
  487. package/src/workflows/4-ux-design/templates/instructions/accessibility-audit.workflow.md +166 -0
  488. package/src/workflows/4-ux-design/templates/instructions/accessibility.instructions.md +102 -0
  489. package/src/workflows/4-ux-design/templates/instructions/data-api.instructions.md +69 -0
  490. package/src/workflows/4-ux-design/templates/instructions/form-validation.instructions.md +54 -0
  491. package/src/workflows/4-ux-design/templates/instructions/meta-content.instructions.md +37 -0
  492. package/src/workflows/4-ux-design/templates/instructions/open-questions.instructions.md +164 -0
  493. package/src/workflows/4-ux-design/templates/instructions/responsive.instructions.md +64 -0
  494. package/src/workflows/4-ux-design/templates/page-specification.template.md +227 -0
  495. package/src/workflows/4-ux-design/templates/scenario-overview.template.md +159 -0
  496. package/src/workflows/4-ux-design/templates/storyboard-specification.template.md +94 -0
  497. package/src/workflows/4-ux-design/ux-design-guide.md +223 -0
  498. package/src/workflows/4-ux-design/workflow-new.yaml +18 -0
  499. package/src/workflows/4-ux-design/workflow.md +61 -0
  500. package/src/workflows/4-ux-design/workflow.yaml +18 -0
  501. package/src/workflows/5-design-system/assessment/01-scan-existing.md +166 -0
  502. package/src/workflows/5-design-system/assessment/02-compare-attributes.md +287 -0
  503. package/src/workflows/5-design-system/assessment/03-calculate-similarity.md +357 -0
  504. package/src/workflows/5-design-system/assessment/04-identify-opportunities.md +339 -0
  505. package/src/workflows/5-design-system/assessment/05-identify-risks.md +357 -0
  506. package/src/workflows/5-design-system/assessment/06-present-decision.md +435 -0
  507. package/src/workflows/5-design-system/assessment/07-execute-decision.md +523 -0
  508. package/src/workflows/5-design-system/design-system-guide.md +353 -0
  509. package/src/workflows/5-design-system/design-system-router.md +370 -0
  510. package/src/workflows/5-design-system/figma-integration/INTEGRATION-SUMMARY.md +458 -0
  511. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-connection-check.md +118 -0
  512. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-01-plugin-installation.md +37 -0
  513. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-02-activate-plugin.md +37 -0
  514. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-03-verify-mcp.md +51 -0
  515. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-02-identify-export-type.md +161 -0
  516. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-prepare-specifications.md +138 -0
  517. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-01-analyze-code.md +62 -0
  518. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-02-generate-ids.md +69 -0
  519. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-03-create-spec.md +98 -0
  520. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-04-review-spec.md +86 -0
  521. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-04-generate-validate.md +207 -0
  522. package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-05-execute-export.md +229 -0
  523. package/src/workflows/5-design-system/figma-integration/code-to-figma/workflow.md +64 -0
  524. package/src/workflows/5-design-system/figma-integration/figma-to-code/README.md +0 -0
  525. package/src/workflows/5-design-system/figma-integration/figma-to-code/figma-integration-guide.md +37 -0
  526. package/src/workflows/5-design-system/figma-integration/reference/figma-designer-guide.md +687 -0
  527. package/src/workflows/5-design-system/figma-integration/reference/figma-mcp-integration.md +661 -0
  528. package/src/workflows/5-design-system/figma-integration/reference/mcp-server-integration.md +922 -0
  529. package/src/workflows/5-design-system/figma-integration/reference/prototype-to-figma-workflow.md +933 -0
  530. package/src/workflows/5-design-system/figma-integration/reference/tools-reference.md +665 -0
  531. package/src/workflows/5-design-system/figma-integration/reference/when-to-extract-decision-guide.md +663 -0
  532. package/src/workflows/5-design-system/operations/add-variant.md +490 -0
  533. package/src/workflows/5-design-system/operations/create-new-component.md +711 -0
  534. package/src/workflows/5-design-system/operations/generate-catalog.md +686 -0
  535. package/src/workflows/5-design-system/operations/initialize-design-system.md +467 -0
  536. package/src/workflows/5-design-system/operations/update-component.md +600 -0
  537. package/src/workflows/5-design-system/templates/catalog.template.html +363 -0
  538. package/src/workflows/5-design-system/templates/component-library-config.template.md +65 -0
  539. package/src/workflows/5-design-system/templates/component.template.md +134 -0
  540. package/src/workflows/5-design-system/templates/design-tokens.template.md +168 -0
  541. package/src/workflows/5-design-system/workflow.yaml +22 -0
  542. package/src/workflows/6-design-deliveries/design-deliveries-guide.md +489 -0
  543. package/src/workflows/6-design-deliveries/steps/step-6.1-detect-completion.md +131 -0
  544. package/src/workflows/6-design-deliveries/steps/step-6.2-create-delivery.md +156 -0
  545. package/src/workflows/6-design-deliveries/steps/step-6.2-create-delivery.md.bak +309 -0
  546. package/src/workflows/6-design-deliveries/steps/step-6.3-create-test-scenario.md +155 -0
  547. package/src/workflows/6-design-deliveries/steps/step-6.3-create-test-scenario.md.bak +432 -0
  548. package/src/workflows/6-design-deliveries/steps/step-6.4-handoff-dialog.md +441 -0
  549. package/src/workflows/6-design-deliveries/steps/step-6.5-hand-off.md +327 -0
  550. package/src/workflows/6-design-deliveries/steps/step-6.6-continue.md +414 -0
  551. package/src/workflows/6-design-deliveries/workflow.md +67 -0
  552. package/src/workflows/7-testing/steps/step-7.1-receive-notification.md +261 -0
  553. package/src/workflows/7-testing/steps/step-7.2-prepare-testing.md +399 -0
  554. package/src/workflows/7-testing/steps/step-7.3-run-tests.md +683 -0
  555. package/src/workflows/7-testing/steps/step-7.4-create-issues.md +517 -0
  556. package/src/workflows/7-testing/steps/step-7.5-create-report.md +441 -0
  557. package/src/workflows/7-testing/steps/step-7.6-send-to-bmad.md +392 -0
  558. package/src/workflows/7-testing/steps/step-7.7-iterate-or-approve.md +596 -0
  559. package/src/workflows/7-testing/testing-guide.md +613 -0
  560. package/src/workflows/7-testing/workflow.md +79 -0
  561. package/src/workflows/8-ongoing-development/existing-product-guide.md +929 -0
  562. package/src/workflows/8-ongoing-development/steps/step-8.1-identify-opportunity.md +497 -0
  563. package/src/workflows/8-ongoing-development/steps/step-8.2-gather-context.md +380 -0
  564. package/src/workflows/8-ongoing-development/steps/step-8.3-design-update.md +495 -0
  565. package/src/workflows/8-ongoing-development/steps/step-8.4-create-delivery.md +402 -0
  566. package/src/workflows/8-ongoing-development/steps/step-8.5-hand-off.md +163 -0
  567. package/src/workflows/8-ongoing-development/steps/step-8.6-validate.md +265 -0
  568. package/src/workflows/8-ongoing-development/steps/step-8.7-monitor.md +432 -0
  569. package/src/workflows/8-ongoing-development/steps/step-8.8-iterate.md +547 -0
  570. package/src/workflows/8-ongoing-development/workflow.md +302 -0
  571. package/src/workflows/9-agent-dialogs/steps/step-01-initialize-dialog.md +244 -0
  572. package/src/workflows/9-agent-dialogs/steps/step-02-analyze-scope.md +195 -0
  573. package/src/workflows/9-agent-dialogs/steps/step-03-create-steps.md +186 -0
  574. package/src/workflows/9-agent-dialogs/steps/step-04-execute-steps.md +250 -0
  575. package/src/workflows/9-agent-dialogs/steps/step-05-complete-dialog.md +177 -0
  576. package/src/workflows/9-agent-dialogs/templates/dialog-capture.template.md +75 -0
  577. package/src/workflows/9-agent-dialogs/templates/dialog-types/INDEX.md +142 -0
  578. package/src/workflows/9-agent-dialogs/templates/dialog-types/bug-fix.template.md +164 -0
  579. package/src/workflows/9-agent-dialogs/templates/dialog-types/design-exploration.template.md +180 -0
  580. package/src/workflows/9-agent-dialogs/templates/dialog-types/prototype-implementation.template.md +292 -0
  581. package/src/workflows/9-agent-dialogs/templates/dialog-types/stitch-generation.template.md +311 -0
  582. package/src/workflows/9-agent-dialogs/templates/dialog.template.md +200 -0
  583. package/src/workflows/9-agent-dialogs/templates/step.template.md +118 -0
  584. package/src/workflows/9-agent-dialogs/workflow.md +401 -0
  585. package/src/workflows/PROJECT-STRUCTURE-SYSTEM.md +226 -0
  586. package/src/workflows/VALIDATION-SUMMARY-REPORT.md +329 -0
  587. package/src/workflows/paths/design-system-only.yaml +62 -0
  588. package/src/workflows/paths/digital-strategy.yaml +39 -0
  589. package/src/workflows/paths/feature-enhancement.yaml +93 -0
  590. package/src/workflows/paths/full-product.yaml +96 -0
  591. package/src/workflows/paths/landing-page.yaml +54 -0
  592. package/src/workflows/paths/quick-prototype.yaml +39 -0
  593. package/src/workflows/project-analysis/AGENT-INITIATION-FLOW.md +295 -0
  594. package/src/workflows/project-analysis/LINK-VERIFICATION.md +179 -0
  595. package/src/workflows/project-analysis/ROUTER-ARCHITECTURE.md +224 -0
  596. package/src/workflows/project-analysis/SYSTEM-GUIDE.md +105 -0
  597. package/src/workflows/project-analysis/agent-domains/freya-domain.md +144 -0
  598. package/src/workflows/project-analysis/agent-domains/idunn-domain.md +112 -0
  599. package/src/workflows/project-analysis/agent-domains/saga-domain.md +132 -0
  600. package/src/workflows/project-analysis/agent-handoff-guide.md +233 -0
  601. package/src/workflows/project-analysis/analysis-types/empty-project-response.md +141 -0
  602. package/src/workflows/project-analysis/analysis-types/folder-based-analysis.md +135 -0
  603. package/src/workflows/project-analysis/analysis-types/new-project-response.md +194 -0
  604. package/src/workflows/project-analysis/analysis-types/outline-based-analysis.md +207 -0
  605. package/src/workflows/project-analysis/analysis-types/unknown-structure-response.md +216 -0
  606. package/src/workflows/project-analysis/context-aware-activation.md +99 -0
  607. package/src/workflows/project-analysis/conversation-persistence/check-conversations.md +162 -0
  608. package/src/workflows/project-analysis/conversation-persistence/conversation-template.md +70 -0
  609. package/src/workflows/project-analysis/conversation-persistence/persistence-guide.md +81 -0
  610. package/src/workflows/project-analysis/conversation-persistence/save-conversation.md +146 -0
  611. package/src/workflows/project-analysis/instructions.md +30 -0
  612. package/src/workflows/project-analysis/project-analysis-router.md +76 -0
  613. package/src/workflows/project-analysis/task-reflection.md +303 -0
  614. package/src/workflows/project-analysis/validation/deep-validation-before-work.md +235 -0
  615. package/src/workflows/project-analysis/work-types/strategy-work.md +88 -0
  616. package/src/workflows/project-analysis/workflow.yaml +82 -0
  617. package/src/workflows/shared/content-creation-workshop/content-creation-workshop-guide.md +320 -0
  618. package/src/workflows/shared/content-creation-workshop/content-output.template.md +349 -0
  619. package/src/workflows/shared/content-creation-workshop/steps-c/OPTIMIZATION-COMPLETE.md +143 -0
  620. package/src/workflows/shared/content-creation-workshop/steps-c/step-00-define-purpose.md +196 -0
  621. package/src/workflows/shared/content-creation-workshop/steps-c/step-01-load-vtc-context.md +126 -0
  622. package/src/workflows/shared/content-creation-workshop/steps-c/step-02-awareness-strategy.md +245 -0
  623. package/src/workflows/shared/content-creation-workshop/steps-c/step-03-action-filter.md +230 -0
  624. package/src/workflows/shared/content-creation-workshop/steps-c/step-04-empowerment-frame.md +248 -0
  625. package/src/workflows/shared/content-creation-workshop/steps-c/step-05-structural-order.md +227 -0
  626. package/src/workflows/shared/content-creation-workshop/steps-c/step-06-generate-content.md +247 -0
  627. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/00-purpose-examples.md +131 -0
  628. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/03-action-filter-example.md +97 -0
  629. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-badass-users-principles.md +159 -0
  630. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-example-empowerment-frame.md +88 -0
  631. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-example-golden-circle.md +96 -0
  632. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-golden-circle-guide.md +160 -0
  633. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-example-hairdresser-newsletter.md +136 -0
  634. package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-generation-instructions.md +95 -0
  635. package/src/workflows/shared/content-creation-workshop/steps-c/workflow.md +41 -0
  636. package/src/workflows/shared/content-creation-workshop/validation-report-content-creation-workshop.md +303 -0
  637. package/src/workflows/shared/content-creation-workshop/workflow.md +87 -0
  638. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-01-define-business-goal.md +115 -0
  639. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-02-identify-solution.md +105 -0
  640. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-03-describe-user.md +131 -0
  641. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-04-positive-driving-forces.md +150 -0
  642. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-05-negative-driving-forces.md +190 -0
  643. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-06-customer-awareness.md +256 -0
  644. package/src/workflows/shared/vtc-workshop/creation-steps-c/step-07-review-and-save.md +233 -0
  645. package/src/workflows/shared/vtc-workshop/creation-steps-c/workflow.md +43 -0
  646. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-01-load-trigger-map.md +81 -0
  647. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-02-select-business-goal.md +84 -0
  648. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-03-select-user.md +88 -0
  649. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-04-select-driving-forces.md +100 -0
  650. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-05-define-solution.md +59 -0
  651. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-06-customer-awareness.md +75 -0
  652. package/src/workflows/shared/vtc-workshop/selection-steps-c/step-07-review-and-save.md +151 -0
  653. package/src/workflows/shared/vtc-workshop/selection-steps-c/workflow.md +48 -0
  654. package/src/workflows/shared/vtc-workshop/validation-report-vtc-workshop.md +269 -0
  655. package/src/workflows/shared/vtc-workshop/vtc-creation-workshop.md +457 -0
  656. package/src/workflows/shared/vtc-workshop/vtc-selection-workshop.md +557 -0
  657. package/src/workflows/shared/vtc-workshop/vtc-template.yaml +210 -0
  658. package/src/workflows/shared/vtc-workshop/vtc-workshop-guide.md +418 -0
  659. package/src/workflows/shared/vtc-workshop/vtc-workshop-router.md +146 -0
  660. package/src/workflows/shared/vtc-workshop/workflow.md +174 -0
  661. package/src/workflows/workflow-init/COMPLETE-SYSTEM-SUMMARY.md +314 -0
  662. package/src/workflows/workflow-init/FINAL-SYSTEM-SUMMARY.md +321 -0
  663. package/src/workflows/workflow-init/PROJECT-OUTLINE-SYSTEM.md +240 -0
  664. package/src/workflows/workflow-init/excalidraw-setup-prompt.md +365 -0
  665. package/src/workflows/workflow-init/instructions.md +22 -0
  666. package/src/workflows/workflow-init/methodology-instructions/custom-methodology-template.md +299 -0
  667. package/src/workflows/workflow-init/methodology-instructions/methodology-guide.md +252 -0
  668. package/src/workflows/workflow-init/methodology-instructions/wds-v6-instructions.md +221 -0
  669. package/src/workflows/workflow-init/methodology-instructions/wps2c-v4-instructions.md +231 -0
  670. package/src/workflows/workflow-init/project-config.template.yaml +87 -0
  671. package/src/workflows/workflow-init/project-initiation-conversation.md +957 -0
  672. package/src/workflows/workflow-init/project-outline.template.yaml +429 -0
  673. package/src/workflows/workflow-init/project-type-selection.md +318 -0
  674. package/src/workflows/workflow-init/steps/step-02-project-structure.md +54 -0
  675. package/src/workflows/workflow-init/steps/step-03-delivery-config.md +76 -0
  676. package/src/workflows/workflow-init/steps/step-04-phases-selection.md +180 -0
  677. package/src/workflows/workflow-init/workflow.yaml +32 -0
  678. package/src/workflows/workflow-status/instructions.md +143 -0
  679. package/src/workflows/workflow-status/workflow.yaml +25 -0
  680. package/tools/cli/commands/install.js +34 -0
  681. package/tools/cli/lib/compiler.js +407 -0
  682. package/tools/cli/lib/ide-configs.js +104 -0
  683. package/tools/cli/lib/installer.js +257 -0
  684. package/tools/cli/lib/ui.js +127 -0
  685. package/tools/cli/wds-cli.js +43 -0
  686. package/tools/wds-npx-wrapper.js +37 -0
@@ -0,0 +1,474 @@
1
+ # Value Trigger Chain (VTC)
2
+
3
+ **A lightweight strategic framework for connecting business goals to user psychology**
4
+
5
+ ---
6
+
7
+ ## What It Is
8
+
9
+ A **Value Trigger Chain (VTC)** is the minimum viable strategic context for creating purposeful design. It's a selected path through your strategic landscape that shows:
10
+
11
+ - **Business Goal** - What success looks like for the organization
12
+ - **Solution** - The specific thing being built to achieve that goal
13
+ - **User** - Who will use this solution
14
+ - **Driving Forces** - What motivates that user (wishes and fears)
15
+ - **Customer Awareness** - Where the user starts and where we want to move them
16
+
17
+ **Why VTC Matters:**
18
+
19
+ Without explicit strategic understanding of the business behind a digital product and the reasons why a user might wish to benefit from using it, design decisions become mere guess work ("I like this") rather than purposeful ("This serves our business goal by triggering the user's wish to X"). While you *can* design without a VTC, you risk:
20
+ - Creating beautiful but ineffective solutions
21
+ - Making decisions based on personal preference rather than user psychology
22
+ - Missing opportunities to align design with business goals
23
+ - Difficulty explaining or defending design choices
24
+ - Lower conversion rates and user satisfaction
25
+
26
+ **What VTC Provides:**
27
+
28
+ A VTC is a heuristic - a quick strategic shortcut. True strategic grounding requires business analysis, user research, and ideally a full Trigger Map with prioritization. However, as a rapid way to establish rough direction, VTC is remarkably effective:
29
+ - Disqualifies catastrophic ideas early ("This doesn't serve any user driving force")
30
+ - Gets discussions moving in a productive direction
31
+ - Provides enough context for meaningful design decisions
32
+ - Far better than no strategic grounding at all
33
+ - Can evolve into a full Trigger Map when project scope warrants it
34
+
35
+ Think of it as strategic scaffolding: sufficient to build on, but not the complete architectural blueprint.
36
+
37
+ **Structure:**
38
+
39
+ ```
40
+ Business Goal → Solution → User → Driving Forces → Customer Awareness Progression
41
+ ```
42
+
43
+ **Example:**
44
+
45
+ | Business Goal | Solution | User | Driving Forces | Customer Awareness |
46
+ |--------------|----------|------|----------------|--------------------|
47
+ | 500 newsletter signups | Landing page with trend insights | Harriet (hairdresser, ambitious, small town) | • Wish to be local beauty authority<br>• Fear of missing industry trends | Problem Aware → Product Aware |
48
+
49
+ ---
50
+
51
+ ## Why It Matters
52
+
53
+ ### The Problem Without VTC
54
+
55
+ Designers often create without strategic grounding:
56
+ - Content lacks purpose
57
+ - Messaging feels generic
58
+ - Design decisions are subjective ("I like this color")
59
+ - No clear success criteria
60
+ - Hard to prioritize features or content
61
+
62
+ ### The Solution With VTC
63
+
64
+ Every design decision has strategic context:
65
+ - Content targets specific driving forces
66
+ - Messaging addresses user psychology
67
+ - Design serves measurable goals
68
+ - Clear prioritization based on VTC impact
69
+ - Objective evaluation of design effectiveness
70
+
71
+ **The core insight:** Value is TRIGGERED when a user's driving forces are TRIGGERED. The VTC makes this triggering intentional rather than accidental.
72
+
73
+ ---
74
+
75
+ ## How It's Valuable in Strategic Design
76
+
77
+ ### 1. **Prioritization**
78
+ When you have multiple design options, ask: "Which best serves our VTC?" Clear answer emerges.
79
+
80
+ ### 2. **Content Creation**
81
+ Every piece of content can reference its VTC to ensure strategic alignment and emotional resonance.
82
+
83
+ ### 3. **Stakeholder Alignment**
84
+ VTCs create shared understanding. Everyone knows WHY we're building WHAT for WHOM.
85
+
86
+ ### 4. **Measurement**
87
+ Each VTC element is measurable:
88
+ - Business Goal: Quantifiable metric
89
+ - User: Identifiable segment
90
+ - Driving Forces: Observable behaviors
91
+ - Customer Awareness: Progression tracking
92
+
93
+ ### 5. **Scalability**
94
+ - 1 VTC: Quick prototype
95
+ - 3 VTCs: Focused product
96
+ - 10+ VTCs: Complex platform with multiple user types
97
+
98
+ Start small, scale strategically.
99
+
100
+ ---
101
+
102
+ ## Derived From
103
+
104
+ The VTC method derives from **Effect Management** (inUse, Sweden) and **Impact Mapping** (Gojko Adzic), which pioneered the concept of visually connecting business goals to user behaviors.
105
+
106
+ VTC is Whiteport's lightweight adaptation, adding:
107
+ - **Customer Awareness positioning** (from Eugene Schwartz)
108
+ - **Negative driving forces** (fears and frustrations)
109
+ - **Standalone usability** (can exist without full Trigger Map)
110
+
111
+ **Related Whiteport Methods:**
112
+ - [Trigger Mapping Guide](./phase-2-trigger-mapping-guide.md) - Comprehensive version containing multiple VTCs
113
+ - [Scenario Definition](./phase-4-ux-design-guide.md) - VTCs anchor each scenario
114
+
115
+ **Foundational Models:**
116
+ - [Customer Awareness Cycle](../models/customer-awareness-cycle.md) - Eugene Schwartz (positioning users)
117
+ - [Impact Mapping](../models/impact-effect-mapping.md) - Gojko Adzic (strategic connections)
118
+
119
+ ---
120
+
121
+ ## When to Use VTC
122
+
123
+ ### Use Direct VTC When:
124
+ - **Timeline:** < 2 weeks
125
+ - **Scope:** 1-3 key flows, prototype, MVP
126
+ - **Users:** Single primary user type
127
+ - **Budget:** < $10k
128
+ - **Goal:** Quick strategic grounding without extensive mapping
129
+
130
+ ### Use Full Trigger Map (Contains Many VTCs) When:
131
+ - **Timeline:** > 1 month
132
+ - **Scope:** Complex product, many scenarios
133
+ - **Users:** Multiple distinct user types
134
+ - **Budget:** > $25k
135
+ - **Goal:** Long-term strategic foundation
136
+
137
+ **The relationship:** Trigger Map = Multiple VTCs + Relationships + Prioritization
138
+
139
+ ---
140
+
141
+ ## How to Create a VTC
142
+
143
+ ### Step 1: Define Business Goal (5 minutes)
144
+
145
+ What does success look like? Be specific and measurable.
146
+
147
+ **Good:** "500 newsletter signups in Q1"
148
+ **Bad:** "More engagement"
149
+
150
+ ### Step 2: Identify Solution (2 minutes)
151
+
152
+ What are you building to achieve this goal?
153
+
154
+ **Examples:**
155
+ - Landing page with lead magnet
156
+ - Onboarding flow
157
+ - Feature upgrade prompt
158
+ - Email campaign + dashboard
159
+
160
+ ### Step 3: Describe User (5 minutes)
161
+
162
+ Who will use this solution? Go beyond demographics to psychology.
163
+
164
+ **Template:**
165
+ ```
166
+ [Name] ([role], [key traits])
167
+ - Context: [when/where they encounter solution]
168
+ - Current state: [what they're trying to accomplish]
169
+ ```
170
+
171
+ **Example:**
172
+ ```
173
+ Harriet (hairdresser, ambitious, small-town)
174
+ - Context: Late evening, researching industry trends
175
+ - Current state: Wants to stay ahead of competitors
176
+ ```
177
+
178
+ ### Step 4: Identify Driving Forces (10 minutes)
179
+
180
+ What motivates this user? Include both wishes (positive) and fears (negative).
181
+
182
+ **Wishes (Positive Driving Forces):**
183
+ - What do they want to achieve?
184
+ - What would make them feel successful?
185
+ - What aspirations drive their actions?
186
+
187
+ **Fears (Negative Driving Forces):**
188
+ - What do they want to avoid?
189
+ - What keeps them up at night?
190
+ - What would feel like failure?
191
+
192
+ **Example:**
193
+ - ✅ Wish to be local beauty authority
194
+ - ❌ Fear of missing industry trends
195
+ - ✅ Wish to attract premium clients
196
+ - ❌ Fear of being seen as outdated
197
+
198
+ **Pro tip:** Positive and negative are often two sides of the same coin. Include both for fuller picture.
199
+
200
+ ### Step 5: Position Customer Awareness (5 minutes)
201
+
202
+ Where is this user NOW in their awareness journey? Where do we want to move them?
203
+
204
+ **Customer Awareness Stages:**
205
+ 1. **Unaware** - Doesn't know problem exists
206
+ 2. **Problem Aware** - Knows problem, doesn't know solutions
207
+ 3. **Solution Aware** - Knows solutions exist, doesn't know yours
208
+ 4. **Product Aware** - Knows your solution exists
209
+ 5. **Most Aware** - Has used, loved, and advocates for your solution
210
+
211
+ **VTC Format:** `[Start] → [End]`
212
+
213
+ **Examples:**
214
+ - "Problem Aware → Solution Aware" (introducing new approach)
215
+ - "Product Aware → Most Aware" (onboarding flow)
216
+ - "Unaware → Problem Aware" (educational content)
217
+
218
+ ### Step 6: Document & Validate (3 minutes)
219
+
220
+ Write your VTC in table format:
221
+
222
+ | Business Goal | Solution | User | Driving Forces | Customer Awareness |
223
+ |--------------|----------|------|----------------|--------------------|
224
+ | [goal] | [solution] | [user description] | • [positive force]<br>• [negative force]<br>• [another force] | [start] → [end] |
225
+
226
+ **Validation Questions:**
227
+ 1. Is the business goal measurable?
228
+ 2. Does the solution serve both the goal AND the user?
229
+ 3. Are driving forces specific enough to inform design?
230
+ 4. Does the customer awareness progression make sense for this solution?
231
+ 5. Can we design/write content differently based on this VTC?
232
+
233
+ If you answered "no" to any question, refine that element.
234
+
235
+ ---
236
+
237
+ ## Using VTCs in Your Design Process
238
+
239
+ ### In Project Pitch
240
+ - Define 1 simplified VTC to communicate strategic vision
241
+ - Helps stakeholders understand WHO, WHY, and HOW
242
+
243
+ ### In Scenario Definition
244
+ - Assign primary VTC to each scenario
245
+ - All pages in scenario inherit this VTC by default
246
+ - Optional: Define secondary VTCs for specific page sections
247
+
248
+ ### In Content Creation
249
+ - Before writing any content, identify applicable VTC
250
+ - Generate content that triggers the driving forces
251
+ - Move user along customer awareness spectrum
252
+ - Explain reasoning: "This content serves VTC-01 by..."
253
+
254
+ ### In Component Specifications
255
+ - Microcopy references VTC
256
+ - Error messages address fears (negative driving forces)
257
+ - Success states celebrate wishes (positive driving forces)
258
+
259
+ ### In Design Deliveries
260
+ - Show which VTC each flow serves
261
+ - Helps developers understand strategic intent
262
+ - Informs prioritization decisions
263
+
264
+ ### In Testing
265
+ - Validate: Did we trigger the driving forces?
266
+ - Measure: Did user progress in customer awareness?
267
+ - Test: Does design serve the business goal?
268
+
269
+ ---
270
+
271
+ ## Imaginary Examples
272
+
273
+ ### Example 1: SaaS Onboarding
274
+
275
+ **VTC:**
276
+
277
+ | Business Goal | Solution | User | Driving Forces | Customer Awareness |
278
+ |--------------|----------|------|----------------|--------------------|
279
+ | 60% activation rate | Interactive onboarding flow | Sarah (marketing manager, stretched thin) | • Wish to prove ROI to boss<br>• Fear of wasting time on complex tools | Product Aware → Most Aware |
280
+
281
+ **Design Implications:**
282
+ - Show ROI immediately (addresses "prove ROI" wish)
283
+ - Make first value moment < 2 minutes (addresses "fear of wasting time")
284
+ - Progress indicators show "almost done" (reduces anxiety)
285
+ - Success state: "You're ready to show your team"
286
+
287
+ ### Example 2: E-commerce Product Page
288
+
289
+ **VTC:**
290
+
291
+ | Business Goal | Solution | User | Driving Forces | Customer Awareness |
292
+ |--------------|----------|------|----------------|--------------------|
293
+ | 15% conversion rate | Product page with social proof | James (first-time buyer, cautious) | • Wish to make smart purchase<br>• Fear of buying wrong product | Solution Aware → Product Aware |
294
+
295
+ **Design Implications:**
296
+ - Detailed specs (addresses "smart purchase" wish)
297
+ - Return policy prominent (reduces "wrong product" fear)
298
+ - Customer reviews front and center (social proof reduces risk)
299
+ - Comparison table (helps make informed decision)
300
+
301
+ ### Example 3: Newsletter Signup (Context-Specific Goals)
302
+
303
+ **VTC:**
304
+
305
+ | Business Goal | Solution | User | Driving Forces | Customer Awareness |
306
+ |--------------|----------|------|----------------|--------------------|
307
+ | 500 signups | Landing page with trend insights | Harriet (hairdresser, ambitious, small-town) | • Wish to be local beauty authority<br>• Fear of missing industry trends | Problem Aware → Product Aware |
308
+
309
+ **Understanding Context:**
310
+
311
+ Harriet has many life goals (parent, business owner, friend), but in the context of **discovering a beauty trends newsletter**, only her professional goals are active:
312
+
313
+ *Active in this context:*
314
+ - Professional status and influence
315
+ - Staying current with industry
316
+ - Competitive advantage locally
317
+
318
+ *Not active in this context:*
319
+ - Her parenting goals
320
+ - Her financial planning
321
+ - Her social life
322
+
323
+ **Design Implications:**
324
+ - Headline: "Never Miss a Trend" (addresses fear directly in THIS context)
325
+ - Subhead: "Become Your Town's Beauty Authority" (speaks to wish in THIS situation)
326
+ - Lead magnet: "This Week's Top 5 Trends" (immediate professional value)
327
+ - Testimonial: "My clients always ask how I stay so current!"
328
+
329
+ **Why Context Matters:**
330
+
331
+ The same landing page wouldn't mention:
332
+ - "Balance work and family" (different context)
333
+ - "Manage salon finances" (different usage situation)
334
+ - "Plan your social calendar" (different need)
335
+
336
+ VTCs focus on the **active goals in the specific usage situation**.
337
+
338
+ ---
339
+
340
+ ## Real Applications
341
+
342
+ ### WDS Presentation Project
343
+
344
+ The WDS Presentation landing page uses VTCs to guide content creation and design decisions.
345
+
346
+ **See:** [WDS Presentation Example](../examples/WDS-Presentation/)
347
+
348
+ **VTCs Defined:**
349
+ - Stina the Strategist (designer wanting better tools)
350
+ - Lars the Leader (executive wanting team efficiency)
351
+ - Felix the Full-Stack (developer wanting clearer specs)
352
+
353
+ Each section of the page targets specific driving forces from these VTCs, demonstrating how strategic grounding shapes content and design.
354
+
355
+ **Explore:**
356
+ - [Product Brief](../examples/WDS-Presentation/docs/1-project-brief/01-product-brief.md) - Shows business goals and positioning
357
+ - [Trigger Map](../examples/WDS-Presentation/docs/2-trigger-map/00-trigger-map.md) - Contains all VTCs for the project
358
+ - [Personas](../examples/WDS-Presentation/docs/2-trigger-map/) - Detailed user profiles with driving forces
359
+
360
+ ---
361
+
362
+ ## VTC in Different Contexts
363
+
364
+ ### Lightweight VTC (Direct Definition)
365
+
366
+ **When:** Quick projects, prototypes, single-feature work
367
+
368
+ **Process:**
369
+ 1. 30-minute VTC workshop
370
+ 2. Define 1-3 VTCs directly
371
+ 3. Use VTCs to guide design
372
+ 4. No full Trigger Map needed
373
+
374
+ **Output:** Simple table or YAML file with VTCs
375
+
376
+ ### VTC from Trigger Map (Extracted)
377
+
378
+ **When:** Complex projects with multiple user types
379
+
380
+ **Process:**
381
+ 1. Create full Trigger Map (1-2 days)
382
+ 2. Extract VTCs from map for each scenario
383
+ 3. VTCs reference back to richer context
384
+ 4. Update map as project evolves
385
+
386
+ **Output:** VTCs with deep context and relationships
387
+
388
+ ### The Spectrum
389
+
390
+ ```
391
+ Quick (1 day) Medium (1 week) Large (months)
392
+ │ │ │
393
+ 1 VTC directly → 2-3 VTCs directly → Full Trigger Map
394
+ Single scenario Focused scope containing 10+ VTCs
395
+ Minimal docs Some prioritization Complete strategic map
396
+ ```
397
+
398
+ **Start where your project needs to start. Scale up if needed.**
399
+
400
+ ---
401
+
402
+ ## Common Questions
403
+
404
+ ### Q: How many VTCs do I need?
405
+
406
+ **A:** Start with one per major user type or key scenario. For a simple product: 1-3 VTCs. For a complex platform: 10-20 VTCs.
407
+
408
+ ### Q: Can a page serve multiple VTCs?
409
+
410
+ **A:** Yes! Often a page serves a primary VTC but specific sections address secondary VTCs. Document this in your page specification.
411
+
412
+ ### Q: What if I have multiple business goals?
413
+
414
+ **A:** Create separate VTCs for each. One VTC might serve multiple goals, but each VTC should have a clear primary goal.
415
+
416
+ ### Q: How detailed should driving forces be?
417
+
418
+ **A:** Specific enough to inform design decisions. "Want to save time" is too vague. "Fear of spending hours learning yet another tool" informs design.
419
+
420
+ ### Q: When do I need a full Trigger Map instead of just VTCs?
421
+
422
+ **A:** When you have:
423
+ - Multiple user types with complex relationships
424
+ - Need to prioritize across many scenarios
425
+ - Long-term product requiring strategic foundation
426
+ - Stakeholders needing comprehensive strategic view
427
+
428
+ ---
429
+
430
+ ## VTC Template
431
+
432
+ Copy this template to create your VTCs:
433
+
434
+ ```yaml
435
+ vtc-01:
436
+ business_goal: "[Measurable goal]"
437
+ solution: "[What you're building]"
438
+ user: "[Name] ([role/traits])"
439
+ context: "[When/where they encounter solution]"
440
+ driving_forces:
441
+ positive:
442
+ - "[Wish/aspiration]"
443
+ - "[Another wish]"
444
+ negative:
445
+ - "[Fear/frustration]"
446
+ - "[Another fear]"
447
+ customer_awareness: "[Start Stage] → [End Stage]"
448
+
449
+ # Add notes
450
+ notes: |
451
+ [Any additional context about this VTC]
452
+ [Why this combination matters]
453
+ [How it connects to other VTCs]
454
+ ```
455
+
456
+ ---
457
+
458
+ ## Next Steps
459
+
460
+ 1. **Try it:** Define your first VTC for your current project (30 minutes)
461
+ 2. **Use it:** Reference your VTC when making next design decision
462
+ 3. **Validate it:** Does your VTC actually inform your choices?
463
+ 4. **Expand:** Add more VTCs as you discover more user types or scenarios
464
+ 5. **Consider Trigger Map:** If you have 5+ VTCs, consider creating a full map for better prioritization
465
+
466
+ **Related Guides:**
467
+ - [Trigger Mapping Guide](./phase-2-trigger-mapping-guide.md) - When you need comprehensive strategic mapping
468
+ - [Scenario Definition Guide](./phase-4-ux-design-guide.md) - How VTCs anchor scenarios
469
+ - [Customer Awareness Cycle Model](../models/customer-awareness-cycle.md) - Deep dive into awareness positioning
470
+
471
+ ---
472
+
473
+ *Value Trigger Chain - Minimum viable strategic context for purposeful design.*
474
+