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,672 @@
1
+ # Kathy Sierra Badass Users Principles
2
+
3
+ **User capability, not product features: Making users awesome at what they want to do**
4
+
5
+ **Originated by:** Kathy Sierra
6
+ **Source:** Books, blog (Creating Passionate Users), conference talks (2000s-2010s)
7
+ **Applied in WDS:** Component design, microcopy, interaction patterns, user experience optimization
8
+
9
+ ---
10
+
11
+ ## What It Is
12
+
13
+ **Kathy Sierra's Badass Users Principles** are a collection of user experience insights focused on one revolutionary idea:
14
+
15
+ **Don't make a better product. Make users better at what they want to do.**
16
+
17
+ **Core Concepts:**
18
+
19
+ 1. **Badass Users:** Focus on making users feel capable and awesome
20
+ 2. **Cognitive Resources:** Treat user's mental energy as precious and finite
21
+ 3. **Perceptual Exposure:** Repeated micro-exposures create expertise
22
+ 4. **The Suck Zone:** Get users through beginner frustration to competence quickly
23
+ 5. **Post-UX:** Experience extends beyond your app/product
24
+
25
+ **The Revolutionary Insight:** Users don't care about your product. They care about being good at something your product helps them do.
26
+
27
+ ---
28
+
29
+ ## Why It Matters
30
+
31
+ ### The Problem Without Kathy Sierra Thinking
32
+
33
+ Traditional product focus:
34
+ - "Look at all our features!"
35
+ - Success = feature usage
36
+ - UX = making product easy to use
37
+ - Help = explaining product
38
+ - Marketing = product benefits
39
+
40
+ **Result:** Products users tolerate but don't love.
41
+
42
+ ### The Solution With Kathy Sierra Thinking
43
+
44
+ User capability focus:
45
+ - "Look at what you can now do!"
46
+ - Success = user competence and confidence
47
+ - UX = making user feel capable
48
+ - Help = making user better at their goal
49
+ - Marketing = user transformation
50
+
51
+ **Result:** Products users evangelize because they feel awesome using them.
52
+
53
+ **Example:**
54
+
55
+ **Camera Company A (Product-Focused):**
56
+ "Our camera has 47 features! 12 shooting modes! Advanced ISO controls!"
57
+
58
+ **Camera Company B (Sierra-Style):**
59
+ "Take amazing photos in any light. You'll get shots you're proud to share. We'll help you get there fast."
60
+
61
+ **Which sells more? B. Because people want to be good photographers, not feature-operated.**
62
+
63
+ ---
64
+
65
+ ## How It's Valuable in Strategic Design
66
+
67
+ ### 1. **Component Design**
68
+
69
+ Traditional: "What does this component do?"
70
+ Sierra: "How does this help user feel capable?"
71
+
72
+ **Example: File Upload**
73
+
74
+ **Traditional Thinking:**
75
+ ```
76
+ Component: File uploader
77
+ Features:
78
+ - Drag and drop
79
+ - File browser
80
+ - Multiple file support
81
+ - Progress indicator
82
+ ```
83
+
84
+ **Sierra Thinking:**
85
+ ```
86
+ User Goal: Get my files uploaded without thinking about it
87
+
88
+ Design for Capability:
89
+ - HUGE drop zone: "I got this, just drop anywhere"
90
+ - Instant visual feedback: "It's working"
91
+ - Clear success state: "You did it! 5 files ready"
92
+ - Error recovery: "This one didn't work. Try this instead." (not "Error 402")
93
+
94
+ Result: User feels confident, not anxious
95
+ ```
96
+
97
+ ### 2. **Microcopy and Messaging**
98
+
99
+ Traditional: Explain product
100
+ Sierra: Build user confidence
101
+
102
+ **Examples:**
103
+
104
+ **Empty State:**
105
+ - ❌ "No projects available"
106
+ - ✅ "Ready to create your first project?"
107
+
108
+ **Success Message:**
109
+ - ❌ "File uploaded successfully"
110
+ - ✅ "You're all set! Your report is ready."
111
+
112
+ **Error Message:**
113
+ - ❌ "Invalid input. Error code 422"
114
+ - ✅ "Almost there! Try using letters and numbers only."
115
+
116
+ **Tone Shift:** From system status → to user progress
117
+
118
+ ### 3. **Onboarding Strategy**
119
+
120
+ Traditional: Teach all features
121
+ Sierra: Get to "I can do this!" moment FAST
122
+
123
+ **Goal:** Cross the "Suck Zone" (frustrating beginner phase) as quickly as possible to reach "I got this!" feeling.
124
+
125
+ **Approach:**
126
+ 1. One clear, achievable task
127
+ 2. Guide through completion
128
+ 3. Celebrate success
129
+ 4. User now feels capable
130
+ 5. Build from there
131
+
132
+ **Not:**
133
+ 1. Here's feature 1, 2, 3, 4, 5...
134
+ 2. Now try yourself
135
+ 3. Good luck!
136
+
137
+ ### 4. **Progressive Disclosure**
138
+
139
+ Traditional: Show everything upfront
140
+ Sierra: Reveal complexity as user grows
141
+
142
+ **Principle:** Don't overwhelm beginner with expert features. Let users discover depth as they gain competence.
143
+
144
+ **Example: Code Editor**
145
+ - **Day 1:** Basic editing, syntax highlighting
146
+ - **Week 1:** Code completion, snippets
147
+ - **Month 1:** Extensions, customization
148
+ - **Year 1:** Advanced debugging, profiling
149
+
150
+ User discovers capabilities aligned with growing skill, never overwhelmed.
151
+
152
+ ### 5. **Cognitive Load Reduction**
153
+
154
+ Traditional: Assume unlimited mental energy
155
+ Sierra: Treat cognitive resources as finite and precious
156
+
157
+ **Every decision users make depletes mental energy.**
158
+
159
+ **Design Implications:**
160
+ - Sensible defaults (reduce decisions)
161
+ - Clear recommended path (reduce analysis)
162
+ - Consistent patterns (reduce learning)
163
+ - Remove unnecessary choices (reduce paralysis)
164
+
165
+ **Result:** Users have mental energy for what matters - their actual work.
166
+
167
+ ---
168
+
169
+ ## Attribution and History
170
+
171
+ ### Kathy Sierra - The Teacher Who Changed UX
172
+
173
+ **Kathy Sierra** is a game developer, programming instructor, and author who revolutionized how we think about user experience in the 2000s.
174
+
175
+ **Background:**
176
+ - Co-created "Head First" book series (O'Reilly)
177
+ - Game developer interested in learning and motivation
178
+ - Java programmer and teacher
179
+ - Conference speaker and blogger
180
+
181
+ **Breakthrough Work:**
182
+
183
+ Her blog **"Creating Passionate Users"** (2004-2006) was required reading for UX designers and product people. Though she stopped blogging in 2007, her insights remain foundational.
184
+
185
+ ### Core Teachings
186
+
187
+ **From "Creating Passionate Users" and Talks:**
188
+
189
+ 1. **"Make users badass, not your product"** - Focus on user capability
190
+ 2. **"Cognitive resources are precious"** - Reduce mental load
191
+ 3. **"Get through the suck zone fast"** - Early competence crucial
192
+ 4. **"Passionate users evangelize"** - Best users are those who feel awesome
193
+ 5. **"Death by 1000 cuts"** - Small frustrations compound
194
+ 6. **"Brain-friendly design"** - Work with how brains actually learn
195
+
196
+ ### Influence
197
+
198
+ Kathy Sierra influenced:
199
+ - Modern UX design philosophy
200
+ - Product-led growth thinking
201
+ - User onboarding best practices
202
+ - Technical writing and documentation
203
+ - Software craftsmanship movement
204
+ - Game design and gamification
205
+
206
+ **Her Legacy:** Shifted focus from "usability" (can users use it?) to "capability" (do users feel awesome?).
207
+
208
+ ---
209
+
210
+ ## Source Materials
211
+
212
+ ### Books
213
+
214
+ 📚 **Badass: Making Users Awesome**
215
+ By Kathy Sierra (2015)
216
+
217
+ - Her comprehensive book on user capability
218
+ - Covers cognitive resources, expertise development, motivation
219
+ - Practical framework for creating "badass users"
220
+ - [Available on Amazon](https://www.amazon.com/Badass-Making-Awesome-Kathy-Sierra/dp/1491919019)
221
+
222
+ 📚 **Head First Series** (Various Authors, Co-created by Kathy Sierra)
223
+
224
+ - Revolutionary approach to technical books
225
+ - Brain-friendly learning design
226
+ - Shows Sierra's principles in action
227
+ - Multiple titles on Java, Design Patterns, etc.
228
+
229
+ ### Blog (Archive)
230
+
231
+ 🔗 **Creating Passionate Users (Archive)**
232
+
233
+ - Original blog (2004-2007)
234
+ - Still valuable, still relevant
235
+ - [Archived at headrush.typepad.com](http://headrush.typepad.com/)
236
+ - Many posts on user capability, cognitive load, learning
237
+
238
+ **Must-Read Posts:**
239
+ - "Kicking Ass"
240
+ - "The Physics of Passion: The Koolaid Point"
241
+ - "Be a Better [...] by Tomorrow"
242
+ - "Cognitive seduction"
243
+ - "Users don't care about your product"
244
+
245
+ ### Conference Talks
246
+
247
+ 🎥 **"Building the minimum Badass User"** and others
248
+
249
+ - Various conferences 2005-2015
250
+ - [Search YouTube for "Kathy Sierra"](https://www.youtube.com/results?search_query=kathy+sierra)
251
+
252
+ ### Articles About Her Work
253
+
254
+ 🔗 **"Kathy Sierra on Creating Passionate Users"** - Various interviews and retrospectives
255
+
256
+ ---
257
+
258
+ ## Whiteport Methods That Harness This Model
259
+
260
+ ### Component Specifications
261
+
262
+ Components designed to make users feel capable:
263
+
264
+ **Questions to Ask:**
265
+ - Does this component make the user feel smart or stupid?
266
+ - Does it reduce or increase cognitive load?
267
+ - Does it build confidence or create anxiety?
268
+ - Does success feel like user's achievement or system's gift?
269
+
270
+ **Example: Form Validation**
271
+
272
+ **Traditional:**
273
+ ```
274
+ [User fills form, clicks submit]
275
+ "Error: Invalid email format"
276
+ "Error: Password must be 8+ characters"
277
+ [User feels stupid, frustrated]
278
+ ```
279
+
280
+ **Sierra Approach:**
281
+ ```
282
+ [User typing email]
283
+ ✓ "Got it" [green checkmark appears]
284
+
285
+ [User typing password]
286
+ "Almost there... 6 more characters" → "Perfect! ✓"
287
+
288
+ [User feels smart, capable]
289
+ ```
290
+
291
+ ### Microcopy Guidelines
292
+
293
+ Every piece of text asks: "Does this make the user feel capable?"
294
+
295
+ **Error Messages:**
296
+ - Not: "Error occurred"
297
+ - Yes: "Let's fix this together" + specific guidance
298
+
299
+ **Success States:**
300
+ - Not: "Operation completed"
301
+ - Yes: "You did it! [What they accomplished]"
302
+
303
+ **Help Text:**
304
+ - Not: "This field requires..."
305
+ - Yes: "Pro tip: Use your work email for..." (implies user is becoming pro)
306
+
307
+ ### Interaction Design
308
+
309
+ Patterns that reduce cognitive load:
310
+
311
+ **Defaults:** Sensible, let users accept and move on
312
+ **Recommendations:** "Most people like this" (reduce analysis)
313
+ **Undo:** Fearless exploration, not anxiety
314
+ **Progressive Disclosure:** Complexity revealed as skill grows
315
+ **Consistent Patterns:** Learn once, apply everywhere
316
+
317
+ ---
318
+
319
+ ## Imaginary Examples
320
+
321
+ ### Example 1: Photo Editing App
322
+
323
+ **Traditional Product-Focused:**
324
+
325
+ ```
326
+ Features Available:
327
+ - Brightness
328
+ - Contrast
329
+ - Saturation
330
+ - Hue
331
+ - Curves
332
+ - Levels
333
+ - Color Balance
334
+ - Exposure
335
+ - Highlights
336
+ - Shadows
337
+ - [30 more options...]
338
+
339
+ User: "I just want my photo to look good. I don't know what 'curves' are."
340
+ Result: Overwhelmed, gives up, photo still looks bad
341
+ ```
342
+
343
+ **Sierra User-Capability-Focused:**
344
+
345
+ ```
346
+ What do you want to do?
347
+ → Make colors pop [Quick fix applied] "Looking better!"
348
+ → Fix dark photo [Auto adjustment] "That's brighter!"
349
+ → Get creative [3 curated styles] "Which vibe?"
350
+
351
+ Result after 30 seconds: Photo looks great
352
+ User feeling: "I made this look amazing!"
353
+
354
+ [Advanced controls available in menu, for when user is ready]
355
+ ```
356
+
357
+ **Same app, different philosophy. Second version creates capable, confident users.**
358
+
359
+ ### Example 2: Code Review Tool
360
+
361
+ **Traditional:**
362
+
363
+ ```
364
+ Dashboard shows:
365
+ - Open PRs (37)
366
+ - Awaiting your review (12)
367
+ - Comments (184)
368
+ - Approval rate
369
+ - Activity feed (endless scroll)
370
+
371
+ Developer: *anxiety* "Where do I even start?"
372
+ Feels: Overwhelmed, behind, stressed
373
+ Does: Avoids tool
374
+ ```
375
+
376
+ **Sierra Approach:**
377
+
378
+ ```
379
+ Good morning, Alex! You've got 3 PRs to review today.
380
+
381
+ Here's where you'll make the biggest impact:
382
+ → Sarah's login fix (urgent, 5 min) [Review Now]
383
+ → Team's API refactor (big decision needed) [Review Now]
384
+ → Junior dev's first PR (needs guidance) [Review Now]
385
+
386
+ That's it for today! You're staying on top of things.
387
+
388
+ [Other 9 PRs in "Later" section, not prominent]
389
+
390
+ After reviewing Sarah's PR: "Nice catch on that edge case! 2 to go."
391
+
392
+ Developer: Feels capable, helpful, on track
393
+ Does: Reviews PRs confidently
394
+ ```
395
+
396
+ ### Example 3: Language Learning App
397
+
398
+ **Traditional:**
399
+
400
+ ```
401
+ Lesson 1: Greetings
402
+ - Hello = Hola
403
+ - Goodbye = Adiós
404
+ - Please = Por favor
405
+ [10 more phrases]
406
+
407
+ Quiz:
408
+ 1. What is "hello" in Spanish?
409
+ 2. Translate "goodbye"
410
+ ...
411
+
412
+ User: Memorizes words for quiz, forgets next day
413
+ Feeling: "I'm bad at languages"
414
+ ```
415
+
416
+ **Sierra Approach:**
417
+
418
+ ```
419
+ You're meeting Maria at a café!
420
+
421
+ Maria: "¡Hola! ¿Cómo estás?"
422
+ [Hola highlighted, sound plays]
423
+ → Tap to say "Hola!" back
424
+
425
+ You: "¡Hola!"
426
+ Maria: *smiles* "¿Cómo te llamas?"
427
+ → "Me llamo [Your name]"
428
+
429
+ After 5 minutes: You've had a conversation!
430
+ "You just ordered coffee in Spanish! 🎉"
431
+
432
+ User: Had actual (simulated) conversation
433
+ Feeling: "I can do this! I spoke Spanish!"
434
+ Motivation: Through the roof
435
+ ```
436
+
437
+ **Result:** User feels capable, wants to continue.
438
+
439
+ ---
440
+
441
+ ## Real Applications
442
+
443
+ ### WDS Component Specifications
444
+
445
+ WDS component specs include "User Capability Considerations":
446
+
447
+ **For each component:**
448
+ - What is user trying to accomplish?
449
+ - How does this help them feel capable?
450
+ - What cognitive load does this add/remove?
451
+ - What's the "aha moment" (competence feeling)?
452
+ - How do we get them there fast?
453
+
454
+ **Microcopy Standards:**
455
+ - Error messages guide toward success (not blame)
456
+ - Success states celebrate user achievement
457
+ - Empty states encourage confident action
458
+ - Help text implies user competence ("Pro tip" not "Warning")
459
+
460
+ **See:** [WDS Presentation Example](../examples/WDS-Presentation/) - Components designed for capability
461
+
462
+ ---
463
+
464
+ ## Key Concepts in Detail
465
+
466
+ ### 1. Badass Users (The Goal)
467
+
468
+ **Not:** Users who tolerate your product
469
+ **Yes:** Users who are awesome at what they want to do, partly thanks to your product
470
+
471
+ **Badass User Characteristics:**
472
+ - Feels confident and capable
473
+ - Achieves goals efficiently
474
+ - Evangelizes to others (because they feel awesome)
475
+ - Continues to grow skills
476
+ - Values the product (because it makes them valuable)
477
+
478
+ **Design Question:** "Does this make the user more badass?"
479
+
480
+ ### 2. Cognitive Resources (The Constraint)
481
+
482
+ **Key Insight:** Users have limited mental energy. Every decision depletes it.
483
+
484
+ **The Cognitive Budget:**
485
+ - User starts day with X units of mental energy
486
+ - Every decision costs energy
487
+ - Complex decisions cost more
488
+ - When depleted: Poor decisions, frustration, giving up
489
+
490
+ **Design Implication:** Reduce unnecessary cognitive load so users have energy for what matters.
491
+
492
+ **How to Reduce Cognitive Load:**
493
+ - Good defaults (no decision needed)
494
+ - Consistent patterns (no re-learning)
495
+ - Clear recommendations ("Most popular" saves analysis)
496
+ - Remove options (paradox of choice)
497
+ - Undo easily (remove fear of mistakes)
498
+
499
+ ### 3. The Suck Zone (The Challenge)
500
+
501
+ **The Suck Zone:** The frustrating phase between "I want to do this" and "I can do this."
502
+
503
+ ```
504
+ Stage 1: "I want to [skill]!" (Excited)
505
+
506
+ Stage 2: "This is harder than I thought..." (Frustrated)
507
+ ↓ [The Suck Zone - most users quit here]
508
+
509
+ Stage 3: "Oh! I get it!" (Breakthrough)
510
+
511
+ Stage 4: "I can do this!" (Competent, Confident)
512
+ ```
513
+
514
+ **Design Goal:** Get users through Suck Zone as fast as possible.
515
+
516
+ **Strategies:**
517
+ - Quick wins early (small success = "I can do this!")
518
+ - Clear progress indicators
519
+ - Guided practice (not theory)
520
+ - Remove unnecessary complexity initially
521
+ - Celebrate every success
522
+
523
+ **Anti-Pattern:** Lengthy tutorials before user does anything = extending Suck Zone
524
+
525
+ ### 4. Perceptual Exposure (The Method)
526
+
527
+ **Key Insight:** Expertise comes from repeated micro-exposures, not comprehensive study.
528
+
529
+ **Example: Bird Watching**
530
+ - Beginner: "That's a bird"
531
+ - Learning: Sees 100 robins (unconsciously absorbs patterns)
532
+ - Expert: "That's a robin" (instant recognition without thought)
533
+
534
+ **Design Application:**
535
+
536
+ Instead of explaining everything upfront:
537
+ - Show patterns repeatedly in context
538
+ - Let users absorb unconsciously
539
+ - Recognize becomes automatic
540
+ - Expertise emerges without feeling like "learning"
541
+
542
+ **Example: Keyboard Shortcuts**
543
+ - Don't make users memorize list
544
+ - Show shortcut hint next to menu item (repeated exposure)
545
+ - User sees "Cmd+S" every time they click Save
546
+ - Eventually: Muscle memory, no thought
547
+
548
+ ### 5. Post-UX (The Context)
549
+
550
+ **Key Insight:** User experience doesn't end when they close your app.
551
+
552
+ **Post-UX Questions:**
553
+ - Did using our product make them better at their goal?
554
+ - Do they feel more capable NOW in their work/life?
555
+ - Did we reduce frustration in their broader context?
556
+ - Are they better off for having used this?
557
+
558
+ **Example: Project Management Tool**
559
+
560
+ **Traditional Metric:** Daily active users
561
+ **Sierra Metric:** Do teams ship better products because they used our tool?
562
+
563
+ **Design Shift:** Optimize for user's life success, not just product engagement.
564
+
565
+ ---
566
+
567
+ ## Common Questions
568
+
569
+ ### Q: Isn't "making users feel capable" just good UX?
570
+
571
+ **A:** It's a specific lens on UX. Traditional UX asks "Can users complete tasks?" Sierra asks "Do users feel awesome doing it?" Subtle but profound difference.
572
+
573
+ ### Q: What if users actually need to learn complex things?
574
+
575
+ **A:** Still applies! Get them to first competence quickly, then progressively reveal depth. Expert features come after beginner confidence. Sierra's "Head First" books teach complex programming this way successfully.
576
+
577
+ ### Q: How do I measure "feeling capable"?
578
+
579
+ **A:**
580
+ - Net Promoter Score (but ask WHY)
581
+ - "Did you achieve your goal?" (confidence question)
582
+ - "How do you feel about your [skill] now?" (capability question)
583
+ - Voluntary advocacy (do users tell others?)
584
+ - Time to first success (crossing Suck Zone)
585
+
586
+ ### Q: What about power users who want all features visible?
587
+
588
+ **A:** Progressive disclosure serves them too. They get there faster because they weren't overwhelmed at start. Plus, power users were once beginners - you're making more power users by not losing them early.
589
+
590
+ ### Q: Isn't "celebrating success" patronizing?
591
+
592
+ **A:** Not if genuine. "You uploaded 5 files" = patronizing. "You're all set! Your team can now access the report" = acknowledging real achievement.
593
+
594
+ ---
595
+
596
+ ## Applying Sierra Principles in Your Design
597
+
598
+ ### Audit Current Design
599
+
600
+ For each screen/component, ask:
601
+
602
+ **Capability:**
603
+ - Does this make user feel capable or confused?
604
+ - What "aha moment" does this create?
605
+ - How quickly do they reach "I can do this"?
606
+
607
+ **Cognitive Load:**
608
+ - How many decisions does this require?
609
+ - Can we reduce them?
610
+ - Are defaults sensible?
611
+ - Is this consistent with elsewhere?
612
+
613
+ **Suck Zone:**
614
+ - How long until first success?
615
+ - What's blocking quick competence?
616
+ - Can we delay complexity?
617
+
618
+ **Post-UX:**
619
+ - Does using this make user better at their real goal?
620
+ - Is their life better for this interaction?
621
+
622
+ ### Redesign Toward Capability
623
+
624
+ **Before:** Feature-focused
625
+ **After:** Capability-focused
626
+
627
+ **Changes:**
628
+ - Microcopy: From system status → user progress
629
+ - Defaults: From neutral → sensible for user goal
630
+ - Errors: From blame → guidance
631
+ - Success: From confirmation → celebration
632
+ - Order: From complete → progressive
633
+ - Focus: From product → user becoming badass
634
+
635
+ ---
636
+
637
+ ## Sierra Principles Checklist
638
+
639
+ **For Any Design:**
640
+
641
+ - [ ] Does this make the user feel smart?
642
+ - [ ] Have we reduced cognitive load?
643
+ - [ ] Can user succeed quickly (cross Suck Zone)?
644
+ - [ ] Are we revealing complexity progressively?
645
+ - [ ] Does microcopy build confidence?
646
+ - [ ] Do errors guide without blaming?
647
+ - [ ] Do successes feel like user's achievement?
648
+ - [ ] Are defaults sensible for user's goal?
649
+ - [ ] Does this work with how brains actually work?
650
+ - [ ] Will user be better at their real goal after this?
651
+
652
+ **If you answered "no" to any:** Redesign opportunity.
653
+
654
+ ---
655
+
656
+ ## Next Steps
657
+
658
+ 1. **Read:** "Badass: Making Users Awesome" by Kathy Sierra
659
+ 2. **Archive:** Browse her old blog "Creating Passionate Users"
660
+ 3. **Audit:** Choose one component - does it make users feel capable?
661
+ 4. **Redesign:** Rewrite microcopy for one flow with capability focus
662
+ 5. **Test:** Do users feel more confident after new version?
663
+
664
+ **Related Resources:**
665
+ - [Value Trigger Chain Guide](../method/value-trigger-chain-guide.md) - Driving forces include capability desires
666
+ - [Action Mapping Model](./action-mapping.md) - Similar philosophy: focus on what users DO
667
+ - [Phase 4: UX Design Guide](../method/phase-4-ux-design-guide.md) - Scenario design with user capability in mind
668
+
669
+ ---
670
+
671
+ *Kathy Sierra Principles - Don't make a better product. Make users better at what they want to do.*
672
+