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,530 @@
1
+ # Customer Awareness Cycle
2
+
3
+ **A framework for understanding where users are in their buying journey and how to meet them there**
4
+
5
+ **Originated by:** Eugene Schwartz
6
+ **Source:** *Breakthrough Advertising* (1966)
7
+ **Applied in WDS:** Scenario definition, content strategy, user positioning
8
+
9
+ ---
10
+
11
+ ## What It Is
12
+
13
+ The **Customer Awareness Cycle** is a five-stage framework that describes a user's journey from complete unawareness to enthusiastic advocacy. It answers the critical question: *"What does my user already know, and what do they need to know next?"*
14
+
15
+ ### The Five Stages
16
+
17
+ 1. **Unaware** - Doesn't know problem exists
18
+ 2. **Problem Aware** - Knows problem, doesn't know solutions exist
19
+ 3. **Solution Aware** - Knows solutions exist, doesn't know about yours specifically
20
+ 4. **Product Aware** - Knows your solution exists, hasn't committed
21
+ 5. **Most Aware** - Has used, loved, and advocates for your solution
22
+
23
+ **The Core Insight:** You can't sell a solution to someone who doesn't know they have a problem. You must meet users where they are and guide them forward one stage at a time.
24
+
25
+ ---
26
+
27
+ ## Why It Matters
28
+
29
+ ### The Problem Without Customer Awareness
30
+
31
+ Content and design often assume too much or too little:
32
+ - Landing page assumes visitors know the problem (they don't)
33
+ - Onboarding explains WHY when users already bought (they know)
34
+ - Messaging speaks to wrong awareness level
35
+ - Conversion funnels skip critical awareness stages
36
+ - Content feels irrelevant or condescending
37
+
38
+ ### The Solution With Customer Awareness
39
+
40
+ Every interaction meets users where they are:
41
+ - Content depth matches awareness level
42
+ - Messaging addresses current questions
43
+ - Next steps feel natural and logical
44
+ - Progression through stages is intentional
45
+ - Success rates improve dramatically
46
+
47
+ **Example:**
48
+ - Problem Aware user needs: "Here's how solutions work"
49
+ - Product Aware user needs: "Here's why OURS is right for you"
50
+
51
+ Same user type, different content, different design.
52
+
53
+ ---
54
+
55
+ ## How It's Valuable in Strategic Design
56
+
57
+ ### 1. **Content Strategy**
58
+
59
+ Each awareness level requires different content depth and focus:
60
+
61
+ **Unaware → Problem Aware:**
62
+ - Educational content
63
+ - "Did you know..." framing
64
+ - Problem agitation
65
+ - Relatable scenarios
66
+
67
+ **Problem Aware → Solution Aware:**
68
+ - Solution categories
69
+ - "Here's how people solve this"
70
+ - Approach explanation
71
+ - No product pitch yet
72
+
73
+ **Solution Aware → Product Aware:**
74
+ - Your specific approach
75
+ - Differentiation
76
+ - "Why us" messaging
77
+ - Product introduction
78
+
79
+ **Product Aware → Most Aware:**
80
+ - Proof and trust signals
81
+ - Onboarding and activation
82
+ - Success stories
83
+ - Community building
84
+
85
+ ### 2. **Scenario Design**
86
+
87
+ Every scenario should move users forward in awareness:
88
+
89
+ ```yaml
90
+ scenario:
91
+ name: "Landing Page Visit"
92
+ awareness_start: "Solution Aware"
93
+ awareness_goal: "Product Aware"
94
+ design_implication: "Show how OUR solution works, not ALL solutions"
95
+ ```
96
+
97
+ This creates measurable goals and clear design direction.
98
+
99
+ ### 3. **Messaging Hierarchy**
100
+
101
+ Homepage serves multiple awareness levels:
102
+
103
+ - **Hero:** Problem Aware → Solution Aware
104
+ - **Features:** Solution Aware → Product Aware
105
+ - **Testimonials:** Product Aware → Most Aware
106
+
107
+ Each section progresses the journey.
108
+
109
+ ### 4. **Microcopy and Tone**
110
+
111
+ Awareness level affects everything:
112
+ - Button labels
113
+ - Error messages
114
+ - Empty states
115
+ - Help text
116
+
117
+ **Example - Empty State:**
118
+ - Problem Aware: "Projects help you organize work. Create your first one!"
119
+ - Product Aware: "No projects yet. Ready to start?"
120
+
121
+ ### 5. **Measurement and Optimization**
122
+
123
+ Track awareness progression:
124
+ - What % move from Problem → Solution Aware?
125
+ - Where do users get stuck?
126
+ - Which content advances awareness most effectively?
127
+
128
+ ---
129
+
130
+ ## Attribution and History
131
+
132
+ ### Eugene Schwartz - The Pioneer
133
+
134
+ **Eugene Schwartz** (1927-1995) was a legendary direct response copywriter who wrote *Breakthrough Advertising* in 1966. This book, considered one of the greatest marketing books ever written, introduced the awareness stages framework.
135
+
136
+ Schwartz observed that the most successful ads matched message to awareness level. He codified this into a framework that has influenced marketing and UX for over 50 years.
137
+
138
+ ### Modern Applications
139
+
140
+ While Schwartz focused on advertising copy, his framework applies powerfully to:
141
+ - User experience design
142
+ - Content strategy
143
+ - Product onboarding
144
+ - Marketing funnels
145
+ - Educational platforms
146
+
147
+ **Timeless Principle:** *"You can't tell people what they're not ready to hear."*
148
+
149
+ ---
150
+
151
+ ## Source Materials
152
+
153
+ ### Books
154
+
155
+ 📚 **Breakthrough Advertising** by Eugene Schwartz (1966)
156
+ - *The original source*
157
+ - Out of print but available as reprints
158
+ - Dense, challenging, rewarding read
159
+ - [Available on Amazon](https://www.amazon.com/Breakthrough-Advertising-Eugene-M-Schwartz/dp/0887232981) (reprints ~$125-200)
160
+
161
+ 📚 **The Adweek Copywriting Handbook** by Joseph Sugarman (2006)
162
+ - Accessible introduction to Schwartz's concepts
163
+ - Practical applications
164
+ - [Available on Amazon](https://www.amazon.com/Adweek-Copywriting-Handbook-Ultimate-Writing/dp/0470051248)
165
+
166
+ ### Articles and Resources
167
+
168
+ 🔗 **[Copyhackers: The 5 Stages of Awareness](https://copyhackers.com/2017/05/customer-awareness/)** - Modern application to web copy
169
+
170
+ 🔗 **[Digital Marketer: Customer Awareness](https://www.digitalmarketer.com/blog/customer-awareness/)** - Practical framework for online marketing
171
+
172
+ ### Videos
173
+
174
+ 🎥 **[Customer Awareness - The Copywriter's Secret Weapon](https://www.youtube.com/results?search_query=eugene+schwartz+customer+awareness)** - Various explainer videos on YouTube
175
+
176
+ ---
177
+
178
+ ## Whiteport Methods That Harness This Model
179
+
180
+ ### [Value Trigger Chain Guide](../method/value-trigger-chain-guide.md)
181
+
182
+ VTCs include Customer Awareness positioning:
183
+ - Starting point: Where is user NOW?
184
+ - Target point: Where do we want to move them?
185
+ - Design serves this progression
186
+
187
+ **Example:**
188
+ ```
189
+ Customer Awareness: Problem Aware → Product Aware
190
+ Design Implication: Introduce OUR solution after establishing problem
191
+ ```
192
+
193
+ ### [Trigger Mapping Guide](../method/phase-2-trigger-mapping-guide.md)
194
+
195
+ Trigger Maps can include awareness positioning for each persona:
196
+ - Different users at different awareness levels
197
+ - Scenarios designed to progress awareness
198
+ - Content strategy matches awareness
199
+
200
+ ### [Scenario Definition (Phase 4)](../method/phase-4-ux-design-guide.md)
201
+
202
+ Each scenario defines awareness progression:
203
+ - Entry point awareness level
204
+ - Exit point awareness level
205
+ - Interactions designed to bridge the gap
206
+
207
+ ### [Content Creation Workflow](../method/value-trigger-chain-guide.md#using-vtcs-in-your-design-process)
208
+
209
+ Before creating any content:
210
+ 1. Identify user's current awareness level
211
+ 2. Determine target awareness level
212
+ 3. Create content that bridges the gap
213
+ 4. Validate: Does this advance awareness?
214
+
215
+ ---
216
+
217
+ ## Imaginary Examples
218
+
219
+ ### Example 1: SaaS Landing Page
220
+
221
+ **User:** Startup founder, Problem Aware (knows they need better project management)
222
+
223
+ **Awareness Progression:** Problem Aware → Solution Aware → Product Aware
224
+
225
+ **Page Structure:**
226
+
227
+ **Section 1 - Problem Aware → Solution Aware:**
228
+ - Headline: "Your Team Scattered Across Slack, Email, and Spreadsheets?"
229
+ - Body: Brief description of how modern teams centralize work
230
+ - CTA: "See How It Works" (not "Sign Up")
231
+
232
+ **Section 2 - Solution Aware → Product Aware:**
233
+ - Headline: "Meet [Product]: Where Work Happens"
234
+ - Body: Your specific approach and differentiators
235
+ - CTA: "Try It Free" (awareness sufficient for commitment)
236
+
237
+ ### Example 2: Onboarding Flow
238
+
239
+ **User:** New signup, Product Aware → Most Aware progression needed
240
+
241
+ **Wrong Approach (assuming Unaware):**
242
+ ```
243
+ "Welcome! Did you know teams waste 2.5 hours daily switching between tools?"
244
+ ```
245
+ *User thinks: "I know, that's why I signed up. Get to the point."*
246
+
247
+ **Right Approach (Product Aware):**
248
+ ```
249
+ "Welcome! Let's get your first project set up."
250
+ ```
251
+ *User thinks: "Perfect, let's go."*
252
+
253
+ ### Example 3: Feature Documentation
254
+
255
+ **User:** Existing customer, Most Aware of product but Unaware of new feature
256
+
257
+ **Structure:**
258
+ 1. **Problem Agitation:** "Tired of manually updating status?" (Unaware → Problem Aware)
259
+ 2. **Solution Introduction:** "Status Automations do it for you" (Problem → Solution Aware)
260
+ 3. **How to Use:** "Click Settings → Automations" (Solution → Product Aware on this feature)
261
+ 4. **Advanced Tips:** "Pro tip: Chain automations for..." (Product → Most Aware)
262
+
263
+ ---
264
+
265
+ ## Real Applications
266
+
267
+ ### WDS Presentation Project
268
+
269
+ The WDS Presentation landing page considers multiple awareness levels:
270
+
271
+ **Stina (Designer):**
272
+ - Current: Solution Aware (knows design tools exist)
273
+ - Target: Product Aware (knows WDS specifically)
274
+ - Content: Shows WDS's unique approach vs generic "design tools are great"
275
+
276
+ **Lars (Executive):**
277
+ - Current: Problem Aware (knows design-dev handoff is broken)
278
+ - Target: Solution Aware (learns modern AI-assisted approaches exist)
279
+ - Content: Educates on solution category before pitching WDS
280
+
281
+ **See:** [WDS Presentation Trigger Map](../examples/WDS-Presentation/docs/2-trigger-map/00-trigger-map.md)
282
+
283
+ Each persona's current awareness level shapes how the landing page speaks to them.
284
+
285
+ ---
286
+
287
+ ## Detailed Stage Characteristics
288
+
289
+ ### Stage 1: Unaware
290
+
291
+ **What They Know:** Nothing about problem or solutions
292
+
293
+ **What They Need:**
294
+ - Problem revelation
295
+ - Relatable scenarios
296
+ - "You're not alone" messaging
297
+ - Educational framing
298
+
299
+ **Content Types:**
300
+ - Blog posts about industry challenges
301
+ - Research reports
302
+ - "State of [Industry]" content
303
+ - Social media education
304
+
305
+ **Example Messaging:**
306
+ - "Most designers waste 15 hours/week recreating components that already exist..."
307
+ - "Did you know 73% of projects fail due to unclear requirements?"
308
+
309
+ **Don't:**
310
+ - Pitch your product
311
+ - Assume they know the problem
312
+ - Use jargon
313
+
314
+ ### Stage 2: Problem Aware
315
+
316
+ **What They Know:** Problem exists and affects them
317
+
318
+ **What They Need:**
319
+ - Validation that problem is solvable
320
+ - Overview of solution approaches
321
+ - Hope and direction
322
+ - Not product-specific yet
323
+
324
+ **Content Types:**
325
+ - "How to solve [problem]" guides
326
+ - Solution category overviews
327
+ - Comparison of approaches
328
+ - Educational webinars
329
+
330
+ **Example Messaging:**
331
+ - "There are three main approaches to [problem]: [A], [B], and [C]..."
332
+ - "Teams solve this by establishing shared design systems..."
333
+
334
+ **Don't:**
335
+ - Pitch product before educating on solutions
336
+ - Assume they know solution categories
337
+
338
+ ### Stage 3: Solution Aware
339
+
340
+ **What They Know:** Solution categories exist, exploring options
341
+
342
+ **What They Need:**
343
+ - Your specific approach explained
344
+ - Differentiation from other solutions
345
+ - Why YOUR way is different/better
346
+ - Still some education, less selling
347
+
348
+ **Content Types:**
349
+ - "Our approach to [problem]"
350
+ - Product overview (not features list)
351
+ - Philosophy and methodology
352
+ - Comparison content (you vs others)
353
+
354
+ **Example Messaging:**
355
+ - "Unlike traditional design tools that focus on pixels, WDS starts with user psychology..."
356
+ - "Most solutions require developers to interpret designs. WDS creates specs developers can actually use..."
357
+
358
+ **Don't:**
359
+ - List features without context
360
+ - Assume they know your differentiation
361
+
362
+ ### Stage 4: Product Aware
363
+
364
+ **What They Know:** Your solution exists, evaluating it
365
+
366
+ **What They Need:**
367
+ - Proof it works (case studies, demos)
368
+ - Trust signals (testimonials, security)
369
+ - Clear path to start (pricing, trial)
370
+ - Answers to objections
371
+
372
+ **Content Types:**
373
+ - Product demos and walkthroughs
374
+ - Case studies and testimonials
375
+ - Pricing and packaging info
376
+ - FAQs and objection handling
377
+ - Free trial or demo signup
378
+
379
+ **Example Messaging:**
380
+ - "Join 1,000+ designers who've reduced handoff time by 60%..."
381
+ - "See how [Company] shipped their redesign in half the time..."
382
+ - "Start free, upgrade when you're ready"
383
+
384
+ **Don't:**
385
+ - Over-educate (they're ready to evaluate)
386
+ - Hide pricing or next steps
387
+
388
+ ### Stage 5: Most Aware
389
+
390
+ **What They Know:** Your product intimately, are users/advocates
391
+
392
+ **What They Need:**
393
+ - Advanced tips and best practices
394
+ - Community and belonging
395
+ - New feature announcements
396
+ - Ways to go deeper
397
+ - Recognition and advocacy opportunities
398
+
399
+ **Content Types:**
400
+ - Advanced guides and tutorials
401
+ - Community forums and events
402
+ - Beta features and early access
403
+ - Referral and advocacy programs
404
+ - Power user showcases
405
+
406
+ **Example Messaging:**
407
+ - "Pro tip: Did you know you can chain automations?"
408
+ - "Meet Sarah, who uses WDS to design 3x faster..."
409
+ - "Invite your team, get [benefit]"
410
+
411
+ **Don't:**
412
+ - Explain basics they already know
413
+ - Treat them like newbies
414
+
415
+ ---
416
+
417
+ ## Common Questions
418
+
419
+ ### Q: Can users skip stages?
420
+
421
+ **A:** Sometimes, but rarely. Most users progress sequentially. Trying to force jumps (Problem Aware → Most Aware) usually fails. Design for stage-by-stage progression.
422
+
423
+ ### Q: Can the same content serve multiple awareness levels?
424
+
425
+ **A:** Advanced content can serve different parts to different users (Most Aware read deep, Solution Aware skim headlines). But forcing one page to serve Unaware AND Most Aware usually serves neither well.
426
+
427
+ ### Q: How do I know what awareness level my users are?
428
+
429
+ **A:** Research, analytics, and testing:
430
+ - User interviews: "How did you hear about us?"
431
+ - Analytics: What content do they consume before converting?
432
+ - Surveys: "How familiar are you with [solution category]?"
433
+ - A/B testing: Which messaging resonates?
434
+
435
+ ### Q: What if I have users at all levels?
436
+
437
+ **A:** Design entry points for each level:
438
+ - Blog (Unaware → Problem Aware)
439
+ - Resource Center (Problem → Solution Aware)
440
+ - Product Pages (Solution → Product Aware)
441
+ - App Login (Most Aware)
442
+
443
+ Or design sections of pages for progression (homepage hero → features → testimonials).
444
+
445
+ ---
446
+
447
+ ## Using Customer Awareness in Your Process
448
+
449
+ ### Step 1: Identify Current Awareness
450
+
451
+ For each key user type:
452
+ - Where are they NOW?
453
+ - What research have they done?
454
+ - How did they find you?
455
+ - What do they already know?
456
+
457
+ ### Step 2: Define Target Awareness
458
+
459
+ For this interaction:
460
+ - Where do we want to move them?
461
+ - What's the next stage they're ready for?
462
+ - What prevents them from progressing?
463
+
464
+ ### Step 3: Design the Bridge
465
+
466
+ Create content and interactions that:
467
+ - Acknowledge current awareness
468
+ - Provide what they need to progress
469
+ - Don't assume too much knowledge
470
+ - Don't over-explain what they know
471
+
472
+ ### Step 4: Measure Progression
473
+
474
+ Track:
475
+ - What % progress to next stage?
476
+ - Where do users get stuck?
477
+ - Which content advances awareness?
478
+ - What stage converts best?
479
+
480
+ ### Step 5: Optimize
481
+
482
+ Adjust content and design based on data:
483
+ - Strengthen weak transitions
484
+ - Add missing bridges
485
+ - Remove awareness mismatches
486
+
487
+ ---
488
+
489
+ ## Customer Awareness Template
490
+
491
+ Use this template when defining scenarios or content:
492
+
493
+ ```yaml
494
+ scenario: "[scenario name]"
495
+
496
+ user:
497
+ name: "[User name/type]"
498
+ current_awareness: "[Unaware/Problem/Solution/Product/Most]"
499
+ target_awareness: "[Problem/Solution/Product/Most Aware]"
500
+
501
+ content_strategy:
502
+ focus: "[What this awareness transition requires]"
503
+ tone: "[How to speak to this awareness level]"
504
+ depth: "[How much detail to include]"
505
+ call_to_action: "[What action is appropriate for target awareness]"
506
+
507
+ measurement:
508
+ success: "[User reached target awareness]"
509
+ metric: "[How we measure awareness progression]"
510
+ ```
511
+
512
+ ---
513
+
514
+ ## Next Steps
515
+
516
+ 1. **Audit current content:** What awareness level does each piece assume? Does it match your users?
517
+ 2. **Map user journey:** Where do users enter (awareness level) and where should they exit?
518
+ 3. **Identify gaps:** Which awareness transitions are weak or missing?
519
+ 4. **Design bridges:** Create content that moves users forward stage by stage
520
+ 5. **Test and measure:** Track progression through awareness stages
521
+
522
+ **Related Resources:**
523
+ - [Value Trigger Chain Guide](../method/value-trigger-chain-guide.md) - Includes Customer Awareness positioning
524
+ - [Trigger Mapping Guide](../method/phase-2-trigger-mapping-guide.md) - Uses awareness to position personas
525
+ - [Phase 4: UX Design Guide](../method/phase-4-ux-design-guide.md) - Applies awareness to scenarios
526
+
527
+ ---
528
+
529
+ *Customer Awareness Cycle - Meet users where they are, guide them where they need to go.*
530
+