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.
- package/LICENSE +27 -0
- package/README.md +196 -0
- package/docs/getting-started/MANUAL-INIT-GUIDE.md +251 -0
- package/docs/getting-started/about-wds.md +86 -0
- package/docs/getting-started/agent-activation/activation/step-01-load-agent-definition.md +28 -0
- package/docs/getting-started/agent-activation/activation/step-02-check-conversations.md +43 -0
- package/docs/getting-started/agent-activation/activation/step-03-check-activation-context.md +42 -0
- package/docs/getting-started/agent-activation/activation/step-04-handoff-presentation.md +30 -0
- package/docs/getting-started/agent-activation/activation/step-04-standard-presentation.md +27 -0
- package/docs/getting-started/agent-activation/activation/step-05-handoff-acknowledge.md +34 -0
- package/docs/getting-started/agent-activation/activation/step-05-standard-analysis.md +26 -0
- package/docs/getting-started/agent-activation/agent-launchers.md +134 -0
- package/docs/getting-started/agent-activation/wds-freya-ux.md +67 -0
- package/docs/getting-started/agent-activation/wds-idunn-pm.md +67 -0
- package/docs/getting-started/agent-activation/wds-mimir.md +78 -0
- package/docs/getting-started/agent-activation/wds-saga-analyst.md +65 -0
- package/docs/getting-started/getting-started-overview.md +112 -0
- package/docs/getting-started/installation.md +62 -0
- package/docs/getting-started/quick-start.md +125 -0
- package/docs/getting-started/where-to-go-next.md +137 -0
- package/docs/learn-wds/00-course-overview/00-getting-started-overview.md +66 -0
- package/docs/learn-wds/00-course-overview/01-prerequisites.md +98 -0
- package/docs/learn-wds/00-course-overview/02-learning-paths.md +99 -0
- package/docs/learn-wds/00-course-overview/03-support.md +128 -0
- package/docs/learn-wds/00-course-overview.md +211 -0
- package/docs/learn-wds/Webinars/2024-12-22-WDS-Jam-1-Say-Hello-to-AI-Agent-Framework.md +0 -0
- package/docs/learn-wds/Webinars/2024-12-22-WDS-Sessions-1-Say-Hello-to-WDS.md +174 -0
- package/docs/learn-wds/Webinars/2025-10-22-Webinar-WDS-v4.md +181 -0
- package/docs/learn-wds/Webinars/2026-01-15-WDS-Sessions-2-Strategy-in-Practice.md +159 -0
- package/docs/learn-wds/course-explainers/Module 00-transcript.srt +635 -0
- package/docs/learn-wds/course-explainers/Module 02-transcript.srt +807 -0
- package/docs/learn-wds/course-explainers/Module-00-notebook-lm-prompt.md +250 -0
- package/docs/learn-wds/course-explainers/Module-00-thumbnail-prompt.md +33 -0
- package/docs/learn-wds/course-explainers/Module-00-youtube-show-notes.md +78 -0
- package/docs/learn-wds/course-explainers/Module-01-notebook-lm-prompt.md +418 -0
- package/docs/learn-wds/course-explainers/Module-01-thumbnail-prompt.md +33 -0
- package/docs/learn-wds/course-explainers/Module-01-transcript.srt +731 -0
- package/docs/learn-wds/course-explainers/Module-02-notebook-lm-prompt.md +342 -0
- package/docs/learn-wds/course-explainers/Module-02-thumbnail-prompt.md +34 -0
- package/docs/learn-wds/course-explainers/Module-03-notebook-lm-prompt.md +745 -0
- package/docs/learn-wds/course-explainers/Module-03-thumbnail-prompt.md +33 -0
- package/docs/learn-wds/course-explainers/Module-03-transcript.srt +595 -0
- package/docs/learn-wds/course-explainers/Module-04-notebook-lm-prompt.md +163 -0
- package/docs/learn-wds/course-explainers/Module-04-thumbnail-prompt.md +36 -0
- package/docs/learn-wds/course-explainers/Module-04-youtube-show-notes.md +95 -0
- package/docs/learn-wds/course-explainers/Module-05-notebook-lm-prompt.md +274 -0
- package/docs/learn-wds/course-explainers/Module-05-thumbnail-prompt.md +40 -0
- package/docs/learn-wds/course-explainers/Module-05-youtube-show-notes.md +65 -0
- package/docs/learn-wds/course-explainers/module-01-YOUTUBE-SHOW-NOTES.md +75 -0
- package/docs/learn-wds/course-explainers/module-02-YOUTUBE-SHOW-NOTES.md +86 -0
- package/docs/learn-wds/course-explainers/module-03-YOUTUBE-SHOW-NOTES.md +82 -0
- package/docs/learn-wds/course-explainers/trigger-map-example.jpg +0 -0
- package/docs/learn-wds/module-01-why-wds-matters/lesson-01-the-problem.md +113 -0
- package/docs/learn-wds/module-01-why-wds-matters/lesson-02-the-solution.md +75 -0
- package/docs/learn-wds/module-01-why-wds-matters/lesson-03-the-path-forward.md +94 -0
- package/docs/learn-wds/module-01-why-wds-matters/module-01-overview.md +109 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-lesson.md +124 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/01-quick-checklist.md +63 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-01-git-setup/02-full-lesson.md +124 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/checklist.md +87 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-01-github-and-ide-setup/lesson.md +203 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-01-setting-up-github/checklist.md +70 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-git-configuration/checklist.md +40 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/01-quick-checklist.md +48 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-full-lesson.md +88 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-lesson.md +88 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-ide-installation/02-quick-checklist.md +48 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/checklist.md +48 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-02-install-ide/tutorial.md +149 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/01-quick-checklist.md +51 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/02-full-lesson.md +111 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-lesson.md +111 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-03-git-cloning/03-quick-checklist.md +51 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/checklist.md +41 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-03-git-setup/tutorial.md +159 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/checklist.md +93 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-04-clone-and-wds/tutorial.md +217 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/01-quick-checklist.md +73 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/02-full-lesson.md +206 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-lesson.md +206 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-04-wds-initialization/04-quick-checklist.md +73 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/checklist.md +79 -0
- package/docs/learn-wds/module-02-installation-setup/lesson-05-initiate-mimir/tutorial.md +244 -0
- package/docs/learn-wds/module-02-installation-setup/module-02-overview.md +77 -0
- package/docs/learn-wds/module-03-alignment-signoff/lesson-01-understanding-alignment.md +175 -0
- package/docs/learn-wds/module-03-alignment-signoff/lesson-02-creating-alignment-document.md +289 -0
- package/docs/learn-wds/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md +115 -0
- package/docs/learn-wds/module-03-alignment-signoff/lesson-04-external-contracts.md +201 -0
- package/docs/learn-wds/module-03-alignment-signoff/lesson-05-internal-signoff.md +189 -0
- package/docs/learn-wds/module-03-alignment-signoff/module-03-overview.md +170 -0
- package/docs/learn-wds/module-03-alignment-signoff/tutorial-03.md +344 -0
- package/docs/learn-wds/module-04-product-brief/lesson-01-chaos-problem.md +193 -0
- package/docs/learn-wds/module-04-product-brief/lesson-02-five-questions.md +364 -0
- package/docs/learn-wds/module-04-product-brief/lesson-03-document-structure.md +388 -0
- package/docs/learn-wds/module-04-product-brief/lesson-04-wds-advantage.md +402 -0
- package/docs/learn-wds/module-04-product-brief/lesson-05-using-brief.md +491 -0
- package/docs/learn-wds/module-04-product-brief/lesson-06-additional-documents.md +645 -0
- package/docs/learn-wds/module-04-product-brief/module-04-overview.md +194 -0
- package/docs/learn-wds/module-04-product-brief/tutorial-04.md +400 -0
- package/docs/learn-wds/module-05-map-triggers-outcomes/tutorial-04.md +460 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-01-missing-link.md +237 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-02-heritage-evolution.md +364 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-03-five-workshops-overview.md +459 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-04-workshop-1-business-goals.md +274 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-05-workshop-2-target-groups.md +504 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-06-workshop-3-driving-forces.md +458 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-07-workshop-4-prioritization.md +313 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-08-workshop-5-feature-impact.md +474 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-09-positive-negative-drivers.md +348 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-10-visual-trigger-map.md +411 -0
- package/docs/learn-wds/module-05-trigger-mapping/lesson-11-feature-impact-scoring.md +403 -0
- package/docs/learn-wds/module-05-trigger-mapping/module-05-overview.md +283 -0
- package/docs/learn-wds/module-05-trigger-mapping/tutorial-05.md +595 -0
- package/docs/learn-wds/module-05-trigger-mapping/tutorial-05b-value-trigger-chain.md +393 -0
- package/docs/learn-wds/module-05-trigger-mapping/tutorial-05c-documentation-synthesis.md +475 -0
- package/docs/learn-wds/module-06-platform-architecture/tutorial-06.md +358 -0
- package/docs/learn-wds/module-08-initialize-scenario/tutorial-08.md +521 -0
- package/docs/learn-wds/module-09-design-system/tutorial-09.md +515 -0
- package/docs/learn-wds/module-10-design-delivery/tutorial-10.md +604 -0
- package/docs/learn-wds/module-12-conceptual-specs/tutorial-12.md +734 -0
- package/docs/method/content-creation-philosophy.md +311 -0
- package/docs/method/content-purpose-guide.md +436 -0
- package/docs/method/phase-1-product-exploration-guide.md +178 -0
- package/docs/method/phase-2-trigger-mapping-guide.md +399 -0
- package/docs/method/phase-3-prd-platform-guide.md +284 -0
- package/docs/method/phase-4-ux-design-guide.md +388 -0
- package/docs/method/phase-5-design-system-guide.md +916 -0
- package/docs/method/phase-6-prd-finalization-guide.md +510 -0
- package/docs/method/tone-of-voice-guide.md +466 -0
- package/docs/method/value-trigger-chain-guide.md +474 -0
- package/docs/method/wds-method-guide.md +378 -0
- package/docs/models/action-mapping.md +681 -0
- package/docs/models/customer-awareness-cycle.md +530 -0
- package/docs/models/golden-circle.md +532 -0
- package/docs/models/gtd-getting-things-done.md +193 -0
- package/docs/models/impact-effect-mapping.md +600 -0
- package/docs/models/kathy-sierra-badass-users.md +672 -0
- package/docs/models/models-guide.md +297 -0
- package/docs/models/smart-goals-model.md +294 -0
- package/docs/tools/cursor-windsurf.md +190 -0
- package/docs/tools/figma-mcp.md +453 -0
- package/docs/tools/figma.md +212 -0
- package/docs/tools/git.md +285 -0
- package/docs/tools/html-to-design.md +185 -0
- package/docs/tools/nanobanana.md +240 -0
- package/docs/tools/prepare-for-figma-export.md +690 -0
- package/docs/tools/wds-tools-guide.md +115 -0
- package/package.json +114 -0
- package/src/agents/freya-ux.agent.yaml +128 -0
- package/src/agents/idunn-pm.agent.yaml +94 -0
- package/src/agents/mimir-orchestrator.agent.yaml +139 -0
- package/src/agents/saga-analyst.agent.yaml +128 -0
- package/src/data/agent-guides/freya/agentic-development.md +200 -0
- package/src/data/agent-guides/freya/content-creation.md +270 -0
- package/src/data/agent-guides/freya/design-system.md +336 -0
- package/src/data/agent-guides/freya/meta-content-guide.md +483 -0
- package/src/data/agent-guides/freya/specification-quality.md +250 -0
- package/src/data/agent-guides/freya/strategic-design.md +118 -0
- package/src/data/agent-guides/idunn/design-handoffs.md +411 -0
- package/src/data/agent-guides/idunn/platform-requirements.md +351 -0
- package/src/data/agent-guides/mimir/emotional-intelligence.md +295 -0
- package/src/data/agent-guides/mimir/teaching-styles.md +286 -0
- package/src/data/agent-guides/mimir/wds-overview.md +369 -0
- package/src/data/agent-guides/saga/discovery-conversation.md +245 -0
- package/src/data/agent-guides/saga/strategic-documentation.md +456 -0
- package/src/data/agent-guides/saga/trigger-mapping.md +403 -0
- package/src/data/design-system/component-boundaries.md +318 -0
- package/src/data/design-system/figma-component-structure.md +697 -0
- package/src/data/design-system/naming-conventions.md +200 -0
- package/src/data/design-system/state-management.md +93 -0
- package/src/data/design-system/token-architecture.md +474 -0
- package/src/data/design-system/validation-patterns.md +74 -0
- package/src/data/presentations/freya-intro.md +275 -0
- package/src/data/presentations/freya-presentation.md +78 -0
- package/src/data/presentations/idunn-intro.md +231 -0
- package/src/data/presentations/idunn-presentation.md +80 -0
- package/src/data/presentations/mimir-presentation.md +123 -0
- package/src/data/presentations/saga-intro.md +285 -0
- package/src/data/presentations/saga-presentation.md +75 -0
- package/src/gems/eira-visual-designer.md +571 -0
- package/src/module.yaml +111 -0
- package/src/templates/design-delivery.template.yaml +104 -0
- package/src/templates/platform-requirements.template.yaml +69 -0
- package/src/templates/test-scenario.template.yaml +192 -0
- package/src/workflows/00-system/FILE-NAMING-CONVENTIONS.md +286 -0
- package/src/workflows/00-system/INSTRUCTION-FILE-GUIDELINES.md +284 -0
- package/src/workflows/00-system/SPECIFICATION-FORMATTING-STANDARDS.md +516 -0
- package/src/workflows/00-system/language-configuration-guide.md +472 -0
- package/src/workflows/00-system/language-flow-diagram.md +446 -0
- package/src/workflows/00-system/wds-workflow-status-template.yaml +106 -0
- package/src/workflows/1-project-brief/alignment-signoff/contract.template.md +297 -0
- package/src/workflows/1-project-brief/alignment-signoff/pitch.template.md +101 -0
- package/src/workflows/1-project-brief/alignment-signoff/section-guide.md +212 -0
- package/src/workflows/1-project-brief/alignment-signoff/service-agreement.template.md +277 -0
- package/src/workflows/1-project-brief/alignment-signoff/signoff.template.md +188 -0
- package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-01-start.md +81 -0
- package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-01.5-extract-communications.md +78 -0
- package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-02-explore-sections.md +159 -0
- package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-03-synthesize.md +48 -0
- package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-03.5-generate-contract.md +87 -0
- package/src/workflows/1-project-brief/alignment-signoff/steps-c/step-04-present-for-approval.md +89 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md +27 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/02-determine-if-needed.md +32 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/03-offer-extract-communications.md +31 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/04-extract-info.md +39 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/05-detect-starting-point.md +34 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/06-explore-realization.md +45 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/07-explore-solution.md +25 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/08-explore-why-it-matters.md +33 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/09-explore-how-we-see-it-working.md +29 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/10-explore-paths-we-explored.md +28 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/11-explore-recommended-solution.md +26 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/12-explore-path-forward.md +38 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/13-explore-value-we-create.md +40 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/14-explore-cost-of-inaction.md +37 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/15-explore-our-commitment.md +33 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/16-explore-summary.md +26 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/17-reflect-back.md +33 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18-synthesize-document.md +41 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18.5-create-vtc.md +76 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/19-present-for-approval.md +44 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/20-offer-signoff-document.md +38 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/21-determine-business-model.md +50 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/22-build-section-01-project-overview.md +29 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/23-build-section-02-business-model.md +66 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/24-build-section-03-scope-of-work.md +46 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/25-build-section-04-payment-terms.md +81 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/26-build-section-05-timeline.md +31 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/27-build-section-06-availability.md +38 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/28-build-section-07-confidentiality.md +42 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/29-build-section-08-not-to-exceed.md +54 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/30-build-section-09-work-initiation.md +41 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/31-build-section-10-terms-and-conditions.md +38 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/32-build-section-11-approval.md +36 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/33-finalize-contract.md +40 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/34-build-internal-signoff.md +65 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/35-finalize-signoff.md +39 -0
- package/src/workflows/1-project-brief/alignment-signoff/substeps/substeps-guide.md +81 -0
- package/src/workflows/1-project-brief/alignment-signoff/validation-report-alignment-signoff.md +360 -0
- package/src/workflows/1-project-brief/alignment-signoff/workflow.md +157 -0
- package/src/workflows/1-project-brief/complete/validation-report-complete.md +142 -0
- package/src/workflows/1-project-brief/complete/workflow.md +60 -0
- package/src/workflows/1-project-brief/handover/instructions.md +16 -0
- package/src/workflows/1-project-brief/handover/steps/step-01-analyze-brief.md +31 -0
- package/src/workflows/1-project-brief/handover/steps/step-02-create-summary.md +46 -0
- package/src/workflows/1-project-brief/handover/steps/step-03-provide-activation.md +44 -0
- package/src/workflows/1-project-brief/project-brief/complete/instructions.md +273 -0
- package/src/workflows/1-project-brief/project-brief/complete/project-brief.template.md +193 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-01-init.md +35 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-02-vision.md +43 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-03-positioning.md +34 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-04-create-vtc.md +118 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-05-business-model.md +26 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-06-business-customers.md +28 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-07-target-users.md +40 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-08-success-criteria.md +40 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-09-competitive-landscape.md +42 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-10-constraints.md +43 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-10a-platform-strategy.md +73 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-11-create-vtc.md +133 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-11-tone-of-voice.md +233 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/step-12-synthesize.md +44 -0
- package/src/workflows/1-project-brief/project-brief/complete/steps-c/substeps/11-tone-of-voice-example.md +52 -0
- package/src/workflows/1-project-brief/project-brief/complete/workflow.md +60 -0
- package/src/workflows/1-project-brief/project-brief/simplified/instructions.md +126 -0
- package/src/workflows/1-project-brief/project-brief/simplified/simplified-brief.template.md +44 -0
- package/src/workflows/1-project-brief/project-brief/validation-report-project-brief.md +343 -0
- package/src/workflows/1-project-brief/workflow.yaml +37 -0
- package/src/workflows/2-trigger-mapping/REVIEW-FINDINGS.md +160 -0
- package/src/workflows/2-trigger-mapping/document-generation/instructions.md +16 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-01-generate-hub.md +188 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-02-generate-business-goals.md +231 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03a-generate-primary-persona.md +96 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03b-generate-secondary-persona.md +104 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-03c-generate-tertiary-persona.md +96 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-04-generate-key-insights.md +88 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/step-05-quality-check.md +68 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/substeps/04-key-insights-structure.md +222 -0
- package/src/workflows/2-trigger-mapping/document-generation/steps-c/substeps/05-quality-checklist.md +212 -0
- package/src/workflows/2-trigger-mapping/document-generation/templates/persona-document-template.md +485 -0
- package/src/workflows/2-trigger-mapping/document-generation/validation-report-document-generation.md +321 -0
- package/src/workflows/2-trigger-mapping/document-generation/workflow.md +66 -0
- package/src/workflows/2-trigger-mapping/handover/instructions.md +15 -0
- package/src/workflows/2-trigger-mapping/handover/steps/step-01-finalize-hub.md +25 -0
- package/src/workflows/2-trigger-mapping/handover/steps/step-02-add-cross-references.md +27 -0
- package/src/workflows/2-trigger-mapping/handover/steps/step-03-quality-check.md +25 -0
- package/src/workflows/2-trigger-mapping/handover/steps/step-04-create-handover-package.md +73 -0
- package/src/workflows/2-trigger-mapping/handover/steps/step-05-provide-activation.md +64 -0
- package/src/workflows/2-trigger-mapping/instructions.md +159 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/instructions.md +28 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-01-initialize-structure.md +84 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-02-format-business-goals.md +86 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-03-format-platform.md +94 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-04-format-target-groups.md +113 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-05-format-driving-forces.md +118 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-06-create-connections.md +136 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-07-apply-styling.md +171 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/steps-c/step-08-quality-check.md +183 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/validation-report-mermaid-diagram.md +185 -0
- package/src/workflows/2-trigger-mapping/mermaid-diagram/workflow.md +70 -0
- package/src/workflows/2-trigger-mapping/micro-instructions-mermaid-diagram.md +262 -0
- package/src/workflows/2-trigger-mapping/templates/feature-impact.template.md +47 -0
- package/src/workflows/2-trigger-mapping/templates/trigger-map.template.md +169 -0
- package/src/workflows/2-trigger-mapping/workflow.yaml +55 -0
- package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/instructions.md +140 -0
- package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-01-business-goals.md +124 -0
- package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-02-target-groups.md +143 -0
- package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-03-driving-forces.md +133 -0
- package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-04-prioritization.md +130 -0
- package/src/workflows/2-trigger-mapping/workshops/0-documentation-synthesis/step-05-gap-analysis.md +141 -0
- package/src/workflows/2-trigger-mapping/workshops/1-business-goals/instructions.md +106 -0
- package/src/workflows/2-trigger-mapping/workshops/2-target-groups/instructions.md +106 -0
- package/src/workflows/2-trigger-mapping/workshops/3-driving-forces/instructions.md +130 -0
- package/src/workflows/2-trigger-mapping/workshops/4-prioritization/instructions.md +203 -0
- package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/instructions.md +24 -0
- package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-01-extract-features.md +52 -0
- package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-02-confirm-assessment.md +41 -0
- package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-03-make-assessment.md +84 -0
- package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-04-generate-document.md +81 -0
- package/src/workflows/2-trigger-mapping/workshops/5-feature-impact/steps/step-05-wrap-up.md +55 -0
- package/src/workflows/3-prd-platform/handover/instructions.md +16 -0
- package/src/workflows/3-prd-platform/handover/steps/step-01-compile-deliverables.md +38 -0
- package/src/workflows/3-prd-platform/handover/steps/step-02-extract-epic-structure.md +30 -0
- package/src/workflows/3-prd-platform/handover/steps/step-03-prepare-prd-materials.md +31 -0
- package/src/workflows/3-prd-platform/handover/steps/step-04-create-handover-package.md +57 -0
- package/src/workflows/3-prd-platform/handover/steps/step-05-provide-activation.md +68 -0
- package/src/workflows/3-prd-platform/instructions.md +1161 -0
- package/src/workflows/3-prd-platform/templates/experimental-endpoints.template.md +221 -0
- package/src/workflows/3-prd-platform/templates/platform-architecture.template.md +159 -0
- package/src/workflows/3-prd-platform/templates/technical-constraints.template.md +191 -0
- package/src/workflows/3-prd-platform/workflow.yaml +39 -0
- package/src/workflows/4-ux-design/ARCHITECTURE.md +275 -0
- package/src/workflows/4-ux-design/COMPONENT-FILE-STRUCTURE.md +742 -0
- package/src/workflows/4-ux-design/CONCEPTUAL-SPECIFICATIONS.md +557 -0
- package/src/workflows/4-ux-design/CONTENT-PLACEMENT-GUIDE.md +552 -0
- package/src/workflows/4-ux-design/CROSS-PAGE-CONSISTENCY.md +301 -0
- package/src/workflows/4-ux-design/DOCUMENTATION-ARCHITECTURE.md +161 -0
- package/src/workflows/4-ux-design/HTML-VS-VISUAL-STYLES.md +243 -0
- package/src/workflows/4-ux-design/IMAGE-SKETCHING-BEST-PRACTICES.md +272 -0
- package/src/workflows/4-ux-design/PROACTIVE-TRANSLATION-WORKFLOW.md +447 -0
- package/src/workflows/4-ux-design/SKETCH-FIRST-IMPLEMENTATION-PLAN.md +617 -0
- package/src/workflows/4-ux-design/SKETCH-TEXT-ANALYSIS-GUIDE.md +532 -0
- package/src/workflows/4-ux-design/SKETCH-TEXT-QUICK-REFERENCE.md +222 -0
- package/src/workflows/4-ux-design/SKETCH-TEXT-STRATEGY.md +509 -0
- package/src/workflows/4-ux-design/STORYBOARD-INTEGRATION.md +714 -0
- package/src/workflows/4-ux-design/TRANSLATION-ORGANIZATION-GUIDE.md +513 -0
- package/src/workflows/4-ux-design/WDS-SPECIFICATION-PATTERN.md +436 -0
- package/src/workflows/4-ux-design/agentic-development/guides/AGENTIC-DEVELOPMENT-GUIDE.md +380 -0
- package/src/workflows/4-ux-design/agentic-development/guides/CREATION-GUIDE.md +1148 -0
- package/src/workflows/4-ux-design/agentic-development/guides/FILE-INDEX.md +212 -0
- package/src/workflows/4-ux-design/agentic-development/guides/PROTOTYPE-ANALYSIS.md +832 -0
- package/src/workflows/4-ux-design/agentic-development/guides/PROTOTYPE-INITIATION-DIALOG.md +409 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/1-prototype-setup.md +95 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/2-scenario-analysis.md +174 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/3-logical-view-breakdown.md +197 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4a-announce-and-gather.md +69 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4b-create-story-file.md +144 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4c-implement-section.md +113 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4d-present-for-testing.md +68 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4e-handle-issue.md +85 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4f-handle-improvement.md +104 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/4g-section-approved.md +146 -0
- package/src/workflows/4-ux-design/agentic-development/steps-c/5-finalization.md +158 -0
- package/src/workflows/4-ux-design/agentic-development/templates/PROTOTYPE-ROADMAP-template.md +382 -0
- package/src/workflows/4-ux-design/agentic-development/templates/components/DEV-MODE-GUIDE.md +189 -0
- package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.css +164 -0
- package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.html +18 -0
- package/src/workflows/4-ux-design/agentic-development/templates/components/dev-mode.js +430 -0
- package/src/workflows/4-ux-design/agentic-development/templates/demo-data-template.json +63 -0
- package/src/workflows/4-ux-design/agentic-development/templates/page-template.html +465 -0
- package/src/workflows/4-ux-design/agentic-development/templates/story-file-template.md +167 -0
- package/src/workflows/4-ux-design/agentic-development/templates/work-file-template.yaml +264 -0
- package/src/workflows/4-ux-design/agentic-development/validation-report-agentic-development.md +251 -0
- package/src/workflows/4-ux-design/agentic-development/workflow.md +631 -0
- package/src/workflows/4-ux-design/excalidraw-integration/guides/ai-collaboration.md +565 -0
- package/src/workflows/4-ux-design/excalidraw-integration/guides/excalidraw-guide.md +320 -0
- package/src/workflows/4-ux-design/excalidraw-integration/guides/excalidraw-setup.md +529 -0
- package/src/workflows/4-ux-design/excalidraw-integration/guides/export-workflow.md +563 -0
- package/src/workflows/4-ux-design/excalidraw-integration/guides/sketching-guide.md +693 -0
- package/src/workflows/4-ux-design/excalidraw-integration/validation-report-excalidraw-integration.md +208 -0
- package/src/workflows/4-ux-design/excalidraw-integration/workflow.md +226 -0
- package/src/workflows/4-ux-design/handover/instructions.md +15 -0
- package/src/workflows/4-ux-design/handover/steps/step-01-analyze-scenarios.md +32 -0
- package/src/workflows/4-ux-design/handover/steps/step-01-identify-delivery-scope.md +61 -0
- package/src/workflows/4-ux-design/handover/steps/step-02-create-summary.md +59 -0
- package/src/workflows/4-ux-design/handover/steps/step-02-extract-technical-needs.md +33 -0
- package/src/workflows/4-ux-design/handover/steps/step-03-create-delivery-package.md +79 -0
- package/src/workflows/4-ux-design/handover/steps/step-03-provide-activation.md +47 -0
- package/src/workflows/4-ux-design/handover/steps/step-04-log-delivery.md +41 -0
- package/src/workflows/4-ux-design/handover/steps/step-05-provide-activation.md +75 -0
- package/src/workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md +71 -0
- package/src/workflows/4-ux-design/modular-architecture/00-foundation/agent-designer-collaboration.md +488 -0
- package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/complexity-detection.md +123 -0
- package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/content-placement-rules.md +144 -0
- package/src/workflows/4-ux-design/modular-architecture/01-core-concepts/three-tier-overview.md +144 -0
- package/src/workflows/4-ux-design/modular-architecture/02-workflows/01-what-are-storyboards.md +70 -0
- package/src/workflows/4-ux-design/modular-architecture/02-workflows/01-when-to-use.md +68 -0
- package/src/workflows/4-ux-design/modular-architecture/02-workflows/02-file-structure.md +86 -0
- package/src/workflows/4-ux-design/modular-architecture/02-workflows/complexity-router-workflow.md +155 -0
- package/src/workflows/4-ux-design/modular-architecture/02-workflows/page-specification-workflow.md +312 -0
- package/src/workflows/4-ux-design/modular-architecture/02-workflows/storyboards-guide.md +75 -0
- package/src/workflows/4-ux-design/modular-architecture/03-quick-refs/benefits.md +128 -0
- package/src/workflows/4-ux-design/modular-architecture/03-quick-refs/decision-tree.md +67 -0
- package/src/workflows/4-ux-design/modular-architecture/validation-report-modular-architecture.md +220 -0
- package/src/workflows/4-ux-design/modular-architecture/workflow.md +289 -0
- package/src/workflows/4-ux-design/object-types/COMPLEXITY-ROUTER.md +842 -0
- package/src/workflows/4-ux-design/object-types/ROUTER-FLOW-DIAGRAM.md +275 -0
- package/src/workflows/4-ux-design/object-types/TEXT-DETECTION-PRIORITY.md +391 -0
- package/src/workflows/4-ux-design/object-types/object-router.md +349 -0
- package/src/workflows/4-ux-design/object-types/templates/button.md +345 -0
- package/src/workflows/4-ux-design/object-types/templates/heading-text.md +549 -0
- package/src/workflows/4-ux-design/object-types/templates/image.md +165 -0
- package/src/workflows/4-ux-design/object-types/templates/link.md +167 -0
- package/src/workflows/4-ux-design/object-types/templates/text-input.md +463 -0
- package/src/workflows/4-ux-design/object-types/validation-report-object-types.md +295 -0
- package/src/workflows/4-ux-design/object-types/workflow.md +439 -0
- package/src/workflows/4-ux-design/page-specification-quality/data/validation-standards.md +215 -0
- package/src/workflows/4-ux-design/page-specification-quality/instructions.md +32 -0
- package/src/workflows/4-ux-design/page-specification-quality/quality-guide.md +653 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-01-page-metadata.md +55 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-02-navigation.md +54 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-03-page-overview.md +47 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-04-page-sections.md +58 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-05-section-order.md +59 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-06-object-registry.md +52 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-07-design-system-separation.md +64 -0
- package/src/workflows/4-ux-design/page-specification-quality/steps-v/step-08-final-validation.md +92 -0
- package/src/workflows/4-ux-design/page-specification-quality/templates/diagnostic-report-template.md +227 -0
- package/src/workflows/4-ux-design/page-specification-quality/validation-report-page-specification-quality.md +357 -0
- package/src/workflows/4-ux-design/page-specification-quality/workflow.md +146 -0
- package/src/workflows/4-ux-design/scenario-init/SCENARIO-INIT-DIALOG.md +538 -0
- package/src/workflows/4-ux-design/scenario-init/SCENARIO-INIT-PROCESS.md +221 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/00-SCENARIO-INIT-GUIDE.md +76 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/01-platform-confirmation.md +167 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/02-feature-selection.md +70 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/03-entry-point.md +67 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/04-mental-state.md +74 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/05-mutual-success.md +69 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/06-shortest-path.md +92 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/07-create-vtc.md +132 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/examples/booking-example.md +64 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/examples/ecommerce-example.md +64 -0
- package/src/workflows/4-ux-design/scenario-init/steps-c/examples/saas-example.md +64 -0
- package/src/workflows/4-ux-design/scenario-init/validation-report-scenario-init.md +290 -0
- package/src/workflows/4-ux-design/scenario-init/workflow.md +117 -0
- package/src/workflows/4-ux-design/specification-audit-workflow.md +697 -0
- package/src/workflows/4-ux-design/steps/step-01-init.md +116 -0
- package/src/workflows/4-ux-design/steps/step-02-setup-scenario-structure.md +67 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/page-init-lightweight.md +355 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-01-page-context.md +61 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-02-page-name.md +26 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-03-page-purpose.md +25 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-04-entry-point.md +27 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-05-mental-state.md +22 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-06-desired-outcome.md +22 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-07-variants.md +29 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/step-08-create-page-structure.md +141 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-c-placeholder-pages.md +406 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-page-creation.md +578 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/page-init/workshop-page-process.md +333 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-01-core-feature.md +26 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-02-entry-point.md +26 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-03-mental-state.md +24 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-04-mutual-success.md +27 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-05-shortest-path.md +39 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-06-scenario-name.md +24 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/scenario-init/step-07-create-scenario-folder.md +145 -0
- package/src/workflows/4-ux-design/steps/step-02-substeps/substeps-guide.md +110 -0
- package/src/workflows/4-ux-design/steps/step-03-design-page.md +189 -0
- package/src/workflows/4-ux-design/steps/step-04-complete-scenario.md +59 -0
- package/src/workflows/4-ux-design/steps/step-05-next-steps.md +76 -0
- package/src/workflows/4-ux-design/stitch-generation/stitch-prompt.template.md +174 -0
- package/src/workflows/4-ux-design/stitch-generation/workflow.md +288 -0
- package/src/workflows/4-ux-design/substeps/4a-exploration.md +106 -0
- package/src/workflows/4-ux-design/substeps/4b-sketch-analysis.md +536 -0
- package/src/workflows/4-ux-design/substeps/4c-01-page-basics.md +59 -0
- package/src/workflows/4-ux-design/substeps/4c-02-layout-sections.md +66 -0
- package/src/workflows/4-ux-design/substeps/4c-03-components-objects.md +154 -0
- package/src/workflows/4-ux-design/substeps/4c-04-content-languages.md +83 -0
- package/src/workflows/4-ux-design/substeps/4c-05-interactions.md +82 -0
- package/src/workflows/4-ux-design/substeps/4c-06-states.md +125 -0
- package/src/workflows/4-ux-design/substeps/4c-07-validation.md +124 -0
- package/src/workflows/4-ux-design/substeps/4c-08-generate-spec.md +105 -0
- package/src/workflows/4-ux-design/substeps/4d-prototype.md +282 -0
- package/src/workflows/4-ux-design/substeps/4e-prd-update.md +139 -0
- package/src/workflows/4-ux-design/templates/audit-report.template.md +430 -0
- package/src/workflows/4-ux-design/templates/instructions/accessibility-audit.workflow.md +166 -0
- package/src/workflows/4-ux-design/templates/instructions/accessibility.instructions.md +102 -0
- package/src/workflows/4-ux-design/templates/instructions/data-api.instructions.md +69 -0
- package/src/workflows/4-ux-design/templates/instructions/form-validation.instructions.md +54 -0
- package/src/workflows/4-ux-design/templates/instructions/meta-content.instructions.md +37 -0
- package/src/workflows/4-ux-design/templates/instructions/open-questions.instructions.md +164 -0
- package/src/workflows/4-ux-design/templates/instructions/responsive.instructions.md +64 -0
- package/src/workflows/4-ux-design/templates/page-specification.template.md +227 -0
- package/src/workflows/4-ux-design/templates/scenario-overview.template.md +159 -0
- package/src/workflows/4-ux-design/templates/storyboard-specification.template.md +94 -0
- package/src/workflows/4-ux-design/ux-design-guide.md +223 -0
- package/src/workflows/4-ux-design/workflow-new.yaml +18 -0
- package/src/workflows/4-ux-design/workflow.md +61 -0
- package/src/workflows/4-ux-design/workflow.yaml +18 -0
- package/src/workflows/5-design-system/assessment/01-scan-existing.md +166 -0
- package/src/workflows/5-design-system/assessment/02-compare-attributes.md +287 -0
- package/src/workflows/5-design-system/assessment/03-calculate-similarity.md +357 -0
- package/src/workflows/5-design-system/assessment/04-identify-opportunities.md +339 -0
- package/src/workflows/5-design-system/assessment/05-identify-risks.md +357 -0
- package/src/workflows/5-design-system/assessment/06-present-decision.md +435 -0
- package/src/workflows/5-design-system/assessment/07-execute-decision.md +523 -0
- package/src/workflows/5-design-system/design-system-guide.md +353 -0
- package/src/workflows/5-design-system/design-system-router.md +370 -0
- package/src/workflows/5-design-system/figma-integration/INTEGRATION-SUMMARY.md +458 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-connection-check.md +118 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-01-plugin-installation.md +37 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-02-activate-plugin.md +37 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-01-substeps/substep-03-verify-mcp.md +51 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-02-identify-export-type.md +161 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-prepare-specifications.md +138 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-01-analyze-code.md +62 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-02-generate-ids.md +69 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-03-create-spec.md +98 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-03-substeps/substep-04-review-spec.md +86 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-04-generate-validate.md +207 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/steps/step-05-execute-export.md +229 -0
- package/src/workflows/5-design-system/figma-integration/code-to-figma/workflow.md +64 -0
- package/src/workflows/5-design-system/figma-integration/figma-to-code/README.md +0 -0
- package/src/workflows/5-design-system/figma-integration/figma-to-code/figma-integration-guide.md +37 -0
- package/src/workflows/5-design-system/figma-integration/reference/figma-designer-guide.md +687 -0
- package/src/workflows/5-design-system/figma-integration/reference/figma-mcp-integration.md +661 -0
- package/src/workflows/5-design-system/figma-integration/reference/mcp-server-integration.md +922 -0
- package/src/workflows/5-design-system/figma-integration/reference/prototype-to-figma-workflow.md +933 -0
- package/src/workflows/5-design-system/figma-integration/reference/tools-reference.md +665 -0
- package/src/workflows/5-design-system/figma-integration/reference/when-to-extract-decision-guide.md +663 -0
- package/src/workflows/5-design-system/operations/add-variant.md +490 -0
- package/src/workflows/5-design-system/operations/create-new-component.md +711 -0
- package/src/workflows/5-design-system/operations/generate-catalog.md +686 -0
- package/src/workflows/5-design-system/operations/initialize-design-system.md +467 -0
- package/src/workflows/5-design-system/operations/update-component.md +600 -0
- package/src/workflows/5-design-system/templates/catalog.template.html +363 -0
- package/src/workflows/5-design-system/templates/component-library-config.template.md +65 -0
- package/src/workflows/5-design-system/templates/component.template.md +134 -0
- package/src/workflows/5-design-system/templates/design-tokens.template.md +168 -0
- package/src/workflows/5-design-system/workflow.yaml +22 -0
- package/src/workflows/6-design-deliveries/design-deliveries-guide.md +489 -0
- package/src/workflows/6-design-deliveries/steps/step-6.1-detect-completion.md +131 -0
- package/src/workflows/6-design-deliveries/steps/step-6.2-create-delivery.md +156 -0
- package/src/workflows/6-design-deliveries/steps/step-6.2-create-delivery.md.bak +309 -0
- package/src/workflows/6-design-deliveries/steps/step-6.3-create-test-scenario.md +155 -0
- package/src/workflows/6-design-deliveries/steps/step-6.3-create-test-scenario.md.bak +432 -0
- package/src/workflows/6-design-deliveries/steps/step-6.4-handoff-dialog.md +441 -0
- package/src/workflows/6-design-deliveries/steps/step-6.5-hand-off.md +327 -0
- package/src/workflows/6-design-deliveries/steps/step-6.6-continue.md +414 -0
- package/src/workflows/6-design-deliveries/workflow.md +67 -0
- package/src/workflows/7-testing/steps/step-7.1-receive-notification.md +261 -0
- package/src/workflows/7-testing/steps/step-7.2-prepare-testing.md +399 -0
- package/src/workflows/7-testing/steps/step-7.3-run-tests.md +683 -0
- package/src/workflows/7-testing/steps/step-7.4-create-issues.md +517 -0
- package/src/workflows/7-testing/steps/step-7.5-create-report.md +441 -0
- package/src/workflows/7-testing/steps/step-7.6-send-to-bmad.md +392 -0
- package/src/workflows/7-testing/steps/step-7.7-iterate-or-approve.md +596 -0
- package/src/workflows/7-testing/testing-guide.md +613 -0
- package/src/workflows/7-testing/workflow.md +79 -0
- package/src/workflows/8-ongoing-development/existing-product-guide.md +929 -0
- package/src/workflows/8-ongoing-development/steps/step-8.1-identify-opportunity.md +497 -0
- package/src/workflows/8-ongoing-development/steps/step-8.2-gather-context.md +380 -0
- package/src/workflows/8-ongoing-development/steps/step-8.3-design-update.md +495 -0
- package/src/workflows/8-ongoing-development/steps/step-8.4-create-delivery.md +402 -0
- package/src/workflows/8-ongoing-development/steps/step-8.5-hand-off.md +163 -0
- package/src/workflows/8-ongoing-development/steps/step-8.6-validate.md +265 -0
- package/src/workflows/8-ongoing-development/steps/step-8.7-monitor.md +432 -0
- package/src/workflows/8-ongoing-development/steps/step-8.8-iterate.md +547 -0
- package/src/workflows/8-ongoing-development/workflow.md +302 -0
- package/src/workflows/9-agent-dialogs/steps/step-01-initialize-dialog.md +244 -0
- package/src/workflows/9-agent-dialogs/steps/step-02-analyze-scope.md +195 -0
- package/src/workflows/9-agent-dialogs/steps/step-03-create-steps.md +186 -0
- package/src/workflows/9-agent-dialogs/steps/step-04-execute-steps.md +250 -0
- package/src/workflows/9-agent-dialogs/steps/step-05-complete-dialog.md +177 -0
- package/src/workflows/9-agent-dialogs/templates/dialog-capture.template.md +75 -0
- package/src/workflows/9-agent-dialogs/templates/dialog-types/INDEX.md +142 -0
- package/src/workflows/9-agent-dialogs/templates/dialog-types/bug-fix.template.md +164 -0
- package/src/workflows/9-agent-dialogs/templates/dialog-types/design-exploration.template.md +180 -0
- package/src/workflows/9-agent-dialogs/templates/dialog-types/prototype-implementation.template.md +292 -0
- package/src/workflows/9-agent-dialogs/templates/dialog-types/stitch-generation.template.md +311 -0
- package/src/workflows/9-agent-dialogs/templates/dialog.template.md +200 -0
- package/src/workflows/9-agent-dialogs/templates/step.template.md +118 -0
- package/src/workflows/9-agent-dialogs/workflow.md +401 -0
- package/src/workflows/PROJECT-STRUCTURE-SYSTEM.md +226 -0
- package/src/workflows/VALIDATION-SUMMARY-REPORT.md +329 -0
- package/src/workflows/paths/design-system-only.yaml +62 -0
- package/src/workflows/paths/digital-strategy.yaml +39 -0
- package/src/workflows/paths/feature-enhancement.yaml +93 -0
- package/src/workflows/paths/full-product.yaml +96 -0
- package/src/workflows/paths/landing-page.yaml +54 -0
- package/src/workflows/paths/quick-prototype.yaml +39 -0
- package/src/workflows/project-analysis/AGENT-INITIATION-FLOW.md +295 -0
- package/src/workflows/project-analysis/LINK-VERIFICATION.md +179 -0
- package/src/workflows/project-analysis/ROUTER-ARCHITECTURE.md +224 -0
- package/src/workflows/project-analysis/SYSTEM-GUIDE.md +105 -0
- package/src/workflows/project-analysis/agent-domains/freya-domain.md +144 -0
- package/src/workflows/project-analysis/agent-domains/idunn-domain.md +112 -0
- package/src/workflows/project-analysis/agent-domains/saga-domain.md +132 -0
- package/src/workflows/project-analysis/agent-handoff-guide.md +233 -0
- package/src/workflows/project-analysis/analysis-types/empty-project-response.md +141 -0
- package/src/workflows/project-analysis/analysis-types/folder-based-analysis.md +135 -0
- package/src/workflows/project-analysis/analysis-types/new-project-response.md +194 -0
- package/src/workflows/project-analysis/analysis-types/outline-based-analysis.md +207 -0
- package/src/workflows/project-analysis/analysis-types/unknown-structure-response.md +216 -0
- package/src/workflows/project-analysis/context-aware-activation.md +99 -0
- package/src/workflows/project-analysis/conversation-persistence/check-conversations.md +162 -0
- package/src/workflows/project-analysis/conversation-persistence/conversation-template.md +70 -0
- package/src/workflows/project-analysis/conversation-persistence/persistence-guide.md +81 -0
- package/src/workflows/project-analysis/conversation-persistence/save-conversation.md +146 -0
- package/src/workflows/project-analysis/instructions.md +30 -0
- package/src/workflows/project-analysis/project-analysis-router.md +76 -0
- package/src/workflows/project-analysis/task-reflection.md +303 -0
- package/src/workflows/project-analysis/validation/deep-validation-before-work.md +235 -0
- package/src/workflows/project-analysis/work-types/strategy-work.md +88 -0
- package/src/workflows/project-analysis/workflow.yaml +82 -0
- package/src/workflows/shared/content-creation-workshop/content-creation-workshop-guide.md +320 -0
- package/src/workflows/shared/content-creation-workshop/content-output.template.md +349 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/OPTIMIZATION-COMPLETE.md +143 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-00-define-purpose.md +196 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-01-load-vtc-context.md +126 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-02-awareness-strategy.md +245 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-03-action-filter.md +230 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-04-empowerment-frame.md +248 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-05-structural-order.md +227 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/step-06-generate-content.md +247 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/00-purpose-examples.md +131 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/03-action-filter-example.md +97 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-badass-users-principles.md +159 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/04-example-empowerment-frame.md +88 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-example-golden-circle.md +96 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/05-golden-circle-guide.md +160 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-example-hairdresser-newsletter.md +136 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/substeps/06-generation-instructions.md +95 -0
- package/src/workflows/shared/content-creation-workshop/steps-c/workflow.md +41 -0
- package/src/workflows/shared/content-creation-workshop/validation-report-content-creation-workshop.md +303 -0
- package/src/workflows/shared/content-creation-workshop/workflow.md +87 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-01-define-business-goal.md +115 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-02-identify-solution.md +105 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-03-describe-user.md +131 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-04-positive-driving-forces.md +150 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-05-negative-driving-forces.md +190 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-06-customer-awareness.md +256 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/step-07-review-and-save.md +233 -0
- package/src/workflows/shared/vtc-workshop/creation-steps-c/workflow.md +43 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-01-load-trigger-map.md +81 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-02-select-business-goal.md +84 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-03-select-user.md +88 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-04-select-driving-forces.md +100 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-05-define-solution.md +59 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-06-customer-awareness.md +75 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/step-07-review-and-save.md +151 -0
- package/src/workflows/shared/vtc-workshop/selection-steps-c/workflow.md +48 -0
- package/src/workflows/shared/vtc-workshop/validation-report-vtc-workshop.md +269 -0
- package/src/workflows/shared/vtc-workshop/vtc-creation-workshop.md +457 -0
- package/src/workflows/shared/vtc-workshop/vtc-selection-workshop.md +557 -0
- package/src/workflows/shared/vtc-workshop/vtc-template.yaml +210 -0
- package/src/workflows/shared/vtc-workshop/vtc-workshop-guide.md +418 -0
- package/src/workflows/shared/vtc-workshop/vtc-workshop-router.md +146 -0
- package/src/workflows/shared/vtc-workshop/workflow.md +174 -0
- package/src/workflows/workflow-init/COMPLETE-SYSTEM-SUMMARY.md +314 -0
- package/src/workflows/workflow-init/FINAL-SYSTEM-SUMMARY.md +321 -0
- package/src/workflows/workflow-init/PROJECT-OUTLINE-SYSTEM.md +240 -0
- package/src/workflows/workflow-init/excalidraw-setup-prompt.md +365 -0
- package/src/workflows/workflow-init/instructions.md +22 -0
- package/src/workflows/workflow-init/methodology-instructions/custom-methodology-template.md +299 -0
- package/src/workflows/workflow-init/methodology-instructions/methodology-guide.md +252 -0
- package/src/workflows/workflow-init/methodology-instructions/wds-v6-instructions.md +221 -0
- package/src/workflows/workflow-init/methodology-instructions/wps2c-v4-instructions.md +231 -0
- package/src/workflows/workflow-init/project-config.template.yaml +87 -0
- package/src/workflows/workflow-init/project-initiation-conversation.md +957 -0
- package/src/workflows/workflow-init/project-outline.template.yaml +429 -0
- package/src/workflows/workflow-init/project-type-selection.md +318 -0
- package/src/workflows/workflow-init/steps/step-02-project-structure.md +54 -0
- package/src/workflows/workflow-init/steps/step-03-delivery-config.md +76 -0
- package/src/workflows/workflow-init/steps/step-04-phases-selection.md +180 -0
- package/src/workflows/workflow-init/workflow.yaml +32 -0
- package/src/workflows/workflow-status/instructions.md +143 -0
- package/src/workflows/workflow-status/workflow.yaml +25 -0
- package/tools/cli/commands/install.js +34 -0
- package/tools/cli/lib/compiler.js +407 -0
- package/tools/cli/lib/ide-configs.js +104 -0
- package/tools/cli/lib/installer.js +257 -0
- package/tools/cli/lib/ui.js +127 -0
- package/tools/cli/wds-cli.js +43 -0
- package/tools/wds-npx-wrapper.js +37 -0
|
@@ -0,0 +1,491 @@
|
|
|
1
|
+
# Module 04: Product Brief
|
|
2
|
+
|
|
3
|
+
## Lesson 5: Using Your Product Brief
|
|
4
|
+
|
|
5
|
+
**How this document powers your entire project**
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Not Filed Away, Actively Referenced
|
|
10
|
+
|
|
11
|
+
The Product Brief isn't a document you create and forget. It's your active reference throughout the project - the single source of truth that guides every decision.
|
|
12
|
+
|
|
13
|
+
**The difference:**
|
|
14
|
+
|
|
15
|
+
**Filed Away (Useless):**
|
|
16
|
+
- Created once, never opened again
|
|
17
|
+
- Stored somewhere nobody remembers
|
|
18
|
+
- Outdated within weeks
|
|
19
|
+
- Ignored when making decisions
|
|
20
|
+
|
|
21
|
+
**Actively Referenced (Powerful):**
|
|
22
|
+
- Opened multiple times per week
|
|
23
|
+
- Linked in all project documentation
|
|
24
|
+
- Updated when assumptions change
|
|
25
|
+
- Consulted before major decisions
|
|
26
|
+
|
|
27
|
+
**The goal:** Make the brief so useful that people naturally reference it.
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## How Designers Use It
|
|
32
|
+
|
|
33
|
+
Designers reference the Product Brief to make confident decisions without constant stakeholder approval.
|
|
34
|
+
|
|
35
|
+
### Making Design Decisions
|
|
36
|
+
|
|
37
|
+
**The Question:** "Should we add this feature?"
|
|
38
|
+
|
|
39
|
+
**Without the Brief:**
|
|
40
|
+
- Designer guesses based on intuition
|
|
41
|
+
- Asks stakeholders (delays decision)
|
|
42
|
+
- Builds it and hopes it's right
|
|
43
|
+
- Discovers later it doesn't fit
|
|
44
|
+
|
|
45
|
+
**With the Brief:**
|
|
46
|
+
1. Check the vision - does this align?
|
|
47
|
+
2. Check target users - do they need this?
|
|
48
|
+
3. Check success criteria - does this contribute?
|
|
49
|
+
4. Check constraints - is this feasible?
|
|
50
|
+
5. Make confident decision
|
|
51
|
+
|
|
52
|
+
**Example:**
|
|
53
|
+
|
|
54
|
+
Designer considering social sharing features:
|
|
55
|
+
- Vision: "Family coordination for dog care" → Social sharing doesn't align
|
|
56
|
+
- Target users: "Parents managing household" → They need coordination, not social
|
|
57
|
+
- Success criteria: "Reduce coordination stress" → Social features add complexity
|
|
58
|
+
- Decision: No, doesn't fit the brief
|
|
59
|
+
|
|
60
|
+
**Time saved:** No meeting needed, confident decision made in minutes.
|
|
61
|
+
|
|
62
|
+
### Validating Design Solutions
|
|
63
|
+
|
|
64
|
+
**The Question:** "Is this design on the right track?"
|
|
65
|
+
|
|
66
|
+
**Without the Brief:**
|
|
67
|
+
- Designer relies on personal taste
|
|
68
|
+
- Unclear if it serves the right users
|
|
69
|
+
- Uncertain if it meets success criteria
|
|
70
|
+
- Validation happens late (expensive)
|
|
71
|
+
|
|
72
|
+
**With the Brief:**
|
|
73
|
+
1. Does it serve primary users?
|
|
74
|
+
2. Does it solve the core problem?
|
|
75
|
+
3. Does it respect constraints?
|
|
76
|
+
4. Does it differentiate us?
|
|
77
|
+
5. Will it contribute to success criteria?
|
|
78
|
+
|
|
79
|
+
**Example:**
|
|
80
|
+
|
|
81
|
+
Designer reviewing interface complexity:
|
|
82
|
+
- Target users: "Tech-comfortable parents" → Can handle moderate complexity
|
|
83
|
+
- Success criteria: "Task completion < 2 minutes" → Must be fast
|
|
84
|
+
- Constraints: "Family-friendly, organized, calm" → Can't be overwhelming
|
|
85
|
+
- Decision: Simplify, optimize for speed
|
|
86
|
+
|
|
87
|
+
### Staying Aligned During Iteration
|
|
88
|
+
|
|
89
|
+
**The Challenge:** Design evolves through iteration. How do you know if you're still on track?
|
|
90
|
+
|
|
91
|
+
**The Brief as North Star:**
|
|
92
|
+
- Vision doesn't change (unless project pivots)
|
|
93
|
+
- Target users don't change (unless you discover new insights)
|
|
94
|
+
- Success criteria don't change (unless you learn they're wrong)
|
|
95
|
+
- Constraints don't change (unless business reality shifts)
|
|
96
|
+
|
|
97
|
+
**When iterating:**
|
|
98
|
+
- Reference the brief at start of each sprint
|
|
99
|
+
- Check alignment after major design changes
|
|
100
|
+
- Validate that iterations serve the vision
|
|
101
|
+
- Update brief if fundamental assumptions change
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## How Developers Use It
|
|
106
|
+
|
|
107
|
+
Developers reference the Product Brief to understand the "why" behind requirements and make technical decisions that serve the vision.
|
|
108
|
+
|
|
109
|
+
### Understanding the "Why"
|
|
110
|
+
|
|
111
|
+
**The Problem:** Developers get requirements without context. They build what's specified, not what's needed.
|
|
112
|
+
|
|
113
|
+
**The Brief Provides Context:**
|
|
114
|
+
|
|
115
|
+
**Without the Brief:**
|
|
116
|
+
- "Build a calendar feature" → Builds generic calendar
|
|
117
|
+
- No understanding of user needs
|
|
118
|
+
- No context for technical decisions
|
|
119
|
+
- Builds to spec, not to purpose
|
|
120
|
+
|
|
121
|
+
**With the Brief:**
|
|
122
|
+
- Reads vision: "Family coordination for dog care"
|
|
123
|
+
- Reads target users: "Parents managing household responsibilities"
|
|
124
|
+
- Reads success criteria: "Task completion < 2 minutes"
|
|
125
|
+
- Understands: This needs to be fast and family-focused, not feature-rich
|
|
126
|
+
- Builds accordingly
|
|
127
|
+
|
|
128
|
+
### Making Technical Decisions
|
|
129
|
+
|
|
130
|
+
**The Question:** "Which technical approach should we use?"
|
|
131
|
+
|
|
132
|
+
**Without the Brief:**
|
|
133
|
+
- Developer chooses based on personal preference
|
|
134
|
+
- Might over-engineer or under-engineer
|
|
135
|
+
- Unclear what performance matters
|
|
136
|
+
- Uncertain about future requirements
|
|
137
|
+
|
|
138
|
+
**With the Brief:**
|
|
139
|
+
1. Check constraints - what's required?
|
|
140
|
+
2. Check success criteria - what performance matters?
|
|
141
|
+
3. Check vision - what's the long-term direction?
|
|
142
|
+
4. Make informed technical decision
|
|
143
|
+
|
|
144
|
+
**Example:**
|
|
145
|
+
|
|
146
|
+
Developer choosing database approach:
|
|
147
|
+
- Constraints: "Offline core features required" → Need local storage
|
|
148
|
+
- Success criteria: "< 2s load time" → Need fast queries
|
|
149
|
+
- Vision: "Family coordination" → Need sync across devices
|
|
150
|
+
- Decision: Local-first architecture with sync
|
|
151
|
+
|
|
152
|
+
### Prioritizing Technical Work
|
|
153
|
+
|
|
154
|
+
**The Question:** "What should we build first?"
|
|
155
|
+
|
|
156
|
+
**Without the Brief:**
|
|
157
|
+
- Build in order received
|
|
158
|
+
- Unclear what's critical vs nice-to-have
|
|
159
|
+
- Risk building wrong things first
|
|
160
|
+
- Discover priorities late
|
|
161
|
+
|
|
162
|
+
**With the Brief:**
|
|
163
|
+
1. What serves primary users?
|
|
164
|
+
2. What contributes to success criteria?
|
|
165
|
+
3. What's required by constraints?
|
|
166
|
+
4. What enables the vision?
|
|
167
|
+
|
|
168
|
+
**Example:**
|
|
169
|
+
|
|
170
|
+
Developer prioritizing features:
|
|
171
|
+
- Success criteria: "90% task completion rate" → Core task flow is critical
|
|
172
|
+
- Constraints: "6-month timeline to MVP" → Must focus on essentials
|
|
173
|
+
- Target users: "Parents managing household" → Notifications are important
|
|
174
|
+
- Priority: Task flow, then notifications, then nice-to-haves
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
## How Stakeholders Use It
|
|
179
|
+
|
|
180
|
+
Stakeholders reference the Product Brief to track progress, make informed decisions, and prevent scope creep.
|
|
181
|
+
|
|
182
|
+
### Tracking Progress
|
|
183
|
+
|
|
184
|
+
**The Question:** "Is the project on track?"
|
|
185
|
+
|
|
186
|
+
**Without the Brief:**
|
|
187
|
+
- Subjective assessment
|
|
188
|
+
- Unclear what "on track" means
|
|
189
|
+
- Debates about what matters
|
|
190
|
+
- Anxiety about progress
|
|
191
|
+
|
|
192
|
+
**With the Brief:**
|
|
193
|
+
1. Check success criteria - are we hitting metrics?
|
|
194
|
+
2. Check timeline constraints - are we on schedule?
|
|
195
|
+
3. Check vision - are we building what we said?
|
|
196
|
+
4. Make objective assessment
|
|
197
|
+
|
|
198
|
+
**Example:**
|
|
199
|
+
|
|
200
|
+
Stakeholder reviewing progress:
|
|
201
|
+
- Success criteria: "1,000 active users by month 6" → Currently at 800 (month 5)
|
|
202
|
+
- Timeline: "6-month MVP" → On schedule for launch
|
|
203
|
+
- Vision: "Family coordination" → Features align
|
|
204
|
+
- Assessment: On track, slight user acquisition concern
|
|
205
|
+
|
|
206
|
+
### Making Informed Decisions
|
|
207
|
+
|
|
208
|
+
**The Question:** "Should we approve this change?"
|
|
209
|
+
|
|
210
|
+
**Without the Brief:**
|
|
211
|
+
- Decision based on opinion
|
|
212
|
+
- Unclear if change aligns with vision
|
|
213
|
+
- Risk of scope creep
|
|
214
|
+
- Inconsistent decision-making
|
|
215
|
+
|
|
216
|
+
**With the Brief:**
|
|
217
|
+
1. Does it align with vision?
|
|
218
|
+
2. Does it serve target users?
|
|
219
|
+
3. Does it contribute to success criteria?
|
|
220
|
+
4. Is it feasible within constraints?
|
|
221
|
+
|
|
222
|
+
**Example:**
|
|
223
|
+
|
|
224
|
+
Stakeholder evaluating feature request:
|
|
225
|
+
- Request: "Add social features"
|
|
226
|
+
- Vision: "Family coordination" → Social doesn't align
|
|
227
|
+
- Success criteria: "Reduce coordination stress" → Social adds complexity
|
|
228
|
+
- Constraints: "6-month timeline" → No time for scope expansion
|
|
229
|
+
- Decision: No, doesn't fit the brief
|
|
230
|
+
|
|
231
|
+
### Preventing Scope Creep
|
|
232
|
+
|
|
233
|
+
**The Challenge:** Everyone has ideas. How do you say no without seeming negative?
|
|
234
|
+
|
|
235
|
+
**The Brief as Shield:**
|
|
236
|
+
|
|
237
|
+
**Without the Brief:**
|
|
238
|
+
- "Can we add this?" → "I don't know, maybe?"
|
|
239
|
+
- No clear criteria for yes/no
|
|
240
|
+
- Scope grows unchecked
|
|
241
|
+
- Timeline and budget suffer
|
|
242
|
+
|
|
243
|
+
**With the Brief:**
|
|
244
|
+
- "Can we add this?" → "Let's check the brief"
|
|
245
|
+
- Vision: Does it align?
|
|
246
|
+
- Users: Do they need it?
|
|
247
|
+
- Criteria: Does it contribute?
|
|
248
|
+
- Constraints: Do we have time/budget?
|
|
249
|
+
- Clear yes/no with justification
|
|
250
|
+
|
|
251
|
+
**Example:**
|
|
252
|
+
|
|
253
|
+
Stakeholder suggesting enterprise features:
|
|
254
|
+
- Target users: "Parents managing household" → Not enterprise users
|
|
255
|
+
- Constraints: "Bootstrap budget, 6-month timeline" → No resources for enterprise
|
|
256
|
+
- Vision: "Family coordination" → Consumer focus
|
|
257
|
+
- Response: "Great idea for phase 2, but doesn't fit MVP brief"
|
|
258
|
+
|
|
259
|
+
---
|
|
260
|
+
|
|
261
|
+
## How Product Managers Use It
|
|
262
|
+
|
|
263
|
+
Product managers reference the Product Brief to create roadmaps, write user stories, and measure success.
|
|
264
|
+
|
|
265
|
+
### Creating Roadmaps
|
|
266
|
+
|
|
267
|
+
**The Question:** "What should we build next?"
|
|
268
|
+
|
|
269
|
+
**Without the Brief:**
|
|
270
|
+
- Roadmap based on requests
|
|
271
|
+
- Unclear prioritization criteria
|
|
272
|
+
- Risk of building wrong things
|
|
273
|
+
- Reactive instead of strategic
|
|
274
|
+
|
|
275
|
+
**With the Brief:**
|
|
276
|
+
1. What serves the vision?
|
|
277
|
+
2. What moves success criteria?
|
|
278
|
+
3. What target users need most?
|
|
279
|
+
4. What's feasible within constraints?
|
|
280
|
+
|
|
281
|
+
**Example:**
|
|
282
|
+
|
|
283
|
+
PM planning Q2 roadmap:
|
|
284
|
+
- Success criteria: "70% weekly active users" → Focus on retention
|
|
285
|
+
- Target users: "Parents managing household" → Need reminders, notifications
|
|
286
|
+
- Constraints: "Small team" → Must be achievable
|
|
287
|
+
- Roadmap: Notification system, recurring tasks, mobile improvements
|
|
288
|
+
|
|
289
|
+
### Writing User Stories
|
|
290
|
+
|
|
291
|
+
**The Question:** "How should we describe this feature?"
|
|
292
|
+
|
|
293
|
+
**Without the Brief:**
|
|
294
|
+
- Generic user stories
|
|
295
|
+
- Unclear user context
|
|
296
|
+
- Missing success criteria
|
|
297
|
+
- Developers guess at intent
|
|
298
|
+
|
|
299
|
+
**With the Brief:**
|
|
300
|
+
- Reference target users for "As a..."
|
|
301
|
+
- Reference vision for "I want to..."
|
|
302
|
+
- Reference success criteria for "So that..."
|
|
303
|
+
- Clear, contextualized stories
|
|
304
|
+
|
|
305
|
+
**Example:**
|
|
306
|
+
|
|
307
|
+
Writing story for task assignment:
|
|
308
|
+
- Target users: "Parents managing household responsibilities"
|
|
309
|
+
- Vision: "Eliminate coordination confusion"
|
|
310
|
+
- Success criteria: "Task completion < 2 minutes"
|
|
311
|
+
- Story: "As a parent managing household responsibilities, I want to quickly assign tasks to family members so that everyone knows their responsibilities without confusion or back-and-forth communication"
|
|
312
|
+
|
|
313
|
+
### Measuring Success
|
|
314
|
+
|
|
315
|
+
**The Question:** "Are we successful?"
|
|
316
|
+
|
|
317
|
+
**Without the Brief:**
|
|
318
|
+
- Success is subjective
|
|
319
|
+
- Debates about what matters
|
|
320
|
+
- Moving goalposts
|
|
321
|
+
- Unclear when to celebrate
|
|
322
|
+
|
|
323
|
+
**With the Brief:**
|
|
324
|
+
- Success criteria are defined
|
|
325
|
+
- Metrics are measurable
|
|
326
|
+
- Goalposts are fixed
|
|
327
|
+
- Clear success indicators
|
|
328
|
+
|
|
329
|
+
**Example:**
|
|
330
|
+
|
|
331
|
+
PM measuring launch success:
|
|
332
|
+
- User success: "80% report reduced stress" → Survey shows 82% ✅
|
|
333
|
+
- Business success: "1,000 active families by month 6" → Hit 1,200 ✅
|
|
334
|
+
- Technical success: "99.9% uptime" → Achieved 99.95% ✅
|
|
335
|
+
- Design success: "SUS score > 75" → Scored 78 ✅
|
|
336
|
+
- Result: Successful launch, all criteria met
|
|
337
|
+
|
|
338
|
+
---
|
|
339
|
+
|
|
340
|
+
## When to Update the Brief
|
|
341
|
+
|
|
342
|
+
The Product Brief is a living document, but not everything requires an update.
|
|
343
|
+
|
|
344
|
+
### When to Update
|
|
345
|
+
|
|
346
|
+
**✅ Update when:**
|
|
347
|
+
|
|
348
|
+
**Fundamental Assumptions Change:**
|
|
349
|
+
- Market research reveals different user needs
|
|
350
|
+
- Competitive landscape shifts significantly
|
|
351
|
+
- Business constraints change (budget, timeline, resources)
|
|
352
|
+
- Technical constraints change (platform requirements)
|
|
353
|
+
- Success criteria prove unrealistic or wrong
|
|
354
|
+
|
|
355
|
+
**Example:**
|
|
356
|
+
- Discovery: Primary users also need multi-pet support
|
|
357
|
+
- Impact: Changes target users, success criteria, constraints
|
|
358
|
+
- Action: Update brief, notify team, adjust roadmap
|
|
359
|
+
|
|
360
|
+
**Major Pivots:**
|
|
361
|
+
- Vision changes direction
|
|
362
|
+
- Target users shift
|
|
363
|
+
- Business model changes
|
|
364
|
+
- Positioning evolves
|
|
365
|
+
|
|
366
|
+
**Example:**
|
|
367
|
+
- Decision: Pivot from consumer to enterprise
|
|
368
|
+
- Impact: Changes everything
|
|
369
|
+
- Action: Major brief update, team alignment session
|
|
370
|
+
|
|
371
|
+
### When NOT to Update
|
|
372
|
+
|
|
373
|
+
**❌ Don't update for:**
|
|
374
|
+
|
|
375
|
+
**Tactical Decisions:**
|
|
376
|
+
- Individual feature decisions
|
|
377
|
+
- Design iterations
|
|
378
|
+
- Minor technical choices
|
|
379
|
+
- Day-to-day prioritization
|
|
380
|
+
|
|
381
|
+
**Example:**
|
|
382
|
+
- Decision: Change button color
|
|
383
|
+
- Impact: None on strategy
|
|
384
|
+
- Action: No brief update needed
|
|
385
|
+
|
|
386
|
+
**Opinions and Preferences:**
|
|
387
|
+
- Stakeholder suggestions
|
|
388
|
+
- Team member ideas
|
|
389
|
+
- User feature requests
|
|
390
|
+
- Competitive feature additions
|
|
391
|
+
|
|
392
|
+
**Example:**
|
|
393
|
+
- Request: "Can we add dark mode?"
|
|
394
|
+
- Impact: Doesn't change strategy
|
|
395
|
+
- Action: Evaluate against brief, but don't update brief
|
|
396
|
+
|
|
397
|
+
**The Rule:** Update the brief when fundamental strategy changes, not when tactics evolve.
|
|
398
|
+
|
|
399
|
+
---
|
|
400
|
+
|
|
401
|
+
## Making It a Habit
|
|
402
|
+
|
|
403
|
+
The brief is only powerful if people actually use it. Here's how to make it a habit:
|
|
404
|
+
|
|
405
|
+
### Make It Accessible
|
|
406
|
+
|
|
407
|
+
**Where to store it:**
|
|
408
|
+
- Project root: `/docs/A-Product-Brief/project-brief.md`
|
|
409
|
+
- Always in the same place
|
|
410
|
+
- Version controlled (Git)
|
|
411
|
+
- Linked from README
|
|
412
|
+
|
|
413
|
+
**How to reference it:**
|
|
414
|
+
- Include path in onboarding
|
|
415
|
+
- Link in project documentation
|
|
416
|
+
- Reference in meeting agendas
|
|
417
|
+
- Quote in decision documents
|
|
418
|
+
|
|
419
|
+
### Make It Referenced
|
|
420
|
+
|
|
421
|
+
**In meetings:**
|
|
422
|
+
- Start design reviews by reading relevant sections
|
|
423
|
+
- Reference it when explaining decisions
|
|
424
|
+
- Update it when assumptions change
|
|
425
|
+
- End with action items linked to brief
|
|
426
|
+
|
|
427
|
+
**In documentation:**
|
|
428
|
+
- Link to specific sections in PRDs
|
|
429
|
+
- Quote it in design specs
|
|
430
|
+
- Reference it in user stories
|
|
431
|
+
- Connect roadmap items to brief
|
|
432
|
+
|
|
433
|
+
**In decisions:**
|
|
434
|
+
- "Let's check the brief"
|
|
435
|
+
- "According to our success criteria..."
|
|
436
|
+
- "Our target users need..."
|
|
437
|
+
- "Our constraints say..."
|
|
438
|
+
|
|
439
|
+
### Make It Trusted
|
|
440
|
+
|
|
441
|
+
**Keep it accurate:**
|
|
442
|
+
- Update when things change
|
|
443
|
+
- Remove outdated information
|
|
444
|
+
- Validate assumptions periodically
|
|
445
|
+
- Correct errors immediately
|
|
446
|
+
|
|
447
|
+
**Keep it concise:**
|
|
448
|
+
- Remove what's not useful
|
|
449
|
+
- Focus on decisions, not history
|
|
450
|
+
- Avoid redundancy
|
|
451
|
+
- Stay under 3 pages
|
|
452
|
+
|
|
453
|
+
**Keep it current:**
|
|
454
|
+
- Review quarterly
|
|
455
|
+
- Update after major learnings
|
|
456
|
+
- Refresh when pivoting
|
|
457
|
+
- Don't let it go stale
|
|
458
|
+
|
|
459
|
+
---
|
|
460
|
+
|
|
461
|
+
## The Power of Shared Understanding
|
|
462
|
+
|
|
463
|
+
When everyone on the team references the same Product Brief:
|
|
464
|
+
|
|
465
|
+
**Designers** make confident decisions aligned with vision
|
|
466
|
+
**Developers** understand the "why" and build accordingly
|
|
467
|
+
**Stakeholders** track progress and prevent scope creep
|
|
468
|
+
**Product Managers** create roadmaps and measure success
|
|
469
|
+
|
|
470
|
+
**The result:**
|
|
471
|
+
- ✅ Faster decisions (no constant meetings)
|
|
472
|
+
- ✅ Better alignment (everyone working toward same goals)
|
|
473
|
+
- ✅ Less rework (building right things first time)
|
|
474
|
+
- ✅ More confidence (clear direction and criteria)
|
|
475
|
+
- ✅ Stronger results (coordinated effort)
|
|
476
|
+
|
|
477
|
+
**This is the power of a single source of truth.**
|
|
478
|
+
|
|
479
|
+
---
|
|
480
|
+
|
|
481
|
+
## What's Next
|
|
482
|
+
|
|
483
|
+
In the final lesson, we'll explore the additional strategic documents you can create as your project needs them - expanding your foundation beyond the core Product Brief.
|
|
484
|
+
|
|
485
|
+
---
|
|
486
|
+
|
|
487
|
+
**[Continue to Lesson 6: Additional Strategic Documents →](lesson-06-additional-documents.md)**
|
|
488
|
+
|
|
489
|
+
---
|
|
490
|
+
|
|
491
|
+
[← Back to Lesson 4](lesson-04-wds-advantage.md) | [Back to Module Overview](module-04-overview.md)
|