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,189 @@
|
|
|
1
|
+
# Lesson 5: Internal Signoff Documents
|
|
2
|
+
|
|
3
|
+
**Formalizing alignment for internal company projects**
|
|
4
|
+
|
|
5
|
+
**Time:** 10 minutes
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## When You Need Internal Signoff
|
|
10
|
+
|
|
11
|
+
**Internal signoff is for:**
|
|
12
|
+
- **Manager/Employee**: Seeking approval for an internal project
|
|
13
|
+
- **Internal Stakeholders**: Getting buy-in from departments, executives, or teams
|
|
14
|
+
- **Company Projects**: Building something within your organization
|
|
15
|
+
|
|
16
|
+
**These documents:**
|
|
17
|
+
- Formalize internal agreements
|
|
18
|
+
- Document approval and commitment
|
|
19
|
+
- Set expectations for internal teams
|
|
20
|
+
- May follow company-specific formats
|
|
21
|
+
|
|
22
|
+
---
|
|
23
|
+
|
|
24
|
+
## Internal Signoff vs. External Contracts
|
|
25
|
+
|
|
26
|
+
**Key Differences:**
|
|
27
|
+
|
|
28
|
+
| Aspect | External Contracts | Internal Signoff |
|
|
29
|
+
|--------|-------------------|-----------------|
|
|
30
|
+
| **Parties** | Separate entities (consultant/client) | Same organization (internal) |
|
|
31
|
+
| **Legal Framework** | Governing law, jurisdiction required | Usually not needed |
|
|
32
|
+
| **Payment Terms** | External payment, invoices | Internal budget allocation |
|
|
33
|
+
| **IP Ownership** | Transfer of ownership | Usually stays within company |
|
|
34
|
+
| **Format** | Standard contract format | May follow company format |
|
|
35
|
+
| **Approval** | Signatures from both parties | Internal approval workflow |
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## Internal Signoff Document Structure
|
|
40
|
+
|
|
41
|
+
**Internal signoff focuses on approval, ownership, and outcomes rather than detailed scope:**
|
|
42
|
+
|
|
43
|
+
### 1. Project Overview
|
|
44
|
+
- The Realization
|
|
45
|
+
- Recommended Solution
|
|
46
|
+
- Why It Matters
|
|
47
|
+
|
|
48
|
+
### 2. Goals and Success Metrics
|
|
49
|
+
- **What are we trying to accomplish?**
|
|
50
|
+
- **How will we measure success?**
|
|
51
|
+
- **What does success look like?**
|
|
52
|
+
- **Key performance indicators (KPIs)**
|
|
53
|
+
- **Success criteria**
|
|
54
|
+
|
|
55
|
+
**Focus**: Clear outcomes and measurable results, not detailed deliverables.
|
|
56
|
+
|
|
57
|
+
### 3. Budget and Resources
|
|
58
|
+
- **Budget allocation**: Total budget estimate
|
|
59
|
+
- **Budget breakdown**: How budget will be allocated (if applicable)
|
|
60
|
+
- **Resources needed**: Team, tools, external services (high-level)
|
|
61
|
+
- **Not-to-Exceed**: Budget cap (if applicable)
|
|
62
|
+
|
|
63
|
+
**Focus**: Budget estimates and resource allocation, not hourly rates or time tracking.
|
|
64
|
+
|
|
65
|
+
### 4. Ownership and Responsibility
|
|
66
|
+
- **Project Owner**: Who owns this project?
|
|
67
|
+
- **Process Owner**: Who is responsible for execution?
|
|
68
|
+
- **Key Stakeholders**: Who is involved/affected?
|
|
69
|
+
- **Decision-Making Authority**: Who makes key decisions?
|
|
70
|
+
|
|
71
|
+
**Focus**: Clear ownership and accountability, not detailed work breakdown.
|
|
72
|
+
|
|
73
|
+
### 5. Approval and Sign-Off
|
|
74
|
+
- **Who needs to approve**: List of approvers
|
|
75
|
+
- **Approval stages**: Multi-stage approval process (if applicable)
|
|
76
|
+
- **Sign-off process**: How approval is documented
|
|
77
|
+
- **Timeline for approval**: When approval is needed
|
|
78
|
+
|
|
79
|
+
**Focus**: Clear approval workflow and sign-off process.
|
|
80
|
+
|
|
81
|
+
### 6. Timeline and Milestones
|
|
82
|
+
- **Key milestones**: Major project milestones
|
|
83
|
+
- **Delivery dates**: When outcomes are expected
|
|
84
|
+
- **Critical deadlines**: Important dates
|
|
85
|
+
|
|
86
|
+
**Focus**: High-level timeline, not detailed task schedules.
|
|
87
|
+
|
|
88
|
+
### 7. Optional Sections
|
|
89
|
+
- **Confidentiality**: If sensitive information involved
|
|
90
|
+
- **Risks and Considerations**: Potential challenges or risks
|
|
91
|
+
- **The Path Forward**: High-level approach (brief overview)
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## Company Signoff Format (Optional)
|
|
96
|
+
|
|
97
|
+
**If your company has a standard signoff format:**
|
|
98
|
+
|
|
99
|
+
### Upload Your Format
|
|
100
|
+
- Upload or paste your company's signoff document template
|
|
101
|
+
- Saga will adapt it to match your format
|
|
102
|
+
- Preserve company-specific sections and language
|
|
103
|
+
- Incorporate alignment document content
|
|
104
|
+
|
|
105
|
+
### Benefits
|
|
106
|
+
- Follows internal processes
|
|
107
|
+
- Matches company expectations
|
|
108
|
+
- Easier approval workflow
|
|
109
|
+
- Familiar format for stakeholders
|
|
110
|
+
|
|
111
|
+
**This ensures** the signoff follows your internal processes and approval workflows.
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## Approval Workflow
|
|
116
|
+
|
|
117
|
+
**Internal signoff typically involves:**
|
|
118
|
+
|
|
119
|
+
1. **Initial Review**: Share with immediate stakeholders
|
|
120
|
+
2. **Department Approval**: Get buy-in from affected departments
|
|
121
|
+
3. **Budget Approval**: Secure budget allocation
|
|
122
|
+
4. **Executive Sign-off**: Final approval from decision-makers
|
|
123
|
+
5. **Documentation**: File signed document for records
|
|
124
|
+
|
|
125
|
+
**Saga will help you:**
|
|
126
|
+
- Identify who needs to approve
|
|
127
|
+
- Structure the approval workflow
|
|
128
|
+
- Create appropriate sign-off sections
|
|
129
|
+
|
|
130
|
+
---
|
|
131
|
+
|
|
132
|
+
## Best Practices
|
|
133
|
+
|
|
134
|
+
**For Internal Signoff:**
|
|
135
|
+
|
|
136
|
+
### Focus on Outcomes
|
|
137
|
+
- Emphasize goals and success metrics
|
|
138
|
+
- Show what value will be created
|
|
139
|
+
- Define clear success criteria
|
|
140
|
+
- Avoid getting lost in detailed scope
|
|
141
|
+
|
|
142
|
+
### Clear Ownership
|
|
143
|
+
- Identify project owner clearly
|
|
144
|
+
- Define who owns the process
|
|
145
|
+
- Clarify decision-making authority
|
|
146
|
+
- Set accountability expectations
|
|
147
|
+
|
|
148
|
+
### Budget Clarity
|
|
149
|
+
- Provide realistic budget estimates
|
|
150
|
+
- Show how budget will be allocated
|
|
151
|
+
- Include not-to-exceed cap if needed
|
|
152
|
+
- Focus on budget, not hours or rates
|
|
153
|
+
|
|
154
|
+
### Approval Workflow
|
|
155
|
+
- Identify all approvers early
|
|
156
|
+
- Understand approval stages
|
|
157
|
+
- Follow company sign-off process
|
|
158
|
+
- Get buy-in before formal sign-off
|
|
159
|
+
|
|
160
|
+
### Follow Company Process
|
|
161
|
+
- Use company format if available
|
|
162
|
+
- Follow internal approval workflows
|
|
163
|
+
- Match company documentation standards
|
|
164
|
+
- Document everything properly
|
|
165
|
+
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## After Signoff Document
|
|
169
|
+
|
|
170
|
+
**Once signoff document is approved:**
|
|
171
|
+
- ✅ Internal alignment achieved
|
|
172
|
+
- ✅ Budget/resources committed
|
|
173
|
+
- ✅ Stakeholders on board
|
|
174
|
+
- ✅ Ready to proceed to Project Brief
|
|
175
|
+
|
|
176
|
+
**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## Key Takeaway
|
|
181
|
+
|
|
182
|
+
**Internal signoff documents formalize** internal agreements and secure commitment from stakeholders within your organization. They may follow company-specific formats and focus on approval workflows rather than legal protections.
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
**Next:** [Tutorial: Alignment & Signoff →](tutorial-03.md)
|
|
187
|
+
|
|
188
|
+
[← Back to Module Overview](module-03-overview.md) | [Previous: Lesson 4: External Contracts →](lesson-04-external-contracts.md)
|
|
189
|
+
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
# Module 03: Alignment & Signoff
|
|
2
|
+
|
|
3
|
+
**Get stakeholders aligned and secure commitment before starting the project**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
This module teaches you how to create alignment around your idea and secure formal commitment from stakeholders before diving into detailed project work.
|
|
10
|
+
|
|
11
|
+
**Time:** 55-75 minutes
|
|
12
|
+
**Prerequisites:** Module 02 completed (WDS installed)
|
|
13
|
+
**When to use:** Optional - Use when you need stakeholder alignment (consultant → client, business → suppliers, manager → stakeholders)
|
|
14
|
+
**What you'll create:** Alignment document (pitch) and signoff document (contract/service agreement/signoff)
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## What You'll Learn
|
|
19
|
+
|
|
20
|
+
- **The discovery discipline** - how to understand their outcomes before proposing solutions
|
|
21
|
+
- **The two-meeting approach** - separate discovery from solution presentation
|
|
22
|
+
- **Professional patience** - the carpenter measures twice, the doctor diagnoses first
|
|
23
|
+
- How to ask discovery questions that reveal what success looks like for them
|
|
24
|
+
- Creating a compelling alignment document that gets everyone on the same page
|
|
25
|
+
- Negotiating and iterating until stakeholders accept
|
|
26
|
+
- Generating appropriate signoff documents (external contracts or internal signoff)
|
|
27
|
+
- When to skip this module (if you're doing it yourself)
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## Module Structure
|
|
32
|
+
|
|
33
|
+
### [Lesson 1: Understanding Alignment](lesson-01-understanding-alignment.md)
|
|
34
|
+
|
|
35
|
+
**Time:** 10 minutes
|
|
36
|
+
|
|
37
|
+
- Why alignment matters before starting work
|
|
38
|
+
- **The discovery discipline**: Understanding before solving
|
|
39
|
+
- **Professional patience**: The carpenter measures twice, the doctor diagnoses first
|
|
40
|
+
- The 6 elements of alignment (Idea, Why, What, How, Budget, Commitment)
|
|
41
|
+
- Different user scenarios (consultant, business owner, manager/employee)
|
|
42
|
+
- When to skip alignment (doing it yourself)
|
|
43
|
+
|
|
44
|
+
### [Lesson 2: Creating Your Alignment Document](lesson-02-creating-alignment-document.md)
|
|
45
|
+
|
|
46
|
+
**Time:** 20 minutes
|
|
47
|
+
|
|
48
|
+
- **The discovery phase**: Ask questions until you find the real pain point
|
|
49
|
+
- **Resist solving in the discovery meeting**: Take notes, confirm, then stop
|
|
50
|
+
- The 10 sections of an alignment document
|
|
51
|
+
- How to explore sections flexibly
|
|
52
|
+
- Extracting information from existing communications
|
|
53
|
+
- Synthesizing into a clear, compelling document
|
|
54
|
+
|
|
55
|
+
### [Lesson 3: Negotiation & Acceptance](lesson-03-negotiation-acceptance.md)
|
|
56
|
+
|
|
57
|
+
**Time:** 10 minutes
|
|
58
|
+
|
|
59
|
+
- Sharing with stakeholders
|
|
60
|
+
- Gathering feedback and iterating
|
|
61
|
+
- Getting acceptance and alignment
|
|
62
|
+
- When everyone is on the same page
|
|
63
|
+
|
|
64
|
+
### [Lesson 4: External Contracts](lesson-04-external-contracts.md)
|
|
65
|
+
|
|
66
|
+
**Time:** 15 minutes
|
|
67
|
+
|
|
68
|
+
- When you need external contracts (consultant → client, business → suppliers)
|
|
69
|
+
- Project Contract vs. Service Agreement
|
|
70
|
+
- Key contract clauses and best practices
|
|
71
|
+
- Business models (fixed-price, hourly, retainer)
|
|
72
|
+
- Payment terms, scope protection, legal framework
|
|
73
|
+
|
|
74
|
+
### [Lesson 5: Internal Signoff Documents](lesson-05-internal-signoff.md)
|
|
75
|
+
|
|
76
|
+
**Time:** 10 minutes
|
|
77
|
+
|
|
78
|
+
- When you need internal signoff (manager/employee seeking approval)
|
|
79
|
+
- Internal signoff document structure
|
|
80
|
+
- Company signoff format adaptation
|
|
81
|
+
- Approval workflows and stakeholders
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Tutorial
|
|
86
|
+
|
|
87
|
+
**[Tutorial: Alignment & Signoff →](tutorial-03.md)**
|
|
88
|
+
|
|
89
|
+
Step-by-step hands-on guide to creating your alignment document and securing signoff.
|
|
90
|
+
|
|
91
|
+
**Time:** 55-75 minutes
|
|
92
|
+
**What you'll create:** Complete alignment document and signoff document (external contract or internal signoff)
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## Key Concepts
|
|
97
|
+
|
|
98
|
+
**The Discovery Discipline:**
|
|
99
|
+
- **Understand before you solve** - The carpenter measures twice, the doctor diagnoses first
|
|
100
|
+
- **Separate discovery from solution** - Don't present solutions in the first meeting
|
|
101
|
+
- **Ask until you find the pain point** - Keep digging deeper to understand the real issue
|
|
102
|
+
- **Take notes, confirm understanding, then stop** - Come back with a thoughtful proposal
|
|
103
|
+
|
|
104
|
+
**Alignment Document (Pitch):**
|
|
105
|
+
- Created AFTER discovery phase
|
|
106
|
+
- Makes the case for why the project matters
|
|
107
|
+
- Gets stakeholders aligned on Idea, Why, What, How, Budget, Commitment
|
|
108
|
+
- Readable in 2-3 minutes
|
|
109
|
+
- Allows negotiation and iteration
|
|
110
|
+
|
|
111
|
+
**Signoff Documents:**
|
|
112
|
+
- **External Contracts**: Project Contract (consultant → client) or Service Agreement (business → suppliers)
|
|
113
|
+
- Includes legal protections, payment terms, IP ownership
|
|
114
|
+
- Different business models (fixed-price, hourly, retainer)
|
|
115
|
+
- **Internal Signoff**: For internal company projects
|
|
116
|
+
- May follow company-specific formats
|
|
117
|
+
- Focuses on approval workflows and budget allocation
|
|
118
|
+
- Both include scope, investment, timeline, deliverables
|
|
119
|
+
|
|
120
|
+
**The Flow:**
|
|
121
|
+
1. **Discovery meeting** - Listen: Ask questions, understand their goals and what's important for success
|
|
122
|
+
2. **Stop & reflect** - "Let me think about this and come back with a thoughtful proposal"
|
|
123
|
+
3. **Create alignment document** - Create: Build pitch based on what they told you
|
|
124
|
+
4. **Presentation meeting** - Present: Share proposal showing you understood them
|
|
125
|
+
5. **Iterate** - Negotiate: Adjust and refine together to find the perfect match
|
|
126
|
+
6. **Get acceptance** - Accept: They say yes to the pitch
|
|
127
|
+
7. **Generate signoff** - Contract: Create short, clear contract based on accepted pitch
|
|
128
|
+
8. **Sign** - Both parties sign
|
|
129
|
+
9. **Proceed to Project Brief** - Brief: Use pitch and contract as the backbone
|
|
130
|
+
|
|
131
|
+
**Key:** Pitch and contract become the foundation for your project brief - not throwaway documents.
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Learning Outcomes
|
|
136
|
+
|
|
137
|
+
By the end of this module, you will:
|
|
138
|
+
|
|
139
|
+
- ✅ Understand the discipline of discovery before solution
|
|
140
|
+
- ✅ Know how to ask questions that reveal what success looks like for them
|
|
141
|
+
- ✅ Be able to separate discovery meetings from solution presentation
|
|
142
|
+
- ✅ Understand when you need stakeholder alignment
|
|
143
|
+
- ✅ Know how to create a compelling alignment document based on real understanding
|
|
144
|
+
- ✅ Be able to negotiate and iterate until acceptance
|
|
145
|
+
- ✅ Generate appropriate external contracts or internal signoff documents
|
|
146
|
+
- ✅ Know when to skip this module and go straight to Project Brief
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## When to Skip This Module
|
|
151
|
+
|
|
152
|
+
**Skip if:**
|
|
153
|
+
- You're doing the project yourself
|
|
154
|
+
- You have full autonomy
|
|
155
|
+
- You don't need stakeholder approval
|
|
156
|
+
|
|
157
|
+
**Go directly to:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
|
|
158
|
+
|
|
159
|
+
---
|
|
160
|
+
|
|
161
|
+
## Start Learning
|
|
162
|
+
|
|
163
|
+
**[Begin with Lesson 1: Understanding Alignment →](lesson-01-understanding-alignment.md)**
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
[← Back to Course Overview](../00-course-overview.md) | [Next: Module 04: Create Project Brief →](../module-04-project-brief/tutorial-04.md)
|
|
168
|
+
|
|
169
|
+
*Part of the WDS Course: From Designer to Linchpin*
|
|
170
|
+
|
|
@@ -0,0 +1,344 @@
|
|
|
1
|
+
# Tutorial 03: Alignment & Signoff
|
|
2
|
+
|
|
3
|
+
**Hands-on guide to discovering needs, getting stakeholders aligned, and securing commitment**
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
This tutorial walks you through the professional process of understanding what your stakeholders need, creating an alignment document (pitch) based on that understanding, and securing formal signoff before starting your project.
|
|
10
|
+
|
|
11
|
+
**Time:** 60-90 minutes (including discovery meeting)
|
|
12
|
+
**Prerequisites:** Module 02 completed (WDS installed)
|
|
13
|
+
**What you'll create:** Discovery notes, alignment document, and signoff document
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## What You'll Learn
|
|
18
|
+
|
|
19
|
+
- **The discovery discipline** - how to understand their outcomes before proposing solutions
|
|
20
|
+
- **The two-meeting approach** - separating discovery from solution presentation
|
|
21
|
+
- **Professional patience** - the carpenter measures twice, the doctor diagnoses first
|
|
22
|
+
- How to ask discovery questions that reveal what success looks like
|
|
23
|
+
- Creating a compelling alignment document based on real understanding
|
|
24
|
+
- Negotiating and iterating until acceptance
|
|
25
|
+
- Generating appropriate signoff documents
|
|
26
|
+
- Understanding contract clauses and best practices
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Before You Start
|
|
31
|
+
|
|
32
|
+
**You'll need:**
|
|
33
|
+
- A project idea that needs stakeholder alignment
|
|
34
|
+
- **Access to a stakeholder for a discovery conversation**
|
|
35
|
+
- 60-90 minutes of focused time (including meeting time)
|
|
36
|
+
- Optional: Existing communications/documents from stakeholders
|
|
37
|
+
|
|
38
|
+
**AI Support:**
|
|
39
|
+
- **Saga WDS Analyst Agent** will guide you through the process
|
|
40
|
+
- She'll help you prepare for discovery
|
|
41
|
+
- Help you craft discovery questions
|
|
42
|
+
- Guide you through creating the alignment document AFTER discovery
|
|
43
|
+
- Help generate the signoff document after acceptance
|
|
44
|
+
|
|
45
|
+
**Critical mindset:** You are NOT ready to pitch until you understand what they need. Discovery comes first.
|
|
46
|
+
|
|
47
|
+
---
|
|
48
|
+
|
|
49
|
+
## Step 1: Prepare for Discovery (5 min)
|
|
50
|
+
|
|
51
|
+
**First, clarify your scenario:**
|
|
52
|
+
|
|
53
|
+
- **Consultant proposing to client** → Discovery will help you understand their business needs
|
|
54
|
+
- **Business hiring suppliers** → Discovery will help you clarify what you're buying
|
|
55
|
+
- **Manager/employee seeking approval** → Discovery will help you understand stakeholder priorities
|
|
56
|
+
- **Doing it yourself** → Skip this tutorial, go to Module 04: Create Project Brief
|
|
57
|
+
|
|
58
|
+
**Your scenario:** [Write your scenario here]
|
|
59
|
+
|
|
60
|
+
**With Saga, prepare your discovery questions:**
|
|
61
|
+
- What do you want to learn?
|
|
62
|
+
- What questions will reveal what success looks like for them?
|
|
63
|
+
- What pain points do you suspect exist (to be confirmed)?
|
|
64
|
+
|
|
65
|
+
---
|
|
66
|
+
|
|
67
|
+
## Step 2: Conduct Discovery Meeting (20-30 min)
|
|
68
|
+
|
|
69
|
+
**This is the most important step. Do NOT skip this.**
|
|
70
|
+
|
|
71
|
+
**Your goal:** Understand what they need, NOT pitch your solution.
|
|
72
|
+
|
|
73
|
+
**In the discovery meeting:**
|
|
74
|
+
|
|
75
|
+
1. **Ask questions** - Use the questions you prepared with Saga
|
|
76
|
+
|
|
77
|
+
*Understanding their outcomes:*
|
|
78
|
+
- "What does success look like for you?"
|
|
79
|
+
- "What's not working right now?"
|
|
80
|
+
- "Tell me more about that..."
|
|
81
|
+
- "How does that impact your business/team/users?"
|
|
82
|
+
- "What happens if we don't solve this?"
|
|
83
|
+
- "What have you tried before?"
|
|
84
|
+
- "What would make this a home run?"
|
|
85
|
+
|
|
86
|
+
*Understanding their risks and concerns:*
|
|
87
|
+
- "Is there something specific you're concerned about?"
|
|
88
|
+
- "What would help you feel confident about moving forward?"
|
|
89
|
+
- "What lessons have you learned from past projects?"
|
|
90
|
+
- "What would make you feel this is going well as we proceed?"
|
|
91
|
+
- "What dependencies or external factors should we plan for?"
|
|
92
|
+
- "What would be important to include in our agreement?"
|
|
93
|
+
- "How would you like us to handle changes or unexpected situations?"
|
|
94
|
+
|
|
95
|
+
2. **Listen deeply** - Take detailed notes on what they say (both opportunities AND concerns)
|
|
96
|
+
|
|
97
|
+
3. **Find the pain point AND the risks** - Keep asking until you understand both what they want to achieve and what they're worried about
|
|
98
|
+
|
|
99
|
+
4. **Confirm both exist** - "So if I understand correctly, you're looking to achieve X, which will deliver Y, and you'd like us to plan for Z?"
|
|
100
|
+
|
|
101
|
+
5. **Resist the urge to solve** - Even if you see the perfect solution, DON'T present it yet
|
|
102
|
+
- The carpenter measures twice
|
|
103
|
+
- The doctor diagnoses first
|
|
104
|
+
- You understand before solving
|
|
105
|
+
|
|
106
|
+
6. **End with commitment to return** - "Thank you for sharing this - your goals and what's important to you for this to succeed. Let me think about how I can help you achieve what you need while addressing what you've mentioned. I'll come back to you with a thoughtful proposal."
|
|
107
|
+
|
|
108
|
+
**Why discover risks?** Understanding what's important to them for the project to succeed helps you:
|
|
109
|
+
- Create contract provisions that give them confidence
|
|
110
|
+
- Set realistic expectations together
|
|
111
|
+
- Build trust by showing you're thinking about how to make this successful
|
|
112
|
+
- Design solutions that address what matters to them
|
|
113
|
+
- Include mutually beneficial protections in the agreement
|
|
114
|
+
|
|
115
|
+
**Take detailed notes** during or immediately after the meeting.
|
|
116
|
+
|
|
117
|
+
---
|
|
118
|
+
|
|
119
|
+
## Step 3: Extract Information & Reflect (10 min)
|
|
120
|
+
|
|
121
|
+
**Now work with Saga to synthesize what you learned:**
|
|
122
|
+
|
|
123
|
+
Share your discovery notes with Saga. She will help you extract:
|
|
124
|
+
- Realizations or observations they mentioned
|
|
125
|
+
- Their definition of success
|
|
126
|
+
- Pain points they're experiencing
|
|
127
|
+
- **Concerns and risks they raised** (these will inform contract provisions)
|
|
128
|
+
- **Past project problems they mentioned** (what went wrong before)
|
|
129
|
+
- Requirements they discussed
|
|
130
|
+
- What happens if they don't solve this
|
|
131
|
+
- Context and background
|
|
132
|
+
- Timeline or urgency
|
|
133
|
+
- Budget or constraints
|
|
134
|
+
- **Dependencies and constraints**
|
|
135
|
+
- **What would make them uncomfortable**
|
|
136
|
+
|
|
137
|
+
**Critical check:** Can you clearly articulate:
|
|
138
|
+
1. What success looks like for THEM in their own words?
|
|
139
|
+
2. What specific concerns and risks they mentioned?
|
|
140
|
+
|
|
141
|
+
- **If YES to both:** You're ready to create the alignment document AND design contract provisions that address real concerns
|
|
142
|
+
- **If NO to either:** You need another discovery conversation or follow-up questions
|
|
143
|
+
|
|
144
|
+
**The risks you discover become contract protections:** For example:
|
|
145
|
+
- They mention "past contractors disappeared mid-project" → Include milestone-based payments and regular check-ins in contract
|
|
146
|
+
- They mention "we've had scope creep before" → Include detailed "What's NOT included" section and change order process
|
|
147
|
+
- They mention "we got stuck waiting on vendor access" → Include dependency management and pause clauses
|
|
148
|
+
- They mention "timeline is critical for launch date" → Include time-based milestones and delay penalties/protections
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Step 4: Explore Alignment Sections (20-30 min)
|
|
153
|
+
|
|
154
|
+
**Work through these 10 sections** (in whatever order makes sense) **based on what you learned in discovery:**
|
|
155
|
+
|
|
156
|
+
1. **The Realization** - What they've said needs attention (use their evidence)
|
|
157
|
+
2. **Why It Matters** - Why this matters to THEM and who they help (use their words)
|
|
158
|
+
3. **How We See It Working** - Your solution approach (based on understanding their needs)
|
|
159
|
+
4. **Paths We Explored** - 2-3 solution options you considered
|
|
160
|
+
5. **Recommended Solution** - Preferred approach and why it serves them
|
|
161
|
+
6. **The Path Forward** - How the work will be done (WDS phases and practical approach)
|
|
162
|
+
7. **The Value We'll Create** - What happens if they DO build this (their desired outcomes)
|
|
163
|
+
8. **Cost of Inaction** - What happens if they DON'T build this (their stated consequences)
|
|
164
|
+
9. **Our Commitment** - Resources needed and potential risks
|
|
165
|
+
10. **Summary** - Summary reflecting back their needs
|
|
166
|
+
|
|
167
|
+
**Saga will guide you** through each section, asking one question at a time and reflecting back what she hears.
|
|
168
|
+
|
|
169
|
+
**Key principle:** Everything should connect back to what they told you in discovery. You're not making this up - you're synthesizing their needs into a clear proposal.
|
|
170
|
+
|
|
171
|
+
### Best Practice: Realization Section with Evidence
|
|
172
|
+
|
|
173
|
+
**When exploring "The Realization" section**, Saga will help you:
|
|
174
|
+
|
|
175
|
+
1. **Identify the realization** - What have you realized needs attention?
|
|
176
|
+
2. **Confirm it's real** - Is there evidence that supports this?
|
|
177
|
+
3. **Gather evidence** - What proof do you have?
|
|
178
|
+
|
|
179
|
+
**Soft Evidence** (qualitative):
|
|
180
|
+
- Testimonials: "Customers tell us..."
|
|
181
|
+
- Complaints: "Support tickets show..."
|
|
182
|
+
- Observations: "We've noticed that..."
|
|
183
|
+
- Interviews: "In user interviews, people mentioned..."
|
|
184
|
+
|
|
185
|
+
**Hard Evidence** (quantitative):
|
|
186
|
+
- Statistics: "45% of users..."
|
|
187
|
+
- Analytics: "Bounce rate increased 25%..."
|
|
188
|
+
- Surveys: "78% rated this as 'difficult'..."
|
|
189
|
+
- Logs: "Server logs show 500 errors occur..."
|
|
190
|
+
|
|
191
|
+
**Example:**
|
|
192
|
+
> "Our customers consistently report frustration with checkout (testimonials). Analytics confirm: 45% abandon checkout, taking 12 minutes on average - 3x longer than industry standard (statistics). Support tickets show 60% of complaints are about checkout complexity (complaints), and our survey found 78% rated it as 'difficult' (survey results)."
|
|
193
|
+
|
|
194
|
+
**If you don't have evidence yet:** That's okay! Acknowledge this and propose gathering evidence as part of the project.
|
|
195
|
+
|
|
196
|
+
---
|
|
197
|
+
|
|
198
|
+
## Step 5: Synthesize Alignment Document (5 min)
|
|
199
|
+
|
|
200
|
+
**Saga will help you create:**
|
|
201
|
+
|
|
202
|
+
`docs/1-project-brief/pitch.md`
|
|
203
|
+
|
|
204
|
+
- Clear, brief, readable in 2-3 minutes
|
|
205
|
+
- Makes the case for the project using their language
|
|
206
|
+
- Reflects back what they told you they need
|
|
207
|
+
- Ready to share with stakeholders in your SECOND meeting
|
|
208
|
+
|
|
209
|
+
**Review together:** Does this capture what they said they need? Does it show you understand their desired outcomes?
|
|
210
|
+
|
|
211
|
+
---
|
|
212
|
+
|
|
213
|
+
## Step 6: Presentation Meeting - Share & Negotiate (Variable time)
|
|
214
|
+
|
|
215
|
+
**Now schedule your SECOND meeting with the stakeholder:**
|
|
216
|
+
|
|
217
|
+
- Present the alignment document
|
|
218
|
+
- Show you understood what they need
|
|
219
|
+
- Gather feedback
|
|
220
|
+
- Make changes and iterate
|
|
221
|
+
- Update until everyone is on board
|
|
222
|
+
|
|
223
|
+
**This is negotiation, not rejection:** Their feedback helps you refine the proposal until it serves them perfectly.
|
|
224
|
+
|
|
225
|
+
**Remember:** You're not defending your idea - you're collaborating to find the version that works for everyone.
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
## Step 7: Get Acceptance (Variable time)
|
|
230
|
+
|
|
231
|
+
**Once stakeholders accept:**
|
|
232
|
+
- Everyone is aligned on Idea, Why, What, How, Budget, Commitment
|
|
233
|
+
- You have buy-in before starting detailed work
|
|
234
|
+
- Ready to secure formal commitment
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## Step 8: Generate Signoff Document (15-20 min)
|
|
239
|
+
|
|
240
|
+
**After acceptance, Saga will help you create:**
|
|
241
|
+
|
|
242
|
+
**Choose your document type:**
|
|
243
|
+
1. **Project Contract** - For consultant → client
|
|
244
|
+
2. **Service Agreement** - For business → suppliers
|
|
245
|
+
3. **Signoff Document** - For internal company projects
|
|
246
|
+
- *Optional: Upload your company's signoff format*
|
|
247
|
+
|
|
248
|
+
**Key principle: Short and concise contracts**
|
|
249
|
+
|
|
250
|
+
The Strategic Professional emphasizes: "Long contracts are hard to understand, and it's easier to hide strange provisions in dense text. Keep it clear and brief. The contract is based on the pitch they already accepted - you're formalizing what they agreed to, not writing from scratch."
|
|
251
|
+
|
|
252
|
+
**Saga will guide you through:**
|
|
253
|
+
- **Scope of work** - References the accepted pitch (what's in, what's explicitly out)
|
|
254
|
+
- **Deliverables** - From the pitch
|
|
255
|
+
- **Timeline** - Milestones from the pitch
|
|
256
|
+
- **Payment terms** - Cost and payment schedule from the pitch (with upfront payment guidance for fixed-price contracts)
|
|
257
|
+
- **Change order process** - How scope changes are handled
|
|
258
|
+
- **Acceptance criteria** - When work is considered complete (from their definition of success in the pitch)
|
|
259
|
+
- **Intellectual property ownership** - Who owns what
|
|
260
|
+
- **Termination clause** - How either party can exit
|
|
261
|
+
- **Confidentiality** - If needed
|
|
262
|
+
- **Legal jurisdiction and contract language** - If needed
|
|
263
|
+
- **Work initiation terms** - When work begins
|
|
264
|
+
- **Dispute resolution** - If needed
|
|
265
|
+
- **Warranties & limitations** - What you guarantee (and don't)
|
|
266
|
+
|
|
267
|
+
**The contract references the pitch** - Everything points back to the accepted alignment document. This keeps it short, clear, and aligned.
|
|
268
|
+
|
|
269
|
+
**Output:** `docs/1-project-brief/[contract/service-agreement/signoff].md`
|
|
270
|
+
|
|
271
|
+
---
|
|
272
|
+
|
|
273
|
+
## Step 9: Finalize & Proceed (5 min)
|
|
274
|
+
|
|
275
|
+
**Once signoff document is finalized:**
|
|
276
|
+
- ✅ Alignment achieved
|
|
277
|
+
- ✅ Commitment secured
|
|
278
|
+
- ✅ Foundation established
|
|
279
|
+
- ✅ Pitch and contract ready to become backbone of project brief
|
|
280
|
+
|
|
281
|
+
**The connection:** The pitch and contract aren't throwaway documents. When you move to Module 04 to create your Project Brief, these documents become the foundation. The brief builds on the alignment and legal framework you've established.
|
|
282
|
+
|
|
283
|
+
**Workflow complete:**
|
|
284
|
+
1. ✅ Listen - Discovery meeting
|
|
285
|
+
2. ✅ Create - Pitch based on understanding
|
|
286
|
+
3. ✅ Present - Shared proposal
|
|
287
|
+
4. ✅ Negotiate - Refined together
|
|
288
|
+
5. ✅ Accept - They said yes
|
|
289
|
+
6. ✅ Contract - Short, clear, based on pitch
|
|
290
|
+
7. ✅ Sign - Both parties committed
|
|
291
|
+
8. ➡️ **Next:** Brief - Use pitch and contract as backbone
|
|
292
|
+
|
|
293
|
+
**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md)
|
|
294
|
+
|
|
295
|
+
---
|
|
296
|
+
|
|
297
|
+
## Success Criteria
|
|
298
|
+
|
|
299
|
+
You've completed this tutorial when:
|
|
300
|
+
- ✅ Discovery meeting completed with detailed notes
|
|
301
|
+
- ✅ Can clearly articulate what success looks like for them
|
|
302
|
+
- ✅ Alignment document created based on real understanding
|
|
303
|
+
- ✅ Alignment document shared in presentation meeting
|
|
304
|
+
- ✅ Stakeholders have accepted (everyone aligned)
|
|
305
|
+
- ✅ Signoff document generated and ready for signature
|
|
306
|
+
- ✅ Ready to proceed to Project Brief
|
|
307
|
+
|
|
308
|
+
---
|
|
309
|
+
|
|
310
|
+
## Common Questions
|
|
311
|
+
|
|
312
|
+
**Q: Can I skip the discovery meeting?**
|
|
313
|
+
A: No - that's where you learn what they actually need. Without it, you're guessing.
|
|
314
|
+
|
|
315
|
+
**Q: What if I think I already know what they need?**
|
|
316
|
+
A: The carpenter still measures twice. Confirm your assumptions with real discovery questions.
|
|
317
|
+
|
|
318
|
+
**Q: Can I present a solution in the discovery meeting?**
|
|
319
|
+
A: Resist that urge. Take notes, confirm understanding, say "Let me think about this." Come back with something thoughtful.
|
|
320
|
+
|
|
321
|
+
**Q: Do I always need this?**
|
|
322
|
+
A: No - skip if you're doing it yourself or have full autonomy.
|
|
323
|
+
|
|
324
|
+
**Q: Can I skip the signoff document?**
|
|
325
|
+
A: Yes - the alignment document might be enough. Signoff formalizes the commitment.
|
|
326
|
+
|
|
327
|
+
**Q: What if stakeholders want changes?**
|
|
328
|
+
A: That's normal! Iterate and negotiate until everyone is on board. Their feedback makes the proposal better.
|
|
329
|
+
|
|
330
|
+
**Q: How long does the whole process take?**
|
|
331
|
+
A: Variable - discovery meeting (30-60 min), document creation (30-60 min), presentation & negotiation (variable, could be hours or days). The time invested in understanding saves weeks of misalignment later.
|
|
332
|
+
|
|
333
|
+
---
|
|
334
|
+
|
|
335
|
+
## Next Steps
|
|
336
|
+
|
|
337
|
+
**[Continue to Module 04: Create Project Brief →](../module-04-project-brief/tutorial-04.md)**
|
|
338
|
+
|
|
339
|
+
---
|
|
340
|
+
|
|
341
|
+
[← Back to Module Overview](module-03-overview.md) | [Back to Course Overview](../00-course-overview.md)
|
|
342
|
+
|
|
343
|
+
*Part of the WDS Course: From Designer to Linchpin*
|
|
344
|
+
|