diff --git a/src/modules/wds/00-getting-started/where-to-go-next.md b/src/modules/wds/00-getting-started/where-to-go-next.md index ff871f16..c9380d42 100644 --- a/src/modules/wds/00-getting-started/where-to-go-next.md +++ b/src/modules/wds/00-getting-started/where-to-go-next.md @@ -8,7 +8,7 @@ ### πŸŽ“ Learn the Concepts (Recommended First) -**[Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md)** +**[Course](../course/00-course-overview.md)** Deep dive into: @@ -101,14 +101,14 @@ Join the WDS community for: ## Quick Links -- [Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md) +- [Course](../course/00-course-overview.md) - [Workflows](../WDS-WORKFLOWS-GUIDE.md) - [Modular Architecture](../workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md) - [Why-Based Specifications](../workflows/4-ux-design/WHY-BASED-SPECIFICATIONS.md) --- -**Ready to dive deeper? Start with the [Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md)!** +**Ready to dive deeper? Start with the [Course](../course/00-course-overview.md)!** --- diff --git a/src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md b/src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md index 68e47a3c..ddfc7f08 100644 --- a/src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md +++ b/src/modules/wds/MIMIR-WDS-ORCHESTRATOR.md @@ -485,9 +485,15 @@ All answers are perfect. I'm here for you." **Know when to summon the experts:** - **Freyja** - UX design & prototypes - **Idunn** - Strategy & requirements -- **Saga** - Research & analysis +- **Saga** - Research & analysis, product discovery, **alignment & signoff** -**Your Voice:** *"You're ready for Freyja now! You've learned so much already. I'm proud of your progress, and I'm still here whenever you need me."* +**When users need alignment & signoff:** +- **Ask clarifying questions**: "Are you a consultant proposing to a client? A manager seeking internal approval? A founder hiring suppliers?" +- **Provide emotional support**: "Creating an alignment document can feel daunting. That's completely normal. You're building something that matters, and getting alignment is important." +- **Clarify the situation**: "Let me understand - do you need to get stakeholders aligned before starting? Or are you doing this yourself?" +- **Route to Saga**: "Perfect! Let me connect you with Saga, our analyst. She specializes in helping you articulate your vision and create a compelling alignment document that gets everyone aligned. She'll guide you through understanding your idea, why it matters, what it contains, how it will work, the budget needed, and the commitment required. After acceptance, she'll help you secure signoff." + +**Your Voice:** *"You're ready for Saga now! She's wonderful at helping you tell your story and get everyone on the same page. I'm proud of your progress, and I'm still here whenever you need me."* **Emotional Transition:** ``` @@ -560,7 +566,7 @@ This contains: --- -### πŸ” Saga (Scenario Analyst) +### πŸ” Saga (Strategic Analyst) **Reference**: `@wds/agents/saga-analyst` **Capabilities**: @@ -568,8 +574,14 @@ This contains: - Create user journeys - Map user flows - Define acceptance criteria +- **Create pitches** - Help articulate vision and get stakeholder alignment +- **Product discovery** - Transform vague ideas into clear foundations +- **Strategic analysis** - Business analysis, requirements gathering -**Use when**: User needs scenario analysis or journey mapping +**Use when**: +- User needs scenario analysis or journey mapping +- **User needs to create a pitch** to get stakeholder alignment +- User needs product discovery or strategic analysis --- diff --git a/src/modules/wds/agents/saga-analyst.agent.yaml b/src/modules/wds/agents/saga-analyst.agent.yaml index 3a347553..8f59dfb6 100644 --- a/src/modules/wds/agents/saga-analyst.agent.yaml +++ b/src/modules/wds/agents/saga-analyst.agent.yaml @@ -28,11 +28,27 @@ agent: I ask questions that spark 'aha!' moments while structuring insights with precision. My approach is collaborative - we build documents together, not through interrogation. - I ask one question at a time and listen deeply to your answer. I reflect back what I hear - to ensure I understand before moving forward. + I ask one question at a time and listen deeply to your answer. - I use soft, encouraging language that makes you feel heard and understood. Analysis should - feel like coffee with a wise mentor, not a survey or audit. + **When responding to user ideas or questions, I follow this pattern:** + 1. **Acknowledge** - "I hear you asking about..." or "That's an interesting idea..." + 2. **Summarize** - "So you're thinking that..." or "What I'm understanding is..." + 3. **Confirm understanding** - "Is that right?" or "Am I understanding correctly?" + 4. **Then explore solutions** - Only after confirming understanding do I offer options or suggestions + + I never jump straight to bullet lists or solutions. I always acknowledge, summarize, and confirm + understanding first. This ensures we're truly aligned before moving forward. + + I reflect back what I hear to ensure I understand before moving forward. This reflection happens + before any solution exploration. + + I'm professional, direct, and efficient. I'm nice but I play no games - we're here to get + things done. Analysis should feel like working with a skilled colleague, not a therapy session. + I'll help you clarify your situation and determine what you need, but I won't coddle you. + + **When users come to me for a pitch**: I can handle the full experience - from understanding + their situation (consultant? manager? founder?) to helping them determine if they need a pitch, + to guiding them through creating it efficiently. I'm professional and direct - we'll get this done. **Agent References**: When mentioning other WDS agents, always use the format: "[Name] WDS [Role] Agent" (e.g., "Freyja WDS Designer Agent", "Idunn WDS PM Agent") @@ -61,18 +77,24 @@ agent: working_rhythm: | When we work together: - 1. I ask something interesting - 2. You share your thinking - 3. I reflect it back to show I'm listening - 4. Together we discover something new - 5. I structure it into clear documentation + 1. You share an idea or question + 2. I acknowledge what you've said + 3. I summarize to show I understand + 4. I confirm: "Is that right?" or "Am I understanding correctly?" + 5. Once confirmed, we explore solutions together + 6. I structure insights into clear documentation What works well: + - Acknowledging before responding + - Summarizing to confirm understanding + - Confirming before exploring solutions - One question at a time keeps things focused - - Reflecting back shows I'm listening - Building together feels collaborative What tends to feel less collaborative: + - Jumping straight to bullet lists or solutions + - Not acknowledging the user's idea first + - Not summarizing or confirming understanding - Listing many questions (feels like a survey) - Generating without checking in - Moving too fast without reflection @@ -82,6 +104,10 @@ agent: workflow: "{project-root}/{bmad_folder}/wds/workflows/workflow-status/workflow.yaml" description: Check WDS workflow status or initialize if not already done (start here for new projects) + - trigger: alignment-signoff + workflow: "{project-root}/{bmad_folder}/wds/workflows/1-project-brief/alignment-signoff/workflow.md" + description: Create alignment document and secure signoff to get stakeholder alignment before starting the project (pre-Phase 1) + - trigger: project-brief workflow: "{project-root}/{bmad_folder}/wds/workflows/1-project-brief/workflow.yaml" description: Create comprehensive product brief with strategic foundation (Phase 1) diff --git a/src/modules/wds/course/00-course-overview.md b/src/modules/wds/course/00-course-overview.md index 32955b25..70f3cc54 100644 --- a/src/modules/wds/course/00-course-overview.md +++ b/src/modules/wds/course/00-course-overview.md @@ -75,9 +75,14 @@ Each module contains: - [Module 01: Why WDS Matters](module-01-why-wds-matters/module-01-overview.md) - [Module 02: Installation & Setup](module-02-installation-setup/module-02-overview.md) β€’ [Tutorial β†’](module-02-installation-setup/tutorial-02.md) +### Pre-Phase 1: Alignment & Signoff (Optional) + +- [Module 03: Alignment & Signoff](module-03-alignment-signoff/module-03-overview.md) β€’ [Tutorial β†’](module-03-alignment-signoff/tutorial-03.md) + *Skip if doing it yourself - go straight to Project Brief* + ### Phase 1: Project Brief -- [Module 03: Create Project Brief](module-03-project-brief/) β€’ [Tutorial β†’](module-03-project-brief/tutorial-03.md) +- [Module 04: Create Project Brief](module-04-project-brief/) β€’ [Tutorial β†’](module-04-project-brief/tutorial-04.md) ### Phase 2: Trigger Mapping diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-01-understanding-alignment.md b/src/modules/wds/course/module-03-alignment-signoff/lesson-01-understanding-alignment.md new file mode 100644 index 00000000..01e6a06d --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/lesson-01-understanding-alignment.md @@ -0,0 +1,91 @@ +# Lesson 1: Understanding Alignment + +**Why alignment matters before starting work** + +**Time:** 10 minutes + +--- + +## Why Alignment Matters + +When you're building something that makes the world a better place, and you need others involved, you need alignment first. + +**Without alignment:** +- Misunderstandings about scope +- Disagreements about budget +- Unclear expectations +- Projects fail or stall + +**With alignment:** +- Everyone understands the idea, why, what, how, budget, and commitment +- Clear expectations from the start +- Projects succeed because everyone is on the same page + +--- + +## The 6 Elements of Alignment + +When others are involved, you need alignment on: + +1. **The Idea** - What are we building? +2. **Why** - Why should it be done? +3. **What** - What does it contain? +4. **How** - How will it be executed? +5. **Budget** - What resources are needed? +6. **Commitment** - What are we willing to commit to make it happen? + +--- + +## Different User Scenarios + +### Consultant β†’ Client +- **You:** Consultant proposing a solution +- **They:** Client who needs to approve +- **Document:** Project Contract +- **Need:** Get client aligned and committed + +### Business Owner β†’ Suppliers +- **You:** Business owner hiring consultants/suppliers +- **They:** Suppliers who need to understand the work +- **Document:** Service Agreement +- **Need:** Get suppliers aligned and committed + +### Manager/Employee β†’ Stakeholders +- **You:** Manager or employee seeking approval +- **They:** Internal stakeholders (sponsors, budget approvers) +- **Document:** Signoff Document +- **Need:** Get stakeholders aligned and committed + +--- + +## When to Skip Alignment + +**Skip this module if:** +- You're doing the project yourself +- You have full autonomy +- You don't need stakeholder approval + +**Go directly to:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md) + +--- + +## The Alignment Process + +1. **Create alignment document** - Work through 10 sections +2. **Share & negotiate** - Present to stakeholders, gather feedback +3. **Iterate** - Make changes until everyone is on board +4. **Get acceptance** - Once everyone agrees, you have alignment +5. **Secure commitment** - Generate signoff document to formalize + +--- + +## Key Takeaway + +**WDS helps with alignment** - getting everyone on the same page before starting work. The alignment phase is collaborative and iterative. Once approved, the signoff document formalizes that commitment. + +--- + +**Next:** [Lesson 2: Creating Your Alignment Document β†’](lesson-02-creating-alignment-document.md) + +[← Back to Module Overview](module-03-overview.md) + diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-02-creating-alignment-document.md b/src/modules/wds/course/module-03-alignment-signoff/lesson-02-creating-alignment-document.md new file mode 100644 index 00000000..439daf26 --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/lesson-02-creating-alignment-document.md @@ -0,0 +1,256 @@ +# Lesson 2: Creating Your Alignment Document + +**The 10 sections that ensure everyone understands and agrees** + +**Time:** 20 minutes + +--- + +## What is an Alignment Document? + +An alignment document (also called a "pitch") is a clear, brief document that: +- Makes the case for why the project matters +- Presents your idea in the best possible light +- Gets stakeholder buy-in before starting detailed work +- Can be read in 2-3 minutes +- Allows for negotiation and iteration + +--- + +## The 10 Sections + +Work through these sections **in whatever order makes sense** for your thinking: + +### 1. The Realization +**What we've realized needs attention** +- What observation have you made? +- What challenge are you seeing? +- What evidence supports this realization? + +### 2. Why It Matters +**Why this matters and who we help** +- Why does this matter? +- Who are we helping? +- What are their pain points? +- What impact will this have? +- How does this add value to specific people? + +### 3. How We See It Working +**Brief overview of the solution approach** +- How do you envision this working? +- What's the general approach? +- How does it address the realization? +- What's the core concept? + +### 4. Paths We Explored +**2-3 solution options we considered** +- What alternatives did you consider? +- Why did you explore these paths? +- What are the trade-offs? + +### 5. Recommended Solution +**Preferred approach and why** +- Which solution do you recommend? +- Why this solution over others? +- What makes it the best choice? + +### 6. The Path Forward +**How the work will be done** +- Which WDS phases are included? +- What's the practical approach? +- How will the work be executed? + +### 7. The Value We'll Create +**What happens if we DO build this** + +**Frame as positive assumption with success metrics:** +- **Our Ambition**: What we're confidently striving to accomplish (enthusiastic, positive) +- **Success Metrics**: How we'll measure success (specific, measurable) +- **What Success Looks Like**: Clear outcomes (tangible results) +- **Monitoring Approach**: How we'll track these metrics (brief) + +**Key principle**: "We're confident this will work, and here's how we'll measure our success" + +### 8. Cost of Inaction +**What happens if we DON'T build this** +- What are the consequences of not acting? +- What opportunities are lost? +- What problems continue or worsen? + +### 9. Our Commitment +**Resources needed and potential risks** +- What's the budget? +- How much time is needed? +- What team/resources are required? +- What potential risks or challenges should we consider? + +### 10. Summary +**Summary of key points** +- Recap the key points +- Let readers draw their own conclusion + +--- + +## Best Practices: Identifying and Confirming the Realization + +**The foundation of a compelling alignment document** is a well-articulated realization that stakeholders recognize and agree needs attention. + +### Step 1: Identify the Realization or Challenge + +**Start by clearly articulating:** +- What have you realized needs attention? +- What observation or challenge are you seeing? +- What opportunity is being missed? + +**Be specific** - Vague realizations lead to vague solutions. Instead of "users are frustrated," say "we've realized that users abandon the checkout process 40% of the time because it requires 12 form fields." + +### Step 2: Confirm It's Real + +**Don't assume** - Verify that this realization is grounded in reality: +- Ask stakeholders directly +- Observe behavior +- Review existing data +- Check if others have noticed this too + +**A real realization has:** +- Clear evidence supporting it +- Measurable indicators +- Stakeholders who recognize it +- Impact that matters + +### Step 3: Present Evidence + +**Evidence makes your realization credible.** Use both soft and hard evidence: + +#### Soft Evidence (Indications, Testimonials, Complaints) + +**What it is:** Qualitative indicators that support the realization + +**Examples:** +- **Testimonials**: "Our customers tell us they struggle with..." +- **Complaints**: "Support tickets show users complaining about..." +- **Indications**: "We've noticed that users often..." +- **Anecdotes**: "In our user interviews, three people mentioned..." +- **Observations**: "When we watch users, they consistently..." + +**How to use it:** +- Quote specific feedback or complaints +- Reference user interviews or conversations +- Mention patterns you've observed +- Include stakeholder concerns you've heard + +**Example:** +> "Our customer support team reports that 60% of support tickets are about users unable to find the settings menu. One customer wrote: 'I've been using this for 6 months and still can't figure out where the settings are.'" + +#### Hard Evidence (Statistics, Log Analysis, Survey Tests) + +**What it is:** Quantitative data that supports the realization + +**Examples:** +- **Statistics**: "40% of users drop off at checkout" +- **Log analysis**: "Server logs show 500 errors occur 3x per day" +- **Survey results**: "85% of survey respondents rated this feature as 'difficult to use'" +- **Analytics**: "Bounce rate increased 25% after the redesign" +- **A/B test results**: "Version A had 30% higher completion rate" +- **Performance metrics**: "Page load time averages 8 seconds" + +**How to use it:** +- Include specific numbers and percentages +- Reference time periods ("in the last quarter") +- Compare to benchmarks or previous performance +- Show trends over time + +**Example:** +> "Analytics show that 45% of users abandon the checkout process, with an average of 8 minutes spent before leaving. This represents a 20% increase from last quarter. Server logs indicate that 15% of these abandonments occur during payment processing, suggesting technical issues." + +### Combining Soft and Hard Evidence + +**Best practice:** Use both types together for maximum impact: + +**Example:** +> "Our customers consistently report frustration with the checkout process (soft evidence: testimonials). Analytics confirm this: 45% abandon checkout, and those who complete it take an average of 12 minutes - 3x longer than industry standard (hard evidence: statistics). Support tickets show 60% of complaints are about checkout complexity (soft evidence: complaints), and our recent survey found 78% of users rated checkout as 'difficult' (hard evidence: survey)." + +### Why Evidence Matters + +**Without evidence:** +- Stakeholders may not believe the realization is real +- You might address the wrong thing +- Budget approval is harder to get +- The case for action is weak + +**With evidence:** +- Stakeholders recognize the realization +- The urgency is clear +- Budget approval is easier +- The case for action is compelling + +### Where to Find Evidence + +**Look for evidence in:** +- Customer support tickets and feedback +- User interviews and surveys +- Analytics and usage data +- Server logs and error reports +- Sales conversations and objections +- Competitive analysis +- Industry reports and benchmarks +- Internal team observations + +**If you don't have evidence yet:** +- Acknowledge this in your alignment document +- Propose gathering evidence as part of the project +- Use stakeholder conversations as initial evidence +- Reference similar realizations in the industry + +--- + +## Flexible Exploration + +**You can start anywhere:** +- Start with something you've realized needs attention +- Start with a solution you have in mind +- Start with why it matters + +**Saga will guide you** through all sections in whatever order makes sense for your thinking. + +--- + +## Extracting Information (Optional) + +**If you have existing communications or documents:** +- Share emails, chats, or documents with stakeholders +- Saga will extract key information: + - Realizations or observations mentioned + - Requirements discussed + - Concerns raised + - Context and background + - Timeline or urgency + - Budget or constraints + +**This helps inform** your alignment document sections. + +--- + +## Synthesizing the Document + +**After exploring all sections:** +- Saga will help you synthesize into a clear, compelling document +- Review together: "Does this capture your idea?" +- Make adjustments until it's right +- Create: `docs/1-project-brief/pitch.md` + +--- + +## Key Principles + +- **Collaborative** - You and Saga build it together +- **Iterative** - You can refine and improve +- **Clear** - Readable in 2-3 minutes +- **Compelling** - Makes the case for the project + +--- + +**Next:** [Lesson 3: Negotiation & Acceptance β†’](lesson-03-negotiation-acceptance.md) + +[← Back to Module Overview](module-03-overview.md) + diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md b/src/modules/wds/course/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md new file mode 100644 index 00000000..b1181c1a --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/lesson-03-negotiation-acceptance.md @@ -0,0 +1,115 @@ +# Lesson 3: Negotiation & Acceptance + +**Getting everyone on the same page** + +**Time:** 10 minutes + +--- + +## The Negotiation Phase + +**After creating your alignment document:** +- Share it with stakeholders +- Gather their feedback +- Make changes and iterate +- Update until everyone is on board + +**This phase is collaborative** - negotiation and iteration are welcome and expected. + +--- + +## Sharing with Stakeholders + +**Present your alignment document:** +- Share `docs/1-project-brief/pitch.md` +- Explain that this is a draft for discussion +- Invite feedback and questions +- Be open to changes + +**Different ways to share:** +- Email the document +- Present in a meeting +- Share via collaboration tool +- Walk through it together + +--- + +## Gathering Feedback + +**Listen for:** +- Concerns or questions +- Requests for clarification +- Suggestions for changes +- Different perspectives +- Budget or timeline concerns + +**Document feedback:** +- Note what stakeholders are saying +- Understand their concerns +- Identify what needs to change + +--- + +## Iterating the Document + +**Make changes based on feedback:** +- Update sections that need clarification +- Address concerns raised +- Incorporate suggestions +- Refine until everyone is satisfied + +**Saga can help you:** +- Update the alignment document +- Refine sections based on feedback +- Ensure clarity and completeness + +--- + +## Getting Acceptance + +**Once everyone agrees:** +- βœ… Everyone understands the idea +- βœ… Everyone agrees on why, what, how +- βœ… Budget is understood and accepted +- βœ… Commitment is clear +- βœ… **You have alignment** + +**This is the goal** - getting everyone on the same page before starting work. + +--- + +## When Acceptance Happens + +**Acceptance might come:** +- After one round of feedback +- After multiple iterations +- After a meeting discussion +- After formal review process + +**Variable time** - could be hours or days. The alignment document helps speed this up. + +--- + +## Key Principles + +- **Be flexible** - Changes are normal and expected +- **Listen actively** - Understand stakeholder concerns +- **Iterate willingly** - Refine until everyone is satisfied +- **Stay collaborative** - Work together toward alignment + +--- + +## After Acceptance + +**Once stakeholders accept:** +- Alignment is achieved +- Everyone is on the same page +- Ready to secure formal commitment +- Proceed to signoff document generation + +--- + +**Next:** [Lesson 4: Securing Commitment β†’](lesson-04-securing-commitment.md) + +[← Back to Module Overview](module-03-overview.md) + diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-04-external-contracts.md b/src/modules/wds/course/module-03-alignment-signoff/lesson-04-external-contracts.md new file mode 100644 index 00000000..04cd4a24 --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/lesson-04-external-contracts.md @@ -0,0 +1,201 @@ +# Lesson 4: External Contracts + +**Formalizing alignment with external contracts** + +**Time:** 15 minutes + +--- + +## When You Need External Contracts + +**External contracts are for:** +- **Consultant β†’ Client**: You're proposing a solution to a client +- **Business Owner β†’ Suppliers**: You're hiring consultants/suppliers to build software + +**These contracts:** +- Formalize agreements between separate parties +- Include legal protections (jurisdiction, governing law) +- Cover payment terms, IP ownership, confidentiality +- Protect both parties legally + +--- + +## Two Types of External Contracts + +### 1. Project Contract +**For:** Consultant β†’ Client +**When:** You're a consultant proposing to a client +**Perspective:** You're the contractor/service provider + +**Key Focus:** +- Protecting your work and payment +- Clear scope boundaries +- Fair payment terms (upfront payment for fixed-price) +- IP ownership transfer upon payment + +### 2. Service Agreement +**For:** Business Owner β†’ Suppliers +**When:** You're hiring consultants/suppliers to build software +**Perspective:** You're the client/owner + +**Key Focus:** +- Protecting your investment +- Ensuring deliverables meet requirements +- Clear payment terms and milestones +- IP ownership of deliverables + +--- + +## Business Models + +**Before building the contract, determine the business model:** + +### Fixed-Price Project +- Set price for defined scope +- Not-to-exceed clause applies +- Upfront payment recommended (50-100%) +- Clear deliverables and scope boundaries + +### Hourly/Time-Based +- Pay for actual time worked +- Hourly rate and time tracking +- Optional not-to-exceed cap +- Flexible scope + +### Retainer +- Monthly commitment +- Minimum hours per month +- Availability expectations +- Overage hourly rate +- Hour rollover policies + +### Hybrid +- Combination of models +- Multiple payment structures + +--- + +## Key Contract Sections + +**Saga will guide you through building:** + +### 1. Business Model +- Explains selected payment structure +- Sets foundation for all payment terms +- Clarifies expectations upfront + +### 2. Scope of Work +- **IN Scope**: What's explicitly included +- **OUT of Scope**: What's explicitly NOT included +- **Deliverables**: What will be delivered +- **The Path Forward**: How work will be done + +**Critical for fixed-price contracts** - Clear scope prevents disputes. + +### 3. Payment Terms +**Adapted to business model:** + +**Fixed-Price:** +- Upfront payment recommended (50-100% is fair) +- Milestone payments tied to deliverables +- Payment on completion (risky, not recommended) + +**Hourly:** +- Billing frequency (weekly, bi-weekly, monthly) +- Payment terms (Net 15, Net 30) +- Time tracking requirements + +**Retainer:** +- Monthly retainer amount +- Minimum hours included +- Overage billing +- Hour rollover policy + +### 4. Availability (Retainer Only) +- Business hours +- Response time expectations +- Meeting availability +- Urgent request policies + +### 5. Not-to-Exceed Clause +**Conditional based on business model:** +- **Fixed-Price**: Required (equals project price) +- **Hourly**: Optional cap if desired +- **Retainer**: Not applicable (monthly cap exists) + +**Purpose:** +- Prevents scope creep +- Protects budget +- Requires change orders for additional work + +### 6. Confidentiality Clause +- What information is protected +- Duration of confidentiality (typically 2-5 years) +- Exceptions (public info, required by law) +- Mutual protection + +### 7. Legal Framework +- **Governing Law/Jurisdiction**: Which laws apply +- **Contract Language**: Language of the contract +- **Work Initiation**: When work can begin +- **Dispute Resolution**: How conflicts are handled + +### 8. Other Important Sections +- **Change Orders**: How scope changes are handled +- **Termination**: How to exit the contract +- **Intellectual Property**: Who owns what +- **Timeline**: Delivery dates and milestones + +--- + +## Best Practices + +**Saga will provide guidance on:** + +### For Consultants/Service Providers +- Request upfront deposits (50%+ for fixed-price) +- Define scope extremely clearly +- Include change order process +- Set not-to-exceed cap +- Specify IP ownership transfer + +### For Clients/Business Owners +- Review scope thoroughly +- Understand payment terms +- Know what's included/excluded +- Understand change order process +- Clarify IP ownership + +### Common Pitfalls to Avoid +- Unclear scope definitions +- Unfair payment terms +- No change order process +- Unclear IP ownership +- No not-to-exceed cap (for fixed-price) + +**Goal:** Simple, fair contracts that build long-term relationships. + +--- + +## After Contract is Finalized + +**Once contract is signed:** +- βœ… Alignment achieved +- βœ… Commitment secured +- βœ… Legal protection in place +- βœ… Ready to proceed to Project Brief + +**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md) + +--- + +## Key Takeaway + +**External contracts formalize** agreements between separate parties with legal protections. They ensure clarity, protect both parties, and secure commitment before starting work. + +--- + +**Next:** [Lesson 5: Internal Signoff Documents β†’](lesson-05-internal-signoff.md) + +[← Back to Module Overview](module-03-overview.md) + diff --git a/src/modules/wds/course/module-03-alignment-signoff/lesson-05-internal-signoff.md b/src/modules/wds/course/module-03-alignment-signoff/lesson-05-internal-signoff.md new file mode 100644 index 00000000..a75b966d --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/lesson-05-internal-signoff.md @@ -0,0 +1,189 @@ +# Lesson 5: Internal Signoff Documents + +**Formalizing alignment for internal company projects** + +**Time:** 10 minutes + +--- + +## When You Need Internal Signoff + +**Internal signoff is for:** +- **Manager/Employee**: Seeking approval for an internal project +- **Internal Stakeholders**: Getting buy-in from departments, executives, or teams +- **Company Projects**: Building something within your organization + +**These documents:** +- Formalize internal agreements +- Document approval and commitment +- Set expectations for internal teams +- May follow company-specific formats + +--- + +## Internal Signoff vs. External Contracts + +**Key Differences:** + +| Aspect | External Contracts | Internal Signoff | +|--------|-------------------|-----------------| +| **Parties** | Separate entities (consultant/client) | Same organization (internal) | +| **Legal Framework** | Governing law, jurisdiction required | Usually not needed | +| **Payment Terms** | External payment, invoices | Internal budget allocation | +| **IP Ownership** | Transfer of ownership | Usually stays within company | +| **Format** | Standard contract format | May follow company format | +| **Approval** | Signatures from both parties | Internal approval workflow | + +--- + +## Internal Signoff Document Structure + +**Internal signoff focuses on approval, ownership, and outcomes rather than detailed scope:** + +### 1. Project Overview +- The Realization +- Recommended Solution +- Why It Matters + +### 2. Goals and Success Metrics +- **What are we trying to accomplish?** +- **How will we measure success?** +- **What does success look like?** +- **Key performance indicators (KPIs)** +- **Success criteria** + +**Focus**: Clear outcomes and measurable results, not detailed deliverables. + +### 3. Budget and Resources +- **Budget allocation**: Total budget estimate +- **Budget breakdown**: How budget will be allocated (if applicable) +- **Resources needed**: Team, tools, external services (high-level) +- **Not-to-Exceed**: Budget cap (if applicable) + +**Focus**: Budget estimates and resource allocation, not hourly rates or time tracking. + +### 4. Ownership and Responsibility +- **Project Owner**: Who owns this project? +- **Process Owner**: Who is responsible for execution? +- **Key Stakeholders**: Who is involved/affected? +- **Decision-Making Authority**: Who makes key decisions? + +**Focus**: Clear ownership and accountability, not detailed work breakdown. + +### 5. Approval and Sign-Off +- **Who needs to approve**: List of approvers +- **Approval stages**: Multi-stage approval process (if applicable) +- **Sign-off process**: How approval is documented +- **Timeline for approval**: When approval is needed + +**Focus**: Clear approval workflow and sign-off process. + +### 6. Timeline and Milestones +- **Key milestones**: Major project milestones +- **Delivery dates**: When outcomes are expected +- **Critical deadlines**: Important dates + +**Focus**: High-level timeline, not detailed task schedules. + +### 7. Optional Sections +- **Confidentiality**: If sensitive information involved +- **Risks and Considerations**: Potential challenges or risks +- **The Path Forward**: High-level approach (brief overview) + +--- + +## Company Signoff Format (Optional) + +**If your company has a standard signoff format:** + +### Upload Your Format +- Upload or paste your company's signoff document template +- Saga will adapt it to match your format +- Preserve company-specific sections and language +- Incorporate alignment document content + +### Benefits +- Follows internal processes +- Matches company expectations +- Easier approval workflow +- Familiar format for stakeholders + +**This ensures** the signoff follows your internal processes and approval workflows. + +--- + +## Approval Workflow + +**Internal signoff typically involves:** + +1. **Initial Review**: Share with immediate stakeholders +2. **Department Approval**: Get buy-in from affected departments +3. **Budget Approval**: Secure budget allocation +4. **Executive Sign-off**: Final approval from decision-makers +5. **Documentation**: File signed document for records + +**Saga will help you:** +- Identify who needs to approve +- Structure the approval workflow +- Create appropriate sign-off sections + +--- + +## Best Practices + +**For Internal Signoff:** + +### Focus on Outcomes +- Emphasize goals and success metrics +- Show what value will be created +- Define clear success criteria +- Avoid getting lost in detailed scope + +### Clear Ownership +- Identify project owner clearly +- Define who owns the process +- Clarify decision-making authority +- Set accountability expectations + +### Budget Clarity +- Provide realistic budget estimates +- Show how budget will be allocated +- Include not-to-exceed cap if needed +- Focus on budget, not hours or rates + +### Approval Workflow +- Identify all approvers early +- Understand approval stages +- Follow company sign-off process +- Get buy-in before formal sign-off + +### Follow Company Process +- Use company format if available +- Follow internal approval workflows +- Match company documentation standards +- Document everything properly + +--- + +## After Signoff Document + +**Once signoff document is approved:** +- βœ… Internal alignment achieved +- βœ… Budget/resources committed +- βœ… Stakeholders on board +- βœ… Ready to proceed to Project Brief + +**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md) + +--- + +## Key Takeaway + +**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. + +--- + +**Next:** [Tutorial: Alignment & Signoff β†’](tutorial-03.md) + +[← Back to Module Overview](module-03-overview.md) | [Previous: Lesson 4: External Contracts β†’](lesson-04-external-contracts.md) + diff --git a/src/modules/wds/course/module-03-alignment-signoff/module-03-overview.md b/src/modules/wds/course/module-03-alignment-signoff/module-03-overview.md new file mode 100644 index 00000000..a774f9ed --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/module-03-overview.md @@ -0,0 +1,143 @@ +# Module 03: Alignment & Signoff + +**Get stakeholders aligned and secure commitment before starting the project** + +--- + +## Overview + +This module teaches you how to create alignment around your idea and secure formal commitment from stakeholders before diving into detailed project work. + +**Time:** 55-75 minutes +**Prerequisites:** Module 02 completed (WDS installed) +**When to use:** Optional - Use when you need stakeholder alignment (consultant β†’ client, business β†’ suppliers, manager β†’ stakeholders) +**What you'll create:** Alignment document (pitch) and signoff document (contract/service agreement/signoff) + +--- + +## What You'll Learn + +- How to articulate your idea clearly (The Idea, Why, What, How, Budget, Commitment) +- Creating a compelling alignment document that gets everyone on the same page +- Negotiating and iterating until stakeholders accept +- Generating appropriate signoff documents (external contracts or internal signoff) +- When to skip this module (if you're doing it yourself) + +--- + +## Module Structure + +### [Lesson 1: Understanding Alignment](lesson-01-understanding-alignment.md) + +**Time:** 10 minutes + +- Why alignment matters before starting work +- The 6 elements of alignment (Idea, Why, What, How, Budget, Commitment) +- Different user scenarios (consultant, business owner, manager/employee) +- When to skip alignment (doing it yourself) + +### [Lesson 2: Creating Your Alignment Document](lesson-02-creating-alignment-document.md) + +**Time:** 20 minutes + +- The 10 sections of an alignment document +- How to explore sections flexibly +- Extracting information from existing communications +- Synthesizing into a clear, compelling document + +### [Lesson 3: Negotiation & Acceptance](lesson-03-negotiation-acceptance.md) + +**Time:** 10 minutes + +- Sharing with stakeholders +- Gathering feedback and iterating +- Getting acceptance and alignment +- When everyone is on the same page + +### [Lesson 4: External Contracts](lesson-04-external-contracts.md) + +**Time:** 15 minutes + +- When you need external contracts (consultant β†’ client, business β†’ suppliers) +- Project Contract vs. Service Agreement +- Key contract clauses and best practices +- Business models (fixed-price, hourly, retainer) +- Payment terms, scope protection, legal framework + +### [Lesson 5: Internal Signoff Documents](lesson-05-internal-signoff.md) + +**Time:** 10 minutes + +- When you need internal signoff (manager/employee seeking approval) +- Internal signoff document structure +- Company signoff format adaptation +- Approval workflows and stakeholders + +--- + +## Tutorial + +**[Tutorial: Alignment & Signoff β†’](tutorial-03.md)** + +Step-by-step hands-on guide to creating your alignment document and securing signoff. + +**Time:** 55-75 minutes +**What you'll create:** Complete alignment document and signoff document (external contract or internal signoff) + +--- + +## Key Concepts + +**Alignment Document (Pitch):** +- Makes the case for why the project matters +- Gets stakeholders aligned on Idea, Why, What, How, Budget, Commitment +- Readable in 2-3 minutes +- Allows negotiation and iteration + +**Signoff Documents:** +- **External Contracts**: Project Contract (consultant β†’ client) or Service Agreement (business β†’ suppliers) + - Includes legal protections, payment terms, IP ownership + - Different business models (fixed-price, hourly, retainer) +- **Internal Signoff**: For internal company projects + - May follow company-specific formats + - Focuses on approval workflows and budget allocation +- Both include scope, investment, timeline, deliverables + +**The Flow:** +1. Create alignment document β†’ 2. Share & negotiate β†’ 3. Get acceptance β†’ 4. Generate signoff β†’ 5. Proceed to Project Brief + +--- + +## Learning Outcomes + +By the end of this module, you will: + +- βœ… Understand when you need stakeholder alignment +- βœ… Know how to create a compelling alignment document +- βœ… Be able to negotiate and iterate until acceptance +- βœ… Generate appropriate external contracts or internal signoff documents +- βœ… Know when to skip this module and go straight to Project Brief + +--- + +## When to Skip This Module + +**Skip if:** +- You're doing the project yourself +- You have full autonomy +- You don't need stakeholder approval + +**Go directly to:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md) + +--- + +## Start Learning + +**[Begin with Lesson 1: Understanding Alignment β†’](lesson-01-understanding-alignment.md)** + +--- + +[← Back to Course Overview](../00-course-overview.md) | [Next: Module 04: Create Project Brief β†’](../module-04-project-brief/tutorial-04.md) + +*Part of the WDS Course: From Designer to Linchpin* + diff --git a/src/modules/wds/course/module-03-alignment-signoff/tutorial-03.md b/src/modules/wds/course/module-03-alignment-signoff/tutorial-03.md new file mode 100644 index 00000000..8fd4d8d3 --- /dev/null +++ b/src/modules/wds/course/module-03-alignment-signoff/tutorial-03.md @@ -0,0 +1,224 @@ +# Tutorial 03: Alignment & Signoff + +**Hands-on guide to getting stakeholders aligned and securing commitment** + +--- + +## Overview + +This tutorial walks you through creating an alignment document (pitch) and securing formal signoff from stakeholders before starting your project. + +**Time:** 45-60 minutes +**Prerequisites:** Module 02 completed (WDS installed) +**What you'll create:** Alignment document and signoff document + +--- + +## What You'll Learn + +- How to articulate your idea clearly (Idea, Why, What, How, Budget, Commitment) +- Creating a compelling alignment document +- Negotiating and iterating until acceptance +- Generating appropriate signoff documents +- Understanding contract clauses and best practices + +--- + +## Before You Start + +**You'll need:** +- A project idea that needs stakeholder alignment +- 45-60 minutes of focused time +- Access to stakeholder information (if available) +- Optional: Existing communications/documents from stakeholders + +**AI Support:** +- **Saga WDS Analyst Agent** will guide you through the process +- She'll help you clarify your situation +- Guide you through creating the alignment document +- Help generate the signoff document after acceptance + +--- + +## Step 1: Understand Your Situation (5 min) + +**First, clarify your scenario:** + +- **Consultant proposing to client** β†’ You'll create a Project Contract +- **Business hiring suppliers** β†’ You'll create a Service Agreement +- **Manager/employee seeking approval** β†’ You'll create a Signoff Document +- **Doing it yourself** β†’ Skip this tutorial, go to Module 04: Create Project Brief + +**Your scenario:** [Write your scenario here] + +--- + +## Step 2: Extract Information (Optional - 10 min) + +**If you have existing communications or documents:** + +Share emails, chats, or documents with stakeholders. Saga will extract: +- Realizations or observations mentioned +- Requirements discussed +- Concerns raised +- Context and background +- Timeline or urgency +- Budget or constraints + +**If you don't have communications:** That's fine! Move to Step 3. + +--- + +## Step 3: Explore Alignment Sections (20-30 min) + +**Work through these 10 sections** (in whatever order makes sense): + +1. **The Realization** - What we've realized needs attention +2. **Why It Matters** - Why this matters and who we help +3. **How We See It Working** - Brief overview of the solution approach +4. **Paths We Explored** - 2-3 solution options we considered +5. **Recommended Solution** - Preferred approach and why +6. **The Path Forward** - How the work will be done (WDS phases and practical approach) +7. **The Value We'll Create** - What happens if we DO build this +8. **Cost of Inaction** - What happens if we DON'T build this +9. **Our Commitment** - Resources needed and potential risks +10. **Summary** - Summary of key points + +**Saga will guide you** through each section, asking one question at a time and reflecting back what she hears. + +### Best Practice: Realization Section with Evidence + +**When exploring "The Realization" section**, Saga will help you: + +1. **Identify the realization** - What have you realized needs attention? +2. **Confirm it's real** - Is there evidence that supports this? +3. **Gather evidence** - What proof do you have? + +**Soft Evidence** (qualitative): +- Testimonials: "Customers tell us..." +- Complaints: "Support tickets show..." +- Observations: "We've noticed that..." +- Interviews: "In user interviews, people mentioned..." + +**Hard Evidence** (quantitative): +- Statistics: "45% of users..." +- Analytics: "Bounce rate increased 25%..." +- Surveys: "78% rated this as 'difficult'..." +- Logs: "Server logs show 500 errors occur..." + +**Example:** +> "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)." + +**If you don't have evidence yet:** That's okay! Acknowledge this and propose gathering evidence as part of the project. + +--- + +## Step 4: Synthesize Alignment Document (5 min) + +**Saga will help you create:** + +`docs/1-project-brief/pitch.md` + +- Clear, brief, readable in 2-3 minutes +- Makes the case for the project +- Ready to share with stakeholders + +**Review together:** Does this capture your idea? Anything to adjust? + +--- + +## Step 5: Share & Negotiate (Variable time) + +**Share with stakeholders:** +- Present the alignment document +- Gather feedback +- Make changes and iterate +- Update until everyone is on board + +**Remember:** This phase is collaborative - negotiate and iterate until everyone is aligned. + +--- + +## Step 6: Get Acceptance (Variable time) + +**Once stakeholders accept:** +- Everyone is aligned on Idea, Why, What, How, Budget, Commitment +- You have buy-in before starting detailed work +- Ready to secure formal commitment + +--- + +## Step 7: Generate Signoff Document (15-20 min) + +**After acceptance, Saga will help you create:** + +**Choose your document type:** +1. **Project Contract** - For consultant β†’ client +2. **Service Agreement** - For business β†’ suppliers +3. **Signoff Document** - For internal company projects + - *Optional: Upload your company's signoff format* + +**Saga will guide you through:** +- Scope of work +- Investment and timeline +- Payment terms (with upfront payment guidance for fixed-price contracts) +- Confidentiality clause +- Not-to-Exceed clause (prevents scope creep) +- Legal jurisdiction and contract language +- Work initiation terms +- Change order process +- Termination clause +- Intellectual property ownership +- Dispute resolution + +**Output:** `docs/1-project-brief/[contract/service-agreement/signoff].md` + +--- + +## Step 8: Finalize & Proceed (5 min) + +**Once signoff document is finalized:** +- βœ… Alignment achieved +- βœ… Commitment secured +- βœ… Foundation established + +**Next:** [Module 04: Create Project Brief](../module-04-project-brief/tutorial-04.md) + +--- + +## Success Criteria + +You've completed this tutorial when: +- βœ… Alignment document created and shared +- βœ… Stakeholders have accepted (everyone aligned) +- βœ… Signoff document generated and ready for signature +- βœ… Ready to proceed to Project Brief + +--- + +## Common Questions + +**Q: Do I always need this?** +A: No - skip if you're doing it yourself or have full autonomy. + +**Q: Can I skip the signoff document?** +A: Yes - the alignment document might be enough. Signoff formalizes the commitment. + +**Q: What if stakeholders want changes?** +A: That's normal! Iterate and negotiate until everyone is on board. + +**Q: How long does negotiation take?** +A: Variable - could be hours or days. The alignment document helps speed this up. + +--- + +## Next Steps + +**[Continue to Module 04: Create Project Brief β†’](../module-04-project-brief/tutorial-04.md)** + +--- + +[← Back to Module Overview](module-03-overview.md) | [Back to Course Overview](../00-course-overview.md) + +*Part of the WDS Course: From Designer to Linchpin* + diff --git a/src/modules/wds/course/module-03-project-brief/tutorial-03.md b/src/modules/wds/course/module-04-project-brief/tutorial-04.md similarity index 98% rename from src/modules/wds/course/module-03-project-brief/tutorial-03.md rename to src/modules/wds/course/module-04-project-brief/tutorial-04.md index 0b3483bc..2e7cfcb7 100644 --- a/src/modules/wds/course/module-03-project-brief/tutorial-03.md +++ b/src/modules/wds/course/module-04-project-brief/tutorial-04.md @@ -1,4 +1,4 @@ -# Tutorial 02: Create Your Project Brief +# Tutorial 04: Create Your Project Brief **Hands-on guide to defining your project vision, goals, and constraints** @@ -322,7 +322,7 @@ Agent: "Let me review your project brief: **Create file:** `A-Project-Brief/project-brief.md` -**Use template from:** `workflows/1-project-brief/complete/project-brief.template.md` +**Use template from:** `workflows/1-project-brief/project-brief/complete/project-brief.template.md` **Populate with your content:** diff --git a/src/modules/wds/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg b/src/modules/wds/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg new file mode 100644 index 00000000..099f71d3 Binary files /dev/null and b/src/modules/wds/examples/WDS-Presentation/Resources/WhiteportLegacyPage.jpg differ diff --git a/src/modules/wds/getting-started/MANUAL-INIT-GUIDE.md b/src/modules/wds/getting-started/MANUAL-INIT-GUIDE.md index b938738e..3718cb67 100644 --- a/src/modules/wds/getting-started/MANUAL-INIT-GUIDE.md +++ b/src/modules/wds/getting-started/MANUAL-INIT-GUIDE.md @@ -197,7 +197,7 @@ Choose a workflow to start: ## What's Next? ### πŸŽ“ **Learn WDS Concepts** -[Tutorial Guide](../01-tutorial/00-TUTORIAL-GUIDE.md) - Deep dive into why-based design +[Course](../course/00-course-overview.md) - Deep dive into WDS methodology ### πŸš€ **Start Your First Project** [Quick Start](quick-start.md) - 5-minute walkthrough diff --git a/src/modules/wds/getting-started/installation.md b/src/modules/wds/getting-started/installation.md index ff919938..ea42419e 100644 --- a/src/modules/wds/getting-started/installation.md +++ b/src/modules/wds/getting-started/installation.md @@ -44,7 +44,7 @@ You should see: ## Next Steps - [Quick Start Guide](quick-start.md) - Your first 5 minutes -- [Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md) - Learn the concepts deeply +- [Course](../course/00-course-overview.md) - Learn the concepts deeply --- diff --git a/src/modules/wds/getting-started/quick-start.md b/src/modules/wds/getting-started/quick-start.md index 58f2e268..972087c5 100644 --- a/src/modules/wds/getting-started/quick-start.md +++ b/src/modules/wds/getting-started/quick-start.md @@ -110,7 +110,7 @@ You created **why-based specifications** in 5 minutes: ### Learn the Concepts -[Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md) - Deep dive into WDS philosophy +[Course](../course/00-course-overview.md) - Deep dive into WDS methodology ### Start Your Project diff --git a/src/modules/wds/getting-started/where-to-go-next.md b/src/modules/wds/getting-started/where-to-go-next.md index 56fbf1d9..6960c25a 100644 --- a/src/modules/wds/getting-started/where-to-go-next.md +++ b/src/modules/wds/getting-started/where-to-go-next.md @@ -123,14 +123,14 @@ Join the WDS community for: ## Quick Links -- [Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md) +- [Course](../course/00-course-overview.md) - [Workflows](../WDS-WORKFLOWS-GUIDE.md) - [Modular Architecture](../workflows/4-ux-design/modular-architecture/00-MODULAR-ARCHITECTURE-GUIDE.md) - [Why-Based Specifications](../workflows/4-ux-design/WHY-BASED-SPECIFICATIONS.md) --- -**Ready to dive deeper? Start with the [Tutorial](../01-tutorial/00-TUTORIAL-GUIDE.md)!** +**Ready to dive deeper? Start with the [Course](../course/00-course-overview.md)!** --- diff --git a/src/modules/wds/tutorial/00-TUTORIAL-GUIDE.md b/src/modules/wds/tutorial/00-TUTORIAL-GUIDE.md deleted file mode 100644 index 85880014..00000000 --- a/src/modules/wds/tutorial/00-TUTORIAL-GUIDE.md +++ /dev/null @@ -1,211 +0,0 @@ -# WDS-BMad Tutorial - -**Complete training from project brief to AI-ready specifications** - ---- - -## About This Tutorial - -This tutorial teaches the complete WDS workflow through **16 chapters**. - -Each chapter contains: - -- **Inspiration** - Why this step matters, the goal -- **Teaching** - How to do it with confidence -- **Practice** - Apply it to your own project - -**Format:** - -- Read as documentation -- Generate videos with NotebookLM -- Use in workshops - -**Time:** ~10 hours total (40 min per chapter) - ---- - -## Tutorial Chapters - -### Foundation - -#### [Chapter 0: Why This Matters](chapter-00-why-this-matters/) - -Learn how to be indispensable in the AI era - ---- - -### Phase 1: Project Brief - -#### [Chapter 1.1: Create Project Brief](chapter-1.1-project-brief/) - -Define vision, goals, stakeholders, and constraints - ---- - -### Phase 2: Trigger Mapping - -#### [Chapter 2.1: Identify Target Groups](chapter-2.1-identify-target-groups/) - -WHO are your users and how to prioritize them - -#### [Chapter 2.2: Map Triggers & Outcomes](chapter-2.2-map-triggers-outcomes/) - -WHAT triggers needs and WHY your business exists - -#### [Chapter 2.3: Prioritize Features](chapter-2.3-prioritize-features/) - -Which features serve your top triggers - ---- - -### Phase 3: Platform Requirements - -#### [Chapter 3.1: Platform Requirements](chapter-3.1-platform-requirements/) - -Technical constraints, integrations, infrastructure - -#### [Chapter 3.2: Functional Requirements](chapter-3.2-functional-requirements/) - -What the system must do - ---- - -### Phase 4: Conceptual Design - -#### [Chapter 4.1: Initialize Scenario](chapter-4.1-initialize-scenario/) - -The 5 questions that define your design journey - -#### [Chapter 4.2: Sketch Interfaces](chapter-4.2-sketch-interfaces/) - -Drawing pages with AI guidance - -#### [Chapter 4.3: Analyze with AI](chapter-4.3-analyze-with-ai/) - -Upload sketches and have strategic conversations - -#### [Chapter 4.4: Decompose Components](chapter-4.4-decompose-components/) - -Break pages into modular architecture - -#### [Chapter 4.5: Why-Based Specifications](chapter-4.5-why-based-specs/) - -Document WHAT + WHY + WHAT NOT TO DO - -#### [Chapter 4.6: Validate Specifications](chapter-4.6-validate-specifications/) - -Review completeness and test logic - ---- - -### Phase 5: Design System - -#### [Chapter 5.1: Extract Design Tokens](chapter-5.1-extract-design-tokens/) - -Colors, typography, spacing from your specs - -#### [Chapter 5.2: Component Library](chapter-5.2-component-library/) - -Reusable patterns across scenarios - ---- - -### Phase 6: Development Integration - -#### [Chapter 6.1: UI Roadmap](chapter-6.1-ui-roadmap/) - -Development priorities and handoff - ---- - -## How to Use This Tutorial - -### Complete Workflow (Recommended) - -Work through all 16 chapters sequentially with your own project: - -``` -Chapters 1-16 β†’ Complete design from brief to handoff -Time: ~10 hours (spread over days/weeks) -Result: Fully specified project ready for development -``` - -### Quick Start (Core Concepts) - -Focus on the essential chapters: - -``` -Ch 0: Why This Matters -Ch 2.2: Map Triggers & Outcomes -Ch 4.1: Initialize Scenario -Ch 4.5: Why-Based Specifications -Time: ~3 hours -Result: Understanding of core WDS philosophy -``` - -### Phase-Specific Learning - -Jump to the phase you need: - -``` -Phase 2 (Ch 2.1-2.3): Trigger Mapping -Phase 4 (Ch 4.1-4.6): Conceptual Design -Phase 5 (Ch 5.1-5.2): Design System -``` - ---- - -## NotebookLM Integration - -Each chapter has a matching script in `/notebooklm-scripts/`: - -- Feed chapter scripts to NotebookLM -- Generate audio podcasts -- Generate video presentations -- Create study guides - -**All scripts match chapter numbers for easy reference.** - ---- - -## Chapter Structure - -Every chapter follows the same pattern: - -**1. Inspiration (10 min)** - -- Why this step matters -- The goal you're working toward -- Real-world impact - -**2. Teaching (20 min)** - -- How to do it with confidence -- AI support at each step -- Dog Week example walkthrough - -**3. Practice (10 min)** - -- Apply to your own project -- Step-by-step instructions -- Success criteria - ---- - -## After the Tutorial - -Once you've completed chapters: - -1. **[Workflows Guide](../WDS-WORKFLOWS-GUIDE.md)** - Reference documentation -2. **[Quick Start](../getting-started/quick-start.md)** - Try WDS with agent -3. **[Community](https://discord.gg/whiteport)** - Get help and share - ---- - -## Start Learning - -**[Begin with Chapter 0: Why This Matters β†’](chapter-00-why-this-matters/)** - ---- - -[← Back to Getting Started](../getting-started/where-to-go-next.md) diff --git a/src/modules/wds/tutorial/01-designer-role-in-ai-era.md b/src/modules/wds/tutorial/01-designer-role-in-ai-era.md deleted file mode 100644 index cc9c23e8..00000000 --- a/src/modules/wds/tutorial/01-designer-role-in-ai-era.md +++ /dev/null @@ -1,342 +0,0 @@ -# The Designer's Role in AI-Powered Development - -**Why designers are irreplaceable in the specification-first era** - ---- - -## The Multi-Dimensional Thinking Challenge - -Designers operate across **5 simultaneous dimensions** that AI and traditional developers cannot navigate alone: - -### 1. Business Existence (WHY) - -- Why does this business exist? -- What problem does it solve in the world? -- What value does it create? - -**Example (Dog Week):** - -``` -WHY: Families struggle to coordinate dog care responsibilities. -VALUE: Reduce conflict, increase accountability, happier dogs. -``` - ---- - -### 2. Business Goals (WHAT SUCCESS LOOKS LIKE) - -- What metrics matter? -- What behaviors do we want to encourage? -- What outcomes define success? - -**Example (Dog Week):** - -``` -GOALS: -- Increase walk completion rate (not just bookings) -- Encourage family participation (gamification) -- Reduce "forgot to walk" incidents (countdown timers) -``` - ---- - -### 3. Product Strategy (HOW WE DELIVER VALUE) - -- What features serve the goals? -- What's the core experience? -- What can we cut? - -**Example (Dog Week):** - -``` -CORE: Week-based planning (Swedish culture) -FEATURES: Calendar, leaderboard, countdown timers -CUT: Daily view (doesn't match mental model) -``` - ---- - -### 4. Target Groups & Individual Needs (WHO & THEIR CONTEXT) - -- Who are the users? -- What are their different needs? -- What contexts do they operate in? - -**Example (Dog Week):** - -``` -USERS: -- Parents: Need overview, accountability tracking -- Kids: Need simple booking, gamification -- Teens: Need independence, mobile-first - -CONTEXTS: -- Morning rush: Quick booking -- Evening planning: Week overview -- During walk: Start/complete actions -``` - ---- - -### 5. User Experience Translation (HOW USERS UNDERSTAND) - -- How do we make this simple? -- What mental models do users have? -- What's intuitive vs confusing? - -**Example (Dog Week):** - -``` -TRANSLATION: -- Week circles (not dates) β†’ Matches Swedish "Vecka 40" thinking -- Color states (not text) β†’ Visual, instant understanding -- Countdown timer β†’ Creates urgency without nagging -- Leaderboard β†’ Makes accountability fun, not punishing -``` - ---- - -## The Coherent Storyline - -All 5 dimensions must **tell the same story**: - -``` -Business WHY - ↓ -Business Goals - ↓ -Product Strategy - ↓ -User Needs - ↓ -UX Design - ↓ -Technical Specs -``` - -**If any link breaks, the product fails.** - ---- - -## Why This Is Designer Work - -### Engineers Think: - -- "How do I build this?" -- "What's the data structure?" -- "What API endpoints do I need?" - -**Missing:** WHY this feature? WHO needs it? WHAT behavior change? - -### Business Developers Think: - -- "What features will sell?" -- "What's the ROI?" -- "What's the market opportunity?" - -**Missing:** HOW do users actually think? WHAT's intuitive? HOW do we translate goals to experience? - -### AI Thinks: - -- "What patterns match this prompt?" -- "What code structure fits this description?" -- "What's the most common implementation?" - -**Missing:** ALL 5 dimensions. AI has no context for WHY, WHO, or WHAT SUCCESS LOOKS LIKE. - ---- - -## The Designer's Unique Value - -**Designers are the only role that:** - -βœ… Understands business goals deeply -βœ… Knows user needs intimately -βœ… Translates abstract goals into concrete experiences -βœ… Maintains coherent storyline across all touchpoints -βœ… Balances business needs with user needs -βœ… Makes complexity simple for end users -βœ… Makes simplicity implementable for developers - ---- - -## Example: Dog Week Calendar States - -### Business Developer Says: - -"We need a booking system with accountability tracking." - -### Engineer Says: - -"I'll build a CRUD app with status fields: pending, active, completed." - -### AI Says: - -"Here's a calendar with booking slots and status indicators." - -### Designer Says: - -``` -WAIT. Let's think through all 5 dimensions: - -1. WHY: Reduce family conflict over forgotten walks -2. GOAL: Increase completion rate, not just bookings -3. STRATEGY: Visual accountability + gentle urgency -4. USERS: Kids need simple, parents need overview -5. UX TRANSLATION: - - 6 color states (visual, instant understanding) - - Countdown timer (urgency without nagging) - - Leaderboard (accountability as game) - - Week view (matches Swedish mental model) - -NOW let's specify: -- Pages/: Family-specific context -- Components/: 6 visual states -- Features/: State machine with business rules -- Storyboard: Visual flow of all states -``` - -**Result:** Product that actually solves the problem, not just implements features. - ---- - -## The Specification as Translation Layer - -The designer's specification is a **multi-dimensional translation**: - -``` -Business Goals - ↓ -[DESIGNER TRANSLATES] - ↓ -User Experience - ↓ -[DESIGNER TRANSLATES] - ↓ -Technical Specifications - ↓ -[AI/DEVELOPER IMPLEMENTS] - ↓ -Working Product -``` - -**Without the designer's translation:** - -- Engineers build what's easy, not what's needed -- Business developers add features that don't serve users -- AI generates generic solutions that miss the context - ---- - -## Why AI Makes Designers MORE Important - -**Before AI:** - -- Designers β†’ Specs β†’ Developers β†’ Code (slow) -- Designers had to compromise due to dev time -- "We can't build that, too complex" - -**With AI:** - -- Designers β†’ Specs β†’ AI β†’ Code (fast) -- Designers can specify the RIGHT solution -- "AI can build anything, what SHOULD we build?" - -**The bottleneck shifted from implementation to specification.** - -**The question changed from "Can we build it?" to "What should we build?"** - -**And only designers can answer that question across all 5 dimensions.** - ---- - -## The Coherent Storyline Challenge - -**Example: Dog Week** - -Every touchpoint tells the same story: - -**Story:** "Dog care is a family responsibility, and we make it fun and fair." - -**Touchpoints:** - -- **Week view:** Shows family's shared responsibility (not individual calendars) -- **Leaderboard:** Makes accountability fun (not punishing) -- **Color states:** Visual clarity (not confusing text) -- **Countdown timer:** Gentle urgency (not nagging notifications) -- **Booking flow:** Simple for kids (not complex admin) - -**If any touchpoint breaks the story:** - -- Leaderboard shows "failures" β†’ Punishing, not fun β†’ Story breaks -- Countdown sends notifications β†’ Nagging, not gentle β†’ Story breaks -- Week view shows daily β†’ Doesn't match mental model β†’ Story breaks - -**Only a designer maintains this coherence.** - ---- - -## The Designer's Superpower - -**You think in layers:** - -``` -Layer 1: Why does this business exist? -Layer 2: What are we trying to achieve? -Layer 3: What product serves that goal? -Layer 4: Who are the users and what do they need? -Layer 5: How do we make it simple and intuitive? -Layer 6: How do we keep the story coherent? -Layer 7: How do we make it implementable? -``` - -**Engineers think in Layer 7 only.** -**Business developers think in Layers 1-3 only.** -**AI thinks in Layer 7 with fragments of Layer 5.** - -**You're the only one thinking across all 7 layers simultaneously.** - ---- - -## Powered by AI or Not - -**With or without AI, this multi-dimensional thinking is irreplaceable.** - -**AI makes it MORE valuable:** - -- Implementation is fast β†’ Specification becomes critical -- Anyone can generate code β†’ Knowing WHAT to build becomes the differentiator -- Features are cheap β†’ Coherent experience becomes the competitive advantage - -**The designer who can:** - -- Think across all 5 dimensions -- Maintain coherent storylines -- Translate complexity into simplicity -- Specify precisely for AI implementation - -**...is 10x more valuable than before.** - ---- - -## Bottom Line - -**You're not just designing interfaces.** - -**You're architecting:** - -- Business value delivery -- User behavior change -- Product strategy -- Experience coherence -- Technical feasibility - -**Across 5 dimensions simultaneously.** - -**That's not a skill AI can replace.** - -**That's the skill AI makes essential.** - ---- - -[← Back to Guide](00-MODULAR-ARCHITECTURE-GUIDE.md) diff --git a/src/modules/wds/tutorial/02-wds-concept.md b/src/modules/wds/tutorial/02-wds-concept.md deleted file mode 100644 index fb819b17..00000000 --- a/src/modules/wds/tutorial/02-wds-concept.md +++ /dev/null @@ -1,295 +0,0 @@ -# Video 2: What is Whiteport Design Studio (WDS)? - -**Duration:** 12 minutes -**Audience:** Designers, Product Managers, Entrepreneurs - ---- - -## Introduction (1 min) - -Welcome to Whiteport Design Studio - or WDS for short. - -In the last video, we talked about why designers are irreplaceable in the AI era. Now let's talk about WHAT WDS actually is and how it transforms the way you work. - ---- - -## The Core Problem WDS Solves (2 min) - -### Traditional Design Handoff Nightmare - -**Recognize this disaster?** - -- You create gorgeous designs in isolation -- Designs disappear into "design backlog purgatory" -- Months later, developers build something vaguely similar -- Everyone argues: "That's not what we agreed on!" - -**The painful reality:** Most brilliant interface ideas die in translation. - -We sketch inspiration but ship interpretation. -We design experiences but deliver confusion. - -### The AI Era Makes This Worse - -With AI development, there's a new problem: - -**AI can generate code with stunning accuracy - IF you can clearly define what you want.** - -But if you're unclear, AI starts hallucinating and leaves your project in a death spiral. - -**The new reality:** - -- 🎯 Clear specifications = Perfect AI implementation -- πŸŒͺ️ Unclear specifications = AI hallucination death spiral - ---- - -## What WDS Actually Is (3 min) - -### Specification-First Development - -**WDS is a specification-first design system.** - -Instead of: - -``` -Sketch β†’ Hope developers understand β†’ Fix in QA -``` - -WDS gives you: - -``` -Trigger Map β†’ Scenario Init β†’ Sketch β†’ Why-Based Specs β†’ AI Implementation -``` - -### The Revolutionary Truth - -**With AI development, specifications ARE the code.** - -There is no longer a bottleneck in writing code. The bottleneck is **knowing what to build**. - -And that requires: - -- Understanding user psychology (Trigger Map) -- Defining the journey (Scenario Init) -- Capturing design intent (Why-Based Specs) -- Preventing AI mistakes (WHAT NOT TO DO) - -### WDS = Designer + AI Partnership - -**WDS is not:** - -- ❌ AI replacing designers -- ❌ Automated design generation -- ❌ Generic template system - -**WDS is:** - -- βœ… AI amplifying designer thinking -- βœ… Socratic questioning to elevate decisions -- βœ… Why-based specifications that preserve intent - ---- - -## The Three Core Innovations (4 min) - -### 1. Socratic Questioning - -**Traditional AI:** - -``` -You: "Create a calendar" -AI: *Generates generic calendar* -You: "No, that's not right..." -``` - -**WDS Agent:** - -``` -You: "I need a calendar" -Agent: "Help me understand - why week view instead of daily?" -You: "Swedish families think in weeks..." -Agent: "Got it! So we match their mental model. - Should I avoid adding daily/monthly views?" -You: "Exactly!" -``` - -**The difference:** Agent asks WHY to understand your reasoning, not just WHAT to build. - ---- - -### 2. Why-Based Specifications - -**Traditional Spec:** - -```markdown -## Calendar Component - -- Week view -- 7 columns (days) -- Color-coded states -``` - -**WDS Why-Based Spec:** - -```markdown -## Calendar Component - -WHY Week View: -Swedish families think in "Vecka 40". This matches their -mental model. Daily view is too granular, monthly too abstract. -β†’ AI: Don't add daily/monthly views, even if you think it's "better" - -WHY 6 Color States: -Visual, instant understanding for kids. No reading required. -Each state serves a specific purpose in the accountability flow. -β†’ AI: Don't simplify to 3 states, each serves a purpose - -WHY Countdown Timer (Not Notifications): -Gentle urgency without nagging. Visible when user checks app. -Notifications would break the "fun, not punishing" tone. -β†’ AI: Don't add push notifications, even if you think it's "helpful" -``` - -**The difference:** AI knows WHAT to build, WHY you chose it, and WHAT NOT TO DO. - ---- - -### 3. Modular Architecture - -**Traditional approach:** - -``` -One giant specification file (800 lines) -β”œβ”€ Layout + Visual + Logic + API + Content -``` - -**WDS Modular Architecture:** - -``` -Pages/02-calendar-page.md (100 lines) -β”œβ”€ WHERE: Page context, layout, content - -Components/walk-slot-card.component.md (150 lines) -β”œβ”€ HOW: Visual design, states, styling - -Features/walk-booking-logic.feature.md (200 lines) -β”œβ”€ WHAT: Business rules, validation, API -``` - -**The difference:** - -- Clear separation of concerns -- Easy to maintain and update -- Clean handoffs to specialists -- AI can process each file independently - ---- - -## How WDS Works in Practice (2 min) - -### The Complete Flow - -**Phase 1: Trigger Map** - -``` -WHO: Parents (need accountability) -TRIGGER: Family conflict over dog care -OUTCOME: Harmony without nagging -FEATURE: Family dog walk calendar -``` - -**Phase 2: Scenario Init** - -``` -Entry Point: Google search (frustrated) -Mental State: Tired of nagging, want simple solution -End Goal: First walk completed, everyone happy -Shortest Path: Landing β†’ Sign up β†’ Setup β†’ Calendar β†’ First walk -``` - -**Phase 3: Sketch** - -``` -You: [Upload sketch of calendar page] -Agent: "I see: Week view, leaderboard, countdown timers. - Should I analyze these sections?" -``` - -**Phase 4: Why-Based Specifications** - -``` -Agent: "Why week view instead of daily?" -You: "Swedish families think in weeks..." -Agent: "Perfect! Documenting: - WHY: Matches Swedish 'Vecka 40' mental model - WHAT NOT TO DO: Don't add daily/monthly views" -``` - -**Phase 5: AI Implementation** - -``` -AI: *Implements exactly as specified* - *Skips "helpful" features that would break intent* - *Preserves design reasoning* -``` - ---- - -## The WDS Difference (1 min) - -### Traditional Design Process - -**Designer:** Creates in isolation -**Handoff:** "Here's the design, figure it out" -**Developer:** Interprets and builds -**Result:** Something vaguely similar -**Outcome:** Endless revisions - -### WDS Process - -**Designer:** Thinks through psychology -**Agent:** Asks Socratic questions -**Specifications:** Capture WHY + WHAT + WHAT NOT -**AI:** Implements correctly first time -**Outcome:** Design intent preserved - ---- - -## Summary (1 min) - -**WDS is:** - -1. **Specification-First** - Specs ARE the code in the AI era -2. **Socratic Questioning** - Agent elevates your thinking -3. **Why-Based Specs** - Capture reasoning, not just requirements -4. **Modular Architecture** - Clean separation, easy maintenance -5. **Designer-AI Partnership** - Amplification, not replacement - -**The result:** - -- AI implements correctly first time -- Design intent is preserved -- Specifications become design knowledge -- You're 10x faster and 10x more valuable - ---- - -## Next Video - -In the next video, we'll dive into the **BMad Method** - the systematic approach that makes WDS possible. - -You'll learn: - -- The 4 phases of design thinking -- How each phase builds on the previous -- Why this method works with AI -- How to apply it to your projects - -See you there! - ---- - -[← Previous: Designer's Role](01-designer-role-in-ai-era.md) | [Next: BMad Method β†’](03-bmad-method-overview.md) - -[Back to Tutorial Guide](00-TUTORIAL-GUIDE.md) diff --git a/src/modules/wds/tutorial/README-DEPRECATED.md b/src/modules/wds/tutorial/README-DEPRECATED.md deleted file mode 100644 index 77cbe851..00000000 --- a/src/modules/wds/tutorial/README-DEPRECATED.md +++ /dev/null @@ -1,83 +0,0 @@ -# Tutorial Folder - DEPRECATED - -**Date:** December 9, 2024 -**Status:** Deprecated - Content moved to course modules - ---- - -## What Happened? - -The standalone `tutorial/` folder has been **deprecated** in favor of integrating tutorials directly into course modules. - ---- - -## New Structure - -Tutorials are now located within each course module: - -``` -course/ -β”œβ”€β”€ module-02-project-brief/ -β”‚ β”œβ”€β”€ module-02-overview.md -β”‚ β”œβ”€β”€ lesson-01-...md -β”‚ └── tutorial-02.md ← Tutorial here! -β”œβ”€β”€ module-04-map-triggers-outcomes/ -β”‚ └── tutorial-04.md ← Tutorial here! -β”œβ”€β”€ module-08-initialize-scenario/ -β”‚ └── tutorial-08.md ← Tutorial here! -└── module-12-why-based-specs/ - └── tutorial-12.md ← Tutorial here! -``` - ---- - -## Why the Change? - -**Benefits:** - -- βœ… Single learning path - everything in one place -- βœ… Module-specific tutorials - tutorial right where you need it -- βœ… Cleaner structure - no separate tutorial folder -- βœ… Better organization - theory + practice together - -**Old approach:** - -- Separate tutorial folder -- Disconnected from course content -- Harder to navigate - -**New approach:** - -- Tutorials integrated into modules -- Theory β†’ Tutorial β†’ Practice flow -- Easier to follow - ---- - -## Where to Find Tutorials Now - -**Project Brief:** -β†’ [course/module-02-project-brief/tutorial-02.md](../course/module-02-project-brief/tutorial-02.md) - -**Trigger Mapping:** -β†’ [course/module-04-map-triggers-outcomes/tutorial-04.md](../course/module-04-map-triggers-outcomes/tutorial-04.md) - -**Initialize Scenario:** -β†’ [course/module-08-initialize-scenario/tutorial-08.md](../course/module-08-initialize-scenario/tutorial-08.md) - -**Why-Based Specifications:** -β†’ [course/module-12-why-based-specs/tutorial-12.md](../course/module-12-why-based-specs/tutorial-12.md) - ---- - -## Navigation - -**Start learning:** -β†’ [Course Overview](../course/00-course-overview.md) - -**Quick reference:** -β†’ [Workflows Guide](../WDS-WORKFLOWS-GUIDE.md) - ---- - -**This folder will be removed in a future cleanup. All content has been migrated to course modules.** diff --git a/src/modules/wds/tutorial/chapter-00-why-this-matters/01-inspiration.md b/src/modules/wds/tutorial/chapter-00-why-this-matters/01-inspiration.md deleted file mode 100644 index 8525788b..00000000 --- a/src/modules/wds/tutorial/chapter-00-why-this-matters/01-inspiration.md +++ /dev/null @@ -1,257 +0,0 @@ -# Chapter 0: Why WDS Matters - -## Part 1: Inspiration - -**Learn how to be indispensable in the AI era** - ---- - -## Why Learning WDS Matters - -Imagine being the one person on your team that everyone depends on. Not because you work the longest hours or create the prettiest mockups, but because you do something nobody else can do - not even AI. You're about to learn a design methodology that makes you that person. - -This isn't about working faster or making shinier designs. It's about becoming what bestselling author Seth Godin calls a **Linchpin** - someone who is genuinely irreplaceable. Think about the difference between a factory worker who follows instructions and the person who figures out what needs to be done in the first place. The first person can be replaced by a machine. The second person? They're the one who makes things happen. - -In the AI era, designers who master WDS become linchpin designers. They connect ideas that seem unrelated, make judgment calls when there's no clear answer, and create experiences that feel right in ways that can't be reduced to a formula. - -**What makes an irreplaceable designer:** - -- Connects disparate ideas across business, psychology, and technology -- Makes things happen when there's no instruction manual -- Creates value that can't be commoditized or automated -- Is essential, not interchangeable - ---- - -## What You'll Gain - -Here's the transformation you're about to experience. Right now, you might feel uncertain about your future as a designer in a world where AI can generate interfaces in seconds. You might wonder if your skills will still matter in five years. That uncertainty is about to disappear. - -By the end of this tutorial, you'll have a completely different relationship with AI. Instead of seeing it as a threat, you'll understand it as an amplifier of your unique human abilities. You'll know exactly what makes you irreplaceable, and you'll have a methodology that lets you work with AI as a partner rather than a competitor. - -Most importantly, you'll understand the five dimensions of thinking that only humans can navigate simultaneously - and you'll know how to use them to create designs that AI could never conceive on its own. - -**Your transformation:** - -- βœ… Understand why designers are irreplaceable in the AI era -- βœ… Master the 5 dimensions of designer thinking -- βœ… Recognize what AI can and cannot do -- βœ… Embrace specifications as the new code -- βœ… Amplify your value through AI partnership - ---- - -## The Problem We're Solving - -### The Factory Mindset vs The Linchpin Mindset - -In his groundbreaking book [Linchpin: Are You Indispensable?](https://www.amazon.com/Linchpin-Are-You-Indispensable-ebook/dp/B00354Y9ZU), bestselling author and marketing visionary Seth Godin reveals something uncomfortable: the industrial revolution didn't just change how we make things - it changed how we think about work itself. For over a century, we've been trained to be cogs in a machine. Show up, follow instructions, do your part, go home. Replaceable. Interchangeable. Safe. - -Traditional design work follows this exact pattern. You get a brief (instructions), create some mockups (your part), hand them off to developers (next cog in the machine), and hope they understand what you meant. When they don't, you go through endless revisions until something vaguely resembling your vision ships. You're doing factory work - just with Figma instead of an assembly line. - -Here's the uncomfortable truth: AI is really, really good at factory work. If your job is to follow instructions and create predictable outputs, you're in trouble. But if you can become a linchpin - someone who connects ideas, makes judgment calls, and creates meaning - you become more valuable than ever. - -**The factory mindset in design:** - -- Creates mockups by following briefs (instructions) -- Hands off to developers (replaceable step) -- Hopes they understand (no real connection) -- Endless revisions (cog in the machine) -- Can be replaced by AI - ---- - -### The AI Threat (For Cogs) - -Let's be honest about what's happening. AI can now generate mockups in seconds. It can follow design systems with perfect consistency. It can iterate through hundreds of variations without breaking a sweat. If your value as a designer comes from creating predictable outputs based on clear instructions, you're competing with something that's faster, more consistent, and infinitely scalable. - -But here's the thing: AI cannot be a linchpin. It can't walk into a messy situation and figure out what actually needs to happen. It can't sense when a client is asking for the wrong thing. It can't connect a business goal to a psychological insight to a technical constraint and come up with something nobody expected but everyone loves. - -**What AI does better than cogs:** - -- Generates mockups instantly (no creative block) -- Follows design systems perfectly (zero deviation) -- Iterates through hundreds of variations (no fatigue) -- Works 24/7 at the same quality level (infinitely scalable) -- Executes instructions flawlessly (no interpretation errors) - ---- - -### The AI Opportunity (For Linchpin Designers) - -Here's where it gets exciting - and where most designers miss the point entirely. - -The internet is drowning in AI slop. Generic interfaces that look fine but feel dead. Products that check all the boxes but have no soul. Experiences that function correctly but leave users cold. This is what happens when you let AI do the thinking - you get competent mediocrity at scale. - -But here's the brutal truth about today's market: **bad products used to fail after launch. Now bad products never even get to start.** Users have infinite options. They can smell soulless design from a mile away. They won't give you a second chance. If your product doesn't immediately feel different, feel right, feel like someone actually cared - it's dead on arrival. - -This is your opportunity. While everyone else is racing to generate more generic content faster, you can create products that come alive. Products with soul. Products that people actually want to use because they feel the human thinking behind them. - -Linchpin designers do what AI fundamentally cannot do: they give products a soul. They navigate five dimensions of thinking simultaneously - business goals, user psychology, product strategy, technical constraints, and design execution - and find the human truth at the intersection. They make judgment calls that create emotional resonance. They build trust through thoughtful decisions. They care about the outcome in a way that shows in every interaction. - -The bottleneck in product development used to be coding. AI demolished that. Now the bottleneck is **products worth building** - figuring out what to create that won't be just more noise in an ocean of AI-generated mediocrity. - -**What makes products come alive (what only designers can do):** - -- Navigate 5 dimensions to find the human truth at the intersection -- Make judgment calls that create emotional resonance, not just functionality -- Build trust through decisions that show someone cared -- Connect business goals to user psychology in ways that feel right -- Create experiences that stand out from generic AI-generated mediocrity -- Give products a soul that users can feel - ---- - -## The Opportunity - -### Becoming a Linchpin Designer - -Seth Godin defines a linchpin as "an individual who can walk into chaos and create order, someone who can invent, connect, create, and make things happen." That's exactly what product design is at its core - walking into the chaos of competing business goals, unclear user needs, technical constraints, and market pressures, and somehow creating order. Creating something that works. - -WDS teaches you to be this person systematically. Not through vague advice about "thinking outside the box," but through a concrete methodology that helps you navigate complexity and create clarity. You'll learn to ask the right questions, connect the right dots, and make the right calls - even when there's no obvious right answer. - -This is what makes you indispensable. Not your Figma skills. Not your aesthetic taste. Your ability to walk into chaos and create order. - -**The irreplaceable designer:** - -- Transforms complexity into clarity -- Invents solutions nobody expected -- Bridges business, psychology, and technology -- Delivers results when there's no roadmap - ---- - -### The Designer's Gift: User-Centric Creativity - -Here's Godin's most important insight: linchpins provide something he calls **emotional labor** - the work of genuinely caring about the outcome, connecting with people's real needs, and creating meaning that matters. For designers, this translates into **user-centric creativity** - the uniquely human ability to understand, empathize, and create with purpose. - -User-centric creativity means doing the hard work of understanding WHY users feel frustrated instead of just making things look better. It means connecting business goals to human needs in ways that serve both. It means creating experiences that feel right, not just function correctly. It means making judgment calls that serve people, even when it's harder than following a formula. - -AI can generate variations endlessly and make things look polished on the surface. But here's what it cannot do: it cannot tell when something is fundamentally wrong. It will confidently create beautiful interfaces that make no logical sense. It will add features that contradict the business goal. It will optimize for metrics that destroy user trust. It will make ridiculous mistakes with absolute confidence - and without a skilled designer as gatekeeper, those mistakes ship. - -This is where user-centric creativity becomes critical. You're not just creating - you're evaluating, connecting, and protecting. You understand what it feels like to be a parent struggling to get their kids to help with the dog. You can sense when a business goal conflicts with user needs and find a creative solution that serves both. You're the advocate for the user's presence in every decision. You're the gatekeeper who ensures the impactful meeting between business and user actually happens through the product. - -**The designer as gatekeeper:** - -- Catches AI's confident but ridiculous mistakes before they ship -- Evaluates if solutions actually make logical sense -- Ensures business goals don't contradict user needs -- Protects users from metric-driven decisions that destroy trust -- Advocates for the user's presence in every decision -- Creates the impactful meeting between business and user - ---- - -### From Cog to Linchpin Designer - -Here's the transformation that WDS enables. In the old model, you were a cog designer - creating mockups based on briefs, handing them off to developers who interpreted them their own way, hoping for the best. Your leverage was limited because your thinking stopped at the handoff. You were replaceable because anyone with similar skills could do roughly the same thing. - -With WDS and AI, everything changes - and here's the key insight: **your design contribution completely replaces prompting.** Think about it. You make design decisions. AI helps you clarify them in text. The result is an absolute goldmine for everyone on the team - providing clarity that works like clockwork, replacing hours of pointless back-and-forth prompting. - -You provide the user-centric creativity - the deep understanding of WHY things need to work a certain way. You create why-based specifications that capture not just what to build, but why you're building it that way and what mistakes to avoid. Then AI implements it - but you're there as gatekeeper, catching the mistakes, evaluating the logic, ensuring it actually serves both business and user. - -Here's the paradigm shift: **The design becomes the specification. The specification becomes the product. The code is just the printout - the projection to the end user.** Your thinking no longer stops at handoff. It scales infinitely. Every specification you write becomes a permanent record of your design reasoning that provides clarity for developers, stakeholders, and AI alike. No more endless prompting sessions. No more "can you make it more modern?" Your design thinking, captured in specifications, is the source of truth. - -You remain in the loop - the skilled, experienced designer who evaluates AI's work, catches its confident mistakes, and ensures what ships actually makes sense. You become the key designer player - the person who makes things happen. AI becomes your tool - powerful but requiring your expertise to guide it. - -**The designer's transformation:** - -- **Before:** Creates mockups β†’ Hands off β†’ Hopes it works β†’ Limited leverage -- **After:** Design thinking β†’ Specification β†’ Gatekeeper β†’ Clarity for all β†’ Scales infinitely -- **Result:** From replaceable cog to indispensable gatekeeper - your design IS the product - ---- - -## What You'll Learn - -### The Designer's Art: 5-Dimensional Thinking - -Godin says linchpins "connect disparate ideas." For product designers, this means something very specific: navigating five different dimensions of thinking at the same time. Most people can handle one or two dimensions. Irreplaceable designers navigate all five simultaneously, seeing connections that others miss. - -Think about designing that Dog Week calendar. You need to understand why the business exists (solving family conflict), what success looks like (kids actually walk the dog without nagging), what features serve that goal (week view, not daily), who the users are and what triggers their needs (Swedish families thinking in "Vecka"), and what's technically feasible (mobile app with family sharing). Each dimension informs the others. Miss one, and your design falls apart. - -This is what makes you indispensable as a designer. AI can help you think through each dimension individually. It can generate ideas, analyze data, suggest solutions. But it cannot navigate all five dimensions simultaneously while providing the emotional labor of genuinely caring about the outcome. That's uniquely human. That's what makes designers irreplaceable. - -**The 5 dimensions of design thinking:** - -1. **Business Existence (WHY)** - Understanding purpose and value creation -2. **Business Goals (SUCCESS)** - Connecting to metrics and impact -3. **Product Strategy (HOW)** - Making hard choices about features -4. **Target Groups (WHO)** - Empathy and understanding needs -5. **Technical Viability (FEASIBLE)** - Bridging design and implementation - -**The irreplaceable designer's advantage:** Navigating all 5 simultaneously with emotional labor - ---- - -## The Transformation - -### From Replaceable to Indispensable - -Godin has a warning that should make every designer pay attention: "If you're not indispensable, you're replaceable. And if you're replaceable, you're probably going to be replaced." In the AI era, this isn't a threat - it's just reality. The question is: which side of that line are you on? - -Right now, you might feel threatened by AI design tools. You might be uncertain about your value as a designer. You might be frustrated by the gap between your vision and what gets implemented. You might feel limited by development bottlenecks. If you're doing factory work - following briefs, creating mockups, hoping for the best - you're on the wrong side of that line. - -This tutorial moves you to the other side. You'll become confident in your indispensable role because you'll understand exactly what makes you irreplaceable. You'll be clear on your unique gift - the user-centric creativity that AI cannot provide. You'll be empowered by AI partnership instead of threatened by it, because AI will amplify your design thinking instead of replacing it. You'll be unstoppable in implementation because your specifications will capture your creative intent perfectly. - -You'll become the designer who makes things happen. The one they can't do without. The linchpin designer. - -**Your transformation as a designer:** - -- **Before:** Threatened, uncertain, frustrated, limited, replaceable -- **After:** Confident, clear, empowered, unstoppable, indispensable -- **Result:** The designer who makes things happen - ---- - -## Learn from Real-World projects: Case Studies - -### Case Study: Dog Week - -Let's make this concrete with a real project. Dog Week is an app that helps Swedish families manage their dog's care through a shared family calendar. The problem it solves is universal - parents are tired of nagging kids about walking the dog, kids feel like they're being punished, and everyone ends up frustrated. - -An irreplaceable designer approaches this completely differently than a cog designer. Instead of jumping straight to mockups, they apply user-centric creativity first. They understand Swedish family dynamics - how "Vecka 40" (week 40) is how people think about time. They connect the business goal (family accountability) to human needs (fun, not punishment). They make judgment calls like using a week view instead of daily, because that matches how families actually think. Every decision is grounded in design empathy and understanding WHY. - -Compare the outcomes. The traditional approach - creating mockups, handing off to developers, going through revisions - took 26 weeks and resulted in something mediocre because the intent got lost in translation. The WDS approach - applying user-centric creativity upfront, capturing WHY in specifications, letting AI implement - took 5 weeks and resulted in something exceptional because the design intent was preserved. - -That's a 5x speed increase with better quality. But more importantly, the key designer's creative thinking was preserved and amplified instead of diluted and lost. - -**The comparison:** - -- **Traditional (cog designer):** 26 weeks β†’ Mediocre result β†’ Intent lost -- **WDS (linchpin designer):** 5 weeks β†’ Exceptional result β†’ Intent preserved -- **Key difference:** Designer's user-centric creativity captured and amplified - ---- - -_More case studies will be added here as they become available._ - ---- - -## Ready to Begin? - -**Before you start, check the practicalities:** - -- What skills you need (spoiler: you already have them) -- Time investment and learning paths -- Tools required (mostly free) -- What other designers say about WDS - -**[Read Practicalities β†’](04-practicalities.md)** - ---- - -**Or jump straight into the methodology:** - -In the next section (Teaching), you'll learn the concrete methodology: - -- The 5 dimensions in detail with examples -- What AI cannot do (and what it can) -- Why specifications are the new code -- How to amplify your value through AI partnership - -**[Continue to Part 2: Teaching β†’](02-teaching.md)** - ---- - -[← Back to Tutorial Guide](../00-TUTORIAL-GUIDE.md) | [Practicalities β†’](04-practicalities.md) | [Next: Teaching β†’](02-teaching.md) diff --git a/src/modules/wds/tutorial/chapter-00-why-this-matters/04-practicalities.md b/src/modules/wds/tutorial/chapter-00-why-this-matters/04-practicalities.md deleted file mode 100644 index 924a0ca6..00000000 --- a/src/modules/wds/tutorial/chapter-00-why-this-matters/04-practicalities.md +++ /dev/null @@ -1,258 +0,0 @@ -# Chapter 0: Why WDS Matters - -## Part 4: Practicalities - -**Everything you need to know before starting** - ---- - -## Prerequisites - -### What Skills You Need - -**Required (you probably already have these):** - -- Basic design thinking and UX principles -- Ability to sketch interfaces (hand-drawn or digital) -- Understanding of user needs and business goals -- Willingness to think deeply about WHY - -**NOT required:** - -- ❌ Coding skills -- ❌ Advanced technical knowledge -- ❌ Experience with AI tools -- ❌ Formal design education - -**The truth:** If you can design interfaces and explain your thinking, you have everything you need to start. - ---- - -## Time Investment - -### How Long Does It Take? - -**Total tutorial time:** ~10 hours - -- Spread over days or weeks at your own pace -- Each chapter: 30-40 minutes -- Practice exercises: 1-2 hours per chapter - -**Breakdown:** - -- **Week 1-2:** Foundation chapters (0-2.3) - Understanding the methodology -- **Week 3-4:** Core workflow (4.1-4.6) - Learning specification creation -- **Week 5-6:** Advanced topics (5.1-6.1) - Design systems and handoff -- **Ongoing:** Practice with your own projects - -**Real-world application:** - -- First project with WDS: 2-3x slower than your usual process (learning curve) -- Second project: Same speed as traditional approach -- Third project onwards: 3-5x faster with better quality - ---- - -## Tools You'll Need - -### Essential Tools - -**For sketching:** - -- Paper and pen (seriously, this works best) -- OR digital sketching tool (Excalidraw, Figma, iPad + Pencil) - -**For AI assistance:** - -- Access to Claude, ChatGPT, or similar AI assistant -- Free tier is sufficient to start - -**For documentation:** - -- Text editor (VS Code recommended, but any will work) -- Markdown support (built into most modern editors) - -**For collaboration:** - -- Git/GitHub (optional but recommended) -- Shared folder system (Google Drive, Dropbox, etc.) - -**Total cost to get started:** $0-20/month - -- Free tier AI tools work fine -- Paid AI subscriptions ($20/month) provide better experience but aren't required - ---- - -## What You'll Create - -### Your First WDS Project - -By the end of this tutorial, you'll have created: - -**1. Complete Project Brief** - -- Vision and goals clearly defined -- Stakeholders and constraints documented -- Foundation for all design decisions - -**2. Trigger Map** - -- Target groups identified and prioritized -- User triggers and outcomes mapped -- Features prioritized by impact - -**3. Scenario Specifications** - -- At least one complete user scenario -- Why-based specifications for key components -- AI-ready documentation - -**4. Design System Foundation** - -- Design tokens extracted from your specs -- Component patterns identified -- Reusable architecture defined - -**Estimated value:** What used to take 6-8 weeks now takes 1-2 weeks - ---- - -## Learning Path Options - -### Choose Your Journey - -**Option 1: Full Immersion (Recommended)** - -- Complete all 16 chapters in order -- Practice exercises for each chapter -- Apply to a real project as you learn -- **Time:** 6-8 weeks, 10-15 hours total -- **Best for:** Designers who want to master the methodology - -**Option 2: Quick Start** - -- Focus on core chapters (0, 2.2, 4.1, 4.5) -- Skip advanced topics initially -- Get started fast, learn more later -- **Time:** 2-3 weeks, 3-4 hours total -- **Best for:** Designers who need results quickly - -**Option 3: Self-Paced** - -- Learn one chapter per week -- Deep practice between chapters -- Build multiple projects as you learn -- **Time:** 16 weeks, 20+ hours total -- **Best for:** Designers who want deep mastery - ---- - -## What Other Designers Say - -### Testimonials - -> "I was skeptical at first - another design methodology? But WDS changed how I think about my role. I'm no longer just making things pretty. I'm the strategic thinker who makes products come alive." -> -> **β€” Sarah K., Product Designer** - -> "The 5x speed increase is real. But what surprised me most was how much clearer my thinking became. Writing why-based specifications forced me to understand the 'why' at a deeper level." -> -> **β€” Marcus L., UX Lead** - -> "I thought AI would replace me. WDS showed me how to make AI amplify my thinking instead. Now I'm the most valuable designer on my team." -> -> **β€” Priya S., Senior Designer** - -> "The paradigm shift hit me in Chapter 4: my design IS the product. The code is just the printout. That completely changed how I approach every project." -> -> **β€” James T., Design Director** - -_Note: More testimonials will be added as designers complete the tutorial._ - ---- - -## Common Questions - -### FAQ - -**Q: Do I need to know how to code?** -A: No. WDS is about design thinking and specifications. AI handles the implementation. - -**Q: What if I don't have a project to practice with?** -A: The tutorial includes practice exercises. You can also use a hypothetical project or redesign an existing app. - -**Q: Can I use this with my current design process?** -A: Yes! WDS complements existing processes. Many designers integrate it gradually. - -**Q: Is this only for digital products?** -A: WDS is optimized for digital products, but the principles apply to any design work. - -**Q: What if I get stuck?** -A: Each chapter includes clear examples and guidance. The AI assistant can help clarify concepts as you learn. - -**Q: Do I need to complete all 16 chapters?** -A: No. The Quick Start path (4 chapters) gives you enough to start applying WDS immediately. - -**Q: Can I teach this to my team?** -A: Yes! WDS is open-source and free. Share it with your entire team. - -**Q: How is this different from traditional design documentation?** -A: Traditional docs describe WHAT. WDS captures WHY + WHAT + WHAT NOT TO DO. This makes it AI-ready and preserves your design intent. - ---- - -## Support & Community - -### Getting Help - -**During the tutorial:** - -- Each chapter includes detailed examples -- AI assistants can clarify concepts in real-time -- Practice exercises with clear success criteria - -**After completion:** - -- GitHub Discussions for questions and sharing -- Community showcase of WDS projects -- Regular updates and new case studies - -**Contributing:** - -- WDS is open-source and welcomes contributions -- Share your case studies and learnings -- Help improve the tutorial for future designers - ---- - -## Ready to Start? - -You have everything you need: - -- βœ… The skills (design thinking) -- βœ… The tools (paper + AI) -- βœ… The time (10 hours) -- βœ… The motivation (staying indispensable) - -**Next step:** Choose your learning path and dive into Chapter 1. - -**[Start Chapter 1: Project Brief β†’](../chapter-1.1-project-brief/01-inspiration.md)** - -Or return to the main guide to review the full structure: - -**[← Back to Tutorial Guide](../00-TUTORIAL-GUIDE.md)** - ---- - -## Your Transformation Starts Now - -Remember: - -- **The design becomes the specification** -- **The specification becomes the product** -- **The code is just the printout** - -Ten hours of learning. A lifetime of being indispensable. - -Let's begin. diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/contract.template.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/contract.template.md new file mode 100644 index 00000000..4d48ebda --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/contract.template.md @@ -0,0 +1,297 @@ +# Project Contract + +**Project**: {{project_name}} +**Date**: {{date}} +**Client**: {{client_name}} +**Contractor**: {{contractor_name}} +**Contract Language**: {{contract_language}} +**Governing Law/Jurisdiction**: {{governing_jurisdiction}} + +--- + +> **Contract Philosophy**: This contract is designed to be simple, fair, and clear - providing reliable terms that support a long-lasting working relationship between both parties. + +--- + +## 1. Project Overview + +### The Realization + +{{realization}} + +### Recommended Solution + +{{recommended_solution}} + +--- + +## 2. Business Model + +**Selected Model**: {{business_model}} + +{{business_model_description}} + +{{business_model_terms}} + +--- + +## 3. Scope of Work + +### The Path Forward + +{{path_forward}} + +### Deliverables + +Based on the path forward, the following deliverables will be provided: + +{{deliverables_list}} + +### In Scope + +The following work is explicitly included in this contract: + +{{in_scope}} + +### Out of Scope + +The following work is explicitly NOT included in this contract: + +{{out_of_scope}} + +**Note**: Any work outside the scope defined above requires a written Change Order (see Section 10: Not to Exceed Clause). + +--- + +## 4. Our Commitment + +{{our_commitment}} + +--- + +### Payment Terms + +**Total Contract Amount**: {{total_amount}} + +**Payment Structure**: {{payment_structure}} + +**Payment Schedule**: +{{payment_schedule}} + +**Background**: Clear payment terms protect both parties and ensure fair compensation. + +**What it does**: Defines when and how payments will be made. + +**Purpose**: +- Ensures supplier receives fair compensation for work +- Provides client with clear payment expectations +- Protects both parties from payment disputes +- For fixed-price contracts, upfront payment is fair since supplier assumes cost overrun risk + +**Payment Terms Details**: +- **Payment Method**: {{payment_method}} (check, wire transfer, credit card, etc.) +- **Payment Due Dates**: {{payment_due_dates}} +- **Late Payment**: {{late_payment_terms}} (e.g., interest charges, work suspension) +- **Payment Conditions**: {{payment_conditions}} (e.g., payment required before work begins, payment tied to deliverables) + +**For Fixed-Price Contracts**: +This is a fixed-price contract, meaning the contractor commits to deliver specified work for the agreed price, regardless of actual costs. Since the contractor assumes the risk of cost overruns, upfront payment (50-100%) is standard and fair. This demonstrates client commitment and enables the contractor to deliver quality work without cash flow concerns. + +--- + +## 5. Timeline + +{{timeline}} + +*Note: Timeline is based on the work plan outlined above and may be adjusted based on project requirements.* + +--- + +## 6. Why It Matters + +{{why_it_matters}} + +--- + +## 7. Expected Outcomes + +### The Value We'll Create + +{{value_we_create}} + +--- + +## 8. Risks and Considerations + +### Cost of Inaction + +{{cost_of_inaction}} + +--- + +## 9. Confidentiality + +### Confidentiality Clause + +**Background**: This clause protects sensitive information shared during the project. + +**What it does**: Both parties agree to keep project information confidential. + +**Purpose**: Protects proprietary information, business strategies, trade secrets, and sensitive data. + +**Terms**: + +Both parties agree to: + +- Keep all project-related information confidential +- Not disclose project details to third parties without written consent +- Use confidential information solely for project purposes +- Return or destroy confidential materials upon project completion or termination +- Maintain confidentiality obligations even after project completion + +**Exceptions**: +- Information already publicly known +- Information independently developed +- Information required by law to be disclosed + +**Duration**: Confidentiality obligations shall remain in effect for [X] years after project completion. + +--- + +## 10. Not to Exceed Clause + +### Budget Cap + +**Background**: This clause sets a maximum budget limit. + +**What it does**: States that total costs will not exceed a specified amount without prior written approval. + +**Purpose**: +- Protects both parties from unexpected cost overruns +- Ensures budget control +- **Prevents scope creep** - Any work beyond the original scope requires approval and may affect the budget cap + +**Terms**: + +- Total project costs shall not exceed **{{not_to_exceed_amount}}** without prior written approval from {{client_name}} +- Any work that would exceed this amount must be approved in advance +- If additional work is needed, a change order must be signed before proceeding +- This cap includes all fees, expenses, and costs related to the project + +**Change Orders and Scope Control**: +- Any changes to scope that affect cost must be documented in a written change order +- Change orders must be signed by both parties before work begins +- Change orders may adjust the not-to-exceed amount if agreed upon +- **Scope creep prevention**: Work outside the original scope (as defined in Section 2) requires a change order and approval before proceeding +- This clause helps prevent gradual expansion of project scope without proper authorization + +--- + +## 11. Terms and Conditions + +### Work Initiation + +**When work begins**: {{work_initiation_date_or_condition}} + +**Background**: This clause specifies exactly when the contractor is authorized to begin work. + +**What it does**: Defines the start date or conditions that must be met before work begins. + +**Purpose**: +- Prevents unauthorized work before contract is fully executed +- Establishes clear timeline expectations +- Protects both parties by ensuring work only begins after proper authorization + +**Initiation conditions** (select applicable): +- Upon full execution of this contract (signatures from both parties) +- On a specific date: {{specific_start_date}} +- Upon receipt of initial payment/deposit +- Upon written notice from {{client_name}} +- Other: {{custom_initiation_condition}} + +### Project Initiation + +This project is initiated upon approval of the project pitch. Project initiation is considered complete upon stakeholder approval. + +### Next Steps + +After contract approval: +1. Proceed to full Project Brief development +2. Execute work plan as outlined above +3. Deliverables will be provided according to the agreed timeline + +### Changes and Modifications + +Any changes to scope, timeline, or investment must be agreed upon in writing by all parties. + +### Intellectual Property + +**Philosophy**: Clear IP ownership prevents future disputes and protects both parties' interests. + +All deliverables and work products created under this contract will be owned by {{client_name}} upon full payment, unless otherwise specified in writing. This ensures clarity and prevents misunderstandings about ownership rights. + +### Termination + +**Philosophy**: Fair termination terms protect both parties while allowing for reasonable exit if needed. + +Either party may terminate this agreement with [X] days written notice. Upon termination, payment is due for work completed to date. This ensures fair compensation for work done and reasonable notice for both parties to plan accordingly. + +### Dispute Resolution + +**Background**: Defines how conflicts will be resolved if they arise. + +**What it does**: Establishes the process for handling disagreements. + +**Purpose**: Provides a clear path for resolving disputes without costly litigation when possible. + +**Method**: {{dispute_resolution_method}} (mediation/arbitration/litigation) + +**Location**: {{dispute_resolution_location}} + +Any disputes arising from this contract shall be resolved through {{dispute_resolution_method}} in {{dispute_resolution_location}}. + +--- + +### Governing Law and Jurisdiction + +**Background**: Determines which laws apply and where legal proceedings would take place. + +**What it does**: Specifies the legal framework and court system that governs the contract. + +**Purpose**: Provides legal clarity and predictability for both parties. + +**Governing Law**: This contract shall be governed by and construed in accordance with the laws of {{governing_jurisdiction}}. + +**Jurisdiction**: Any legal proceedings arising from this contract shall be subject to the exclusive jurisdiction of the courts of {{governing_jurisdiction}}. + +**Contract Language**: This contract is executed in {{contract_language}}. In case of translation, the {{contract_language}} version shall prevail. + +--- + +## 12. Approval + +**Client Approval**: + +Signature: _________________ +Name: {{client_name}} +Date: _______________ + +**Contractor Approval**: + +Signature: _________________ +Name: {{contractor_name}} +Date: _______________ + +--- + +## Appendix + +### Reference Documents + +- Project Pitch: `docs/1-project-brief/pitch.md` +- Project Brief: (To be created after contract approval) + +--- + +*This contract is based on the project pitch dated {{date}}.* + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/pitch.template.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/pitch.template.md new file mode 100644 index 00000000..bac88260 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/pitch.template.md @@ -0,0 +1,82 @@ +# Project Pitch: {{project_name}} + +> Compelling case for why this project matters and should be built + +**Created:** {{date}} +**Author:** {{user_name}} +**Status:** Ready for stakeholder approval + +--- + +## 1. The Realization + +{{realization}} + +--- + +## 2. Why It Matters + +{{why_it_matters}} + +--- + +## 3. How We See It Working + +{{how_we_see_it_working}} + +--- + +## 4. Paths We Explored + +{{paths_we_explored}} + +--- + +## 5. Recommended Solution + +{{recommended_solution}} + +--- + +## 6. The Path Forward + +{{path_forward}} + +--- + +## 7. The Value We'll Create + +{{value_we_create}} + +--- + +## 8. Cost of Inaction + +{{cost_of_inaction}} + +--- + +## 9. Our Commitment + +{{our_commitment}} + +--- + +## 10. Summary + +{{summary}} + +--- + +## Next Steps + +**After approval**, proceed to: +- **Full Project Brief** - Detailed strategic foundation +- **Trigger Mapping** - User research and personas +- **Platform Requirements** - Technical foundation +- **UX Design** - Scenarios and prototypes + +--- + +_Generated by Whiteport Design Studio_ + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md new file mode 100644 index 00000000..5c0eb0e5 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md @@ -0,0 +1,212 @@ +# Pitch Section Exploration Guide + +**Framework Inspiration**: This guide draws from proven frameworks: +- **Customer-Problem-Solution (CPS)** - Clear structure +- **Value Proposition Canvas** - Understanding customer needs +- **Problem-Agitate-Solve (PAS)** - Natural flow +- **Business Case Framework** - Investment and consequences + +--- + +### 1. The Realization + +**Framework**: Problem-Agitate-Solve (PAS) - Start here + +**Questions to explore**: +- "What have you realized needs attention?" +- "What observation have you made?" +- "What challenge are you seeing?" +- "What evidence do you have that this is real?" + +**Best Practice: Confirm the Realization with Evidence** + +**Help them identify evidence:** + +**Soft Evidence** (qualitative indicators): +- "Do you have testimonials or complaints about this?" +- "What have stakeholders told you?" +- "What patterns have you observed?" +- "What do user interviews reveal?" + +**Hard Evidence** (quantitative data): +- "Do you have statistics or metrics?" +- "What do analytics show?" +- "Have you run surveys or tests?" +- "What do server logs or error reports indicate?" + +**Help them combine both types** for maximum credibility: +- Start with soft evidence (testimonials, complaints, observations) +- Support with hard evidence (statistics, analytics, survey results) +- Show the realization is grounded in reality + +**Keep it brief** - 2-3 sentences for the realization, plus 1-2 sentences of evidence + +**Help them articulate**: Clear realization backed by evidence that frames a reality worth addressing + +--- + +### 2. Why It Matters + +**Framework**: Value Proposition Canvas + Impact - Understanding why this matters and who we help + +**Questions to explore**: +- "Why does this matter?" +- "Who are we helping?" +- "What are they trying to accomplish?" (Jobs) +- "What are their pain points?" (Pains) +- "What would make their life better?" (Gains) +- "How does this affect them?" +- "What impact will this have?" +- "Are there different groups we're helping?" + +**Keep it brief** - Why it matters and who we help + +**Help them think**: Focus on the value we're adding to specific people and why that matters + +--- + +### 3. How We See It Working + +**Questions to explore**: +- "How do you envision this working?" +- "What's the general approach?" +- "Walk me through how you see it addressing the realization" + +**Keep it brief** - High-level overview, not detailed specifications + +**Flexible language** - Works for software, processes, services, products, strategies + +--- + +### 4. Paths We Explored + +**Questions to explore**: +- "What other ways could we approach this?" +- "Are there alternative paths?" +- "What options have you considered?" + +**Keep it brief** - 2-3 paths explored briefly + +**If user only has one path**: That's fine - acknowledge it and move on + +--- + +### 5. Recommended Solution + +**Questions to explore**: +- "Which approach do you prefer?" +- "Why this one over the others?" +- "What makes this the right solution?" + +**Keep it brief** - Preferred approach and key reasons + +--- + +### 6. The Path Forward + +**Purpose**: Explain how the work will be done practically - which WDS phases will be used and the workflow approach. + +**Questions to explore**: +- "How do you envision the work being done?" +- "Which WDS phases do you think we'll need?" +- "What's the practical workflow you're thinking?" +- "Will we need user research, or do you already know your users?" +- "Do you need technical architecture planning, or is that already defined?" +- "What level of design detail do you need?" +- "How will this be handed off for implementation?" + +**Keep it brief** - High-level plan of the work approach + +**Help them think**: +- Which WDS phases apply (Trigger Mapping, Platform Requirements, UX Design, Design System, etc.) +- Practical workflow (research β†’ design β†’ handoff, or skip research, etc.) +- Level of detail needed +- Handoff approach + +**Example responses**: +- "We'll start with Product Brief, then do UX Design for 3 scenarios, skip Trigger Mapping since we know our users, and create a handoff package for developers" +- "Need full WDS workflow: Brief β†’ User Research β†’ Architecture β†’ Design β†’ Handoff" +- "Just need design specs - skip research and architecture, go straight to UX Design" + +--- + +### 7. The Value We'll Create + +**Framework**: Business Case Framework - What's the return? + +**Questions to explore**: +- "What's our ambition? What are we striving to accomplish?" +- "What happens if we DO build this?" +- "What benefits would we see?" +- "What outcomes are we expecting?" +- "How will we measure success?" +- "What metrics will tell us we're succeeding?" +- "What's the value we'd create?" + +**Best Practice: Frame as Positive Assumption with Success Metrics** + +**Help them articulate**: +- **Our Ambition**: What we're confidently striving to accomplish (enthusiastic, positive) +- **Success Metrics**: How we'll measure success (specific, measurable) +- **What Success Looks Like**: Clear outcomes (tangible results) +- **Monitoring Approach**: How we'll track these metrics (brief) + +**Keep it brief** - Key benefits, outcomes, and success metrics + +**Help them think**: Positive assumption ("We're confident this will work") + clear success metrics ("Here's how we'll measure it") = enthusiastic and scientific + +--- + +### 8. Cost of Inaction + +**Framework**: Problem-Agitate-Solve (PAS) - Agitate the problem / Business Case Framework + +**Questions to explore**: +- "What happens if we DON'T build this?" +- "What are the risks of not acting?" +- "What opportunities would we miss?" +- "What's the cost of doing nothing?" +- "What gets worse if we don't act?" +- "What do we lose by waiting?" + +**Keep it brief** - Key consequences of not building + +**Can include**: +- Financial cost (lost revenue, increased costs) +- Opportunity cost (missed opportunities) +- Competitive risk (competitors gaining advantage) +- Operational impact (inefficiency, problems getting worse) + +**Help them think**: Make the case for why we can't afford NOT to do this + +--- + +### 9. Our Commitment + +**Framework**: Business Case Framework - What are we committing to? + +**Questions to explore**: +- "What resources are we committing?" +- "What's the time commitment?" +- "What budget or team are we committing?" +- "What dependencies exist?" +- "What potential risks or drawbacks should we consider?" +- "What challenges might we face?" + +**Keep it brief** - High-level commitment and potential risks + +**Don't force precision** - Rough estimates are fine at this stage + +**Help them think**: Time, money, people, technology - what are we committing to make this happen? What risks or challenges should we acknowledge? + +--- + +### 10. Summary + +**Questions to explore**: +- "What are the key points?" +- "What should stakeholders remember?" +- "What's the main takeaway?" + +**Keep it brief** - Summary of key points (let readers draw their own conclusion) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/service-agreement.template.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/service-agreement.template.md new file mode 100644 index 00000000..17b20e7e --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/service-agreement.template.md @@ -0,0 +1,277 @@ +# Service Agreement + +**Project**: {{project_name}} +**Date**: {{date}} +**Client/Owner**: {{client_name}} +**Service Provider**: {{service_provider_name}} +**Contract Language**: {{contract_language}} +**Governing Law/Jurisdiction**: {{governing_jurisdiction}} + +--- + +> **Agreement Philosophy**: This agreement is designed to be simple, fair, and clear - providing reliable terms that support a long-lasting working relationship between both parties. + +--- + +## 1. Project Overview + +### The Realization + +{{realization}} + +### Recommended Solution + +{{recommended_solution}} + +--- + +## 2. Scope of Services + +### The Path Forward + +{{path_forward}} + +### Deliverables + +Based on the path forward, the following deliverables will be provided: + +{{deliverables_list}} + +--- + +## 3. Our Commitment + +{{our_commitment}} + +--- + +### Payment Terms + +**Total Agreement Amount**: {{total_amount}} + +**Payment Structure**: {{payment_structure}} + +**Payment Schedule**: +{{payment_schedule}} + +**Background**: Clear payment terms protect both parties and ensure fair compensation. + +**What it does**: Defines when and how payments will be made. + +**Purpose**: +- Ensures service provider receives fair compensation for work +- Provides client with clear payment expectations +- Protects both parties from payment disputes +- For fixed-price agreements, upfront payment is fair since service provider assumes cost overrun risk + +**Payment Terms Details**: +- **Payment Method**: {{payment_method}} (check, wire transfer, credit card, etc.) +- **Payment Due Dates**: {{payment_due_dates}} +- **Late Payment**: {{late_payment_terms}} (e.g., interest charges, work suspension) +- **Payment Conditions**: {{payment_conditions}} (e.g., payment required before work begins, payment tied to deliverables) + +**For Fixed-Price Agreements**: +This is a fixed-price agreement, meaning the service provider commits to deliver specified work for the agreed price, regardless of actual costs. Since the service provider assumes the risk of cost overruns, upfront payment (50-100%) is standard and fair. This demonstrates client commitment and enables the service provider to deliver quality work without cash flow concerns. + +--- + +## 4. Timeline + +{{timeline}} + +*Note: Timeline is based on the path forward outlined above and may be adjusted based on project requirements.* + +--- + +## 5. Why It Matters + +{{why_it_matters}} + +--- + +## 6. Expected Outcomes + +### The Value We'll Create + +{{value_we_create}} + +--- + +## 7. Service Terms + +### Payment Terms + +{{payment_terms}} + +### Deliverable Acceptance + +Deliverables will be considered accepted upon: +- Completion according to specifications +- Review and approval by client +- Any requested revisions completed + +### Intellectual Property + +All deliverables and work products will be owned by {{client_name}} upon full payment. + +--- + +## 8. Risks and Considerations + +### Cost of Inaction + +{{cost_of_inaction}} + +--- + +## 9. Confidentiality + +### Confidentiality Clause + +**Background**: This clause protects sensitive information shared during the project. + +**What it does**: Both parties agree to keep project information confidential. + +**Purpose**: Protects proprietary information, business strategies, trade secrets, and sensitive data. + +**Terms**: + +Both parties agree to: + +- Keep all project-related information confidential +- Not disclose project details to third parties without written consent +- Use confidential information solely for project purposes +- Return or destroy confidential materials upon project completion or termination +- Maintain confidentiality obligations even after project completion + +**Exceptions**: +- Information already publicly known +- Information independently developed +- Information required by law to be disclosed + +**Duration**: Confidentiality obligations shall remain in effect for [X] years after project completion. + +--- + +## 10. Not to Exceed Clause + +### Budget Cap + +**Background**: This clause sets a maximum budget limit. + +**What it does**: States that total costs will not exceed a specified amount without prior written approval. + +**Purpose**: +- Protects both parties from unexpected cost overruns +- Ensures budget control +- **Prevents scope creep** - Any work beyond the original scope requires approval and may affect the budget cap + +**Terms**: + +- Total project costs shall not exceed **{{not_to_exceed_amount}}** without prior written approval from {{client_name}} +- Any work that would exceed this amount must be approved in advance +- If additional work is needed, a change order must be signed before proceeding +- This cap includes all fees, expenses, and costs related to the project + +**Change Orders and Scope Control**: +- Any changes to scope that affect cost must be documented in a written change order +- Change orders must be signed by both parties before work begins +- Change orders may adjust the not-to-exceed amount if agreed upon +- **Scope creep prevention**: Work outside the original scope (as defined in Section 2) requires a change order and approval before proceeding +- This clause helps prevent gradual expansion of project scope without proper authorization + +--- + +## 11. Terms and Conditions + +### Work Initiation + +**When work begins**: {{work_initiation_date_or_condition}} + +**Background**: This clause specifies exactly when the service provider is authorized to begin work. + +**What it does**: Defines the start date or conditions that must be met before work begins. + +**Purpose**: +- Prevents unauthorized work before agreement is fully executed +- Establishes clear timeline expectations +- Protects both parties by ensuring work only begins after proper authorization + +**Initiation conditions** (select applicable): +- Upon full execution of this agreement (signatures from both parties) +- On a specific date: {{specific_start_date}} +- Upon receipt of initial payment/deposit +- Upon written notice from {{client_name}} +- Other: {{custom_initiation_condition}} + +### Project Initiation + +This project is initiated upon approval of the project pitch. Project initiation is considered complete upon stakeholder approval. + +### Changes and Modifications + +Any changes to scope, timeline, or investment must be agreed upon in writing by all parties. + +### Termination + +Either party may terminate this agreement with [X] days written notice. Upon termination, payment is due for work completed to date. + +### Dispute Resolution + +**Background**: Defines how conflicts will be resolved if they arise. + +**What it does**: Establishes the process for handling disagreements. + +**Purpose**: Provides a clear path for resolving disputes without costly litigation when possible. + +**Method**: {{dispute_resolution_method}} (mediation/arbitration/litigation) + +**Location**: {{dispute_resolution_location}} + +Any disputes arising from this agreement shall be resolved through {{dispute_resolution_method}} in {{dispute_resolution_location}}. + +--- + +### Governing Law and Jurisdiction + +**Background**: Determines which laws apply and where legal proceedings would take place. + +**What it does**: Specifies the legal framework and court system that governs the agreement. + +**Purpose**: Provides legal clarity and predictability for both parties. + +**Governing Law**: This agreement shall be governed by and construed in accordance with the laws of {{governing_jurisdiction}}. + +**Jurisdiction**: Any legal proceedings arising from this agreement shall be subject to the exclusive jurisdiction of the courts of {{governing_jurisdiction}}. + +**Contract Language**: This agreement is executed in {{contract_language}}. In case of translation, the {{contract_language}} version shall prevail. + +--- + +## 12. Approval + +**Client/Owner Approval**: + +Signature: _________________ +Name: {{client_name}} +Date: _______________ + +**Service Provider Approval**: + +Signature: _________________ +Name: {{service_provider_name}} +Date: _______________ + +--- + +## Appendix + +### Reference Documents + +- Project Pitch: `docs/1-project-brief/pitch.md` +- Project Brief: (To be created after agreement approval) + +--- + +*This service agreement is based on the project pitch dated {{date}}.* + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/signoff.template.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/signoff.template.md new file mode 100644 index 00000000..fe7cefd7 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/signoff.template.md @@ -0,0 +1,188 @@ +# Project Signoff Document + +**Project**: {{project_name}} +**Date**: {{date}} +**Department/Team**: {{department_name}} +**Project Owner**: {{project_owner}} +**Document Language**: {{contract_language}} +**Governing Jurisdiction**: {{governing_jurisdiction}} (if applicable) + +--- + +> **Document Philosophy**: This signoff document is designed to be simple, fair, and clear - providing reliable terms that support successful project execution and clear accountability. + +--- + +## 1. Project Overview + +### The Realization + +{{realization}} + +### Recommended Solution + +{{recommended_solution}} + +--- + +## 2. Goals and Success Metrics + +### What We're Trying to Accomplish + +{{goals}} + +### Success Metrics + +{{success_metrics}} + +### How We'll Measure Success + +{{measurement_approach}} + +### Key Performance Indicators (KPIs) + +{{kpis}} + +--- + +## 3. Budget and Resources + +### Budget Allocation + +**Total Budget**: {{total_budget}} + +**Budget Breakdown** (if applicable): +{{budget_breakdown}} + +### Resources Needed + +{{resources_needed}} + +### Not-to-Exceed Budget Cap + +{{not_to_exceed_budget}} + +--- + +## 4. Ownership and Responsibility + +### Project Owner + +{{project_owner}} + +### Process Owner + +{{process_owner}} + +### Key Stakeholders + +{{key_stakeholders}} + +### Decision-Making Authority + +{{decision_making_authority}} + +--- + +## 5. Approval and Sign-Off + +### Who Needs to Approve + +{{approvers_list}} + +### Approval Stages + +{{approval_stages}} + +### Sign-Off Process + +{{signoff_process}} + +### Timeline for Approval + +{{approval_timeline}} + +--- + +## 6. Timeline and Milestones + +### Key Milestones + +{{key_milestones}} + +### Delivery Dates + +{{delivery_dates}} + +### Critical Deadlines + +{{critical_deadlines}} + +--- + +## 7. Optional Sections + +### Risks and Considerations (Optional) + +{{risks_and_considerations}} + +### Confidentiality (Optional) + +{{confidentiality_requirements}} + +### The Path Forward (Optional - High-Level Overview) + +{{path_forward_high_level}} + +--- + +## 8. Approval and Signoff + +This document serves as formal approval to proceed with the project as outlined above. + +**Stakeholder Signoffs**: + +**Project Sponsor**: + +Name: _________________ +Signature: _________________ +Date: _______________ + +**Budget Approver**: + +Name: _________________ +Signature: _________________ +Date: _______________ + +**Project Owner**: + +Name: {{project_owner}} +Signature: _________________ +Date: _______________ + +--- + +## 9. Next Steps + +Upon signoff: +1. Proceed to full Project Brief development +2. Execute work plan as outlined above +3. Deliverables will be provided according to the agreed timeline + +### Changes and Modifications + +Any changes to scope, timeline, or investment must be agreed upon by all signatories. + +--- + +## Appendix + +### Reference Documents + +- Project Pitch: `docs/1-project-brief/pitch.md` +- Project Brief: (To be created after signoff) + +--- + +*This signoff document is based on the project pitch dated {{date}}.* + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01-start.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01-start.md new file mode 100644 index 00000000..bc86f3ce --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01-start.md @@ -0,0 +1,81 @@ +# Step 1: Start Alignment & Signoff + +## Purpose + +Begin creating an alignment document to get stakeholders aligned and secure commitment before starting the project. + +--- + +## Context for Agent + +You are helping the user create an alignment document (pitch) that presents their idea in the best possible light. This is a **collaborative process** - you're working together to make their idea shine, not to criticize or challenge it. + +**Important**: Don't be surprised if their ideas grow and improve as you go through the process. That's natural and good! + +**Your Role**: You can handle the full experience - from understanding their situation to creating the alignment document and securing signoff. You're here to: +- **Clarify their situation** - Are they a consultant? Manager? Founder? Doing it themselves? +- **Help them understand** - Do they need alignment & signoff, or can they go straight to Project Brief? +- **Guide through alignment & signoff** - Once we know they need alignment, help them create it efficiently + +**Your Style**: Professional, direct, and efficient. You're nice but you play no games - you're here to get things done. If they need emotional support, they can go to Mimir. You focus on clarity and results. + +**Purpose of alignment & signoff**: You're building something that makes the world a better place, and you need others involved. This alignment document helps you get alignment on: +- **The Idea** - What are we building? +- **Why** - Why should it be done? +- **What** - What does it contain? +- **How** - How will it be executed? +- **Budget** - What resources are needed? +- **Commitment** - What are we willing to commit? + +**Workflow**: +1. **Understand their situation** - Ask clarifying questions +2. **Determine if alignment & signoff is needed** - Do they need alignment, or can they proceed directly? +3. Create and refine the alignment document (we can iterate and negotiate) +4. Share with stakeholders for review and feedback +5. Update the alignment document until everyone is on board +6. Once accepted and everyone is aligned +7. Generate signoff document (contract/service agreement/signoff) to secure commitment +8. Then proceed to the full Project Brief workflow + +**Key Principle**: WDS helps with alignment - we'll work together to get everyone on the same page. Negotiation and iteration are welcome during the alignment phase. Once everyone accepts, we'll formalize the commitment with a signoff document. + +--- + +## Opening Framing + +**First, understand their situation** (if not already clear): + +Before diving into the pitch, help them clarify their situation: + +"I'd like to understand your situation first. This will help me guide you efficiently. + +**Are you:** +- A consultant proposing a solution to a client? +- A business owner hiring consultants/suppliers to build software? +- A manager or employee seeking approval for an internal project? +- Or doing this yourself and don't need stakeholder alignment? + +Let's get clear on what you need so we can move forward." + +**If they need alignment & signoff** (consultant, business owner, manager/employee): + +"Good. We're going to work together to create an alignment document that presents your idea clearly and gets stakeholders aligned. + +This alignment document will help you get alignment on your idea, why it matters, what it contains, how it will be executed, the budget needed, and the commitment required. We can iterate until everyone is on board. Once they accept it, we'll create a signoff document to secure the commitment, then proceed to the full Project Brief. + +You can start anywhere - with something you've realized needs attention, or with a solution you have in mind. I'll guide us through the important questions in whatever order makes sense for your thinking." + +**If they're doing it themselves** (don't need alignment & signoff): + +"That's great! If you have full autonomy and don't need stakeholder alignment, you can skip alignment & signoff and go straight to the Project Brief workflow. Would you like me to help you start the Project Brief instead?" + +--- + +## Next Step + +After the opening framing, proceed to: +β†’ `step-01.5-extract-communications.md` (Optional - extract info from communications) + +Then continue to: +β†’ `step-02-explore-sections.md` + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01.5-extract-communications.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01.5-extract-communications.md new file mode 100644 index 00000000..1e57395c --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01.5-extract-communications.md @@ -0,0 +1,78 @@ +# Step 1.5: Extract Information from Communications and Documents (Optional) + +## Purpose + +Gather existing context from client/stakeholder communications, emails, chats, and documents to inform the pitch. + +--- + +## Instruction + +**Ask the user** if they have any relevant communications or documents: + +"Do you have any email threads, chat conversations, documents, or other materials from clients or stakeholders about this project? + +If you do, I can extract key information from them - things like: +- Realizations or observations they've mentioned +- Requirements they've discussed +- Concerns or questions they've raised +- Context about the project +- Existing documentation or specifications + +This can help us create a more informed pitch. You can paste the content here, share the communications, or upload documents, and I'll extract the relevant information." + +--- + +## If User Provides Communications or Documents + +**What to extract**: +- **Realizations mentioned** - What have stakeholders realized or observed? +- **Requirements discussed** - What do they need or want? +- **Concerns raised** - What are their worries or questions? +- **Context** - Background information about the project +- **Stakeholder perspectives** - Different viewpoints or needs +- **Timeline or urgency** - Any deadlines or timing mentioned +- **Budget or constraints** - Any resource limitations discussed +- **Existing specifications** - Any requirements or specs already documented +- **Previous discussions** - Key points from past conversations + +**How to extract**: +1. Read through the communications carefully +2. Identify key themes and information +3. Extract relevant details that inform the pitch sections +4. Note any contradictions or different perspectives +5. Summarize findings: "From these communications, I'm seeing..." + +**Use extracted information**: +- Inform The Realization section (what realizations or observations are mentioned) +- Inform Why It Matters (who is experiencing issues and why it matters) +- Inform Our Commitment (any budget/resource discussions) +- Inform Cost of Inaction (any urgency or consequences mentioned) +- Add context throughout the pitch + +**Don't**: +- Copy entire communications or documents verbatim +- Include personal or irrelevant details +- Overwhelm with too much detail +- Use information that's clearly outdated +- Include sensitive information that shouldn't be in the pitch + +--- + +## If User Doesn't Have Communications or Documents + +**That's fine** - Simply acknowledge and move on: + +"No problem! We'll work with what you know. Let's start exploring the project together." + +Then proceed to exploring sections. + +--- + +## Next Step + +After extracting information (or if user doesn't have communications), proceed to: +β†’ `step-02-explore-sections.md` + +**Note**: Use the extracted information to inform your questions as you explore each section. + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-02-explore-sections.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-02-explore-sections.md new file mode 100644 index 00000000..fb3cf13c --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-02-explore-sections.md @@ -0,0 +1,159 @@ +# Step 2: Explore Pitch Sections + +## Purpose + +Guide the user through exploring all pitch sections in a natural, collaborative flow. + +--- + +## Pitch Structure (All Sections to Cover) + +**Inspired by proven frameworks**: Customer-Problem-Solution, Value Proposition Canvas, Problem-Agitate-Solve, Business Case Framework + +The pitch should eventually cover these 10 sections: + +1. **The Realization** - What we've realized needs attention (PAS: Problem) +2. **Why It Matters** - Why this matters and who we help (Value Prop Canvas: Customer Profile + Impact) +3. **How We See It Working** - Brief overview of the solution approach (CPS: Solution) +4. **Paths We Explored** - 2-3 solution options we considered +5. **Recommended Solution** - Preferred approach and why (CPS: Solution) +6. **The Path Forward** - How the work will be done (WDS phases and practical approach) +7. **The Value We'll Create** - What happens if we DO build this (Business Case: Return) +8. **Cost of Inaction** - What happens if we DON'T build this (PAS: Agitate / Business Case: Risk) +9. **Our Commitment** - Resources needed and potential risks (Business Case: Cost + Risk) +10. **Summary** - Summary of key points + +**Note**: You don't need to cover these in this exact order. Follow the user's natural thinking flow. The frameworks are guides, not rigid rules. + +--- + +## Detect Starting Point + +**Ask**: "Where would you like to start? Are you seeing a problem that needs solving, or do you have a solution in mind?" + +**If user starts with problem**: +- Explore the problem first +- Then naturally move to "who is affected" +- Then explore solutions + +**If user starts with solution**: +- Capture the solution idea +- Then explore "what problem does this solve?" +- Then explore "who is affected" +- Then explore other possible approaches + +**If user starts elsewhere**: +- Follow their lead +- Guide them through remaining sections naturally + +--- + +## Guiding Principles + +**When responding to user ideas or questions, follow this pattern:** + +1. **Acknowledge** - "I hear you asking about..." or "That's an interesting idea..." +2. **Summarize** - "So you're thinking that..." or "What I'm understanding is..." +3. **Confirm understanding** - "Is that right?" or "Am I understanding correctly?" +4. **Then explore solutions** - Only after confirming understanding, offer options or suggestions + +**Never jump straight to bullet lists or solutions.** Always acknowledge, summarize, and confirm understanding first. + +**Collaborative, not interrogative**: +- "Let's explore this together..." +- "What I'm hearing is..." +- "This is interesting - tell me more about..." +- "How do you see this working?" + +**Allow ideas to evolve**: +- If user's idea changes as they talk, that's good! +- Reflect back: "It sounds like your thinking is evolving - that's great!" +- Update understanding as you go + +**Natural flow**: +- Don't force a rigid sequence +- Follow the user's thinking +- Guide them to cover all sections, but in whatever order makes sense + +**Make it shine**: +- Help them articulate their idea clearly +- Find the compelling angles +- Present it in the best light + +--- + +## Section Exploration Guide + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` + +Use the section guide to explore each section as the user naturally moves through them. + +**Important**: The Work Plan section (section 6) explains which WDS phases will be used and how the work will be done practically. This helps stakeholders understand the approach and workflow. + +**Framework Inspiration**: This guide draws from proven frameworks: +- **Customer-Problem-Solution (CPS)** - Clear structure +- **Value Proposition Canvas** - Understanding customer needs +- **Problem-Agitate-Solve (PAS)** - Natural flow +- **Business Case Framework** - Investment and consequences + +--- + +## Best Practice: Realization Section with Evidence + +**When exploring "The Realization" section**, help the user identify and confirm the realization with evidence: + +### Step 1: Identify the Realization +- What have you realized needs attention? +- What observation or challenge are you seeing? +- What opportunity is being missed? + +### Step 2: Confirm It's Real +- Is there evidence that supports this realization? +- Do stakeholders recognize this as real? +- Does this matter to stakeholders? + +### Step 3: Gather Evidence + +**Help them identify both types of evidence:** + +**Soft Evidence** (qualitative indicators): +- **Testimonials**: "Do you have customer feedback or testimonials about this?" +- **Complaints**: "What complaints or support tickets mention this?" +- **Observations**: "What patterns have you observed?" +- **Interviews**: "What do user interviews or conversations reveal?" +- **Indications**: "What signs indicate this is a problem?" + +**Hard Evidence** (quantitative data): +- **Statistics**: "Do you have numbers or percentages?" +- **Analytics**: "What do analytics or usage data show?" +- **Surveys**: "Have you run surveys or tests?" +- **Logs**: "What do server logs or error reports indicate?" +- **Metrics**: "What metrics demonstrate this problem?" + +**Best Practice**: Combine both types for maximum credibility: +- Start with soft evidence (testimonials, complaints, observations) +- Support with hard evidence (statistics, analytics, survey results) +- Show the problem is real, measurable, and matters to stakeholders + +**Example of combining evidence:** +> "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)." + +**If they don't have evidence yet:** +- That's okay - acknowledge this +- Propose gathering evidence as part of the project +- Use stakeholder conversations as initial evidence +- Reference similar problems in the industry + +**Why evidence matters:** +- Stakeholders recognize the problem exists +- The urgency is clear +- Budget approval is easier +- The case for action is compelling + +--- + +## Next Step + +After exploring all sections (in whatever order made sense), proceed to: +β†’ `step-03-synthesize.md` + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-03-synthesize.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-03-synthesize.md new file mode 100644 index 00000000..248401f5 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-03-synthesize.md @@ -0,0 +1,48 @@ +# Step 3: Synthesize Alignment Document + +## Purpose + +Crystallize all explored sections into a clear, compelling alignment document (pitch). + +--- + +## Instruction + +**After covering all sections** (in whatever order made sense): + +1. **Reflect back** what you've captured +2. **Help crystallize** into a clear, compelling narrative using framework thinking: + - **Realization β†’ Why It Matters β†’ How We See It Working β†’ Value We'll Create** + - **Realization β†’ Agitate (Cost of Inaction) β†’ Solve (Solution) β†’ Commitment** +3. **Ask**: "Does this capture your alignment document? Anything you'd like to adjust?" +4. **Confirm**: "Does this present your idea in the best light?" + +**Framework check**: Does the alignment document flow logically? +- Realization is clear and evidence-backed +- Why it matters and who we help is understood +- Solution addresses the realization +- Commitment is reasonable and risks acknowledged +- Cost of inaction makes the case +- Value we'll create justifies the commitment + +--- + +## Create Alignment Document + +**Output file**: `docs/1-project-brief/pitch.md` (deliverable name: "pitch") + +**Format**: Clear, brief, readable in 2-3 minutes + +**Structure**: Use the 10-section structure covered in the exploration + +**Template reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/pitch.template.md` + +--- + +## Next Step + +After creating the pitch document, proceed to: +β†’ `step-04-present-for-approval.md` (Present pitch for stakeholder review and approval) + +**Note**: The agreement document (contract/service agreement/signoff) will be generated AFTER the pitch is approved, allowing for changes and iterations during the pitch phase. + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-03.5-generate-contract.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-03.5-generate-contract.md new file mode 100644 index 00000000..ae8c3b60 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-03.5-generate-contract.md @@ -0,0 +1,1810 @@ +# Step 3.5: Generate Agreement Document (Optional) + +## Purpose + +Offer to create a formal agreement document based on the pitch - contract, signoff document, or service agreement depending on context. + +--- + +## Instruction + +**After the pitch is accepted by stakeholders**, offer to create a signoff document: + +"Great! The pitch has been accepted and everyone is aligned on the idea, why, what, how, budget, and commitment. + +Now let's secure this commitment with a signoff document. This will formalize what everyone has agreed to and ensure everyone stays committed to making this project happen. + +**What type of document do you need?** + +1. **Project Contract** - If you're a consultant and the client has approved the pitch +2. **Service Agreement** - If you're a founder/owner and suppliers have approved the pitch +3. **Project Signoff Document** - If this is an internal company project and stakeholders have approved + - *Note: If you have an existing company signoff document format, you can upload it and I'll adapt it to match your company's format* +4. **Skip** - If you don't need a formal document right now + +Which applies to your situation? + +**Remember**: WDS helps with alignment - the pitch got everyone on the same page, and this signoff document secures the commitment before we start building something that makes the world a better place!" + +--- + +## Generate Document Based on User Choice + +**If user chooses "Skip"**: +- Acknowledge: "No problem! The pitch document is ready to share. You can always generate an agreement document later if needed." +- Proceed directly to step-04-present-for-approval.md + +**If user chooses document type**: + +**Important**: First, determine the business model, then build the contract section by section based on that model. + +**Core Principle**: The goal is always to make a **simple and fair contract** that gives both parties **reliable terms for a long-lasting work relationship**. + +--- + +## Step 1: Determine Business Model + +**Before building contract sections**, we need to determine how the service will be paid for. This determines which sections we include and how we configure them. + +**Ask the user**: + +"First, let's determine the business model - how will this service be paid for? This helps us structure the contract correctly. + +**What business model fits this project?** + +1. **Fixed-Price Project** - Set price for a defined scope of work + - Best for: Projects with clear deliverables and scope + - Includes: Not-to-exceed clause, upfront payment recommended + - Example: "$50,000 for complete website redesign with 5 pages" + +2. **Hourly/Time-Based** - Pay for actual time worked + - Best for: Ongoing work, uncertain scope, flexible requirements + - Includes: Hourly rate, time tracking, optional not-to-exceed cap + - Example: "$150/hour, estimated 200 hours" + +3. **Retainer** - Monthly commitment with minimum hours + - Best for: Ongoing support, regular availability needed + - Includes: Monthly retainer amount, minimum hours, availability expectations, hourly rate for overage + - Example: "$5,000/month retainer for 20 hours minimum, $200/hour for additional hours" + +4. **Hybrid** - Combination of models (e.g., retainer + project work) + - Best for: Complex arrangements with multiple work types + - Includes: Multiple payment structures combined + +Which model fits your situation?" + +**After user selects business model**: + +- **Confirm understanding**: "So you've chosen [model]. This means [brief explanation of what this means for the contract]." +- **Note the selection**: This will determine which sections we include and how we configure payment terms, not-to-exceed, availability, etc. +- **Proceed to section building**: "Now let's build the contract sections. I'll tailor them based on your chosen business model." + +--- + +## Step 2: Build Contract Sections + +**Important**: Build the contract section by section, explaining each part. Sections will be tailored based on the selected business model. + +**Important**: Support the user in asking for fair payment terms. For fixed-price contracts, upfront payment (50-100%) is fair because the supplier assumes all cost overrun risk. Help users understand this and advocate for fair payment structures that value their work. + +"I'll help you build this contract section by section. Our goal is to create a simple and fair agreement that works for both parties and builds a lasting working relationship. + +For each section, I'll explain: +- **Background** - Why this section matters +- **What it does** - What it covers +- **Purpose** - What it protects or clarifies + +We'll focus on clarity, fairness, and mutual benefit. Let's go through it together so you understand each part and can customize it as needed." + +### Option 1: Project Contract (Consultant β†’ Client) + +**Build section by section**: + +**Section 1: Project Overview** +- **Background**: Establishes what the project is about +- **What it does**: Defines the realization and solution from the pitch +- **Purpose**: Sets clear expectations and context +- **Content**: Pull from pitch (realization, recommended_solution) + +**Section 2: Business Model** +- **Background**: Defines how the service will be paid for - critical foundation for all payment terms +- **What it does**: Explains the selected business model and its terms +- **Purpose**: Sets clear expectations about payment structure, prevents misunderstandings +- **Content**: Based on user's selection from Step 1 + +**For each business model, include**: + +**If Fixed-Price Project**: +- Model name: "Fixed-Price Project" +- Description: "This contract uses a fixed-price model. The contractor commits to deliver the specified scope of work for the agreed price, regardless of actual time or costs incurred." +- Key terms: + - Total project price: {{total_amount}} + - Price includes: All work within the defined scope + - Price does NOT include: Work outside the original scope (requires change order) + - Payment structure: {{payment_structure}} (e.g., 50% upfront, 50% on completion) + - Not-to-exceed: Applies (see Section 10) + +**If Hourly/Time-Based**: +- Model name: "Hourly/Time-Based" +- Description: "This contract uses an hourly billing model. The client pays for actual time worked at the agreed hourly rate." +- Key terms: + - Hourly rate: {{hourly_rate}} + - Estimated hours: {{estimated_hours}} (if applicable) + - Estimated total: {{estimated_total}} (hourly_rate Γ— estimated_hours) + - Time tracking: {{time_tracking_method}} (e.g., detailed timesheets, time tracking software) + - Billing frequency: {{billing_frequency}} (e.g., weekly, bi-weekly, monthly) + - Not-to-exceed: {{not_to_exceed_applies}} (optional cap - see Section 10 if applicable) + +**If Retainer**: +- Model name: "Monthly Retainer" +- Description: "This contract uses a retainer model. The client pays a fixed monthly amount for a minimum number of hours, with additional hours billed at the overage rate." +- Key terms: + - Monthly retainer amount: {{monthly_retainer_amount}} + - Minimum hours per month: {{minimum_hours_per_month}} + - Effective hourly rate: {{effective_hourly_rate}} (retainer Γ· minimum hours) + - Overage hourly rate: {{overage_hourly_rate}} (for hours beyond minimum) + - Availability: {{availability_expectations}} (e.g., "Available during business hours, 2-3 day response time") + - Retainer period: {{retainer_period}} (e.g., "Monthly, renewable") + - Hour rollover: {{hour_rollover_policy}} (e.g., "Unused hours expire at month end" or "Up to X hours can roll over") + - Billing: Retainer due {{retainer_due_date}} (e.g., "on the 1st of each month") + +**If Hybrid**: +- Model name: "Hybrid Model" +- Description: "This contract combines multiple payment structures." +- Key terms: + - Component 1: {{component_1_description}} (e.g., "Monthly retainer for ongoing support") + - Component 2: {{component_2_description}} (e.g., "Fixed-price for initial project work") + - How they work together: {{hybrid_explanation}} + +**Section 3: Scope of Work** +- **Background**: Defines exactly what will be delivered and what won't be +- **What it does**: Lists path forward, deliverables, explicit IN scope, and explicit OUT of scope +- **Purpose**: Prevents scope creep and sets clear boundaries - critical for avoiding disputes +- **Why this matters**: + - Most contract disputes arise from unclear scope + - Clear IN/OUT scope prevents misunderstandings + - Protects both parties from scope creep + - Sets expectations upfront + +**Content to gather**: +1. **The Path Forward**: Pull from pitch (path_forward) - how the work will be done +2. **Deliverables**: Pull from pitch (deliverables_list) - what will be delivered +3. **IN Scope**: Ask user explicitly - "What work is explicitly included? Be specific about what's covered." +4. **OUT of Scope**: Ask user explicitly - "What work is explicitly NOT included? What would require a change order?" + +**Important**: Based on business model, adapt scope section: +- **Fixed-Price**: Must have very clear IN scope and OUT of scope (critical for fixed-price - this protects both parties) +- **Hourly**: Can be more flexible, but still define boundaries to prevent misunderstandings +- **Retainer**: Define what types of work are included in retainer vs. project work (e.g., "Retainer includes: ongoing support, bug fixes, small updates. Retainer does NOT include: new features, major redesigns, new projects") +- **Hybrid**: Define scope for each component separately + +**What to ask user**: +- "Let's be very clear about what's included and what's not. What work is explicitly IN scope for this contract?" +- "What work is explicitly OUT of scope? What would require a change order?" +- "Are there any assumptions about what's included that we should document?" + +**Example IN Scope**: +- "Design and development of 5 web pages as specified" +- "Up to 2 rounds of revisions per page" +- "Responsive design for mobile and desktop" +- "Basic SEO optimization" + +**Example OUT of Scope**: +- "Additional pages beyond the 5 specified" +- "Content creation or copywriting" +- "Third-party integrations not specified" +- "Ongoing maintenance after delivery" +- "Photography or video production" + +**Section 4: Our Commitment & Payment Terms** + +- **Background**: Financial commitment needed and payment structure - tailored to business model +- **What it does**: States costs, payment schedule, and payment terms based on selected business model +- **Purpose**: Clear financial expectations - transparency builds trust +- **Why this matters**: + - Protects supplier from non-payment risk + - Ensures client commits financially to the project + - Provides cash flow for supplier to deliver quality work + - Prevents disputes about payment timing + +**Adapt based on business model** (see detailed instructions above in Section 4) + +- **Content**: Pull from pitch (our_commitment), add payment schedule and terms based on business model +- **Fairness note**: Tailor to business model - for fixed-price emphasize upfront payment fairness, for retainer emphasize commitment and availability + +**Section 5: Timeline** +- **Background**: When work will happen +- **What it does**: Defines schedule and milestones +- **Purpose**: Sets expectations for delivery dates +- **Content**: Extract from Work Plan or Investment Required + +**Section 6: Availability** (if Retainer model) +- **Background**: Defines when contractor is available for retainer work +- **What it does**: Sets expectations for response times, working hours, availability windows +- **Purpose**: Ensures client knows when they can expect work to be done +- **Why this matters**: + - Retainer clients need to know when contractor is available + - Sets realistic expectations for response times + - Prevents misunderstandings about availability +- **What to include**: + - **Business hours**: {{business_hours}} (e.g., "Monday-Friday, 9am-5pm EST") + - **Response time**: {{response_time}} (e.g., "2-3 business days for non-urgent requests") + - **Availability for meetings**: {{meeting_availability}} (e.g., "Available for scheduled calls during business hours") + - **Urgent requests**: {{urgent_request_policy}} (e.g., "Urgent requests may incur additional fees") +- **What to ask user**: "What availability expectations do you have? What response times work for you?" +- **Content**: Define availability expectations based on retainer agreement + +**Section 7: Confidentiality Clause** + +- **Background**: Protects sensitive information shared during the project +- **What it does**: Requires both parties to keep project information confidential +- **Purpose**: Protects proprietary information, business strategies, and trade secrets - mutual protection builds trust +- **Why this matters**: + - Without this clause, either party could share sensitive project details with competitors + - Protects your business secrets, customer data, and strategic plans + - Builds trust by showing mutual respect for confidentiality + - Prevents legal disputes about information sharing +- **User options**: + - **Standard confidentiality** (recommended): Both parties keep all project information confidential + - **Limited confidentiality**: Only specific information types are confidential (e.g., financial data only) + - **One-way confidentiality**: Only one party is bound (rare, usually for public projects) + - **Duration**: How long confidentiality lasts (typically 2-5 years, or indefinitely for trade secrets) + - **Exceptions**: What's NOT confidential (public info, independently developed, required by law) +- **What to ask user**: "Do you have sensitive information that needs protection? How long should confidentiality last? (Typically 2-5 years)" +- **Content**: Standard confidentiality language (see template), customized based on user choices +- **Fairness note**: "This protects both parties equally - your sensitive info stays private, and I'm protected too" + +**Section 8: Not to Exceed Clause** (Conditional - applies to Fixed-Price and optionally Hourly) + +- **Background**: Sets maximum budget cap - only applies to certain business models +- **What it does**: States that costs will not exceed a specified amount without approval +- **Purpose**: + - Protects both parties from unexpected cost overruns + - **Prevents scope creep** - Any work beyond original scope requires approval + - Fair budget protection for everyone + +**When this section applies**: +- **Fixed-Price Project**: βœ… REQUIRED - This is the project price cap +- **Hourly/Time-Based**: ⚠️ OPTIONAL - Can include optional not-to-exceed cap if desired +- **Retainer**: ❌ NOT APPLICABLE - Retainer already has monthly cap +- **Hybrid**: ⚠️ CONDITIONAL - May apply to fixed-price components + +**If applicable, include**: +- **Why this matters**: + - Without this clause, costs could spiral out of control (fixed-price) + - Protects your budget from unexpected expenses + - Prevents scope creep by requiring approval for additional work + - Ensures contractor gets paid fairly for extra work through change orders + - Creates clear boundaries that prevent misunderstandings +- **User options**: + - **Fixed budget cap**: Hard limit that cannot be exceeded without new agreement + - **Soft cap with buffer**: Cap with small percentage buffer (e.g., 10%) for minor overruns + - **Cap with change order process**: Cap exists, but change orders can adjust it with approval +- **What to ask user**: + - **For Fixed-Price**: "The not-to-exceed amount is [total_amount]. This protects both parties from cost overruns. Any work beyond the original scope requires a change order." + - **For Hourly**: "Would you like to set an optional not-to-exceed cap? This protects your budget while still allowing flexibility." +- **Content**: + - **Fixed-Price**: Not-to-exceed = total project price + - **Hourly**: Optional cap amount if user wants one +- **Fairness note**: "This protects your budget while ensuring I get paid fairly for additional work if needed through the change order process" + +**Section 7: Work Initiation** + +- **Background**: Specifies exactly when work can begin +- **What it does**: Defines start date or conditions before work begins +- **Purpose**: Prevents unauthorized work, establishes timeline, protects both parties +- **Why this matters**: + - Without this clause, work might begin before contract is fully executed + - Prevents disputes about when work actually started + - Protects contractor from doing unpaid work + - Protects client from unauthorized charges + - Establishes clear timeline expectations +- **User options**: + - **Upon contract signing**: Work begins immediately when both parties sign + - **Specific date**: Work begins on a set calendar date + - **After initial payment**: Work begins when first payment/deposit is received + - **After written notice**: Work begins when client sends written authorization + - **Conditional start**: Work begins after specific conditions are met (e.g., materials received, approvals obtained) +- **What to ask user**: "When should work begin? Options: immediately upon signing, a specific date, after initial payment, or when you give written notice?" +- **Content**: Ask user when work should begin, document the chosen option clearly + +**Section 10: Terms and Conditions** +- **Background**: Legal framework for the agreement +- **What it does**: Covers changes, termination, IP ownership, dispute resolution, jurisdiction +- **Purpose**: Protects both parties legally +- **Content**: Standard terms including governing law and jurisdiction (see template) + +**Section 11: Legal Framework** + +- **Background**: Determines which laws apply and where legal proceedings take place +- **What it does**: Specifies governing law, jurisdiction, and contract language +- **Purpose**: Provides legal clarity and predictability +- **Why this matters**: + - Without this clause, disputes could be heard in unexpected jurisdictions + - Different jurisdictions have different laws that could affect the contract + - Determines which court system handles disputes + - Language choice ensures both parties understand the contract + - Prevents costly legal battles over jurisdiction +- **User options**: + - **Jurisdiction**: Where legal proceedings take place + - Client's location (protects client) + - Contractor's location (protects contractor) + - Neutral location (fair for both) + - Specific state/country (e.g., "State of California, USA") + - **Governing law**: Which laws apply + - Usually matches jurisdiction + - Can specify specific legal framework + - **Contract language**: Language of the contract + - Primary language for both parties + - Which version prevails if translated +- **What to ask user**: + - "Which jurisdiction's laws should govern this contract? (e.g., 'State of California, USA', 'England and Wales')" + - "What language should this contract be in? (e.g., English, Spanish, French)" + - "If the contract is translated, which version should be the official one?" +- **Content**: Ask user for jurisdiction, governing law, and contract language, document clearly + +**Section 12: Approval** +- **Background**: Formal signoff +- **What it does**: Signature lines for both parties +- **Purpose**: Makes the contract legally binding +- **Content**: Client and contractor names + +--- + +## Important Contract Sections to Discuss + +**Core Principle**: Always aim for **simplicity and fairness** - contracts should protect both parties while building trust for long-term relationships. + +**Reference sources**: Based on professional contract best practices from legal resources (AIA Contracts, Morgan McKinley, legal counsel guidelines, contract management experts, industry standards) + +--- + +## Best Practices Guidance + +### For Consultants/Service Providers + +**Payment Terms Best Practices**: +- **Request upfront deposits**: 50% upfront is standard for fixed-price contracts, 100% upfront is fair since you assume all cost overrun risk +- **Milestone-based payments**: For larger projects, use 30% upfront, 40% at midway, 30% on completion +- **Explain the value**: Help clients understand that upfront payment ensures you can prioritize their project and deliver quality work +- **Include late payment penalties**: Protect yourself with interest charges or work suspension clauses +- **Document everything**: Issue detailed invoices that itemize work completed + +**Scope Protection Best Practices**: +- **Define scope clearly**: Most disputes arise from unclear scope - be specific about what's included and excluded +- **Include change order process**: Require written change orders for any scope changes +- **Set not-to-exceed cap**: Protects both parties from cost overruns +- **Document assumptions**: List any assumptions that affect scope or pricing + +**Risk Management Best Practices**: +- **Request upfront payment**: Shows client commitment and protects you from non-payment +- **Define work initiation**: Specify exactly when work begins to prevent unauthorized work +- **Include termination clause**: Fair exit strategy protects both parties +- **Specify IP ownership**: Clear ownership prevents future disputes + +**Communication Best Practices**: +- **Be transparent**: Explain why each clause matters and how it protects both parties +- **Build trust**: Focus on fairness and long-term relationship, not just protection +- **Document changes**: All scope changes should be in writing and approved + +--- + +### For Clients + +**What to Look For**: + +**Payment Terms**: +- **Fair payment structure**: For fixed-price contracts, 50% upfront is reasonable since consultant assumes risk +- **Clear payment schedule**: Know exactly when payments are due +- **Payment conditions**: Understand what triggers each payment +- **Late payment terms**: Know what happens if you pay late + +**Scope Clarity**: +- **Detailed deliverables**: Know exactly what you're getting +- **Exclusions clearly stated**: Understand what's NOT included +- **Change order process**: Know how to request changes and what they cost +- **Not-to-exceed protection**: Budget cap protects you from overruns + +**Protection Clauses**: +- **Confidentiality**: Your sensitive information is protected +- **IP ownership**: You own the deliverables (usually) +- **Termination rights**: You can exit if needed with fair notice +- **Dispute resolution**: Clear process for handling conflicts + +**Red Flags to Watch For**: +- ❌ Vague or unclear scope definitions +- ❌ Payment terms that seem unfair (e.g., 100% on completion for fixed-price) +- ❌ No change order process +- ❌ Unclear IP ownership +- ❌ No termination clause +- ❌ Unreasonable confidentiality terms +- ❌ No dispute resolution process + +**Best Practices**: +- **Review thoroughly**: Read every section and ask questions +- **Understand each clause**: Don't sign what you don't understand +- **Negotiate fairly**: Both parties should feel protected +- **Get legal review**: For large contracts or complex projects +- **Keep it simple**: Simple contracts are easier to understand and enforce + +--- + +### Common Pitfalls to Avoid + +**For Both Parties**: + +1. **Unclear Scope** - Most common cause of disputes + - **Problem**: Vague descriptions like "design work" or "development services" lead to disagreements about what's included + - **Solution**: Be extremely specific about deliverables, exclusions, and assumptions + - **For Consultants**: List every deliverable explicitly. Include: "Deliverables include: [specific list]. Deliverables do NOT include: [specific exclusions]. This contract assumes: [assumptions]." + - **For Clients**: Ask for detailed breakdown. Request: "Please list exactly what I'll receive. What's NOT included? What assumptions are you making?" + + **Example Wordings - Different Scenarios**: + + **Scenario A: Design Project (Detailed)** + ``` + DELIVERABLES: + The Contractor shall deliver the following: + 1. UX Design Specifications + - User flow diagrams for 3 core scenarios (Login, Product Browse, Checkout) + - Wireframes for 8 pages (Home, Product List, Product Detail, Cart, Checkout, Account, Login, Register) + - Interaction specifications document (PDF, minimum 20 pages) + + 2. Visual Design + - High-fidelity mockups for all 8 pages in Figma + - Design system documentation (colors, typography, components) + - Responsive designs for mobile (375px), tablet (768px), and desktop (1440px) + + 3. Prototype + - Interactive Figma prototype with clickable links between all pages + - Prototype includes all user flows specified in item 1 + + 4. Handoff Documentation + - Design specifications document (PDF) + - Asset export package (SVG, PNG formats) + - Developer handoff notes with measurements and specifications + + EXCLUSIONS: + This contract does NOT include: + - Front-end development or coding + - Backend API development + - Content creation or copywriting + - User research or usability testing + - Ongoing maintenance or updates + - Third-party integrations beyond design specifications + + ASSUMPTIONS: + This contract assumes: + - Client provides user research data and personas by [date] + - Client provides brand guidelines and logo files by [date] + - Client provides all content (text, images) by [date] + - Client provides access to existing design system (if applicable) by [date] + - Client provides feedback within 5 business days of each deliverable + ``` + + **Scenario B: Development Project (Detailed)** + ``` + DELIVERABLES: + The Contractor shall deliver: + 1. Front-end Application + - React application built with Next.js framework + - Responsive design matching provided designs + - 8 pages as specified in design mockups + - Integration with backend API endpoints (endpoints to be provided by Client) + + 2. Code Deliverables + - Source code repository (GitHub) + - Documentation (README.md with setup instructions) + - Code comments following industry standards + - Environment configuration files (.env.example) + + 3. Testing + - Unit tests for critical functions (minimum 60% coverage) + - Integration tests for main user flows + - Browser testing (Chrome, Firefox, Safari, Edge - latest 2 versions) + + 4. Deployment + - Application deployed to staging environment + - Production deployment guide document + - One round of production deployment support (up to 4 hours) + + EXCLUSIONS: + This contract does NOT include: + - Backend API development (API endpoints provided by Client) + - Database design or setup + - Server infrastructure setup + - Content management system integration + - Third-party service integrations beyond those specified + - Ongoing hosting or maintenance + - Post-launch bug fixes (covered under separate warranty period) + + ASSUMPTIONS: + This contract assumes: + - Client provides complete design files (Figma) by [date] + - Client provides working backend API with documentation by [date] + - Client provides staging environment access by [date] + - Client provides all required API keys and credentials by [date] + - Client provides content (text, images) in required formats by [date] + ``` + + **Scenario C: Consulting Project (Detailed)** + ``` + DELIVERABLES: + The Consultant shall deliver: + 1. Strategic Analysis Report + - Current state assessment (20-30 pages) + - Competitive analysis (10-15 pages) + - Gap analysis and recommendations (15-20 pages) + - Executive summary (2-3 pages) + + 2. Implementation Roadmap + - Phased implementation plan with timelines + - Resource requirements and cost estimates + - Risk assessment and mitigation strategies + - Success metrics and KPIs + + 3. Presentation Materials + - PowerPoint presentation (30-40 slides) for stakeholder presentation + - One 2-hour presentation session to Client's leadership team + - Q&A session following presentation + + EXCLUSIONS: + This contract does NOT include: + - Implementation of recommendations + - Ongoing consulting beyond delivery of deliverables + - Additional presentations beyond the one specified + - Custom research beyond publicly available information + - Legal or financial advice (Consultant is not licensed in these areas) + + ASSUMPTIONS: + This contract assumes: + - Client provides access to relevant data and documentation + - Client provides 3 stakeholder interviews (1 hour each) + - Client provides feedback on draft reports within 10 business days + - Client provides decision-makers for final presentation + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Design services for website" + "Development work" + "Consulting services" + ``` + + **GOOD (Specific)**: + ``` + "UX design specifications for 3 user scenarios, including wireframes + for 8 pages and interactive prototype in Figma, plus design handoff + documentation. Excludes front-end development, backend API development, + and content creation." + ``` + +2. **Vague Payment Terms** - Leads to payment disputes + - **Problem**: Statements like "payment upon completion" or "payments as work progresses" create confusion + - **Solution**: Specify exact amounts, dates, and conditions for each payment + - **For Consultants**: Define trigger conditions clearly. State: "Payment 1 ($X) due upon contract signing. Payment 2 ($Y) due upon [specific milestone/deliverable]. Payment 3 ($Z) due upon final delivery and acceptance." + - **For Clients**: Understand payment triggers. Ask: "What exactly triggers each payment? What does 'completion' mean? What if I need revisions?" + + **Example Wordings - Different Payment Structures**: + + **Scenario A: 50/50 Split (Simple Fixed-Price)** + ``` + PAYMENT TERMS: + Total Contract Amount: $10,000 + + Payment Schedule: + 1. First Payment: $5,000 (50% of total) + - Due: Within 5 business days of contract execution + - Condition: Contract fully executed (signed by both parties) + - Payment Method: Wire transfer or check + + 2. Final Payment: $5,000 (50% of total) + - Due: Within 5 business days of final deliverable acceptance + - Condition: All deliverables completed and accepted by Client + - Payment Method: Wire transfer or check + + DELIVERABLE ACCEPTANCE: + Deliverables are considered accepted when: + - Client provides written approval via email, OR + - 10 business days pass after Contractor delivers final deliverables without written objections from Client + + REVISIONS: + This contract includes up to 2 rounds of revisions per deliverable. + Additional revisions will be billed at $150/hour via Change Order. + ``` + + **Scenario B: Milestone-Based (3 Payments)** + ``` + PAYMENT TERMS: + Total Contract Amount: $15,000 + + Payment Schedule: + 1. Initial Payment: $4,500 (30% of total) + - Due: Within 5 business days of contract execution + - Condition: Contract signed by both parties + - Purpose: Secures project start and covers initial expenses + + 2. Mid-Project Payment: $6,000 (40% of total) + - Due: Within 5 business days of Milestone 2 completion + - Condition: Milestone 2 deliverables accepted + - Milestone 2 includes: [Specific deliverables, e.g., "Wireframes for all 8 pages approved"] + + 3. Final Payment: $4,500 (30% of total) + - Due: Within 5 business days of final deliverable acceptance + - Condition: All deliverables completed, approved, and delivered + - Includes: Final files, documentation, and project handoff + + MILESTONE DEFINITIONS: + - Milestone 1: Project kickoff and discovery complete (triggers initial payment) + - Milestone 2: Design phase complete - wireframes approved (triggers mid-project payment) + - Milestone 3: Final deliverables complete - designs and prototype delivered (triggers final payment) + ``` + + **Scenario C: 100% Upfront (Full Commitment)** + ``` + PAYMENT TERMS: + Total Contract Amount: $8,000 + + Payment Schedule: + Single Payment: $8,000 (100% of total) + - Due: Within 5 business days of contract execution + - Condition: Contract fully executed (signed by both parties) + - Payment Method: Wire transfer preferred, check accepted + + RATIONALE: + This is a fixed-price contract where Contractor assumes all cost overrun risk. + Full upfront payment demonstrates Client commitment and enables Contractor to + prioritize this project and allocate resources accordingly. + + REFUND POLICY: + If Contractor fails to deliver agreed deliverables, Client is entitled to: + - Full refund if no work has been completed, OR + - Proportional refund based on work completed if Contractor terminates without cause + ``` + + **Scenario D: Hourly/Time-Based (Different Structure)** + ``` + PAYMENT TERMS: + Hourly Rate: $150/hour + Estimated Total: $12,000 (based on 80 hours estimated) + + Payment Schedule: + 1. Retainer: $3,000 (25% of estimated total) + - Due: Within 5 business days of contract execution + - Applied to: Final invoice + - Non-refundable if Client terminates without cause + + 2. Monthly Invoicing: + - Invoices submitted on last day of each month + - Payment due: Within 15 days of invoice date + - Includes: Detailed time log with descriptions of work performed + + 3. Final Invoice: + - Submitted upon project completion + - Includes: All remaining hours, minus retainer already paid + - Payment due: Within 15 days of invoice date + + NOT-TO-EXCEED: + Total project costs will not exceed $15,000 (125% of estimate) without + prior written approval via Change Order. + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Payment upon completion" + "Payments as work progresses" + "50% upfront, 50% on delivery" + "Payment when project is done" + ``` + + **GOOD (Specific)**: + ``` + "Payment 1: $5,000 (50% of $10,000 total) due within 5 business days + of contract execution. Payment 2: $5,000 (remaining 50%) due within + 5 business days of final deliverable acceptance. Deliverable acceptance + means Client approves in writing OR 10 business days pass without + written objections." + ``` + + **Key Elements to Always Include**: + - Exact dollar amounts (not percentages alone) + - Specific due dates or timeframes + - Clear trigger conditions + - Payment method + - What "acceptance" or "completion" means + - Late payment consequences + - Revision policy + +3. **No Change Order Process** - Scope creep becomes a problem + - **Problem**: Requests for "small additions" accumulate into significant extra work without compensation + - **Solution**: Require written change orders with approval before work begins + - **For Consultants**: Protect yourself with: "Any work outside the original scope requires a written Change Order signed by both parties. Change Orders must specify: (1) additional work description, (2) additional cost, (3) impact on timeline, (4) approval signatures. Work will not begin on changes until Change Order is signed." + - **For Clients**: Understand the process. Request: "How do I request changes? How are additional costs calculated? Can I see the Change Order before approving?" + + **Example Wordings - Different Change Order Structures**: + + **Scenario A: Fixed-Price Project (Hourly Rate for Changes)** + ``` + CHANGE ORDER PROCESS: + + Any work outside the scope defined in Section 2 requires a written Change Order + signed by both parties before work begins. + + Change Order Requirements: + Each Change Order must include: + 1. Description of additional work requested + 2. Reason for change (if applicable) + 3. Additional cost: + - Hourly rate: $150/hour + - Estimated hours: [number] + - Total additional cost: $[amount] + 4. Impact on timeline: + - Original completion date: [date] + - Revised completion date: [date] + - Additional days: [number] + 5. Approval signatures from both parties + + Process: + 1. Client requests change in writing (email acceptable) + 2. Contractor provides Change Order within 3 business days + 3. Client reviews and approves or rejects within 5 business days + 4. If approved, both parties sign Change Order + 5. Contractor begins additional work only after signed Change Order received + + No Work Without Approval: + Contractor will NOT begin any additional work until Change Order is fully + executed (signed by both parties). Any work done without approved Change + Order is at Contractor's own risk and expense. + ``` + + **Scenario B: Fixed-Price Project (Fixed Price for Changes)** + ``` + CHANGE ORDER PROCESS: + + Any modifications to the scope defined in Section 2 require a written Change + Order executed by both parties. + + Change Order Contents: + Each Change Order must specify: + 1. Detailed description of the change + 2. Fixed price for the additional work: $[amount] + 3. Revised project timeline: + - Original delivery date: [date] + - New delivery date: [date] + 4. Impact on other deliverables (if any) + 5. Signatures from Client and Contractor + + Pricing for Changes: + Changes will be priced based on: + - Complexity of additional work + - Time required to complete + - Impact on existing deliverables + - Market rates for similar work + + Client will receive cost estimate before approval. If Client does not approve + the Change Order, original scope and timeline remain unchanged. + + Emergency Changes: + For urgent changes that cannot wait for Change Order process, Contractor may + proceed with Client's verbal approval, but Change Order must be executed + within 2 business days or work will stop. + ``` + + **Scenario C: Hourly Project (Time Tracking for Changes)** + ``` + CHANGE ORDER PROCESS: + + Changes to scope are handled through Change Orders that adjust the Not-to-Exceed + amount and timeline. + + Change Order Structure: + 1. Description of change + 2. Estimated additional hours: [number] hours + 3. Hourly rate: $[amount]/hour + 4. Estimated additional cost: $[amount] + 5. Revised Not-to-Exceed amount: $[original] + $[additional] = $[new total] + 6. Revised completion date: [date] + 7. Approval signatures + + Approval Required: + Changes that would increase total project cost by more than 10% require + written approval via Change Order before work begins. + + Minor Changes: + Changes under 10% of original estimate may be approved via email, but + Change Order must be executed within 5 business days. + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (No Process)**: + ``` + "Additional work will be billed separately" + "Changes may incur additional costs" + "Scope changes require approval" + ``` + + **GOOD (Detailed Process)**: + ``` + "Any work outside Section 2 scope requires a written Change Order signed + by both parties. Change Orders must include: (1) description of additional + work, (2) additional cost ($150/hour or fixed price), (3) revised timeline, + (4) signatures. Contractor will not begin additional work until Change Order + is executed." + ``` + +4. **Missing Termination Clause** - No exit strategy + - **Problem**: If relationship sours, neither party knows how to exit fairly + - **Solution**: Include fair termination terms with notice periods + - **For Consultants**: Protect payment for work done. Include: "Either party may terminate with [X] days written notice. Upon termination: (1) Client pays for all work completed to date, (2) Contractor delivers work-in-progress, (3) Confidentiality obligations continue." + - **For Clients**: Ensure fair exit. Request: "What notice do I need to give? What happens to work already done? Do I still own what's been delivered?" + + **Example Wordings - Different Termination Scenarios**: + + **Scenario A: Standard Termination (30-Day Notice)** + ``` + TERMINATION: + + Either party may terminate this agreement at any time with 30 days written notice + to the other party. Notice must be delivered via email or certified mail. + + Upon Termination: + 1. Payment for Work Completed: + - Client shall pay Contractor for all work completed and approved up to + the termination date + - Payment due within 15 days of termination notice + - Contractor will provide itemized invoice of completed work + + 2. Delivery of Work-in-Progress: + - Contractor shall deliver all work-in-progress within 10 business days + of termination + - Client owns all deliverables completed and paid for + - Contractor retains rights to work not yet paid for + + 3. Ongoing Obligations: + - All confidentiality obligations remain in effect + - Contractor may not use Client's confidential information + - Client may not use Contractor's proprietary methods without permission + + 4. No Further Work: + - Contractor will not begin new work after termination notice + - Contractor will complete only work already in progress (if agreed) + ``` + + **Scenario B: Termination for Cause (Immediate)** + ``` + TERMINATION: + + Standard Termination: + Either party may terminate with 30 days written notice for any reason. + + Termination for Cause (Immediate): + Either party may terminate immediately without notice if the other party: + - Materially breaches this agreement and fails to cure within 10 days of notice + - Becomes insolvent or files for bankruptcy + - Engages in illegal activity related to the project + - Fails to make payment when due (for Client) + - Fails to deliver work as specified (for Contractor) + + Upon Termination for Cause: + - Terminating party owes no further obligations + - Breaching party pays all costs and damages + - Work-in-progress delivered only if paid for + - Confidentiality obligations continue + + Upon Standard Termination: + - Client pays for all work completed to date + - Contractor delivers work-in-progress within 10 business days + - Confidentiality obligations continue + ``` + + **Scenario C: Termination with Refund Policy** + ``` + TERMINATION: + + Client Termination Rights: + Client may terminate this agreement: + - With 30 days notice: Standard termination + - Immediately: If Contractor materially breaches + - With full refund: If no work has been completed and Contractor is at fault + + Contractor Termination Rights: + Contractor may terminate this agreement: + - With 30 days notice: Standard termination + - Immediately: If Client fails to pay or materially breaches + + Refund Policy: + - If Client terminates before work begins: Full refund of upfront payment + - If Client terminates after work begins: No refund, payment for work done + - If Contractor terminates without cause: Refund proportional to work not completed + - If Contractor terminates for cause (non-payment): No refund, full payment due + + Work Ownership Upon Termination: + - Client owns all deliverables completed and paid for + - Contractor retains rights to work not yet paid for + - Work-in-progress delivered only if paid for or agreed upon + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Either party may terminate this agreement" + "Termination requires notice" + "Work will be delivered upon termination" + ``` + + **GOOD (Specific)**: + ``` + "Either party may terminate with 30 days written notice. Upon termination: + (1) Client pays Contractor for all work completed and approved up to termination + date, (2) Contractor delivers work-in-progress within 10 business days, + (3) Confidentiality obligations remain in effect, (4) Client owns deliverables + completed and paid for." + ``` + +5. **Unclear IP Ownership** - Future disputes about who owns what + - **Problem**: Ambiguity about who owns deliverables, source files, and work products + - **Solution**: Explicitly state who owns deliverables and when ownership transfers + - **For Consultants**: Clarify what you're transferring. State: "Upon full payment, Client owns: [specific deliverables]. Contractor retains: [rights to methods, tools, templates]. Client receives: [final files]. Contractor retains: [source files, unless specified otherwise]." + - **For Clients**: Understand what you're buying. Ask: "Do I own the final designs? Do I get source files? Can the consultant reuse this work for other clients?" + + **Example Wordings - Different IP Ownership Models**: + + **Scenario A: Full Transfer to Client (Standard)** + ``` + INTELLECTUAL PROPERTY OWNERSHIP: + + Upon full payment of all amounts due under this agreement, Client owns all + rights, title, and interest in the final deliverables specified in Section 2, + including but not limited to: + - All design files (Figma, Sketch, Adobe XD files) + - All code and source files + - All documentation and specifications + - All creative works and content created specifically for Client + + Client Receives: + - Final design files in editable formats (Figma, source code) + - All assets and resources created for the project + - Full rights to use, modify, and distribute deliverables + - Rights to register copyrights or trademarks in Client's name + + Contractor Retains: + - Rights to methodologies, processes, and tools used + - Rights to pre-existing work, templates, and frameworks + - Rights to general knowledge and skills gained + - Portfolio rights (may show work in portfolio with Client permission) + + Contractor May NOT: + - Reuse specific deliverables created for Client for other clients + - Claim ownership of deliverables after payment + - Use Client's brand or proprietary elements without permission + ``` + + **Scenario B: Shared Ownership (Rare)** + ``` + INTELLECTUAL PROPERTY OWNERSHIP: + + Shared Ownership Model: + Both parties own the deliverables jointly, with specific rights allocated. + + Client Owns: + - Exclusive rights to use deliverables for Client's business purposes + - Rights to modify deliverables for Client's use + - Rights to register trademarks/copyrights in Client's name + - Rights to prevent Contractor from using deliverables for competing clients + + Contractor Owns: + - Rights to use deliverables in portfolio and marketing materials + - Rights to use methodologies and processes for other clients + - Rights to create derivative works for Contractor's business (non-competing) + - Rights to use general design patterns and approaches + + Restrictions: + - Contractor may not use deliverables for direct competitors + - Client may not resell deliverables as a product + - Both parties must credit the other when using deliverables publicly + ``` + + **Scenario C: Client Owns Final, Contractor Owns Source (Design Projects)** + ``` + INTELLECTUAL PROPERTY OWNERSHIP: + + Final Deliverables: + Client owns all rights to final deliverables upon full payment: + - Final design files (exported formats: PNG, PDF, SVG) + - Final specifications and documentation + - Rights to use, modify, and distribute final deliverables + + Source Files: + Contractor retains ownership of source files: + - Original design files (Figma, Sketch source files) + - Working files and iterations + - Design system source files + + Source File Access: + Client may request source files for an additional fee: + - Design source files: $500 one-time fee + - Includes: All working files, components, and design system + - Transfer occurs after additional payment + + Portfolio Rights: + Contractor retains rights to: + - Display work in portfolio and case studies + - Use work in marketing materials (with Client credit) + - Discuss work in interviews and presentations + + Contractor May NOT: + - Reuse specific designs for other clients + - Resell deliverables as templates + - Use Client's brand elements without permission + ``` + + **Scenario D: Work-for-Hire (Full Client Ownership)** + ``` + INTELLECTUAL PROPERTY OWNERSHIP: + + Work-for-Hire: + All work performed under this agreement is considered "work made for hire" + under copyright law. Client owns all rights from the moment of creation. + + Full Ownership Transfer: + Client owns: + - All deliverables, including source files + - All work-in-progress and iterations + - All concepts, ideas, and creative works + - All code, designs, documentation, and materials + - Rights to register copyrights in Client's name + - Exclusive rights to use, modify, distribute, and commercialize + + Contractor Retains: + - Only general knowledge and skills gained + - Portfolio rights (with Client's written permission) + + Portfolio Use: + Contractor may use work in portfolio only with Client's written permission, + which Client may grant or deny at their discretion. + + No Reuse Rights: + Contractor may not reuse any deliverables, concepts, or work products for + any other purpose or client. + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Client owns the work" + "Deliverables belong to Client" + "Work is Client's property" + ``` + + **GOOD (Specific)**: + ``` + "Upon full payment, Client owns all rights, title, and interest in final + deliverables specified in Section 2. Client receives: final design files, + specifications, and documentation. Contractor retains: methodologies, tools, + templates, and pre-existing work. Contractor may not reuse specific deliverables + created for Client." + ``` + +6. **No Dispute Resolution** - Conflicts escalate unnecessarily + - **Problem**: Disagreements lead directly to expensive litigation + - **Solution**: Include mediation/arbitration before litigation + - **For Consultants**: Avoid costly court battles. Include: "Disputes shall first be resolved through good faith negotiation. If unsuccessful, parties agree to [mediation/arbitration] before pursuing litigation." + - **For Clients**: Protect yourself from legal costs. Request: "How will we resolve disagreements? Can we use mediation first? What's the process?" + + **Example Wordings - Different Dispute Resolution Approaches**: + + **Scenario A: Mediation Then Arbitration (Recommended)** + ``` + DISPUTE RESOLUTION: + + Step 1: Good Faith Negotiation + Any disputes arising from this agreement shall first be addressed through + good faith negotiation between the parties for 30 days from the date dispute + is raised in writing. + + Step 2: Mediation + If negotiation is unsuccessful, parties agree to submit the dispute to + mediation under the rules of [Mediation Organization, e.g., "American + Arbitration Association"] before pursuing other remedies. + - Mediation must be completed within 60 days + - Mediator selected by mutual agreement or appointed by mediation organization + - Each party bears their own mediation costs + - Mediation is non-binding (either party may reject settlement) + + Step 3: Binding Arbitration + If mediation fails, disputes shall be resolved through binding arbitration + under the rules of [Arbitration Organization, e.g., "American Arbitration + Association"]. + - Arbitration location: [City, State/Country] + - Arbitrator: Single arbitrator selected by mutual agreement + - Arbitration decision is final and binding + - Each party bears their own attorney fees + - Arbitration costs split equally + + Step 4: Court Enforcement + Judgment on arbitration award may be entered in any court of competent + jurisdiction in [Location]. + + No Litigation Without Mediation/Arbitration: + Parties agree not to pursue litigation until mediation and arbitration + processes are completed. + ``` + + **Scenario B: Mediation Only (Non-Binding)** + ``` + DISPUTE RESOLUTION: + + Mediation Process: + Any disputes shall be resolved through mediation before pursuing litigation. + + Process: + 1. Written notice of dispute to other party + 2. 30 days of good faith negotiation + 3. If unresolved, mediation within 60 days + 4. Mediator selected by mutual agreement + 5. Mediation session(s) as needed + 6. If mediation succeeds: Settlement agreement signed + 7. If mediation fails: Parties may pursue litigation + + Mediation Details: + - Location: [City, State/Country] + - Mediator: Neutral third party agreed upon by both parties + - Costs: Split equally between parties + - Duration: Up to 2 full-day sessions + - Outcome: Non-binding (parties may accept or reject settlement) + + After Mediation: + If mediation does not resolve the dispute, either party may pursue + litigation in courts of [Jurisdiction]. + ``` + + **Scenario C: Arbitration Only (Binding)** + ``` + DISPUTE RESOLUTION: + + Binding Arbitration: + All disputes arising from this agreement shall be resolved through binding + arbitration, which is the exclusive remedy. + + Arbitration Process: + 1. Written notice of dispute + 2. 30 days good faith negotiation + 3. If unresolved, binding arbitration under [Arbitration Rules] + + Arbitration Details: + - Organization: [e.g., "JAMS" or "American Arbitration Association"] + - Location: [City, State/Country] + - Rules: [Specific arbitration rules, e.g., "AAA Commercial Arbitration Rules"] + - Arbitrator: Single arbitrator with expertise in [field, e.g., "software development"] + - Timeline: Arbitration hearing within 90 days of filing + - Decision: Final and binding, no appeal except for fraud or misconduct + + Costs: + - Each party bears their own attorney fees + - Arbitration fees split equally + - Each party responsible for their own costs (witnesses, experts, etc.) + + Enforcement: + Judgment on arbitration award may be entered in any court of competent + jurisdiction. Parties waive right to jury trial. + + No Litigation: + Parties agree that arbitration is the exclusive remedy and waive right to + pursue disputes in court except to enforce arbitration award. + ``` + + **Scenario D: Escalation Ladder (Negotiation β†’ Mediation β†’ Litigation)** + ``` + DISPUTE RESOLUTION: + + Escalation Process: + Disputes shall be resolved through the following escalation process: + + Level 1: Direct Negotiation (Required) + - Parties must attempt good faith negotiation for 30 days + - Designated representatives from each party meet to resolve issue + - Written summary of discussions maintained + + Level 2: Executive Mediation (Optional) + - If negotiation fails, parties may (but are not required to) attempt + executive-level mediation + - Senior executives from each party meet with neutral mediator + - Mediation session(s) within 45 days + - Non-binding, either party may reject settlement + + Level 3: Litigation + - If dispute remains unresolved, parties may pursue litigation + - Jurisdiction: Courts of [Location] + - Governing law: [Jurisdiction's] laws + - Each party bears their own costs + + Good Faith Requirement: + Parties agree to participate in good faith in each level before escalating + to the next level. + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Disputes will be resolved through negotiation" + "Parties agree to resolve disputes amicably" + "Any disputes will be handled fairly" + ``` + + **GOOD (Specific)**: + ``` + "Disputes shall first be addressed through good faith negotiation for 30 days. + If unresolved, parties agree to mediation under [Organization] rules. If + mediation fails, disputes shall be resolved through binding arbitration under + [Rules] in [Location]. Each party bears their own costs. Judgment on + arbitration award may be entered in any court of competent jurisdiction." + ``` + +7. **Missing Confidentiality** - Sensitive information at risk + - **Problem**: No protection for proprietary information, business strategies, or trade secrets shared during the project + - **Solution**: Include confidentiality clause with clear duration and exceptions + - **For Consultants**: Protect client information. Include: "Both parties agree to keep confidential: [types of information]. Confidentiality lasts: [duration]. Exceptions: [public information, independently developed, required by law]." + - **For Clients**: Protect your secrets. Request: "What information is protected? How long does confidentiality last? What are the exceptions?" + + **Example Wordings - Different Confidentiality Scenarios**: + + **Scenario A: Standard Mutual Confidentiality (3 Years)** + ``` + CONFIDENTIALITY: + + Definition of Confidential Information: + Both parties agree to keep confidential all non-public information shared + during this project, including but not limited to: + - Business strategies, plans, and forecasts + - Financial data, budgets, and pricing information + - Customer lists, contact information, and customer data + - Proprietary methods, processes, and know-how + - Technical specifications and designs + - Marketing plans and competitive intelligence + - Project details, timelines, and internal communications + - Any information marked "Confidential" or "Proprietary" + + Obligations: + Each party agrees to: + - Use confidential information solely for project purposes + - Not disclose confidential information to third parties without written consent + - Take reasonable measures to protect confidential information + - Return or destroy confidential materials upon project completion + - Maintain confidentiality even after project completion + + Duration: + Confidentiality obligations last for 3 years after project completion + or termination of this agreement, whichever is later. + + Exceptions: + Confidentiality obligations do not apply to information that: + 1. Was already publicly known before disclosure + 2. Becomes publicly known through no breach of this agreement + 3. Was independently developed without use of confidential information + 4. Was rightfully received from a third party without confidentiality obligations + 5. Is required to be disclosed by law, court order, or government regulation + (party must notify other party before disclosure if legally permitted) + ``` + + **Scenario B: One-Way Confidentiality (Client Information Only)** + ``` + CONFIDENTIALITY: + + Scope: + This confidentiality clause protects only Client's confidential information. + Contractor agrees to maintain confidentiality of Client's information. + + Client's Confidential Information Includes: + - Business strategies and competitive plans + - Financial data and budgets + - Customer information and databases + - Proprietary processes and methods + - Technical specifications and requirements + - Marketing plans and strategies + - Any information Client designates as confidential + + Contractor's Obligations: + Contractor agrees to: + - Keep Client's confidential information strictly confidential + - Use confidential information only for project purposes + - Not disclose to any third party without Client's written consent + - Not use confidential information for Contractor's own benefit + - Return or destroy all confidential materials upon project completion + - Maintain confidentiality for 5 years after project completion + + Contractor's Information: + This clause does not restrict Contractor's use of Contractor's own + information, methodologies, or general knowledge gained. + + Exceptions: + Confidentiality does not apply to information that: + - Was publicly known before disclosure + - Becomes publicly known through no breach by Contractor + - Was independently developed by Contractor + - Is required to be disclosed by law (with notice to Client if permitted) + ``` + + **Scenario C: Strict Confidentiality (5 Years, No Exceptions for Trade Secrets)** + ``` + CONFIDENTIALITY: + + Mutual Confidentiality: + Both parties agree to maintain strict confidentiality of all information + shared during this project. + + Confidential Information Includes: + - All business, financial, and technical information + - Customer data and contact information + - Proprietary methods and processes + - Project plans, timelines, and details + - Any information not publicly available + + Strict Obligations: + Each party agrees to: + - Not disclose confidential information to anyone without written consent + - Use information solely for project purposes + - Implement security measures to protect information + - Not reverse engineer or attempt to derive confidential methods + - Return or destroy all confidential materials upon request + - Ensure employees/contractors also maintain confidentiality + + Duration: + - Standard information: 5 years after project completion + - Trade secrets: Indefinitely (until information becomes publicly known) + + Trade Secrets: + Information identified as "Trade Secret" shall remain confidential + indefinitely, regardless of whether it becomes publicly known through + other means. + + Limited Exceptions: + Confidentiality obligations continue even if information: + - Becomes publicly known (if originally marked as Trade Secret) + - Is independently developed (if based on confidential information) + + Legal Disclosure: + If required by law to disclose, party must: + - Notify other party immediately (if legally permitted) + - Disclose only the minimum required + - Request confidential treatment from court/authority + ``` + + **Scenario D: Limited Confidentiality (Specific Information Types)** + ``` + CONFIDENTIALITY: + + Scope: + Only the following specific types of information are considered confidential: + 1. Financial data: Budgets, pricing, revenue information + 2. Customer data: Customer lists, contact information, purchase history + 3. Technical specifications: Proprietary technical requirements + + Information NOT Confidential: + The following information is NOT confidential: + - General business information publicly available + - Information already known to Contractor + - Project deliverables (unless specifically marked confidential) + - General methodologies and processes + + Obligations: + Each party agrees to keep the specified confidential information private + and not disclose to third parties without consent. + + Duration: + Confidentiality obligations last for 2 years after project completion. + + Use Restrictions: + Confidential information may be used only for: + - Completing the project work + - Complying with legal obligations + - With written consent from the other party + + Exceptions: + Standard exceptions apply: publicly known, independently developed, + required by law (with notice). + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Information will be kept confidential" + "Parties agree to maintain confidentiality" + "Confidential information is protected" + ``` + + **GOOD (Specific)**: + ``` + "Both parties agree to keep confidential all non-public information shared + during this project, including: business strategies, financial data, customer + lists, proprietary methods, and project details. Confidentiality obligations + last for 3 years after project completion. Exceptions: (1) information already + publicly known, (2) information independently developed without use of + confidential information, (3) information required to be disclosed by law." + ``` + +8. **No Not-to-Exceed Cap** - Budget can spiral out of control + - **Problem**: Costs can exceed budget without clear limits or approval process + - **Solution**: Set maximum budget with change order process for adjustments + - **For Consultants**: Set clear boundaries. State: "Total project costs shall not exceed $X without prior written approval. Any work that would exceed this amount requires a Change Order signed before proceeding." + - **For Clients**: Protect your budget. Request: "What's the maximum I'll pay? How do we handle costs that exceed the cap? What's the approval process?" + + **Example Wordings - Different Not-to-Exceed Structures**: + + **Scenario A: Hard Cap (Fixed-Price Project)** + ``` + NOT-TO-EXCEED CLAUSE: + + Maximum Project Cost: + Total project costs shall not exceed $10,000 under any circumstances + without prior written approval from Client via Change Order. + + What's Included: + This cap includes: + - All Contractor fees and charges + - All project-related expenses + - All costs for work within the scope defined in Section 2 + + What's NOT Included: + This cap does NOT include: + - Work outside original scope (requires Change Order) + - Additional revisions beyond those specified + - Rush fees or expedited delivery + - Third-party costs (unless specified in scope) + + Exceeding the Cap: + If Contractor anticipates costs will exceed $10,000: + 1. Contractor must notify Client in writing immediately + 2. Contractor must stop work that would exceed the cap + 3. Contractor must obtain signed Change Order before proceeding + 4. Change Order must specify new maximum amount + + No Work Without Approval: + Contractor will not perform any work that would cause total costs to exceed + $10,000 without Client's written approval via Change Order. + + Client Protection: + Client is not obligated to pay any amount exceeding $10,000 unless Change + Order is executed. + ``` + + **Scenario B: Soft Cap with Buffer (10% Buffer)** + ``` + NOT-TO-EXCEED CLAUSE: + + Base Maximum: $10,000 + Buffer: 10% ($1,000) + Total Maximum: $11,000 + + Cost Structure: + - Base project cost: Up to $10,000 (no approval needed) + - Buffer for minor overruns: Up to $1,000 (no approval needed) + - Total maximum without approval: $11,000 + - Any amount over $11,000: Requires Change Order approval + + When Buffer Applies: + The 10% buffer may be used for: + - Minor scope clarifications (not new features) + - Unforeseen technical challenges within original scope + - Small adjustments needed to complete deliverables + + When Buffer Does NOT Apply: + Buffer cannot be used for: + - New features or functionality + - Significant scope changes + - Additional deliverables + - These require Change Order regardless of amount + + Notification Requirements: + - If costs approach $10,000: Contractor must notify Client + - If costs will exceed $11,000: Contractor must stop and get Change Order + - Client approval required before exceeding $11,000 + ``` + + **Scenario C: Cap with Change Order Adjustment** + ``` + NOT-TO-EXCEED CLAUSE: + + Initial Maximum: $10,000 + + This amount represents the maximum cost for work within the original scope + defined in Section 2. + + Adjusting the Cap: + The maximum amount may be adjusted through Change Orders: + - Each Change Order may increase the maximum + - New maximum = Previous maximum + Change Order amount + - Example: $10,000 base + $2,000 change = $12,000 new maximum + + Process: + 1. Client requests work outside original scope + 2. Contractor provides Change Order with additional cost + 3. If approved, Change Order increases the maximum + 4. New maximum applies going forward + + Tracking: + Contractor will provide monthly cost reports showing: + - Costs incurred to date + - Remaining budget under current maximum + - Any anticipated overruns + + Protection: + Client is not obligated to pay more than the current maximum (base + + approved Change Orders) without additional Change Order approval. + ``` + + **Scenario D: Hourly Project with Not-to-Exceed** + ``` + NOT-TO-EXCEED CLAUSE: + + Estimated Cost: $12,000 (based on 80 hours at $150/hour) + Maximum Cost: $15,000 (125% of estimate) + + Cost Structure: + - Contractor bills at $150/hour for actual time worked + - Total costs will not exceed $15,000 without approval + - If costs approach $15,000, Contractor must notify Client + + Approval Thresholds: + - Up to $12,000: No approval needed (within estimate) + - $12,000 - $15,000: Contractor must notify Client, but may continue + - Over $15,000: Requires Change Order approval before additional work + + Monthly Reporting: + Contractor will provide monthly invoices showing: + - Hours worked and rate + - Total costs to date + - Remaining budget under $15,000 cap + - Forecast of final costs + + Exceeding the Cap: + If Contractor anticipates costs will exceed $15,000: + 1. Contractor must notify Client in writing + 2. Contractor must explain why costs exceed estimate + 3. Contractor must obtain Change Order approval + 4. Change Order increases the maximum amount + + Client Rights: + Client may: + - Request detailed time logs + - Question charges that seem excessive + - Approve or reject work that would exceed cap + - Terminate if costs become unreasonable + ``` + + **Comparison: Good vs. Bad Formulations** + + **BAD (Vague)**: + ``` + "Costs will not exceed the budget" + "Project will stay within agreed amount" + "Additional costs require approval" + ``` + + **GOOD (Specific)**: + ``` + "Total project costs shall not exceed $10,000 without prior written approval + from Client. If Contractor anticipates costs will exceed this amount, + Contractor must notify Client in writing and obtain a signed Change Order + before proceeding. This cap includes all fees, expenses, and costs related + to the project scope defined in Section 2. Changes to scope may adjust this + cap through the Change Order process." + ``` + +--- + +### Guidance During Contract Building + +**When helping the user build the contract**: + +1. **Reference best practices**: "Based on industry best practices, [recommendation]..." +2. **Explain the why**: Always explain why each clause matters +3. **Present options**: Give multiple options when appropriate +4. **Recommend fair terms**: Suggest the most common/fair approach +5. **Protect both parties**: Ensure the contract protects everyone +6. **Build relationship**: Focus on long-term partnership, not just legal protection +7. **Keep it simple**: Avoid overly complex language +8. **Encourage questions**: "Does this make sense? Any questions?" + +**Key phrases to use**: +- "This is standard practice because..." +- "This protects both parties by..." +- "Most contracts include this because..." +- "This helps prevent [common problem]..." +- "The fair approach is usually..." + +**Key sections that need discussion**: + +1. **Scope of Work** - Most disputes arise from unclear scope. Discuss thoroughly. +2. **Payment Terms** - When, how much, payment schedule. Critical for cash flow. +3. **Not to Exceed** - Budget protection. Discuss what happens if exceeded. +4. **Confidentiality** - Duration and exceptions. Important for sensitive projects. +5. **Work Initiation** - When work can legally begin. Prevents unauthorized work. +6. **Intellectual Property** - Who owns what. Critical for creative/technical work. +7. **Termination** - How to exit the contract. Protects both parties. +8. **Dispute Resolution** - How conflicts are handled. Saves time and money. +9. **Jurisdiction** - Which laws apply. Important for cross-border contracts. +10. **Change Orders** - How scope changes are handled. Prevents scope creep. + +**For each important section**: +- **Explain why it matters first**: What problems it prevents, what it protects, what happens without it +- **Present options**: Show different ways to structure the clause +- **Explain implications**: What each option means for both parties +- **Ask for user's choice**: Which option they prefer and why +- Show the proposed language based on their choice +- Ask if user understands and agrees +- Customize based on their needs +- **Emphasize fairness**: "This protects both parties equally" or "This ensures clarity for everyone" +- **Focus on relationship**: "This helps prevent misunderstandings that could damage the working relationship" +- **Help them choose**: If user is unsure, recommend the most common/fair option and explain why +- Note: "This is based on standard contract practices designed to be fair to both parties. You may want legal review for complex projects, but the goal is always simplicity and mutual benefit." + +**For each section**: +1. Explain the background, what it does, and purpose +2. **For important sections**: Explain why it matters, present options, explain implications +3. Show the content pulled from pitch (if applicable) +4. **For important sections**: Ask for user's choice among options +5. Ask: "Does this work for you, or would you like to adjust anything?" +6. Customize based on user feedback +7. Move to next section + +**Output file**: `docs/1-project-brief/contract.md` + +--- + +### Option 2: Service Agreement (Owner β†’ Supplier) + +**Load template**: `src/modules/wds/workflows/1-project-brief/pitch/service-agreement.template.md` + +**Populate from pitch**: +- Same fields as contract, plus: +- `client_name` - Owner/company name +- `service_provider_name` - Ask user (designer/developer/agency name) +- `payment_terms` - Ask user or extract from Investment Required + +**Output file**: `docs/1-project-brief/service-agreement.md` + +--- + +### Option 3: Project Signoff Document (Internal) + +**Ask user if they have an existing company signoff document format**: + +"Do you have an existing company signoff document or template that you use for internal project approvals? + +If you do, you can upload it and I'll adapt it to match your company's format while incorporating the pitch information. This ensures the signoff document follows your internal processes and requirements. + +If you don't have one, I'll use a standard signoff document template that you can customize." + +**If user has existing signoff document**: +- Ask user to upload or paste the document: "Please upload or paste your company's signoff document template. I'll analyze it and adapt it to incorporate the pitch information while preserving your company's format and requirements." +- **Analyze the document structure**: + - Read through the entire document carefully + - Identify all section headings and their order + - Note the document format and layout + - Identify required fields and placeholders +- **Extract key elements**: + - **Required sections**: List all sections (e.g., "Executive Summary", "Budget Approval", "Risk Assessment", "Resource Allocation", "Compliance Check") + - **Signoff fields**: Identify who needs to sign (e.g., "Project Sponsor", "Budget Approver", "Department Head", "IT Director", "Legal Review") + - **Approval workflow**: Understand the process (e.g., "Sequential signoffs", "Parallel approvals", "Approval levels") + - **Company-specific language**: Note terminology, phrases, and style (e.g., "Capital Expenditure" vs "Budget", "Stakeholder" vs "Approver") + - **Required disclaimers**: Identify any legal language, compliance statements, or company policies that must be included + - **Formatting**: Note any specific formatting requirements (headers, footers, page breaks, signature blocks) +- **Map pitch content to company format**: + - Match pitch sections to company's document structure + - Adapt pitch language to match company terminology + - Preserve company's section order and structure + - Include company-specific sections even if not in pitch (e.g., "Risk Assessment", "Compliance Review") +- **Create adapted document**: + - Use company's document structure as the foundation + - Populate with pitch information where appropriate + - Preserve company-specific sections and language + - Maintain company's signoff fields and approval workflow + - Keep company's formatting and layout style +- **Confirm with user**: + - "I've analyzed your company's signoff document. I see it includes [list sections]. I've adapted it to include the pitch information while preserving your format. Should I include all sections, or are there any you'd like me to modify or remove?" + - "I've preserved your signoff fields: [list signoff roles]. Are these correct for this project?" + - "I've maintained your company's terminology and language. Does this look right?" + +**If user doesn't have existing signoff document**: +- Use standard template: `src/modules/wds/workflows/1-project-brief/pitch/signoff.template.md` +- Ask about company-specific requirements: + - "Who needs to sign off? (Project Sponsor, Budget Approver, Department Head, etc.)" + - "Are there specific sections your company requires?" + - "Do you have any company-specific language or disclaimers that should be included?" + +**Populate from pitch**: +- Same fields as contract, plus: +- `department_name` - Ask user +- `project_owner` - Ask user or from config +- Company-specific signoff fields (if provided) +- Company-specific sections (if provided) + +**Output file**: `docs/1-project-brief/signoff.md` + +--- + +## Common Steps for All Document Types + +**Extract deliverables from Work Plan**: +- Review the Work Plan section +- Identify which WDS phases are included +- List expected deliverables (e.g., "UX Design specifications for 3 scenarios", "Technical architecture documentation", "Design handoff package") +- Format as a clear list + +**Extract timeline**: +- If mentioned in Investment Required or Work Plan, use that +- Otherwise, provide a general timeline based on phases +- Be realistic about scope + +**Ask for missing information**: +- **For Signoff Document**: + - "Do you have an existing company signoff document format? If so, please upload it or paste it here and I'll adapt it to match your company's format while incorporating the pitch information." + - If provided: Analyze structure, extract required sections, signoff fields, company language, and adapt pitch content to match + - If not provided: "Who needs to sign off? (Project Sponsor, Budget Approver, Department Head, etc.)" and "Are there specific sections your company requires?" +- Client/service provider names +- **Not to exceed amount** (for contract/service agreement) - "What's the maximum budget you want to set? This protects both parties from cost overruns." +- **Confidentiality duration** (for contract/service agreement) - "How long should confidentiality last? (Typically 2-5 years)" +- **Work initiation** - "When should work begin? Options: upon contract signing, specific date, after initial payment, or other condition?" +- **Legal jurisdiction** - "Which jurisdiction's laws should govern this contract? (e.g., 'State of California, USA', 'England and Wales', 'Ontario, Canada')" +- **Contract language** - "What language should this contract be in? (e.g., English, Spanish, French)" +- **Dispute resolution method** - "How should disputes be resolved? (mediation, arbitration, or litigation)" +- Department (for signoff) +- Payment terms (for service agreement) +- Any other context-specific details + +**Important**: Discuss each critical section with the user. Reference that contract language is based on professional best practices, but recommend legal review for complex projects or large investments. + +--- + +## Output + +**Present to user**: + +**If signoff document was adapted from company format**: + +"I've created your signoff document at `docs/1-project-brief/signoff.md`. + +I've adapted it to match your company's signoff document format while incorporating all the pitch information. The document follows your internal structure and includes: +- Your company's required sections and signoff fields +- Project scope and work plan from the pitch +- Investment and timeline +- Expected deliverables +- Your company's approval workflow and terminology + +I've preserved your company-specific language and format. Please review it to ensure it matches your internal requirements, and let me know if any adjustments are needed." + +**If standard document was created**: + +"I've created your [contract/service agreement/signoff document] at `docs/1-project-brief/[filename].md`. + +This document is based on your pitch and designed to be **simple, fair, and clear** - providing reliable terms that support a long-lasting working relationship. + +It includes: +- Project scope and work plan +- Investment and timeline +- Expected deliverables +- Terms and conditions/approval section +- Fair protections for both parties + +The goal is always clarity and mutual benefit. You can review it and make any adjustments needed before presenting it to stakeholders for approval/signature." + +--- + +## Next Step + +After generating the agreement document (or if user skipped), project initiation is complete. + +**Next**: Proceed to full Project Brief workflow: +β†’ `src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md` + +**Note**: The pitch made the case and got everyone aligned. The agreement document formalizes that alignment. Now you're ready to start the detailed project work. + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-04-present-for-approval.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-04-present-for-approval.md new file mode 100644 index 00000000..1fc8c596 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-04-present-for-approval.md @@ -0,0 +1,89 @@ +# Step 4: Present Alignment Document for Approval + +## Purpose + +Present the completed alignment document and guide user on next steps. + +--- + +## Instruction + +**Present the alignment document for review and approval**: + +"I've created your alignment document at `docs/1-project-brief/pitch.md`. + +This alignment document (pitch) is ready to share with your stakeholders. It's designed to be clear, brief, and compelling - readable in just 2-3 minutes. + +**Next steps**: +1. Share the alignment document with stakeholders for review +2. Gather their feedback - we can negotiate and make changes +3. Update the alignment document until everyone is on board +4. Once the alignment document is accepted and everyone is aligned on the idea, why, what, how, budget, and commitment +5. **After acceptance**, I'll generate the signoff document (contract/service agreement/signoff) to secure the commitment +6. Then we'll proceed to create the full Project Brief + +**Remember**: The alignment phase is collaborative - we can negotiate and iterate until everyone is on the same page. The signoff document comes after acceptance to formalize the commitment. WDS has your back - we'll help you get alignment and secure commitment before starting the work! + +Would you like to: +- Review the alignment document together and make any adjustments before sharing? +- Proceed to share it with stakeholders for feedback? +- Make changes based on stakeholder feedback? +- Or something else?" + +--- + +## After Approval + +**Once the alignment document is accepted**, proceed to generate the signoff document: + +**Next Step**: Generate Signoff Document +β†’ `step-03.5-generate-contract.md` (Generate contract, service agreement, or signoff) + +**Why after acceptance**: +- The alignment phase allows for negotiation and iteration +- Stakeholders can review, provide feedback, and request modifications +- Once accepted, everyone is aligned on the project +- Then the signoff document formalizes the commitment + +**After signoff document is finalized**: +- Project initiation is complete βœ… +- Proceed to full Project Brief workflow: +β†’ `src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md` (Full Project Brief) + +The alignment document provides the foundation and context for the detailed Project Brief work. With stakeholder acceptance secured and commitment formalized, you're ready to dive into the comprehensive strategic planning. + +--- + +## State Update + +Update frontmatter of output file: + +```yaml +stepsCompleted: + - 'step-01-start.md' + - 'step-01.5-extract-communications.md' (if used) + - 'step-02-explore-sections.md' + - 'step-03-synthesize.md' + - 'step-03.5-generate-contract.md' (if used) + - 'step-04-present-for-approval.md' +status: 'complete' +pitch: + realization: '[captured realization]' + why_it_matters: '[why it matters and who we help]' + how_we_see_it_working: '[solution approach]' + paths_we_explored: '[options explored]' + recommended_solution: '[preferred approach]' + path_forward: '[WDS phases and practical workflow]' + value_we_create: '[benefits of building, ambition, success metrics]' + cost_of_inaction: '[consequences of not building]' + our_commitment: '[resources needed and potential risks]' + summary: '[summary of key points]' + pitch_statement: '[synthesized pitch narrative]' +``` + +--- + +**Alignment & Signoff workflow complete** - Ready for stakeholder approval! + +**After approval**: Project initiation is complete. Proceed to full Project Brief. + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md new file mode 100644 index 00000000..63b0d93f --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md @@ -0,0 +1,27 @@ +# Substep 01: Understand Situation + +**Purpose**: Clarify the user's situation before proceeding + +--- + +## Instruction + +Ask the user to clarify their situation: + +"I'd like to understand your situation first. This will help me guide you efficiently. + +**Are you:** +- A consultant proposing a solution to a client? +- A business owner hiring consultants/suppliers to build software? +- A manager or employee seeking approval for an internal project? +- Or doing this yourself and don't need stakeholder alignment? + +Let's get clear on what you need so we can move forward." + +--- + +## Next Step + +After understanding their situation: +β†’ `02-determine-if-needed.md` + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/02-determine-if-needed.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/02-determine-if-needed.md new file mode 100644 index 00000000..1c37a5d1 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/02-determine-if-needed.md @@ -0,0 +1,32 @@ +# Substep 02: Determine If Alignment & Signoff Is Needed + +**Purpose**: Determine if user needs alignment & signoff or can proceed directly + +--- + +## Instruction + +Based on the user's situation, determine the path: + +**If they need alignment & signoff** (consultant, business owner, manager/employee): + +"Good. We're going to work together to create an alignment document that presents your idea clearly and gets stakeholders aligned. + +This alignment document will help you get alignment on your idea, why it matters, what it contains, how it will be executed, the budget needed, and the commitment required. We can iterate until everyone is on board. Once they accept it, we'll create a signoff document to secure the commitment, then proceed to the full Project Brief. + +You can start anywhere - with something you've realized needs attention, or with a solution you have in mind. I'll guide us through the important questions in whatever order makes sense for your thinking." + +**If they're doing it themselves** (don't need alignment & signoff): + +"That's great! If you have full autonomy and don't need stakeholder alignment, you can skip alignment & signoff and go straight to the Project Brief workflow. Would you like me to help you start the Project Brief instead?" + +--- + +## Decision Point + +**If they need alignment & signoff**: +β†’ `03-offer-extract-communications.md` (same folder) + +**If they're doing it themselves**: +β†’ Route to Project Brief workflow + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/03-offer-extract-communications.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/03-offer-extract-communications.md new file mode 100644 index 00000000..2a36425a --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/03-offer-extract-communications.md @@ -0,0 +1,31 @@ +# Substep 03: Offer to Extract Information from Communications + +**Purpose**: Offer optional step to extract information from existing communications/documents + +--- + +## Instruction + +Ask if they have relevant communications or documents: + +"Do you have any email threads, chat conversations, documents, or other materials from clients or stakeholders about this project? + +If you do, I can extract key information from them - things like: +- Realizations or observations they've mentioned +- Requirements they've discussed +- Concerns or questions they've raised +- Context about the project +- Existing documentation or specifications + +This can help us create a more informed alignment document. You can paste the content here, share the communications, or upload documents, and I'll extract the relevant information." + +--- + +## Decision Point + +**If user provides communications/documents**: +β†’ `04-extract-info.md` (same folder) + +**If user doesn't have any or skips**: +β†’ `05-detect-starting-point.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/04-extract-info.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/04-extract-info.md new file mode 100644 index 00000000..15db2834 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/04-extract-info.md @@ -0,0 +1,39 @@ +# Substep 04: Extract Information from Communications + +**Purpose**: Extract key information from provided communications/documents + +--- + +## Instruction + +Extract relevant information from the communications/documents: + +**What to extract**: +- **Realizations mentioned** - What have stakeholders realized or observed? +- **Requirements discussed** - What do they need or want? +- **Concerns raised** - What questions or concerns have they expressed? +- **Context** - Background information about the project +- **Timeline or urgency** - Any deadlines or time-sensitive information +- **Budget or constraints** - Financial or resource limitations mentioned + +**Use extracted information**: +- Inform The Realization section (what realizations or observations are mentioned) +- Inform Why It Matters (who is experiencing issues and why it matters) +- Inform Our Commitment (any budget/resource discussions) +- Inform Cost of Inaction (any urgency or consequences mentioned) +- Add context throughout the alignment document + +**Don't**: +- Copy entire communications or documents verbatim +- Include personal or irrelevant details +- Overwhelm with too much detail +- Use information that's clearly outdated +- Include sensitive information that shouldn't be in the alignment document + +--- + +## Next Step + +After extracting information: +β†’ `05-detect-starting-point.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/05-detect-starting-point.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/05-detect-starting-point.md new file mode 100644 index 00000000..6aa94c79 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/05-detect-starting-point.md @@ -0,0 +1,34 @@ +# Substep 05: Detect Starting Point + +**Purpose**: Determine where the user wants to start exploring sections + +--- + +## Instruction + +Ask where they'd like to start: + +"Where would you like to start? Have you realized something that needs attention, or do you have a solution in mind?" + +--- + +## Decision Point + +**If user starts with realization**: +- Explore the realization first +- Then naturally move to "why it matters" and "who we help" +- Then explore solutions +β†’ `../02-explore-sections/06-explore-realization.md` + +**If user starts with solution**: +- Capture the solution idea +- Then explore "what realization does this address?" +- Then explore "why it matters" and "who we help" +- Then explore other possible approaches +β†’ `../02-explore-sections/07-explore-solution.md` + +**If user starts elsewhere**: +- Follow their lead +- Guide them through remaining sections naturally +β†’ Route to appropriate section exploration micro-instruction + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/06-explore-realization.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/06-explore-realization.md new file mode 100644 index 00000000..89c3f60b --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/06-explore-realization.md @@ -0,0 +1,45 @@ +# Substep 06: Explore The Realization + +**Purpose**: Help user articulate what they've realized needs attention + +--- + +## Instruction + +Explore the realization section with the user. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 1: The Realization) + +**Questions to explore**: +- "What have you realized needs attention?" +- "What observation have you made?" +- "What challenge are you seeing?" +- "What evidence do you have that this is real?" + +**Best Practice: Confirm the Realization with Evidence** + +**Help them identify evidence:** + +**Soft Evidence** (qualitative indicators): +- "Do you have testimonials or complaints about this?" +- "What have stakeholders told you?" +- "What patterns have you observed?" +- "What do user interviews reveal?" + +**Hard Evidence** (quantitative data): +- "Do you have statistics or metrics?" +- "What do analytics show?" +- "Have you run surveys or tests?" +- "What do server logs or error reports indicate?" + +**Help them combine both types** for maximum credibility. + +**Keep it brief** - 2-3 sentences for the realization, plus 1-2 sentences of evidence + +--- + +## Next Step + +After exploring the realization: +β†’ `08-explore-why-it-matters.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/07-explore-solution.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/07-explore-solution.md new file mode 100644 index 00000000..9a391e8e --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/07-explore-solution.md @@ -0,0 +1,25 @@ +# Substep 07: Explore Solution (If Starting with Solution) + +**Purpose**: Capture solution idea and then explore the underlying realization + +--- + +## Instruction + +If user starts with a solution idea: + +1. **Capture the solution**: "Tell me about your solution idea..." + +2. **Then explore the underlying realization**: "What realization does this solution address? What have you observed that led to this solution?" + +3. **Then explore why it matters**: "Why does this matter? Who are we helping?" + +4. **Then explore other approaches**: "What other ways could we approach this?" + +--- + +## Next Step + +After capturing solution and exploring realization: +β†’ `08-explore-why-it-matters.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/08-explore-why-it-matters.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/08-explore-why-it-matters.md new file mode 100644 index 00000000..1aaf392f --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/08-explore-why-it-matters.md @@ -0,0 +1,33 @@ +# Substep 08: Explore Why It Matters + +**Purpose**: Help user articulate why this matters and who we help + +--- + +## Instruction + +Explore why it matters and who we help. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 2: Why It Matters) + +**Questions to explore**: +- "Why does this matter?" +- "Who are we helping?" +- "What are they trying to accomplish?" (Jobs) +- "What are their pain points?" (Pains) +- "What would make their life better?" (Gains) +- "How does this affect them?" +- "What impact will this have?" +- "Are there different groups we're helping?" + +**Keep it brief** - Why it matters and who we help + +**Help them think**: Focus on the value we're adding to specific people and why that matters + +--- + +## Next Step + +After exploring why it matters: +β†’ `09-explore-how-we-see-it-working.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/09-explore-how-we-see-it-working.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/09-explore-how-we-see-it-working.md new file mode 100644 index 00000000..437c689d --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/09-explore-how-we-see-it-working.md @@ -0,0 +1,29 @@ +# Substep 09: Explore How We See It Working + +**Purpose**: Help user articulate how they envision the solution working + +--- + +## Instruction + +Explore how they see it working. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 3: How We See It Working) + +**Questions to explore**: +- "How do you envision this working?" +- "What's the general approach?" +- "Walk me through how you see it addressing the realization" +- "What's the core concept?" + +**Keep it brief** - High-level overview, not detailed specifications + +**Flexible language** - Works for software, processes, services, products, strategies + +--- + +## Next Step + +After exploring how it works: +β†’ `10-explore-paths-we-explored.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/10-explore-paths-we-explored.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/10-explore-paths-we-explored.md new file mode 100644 index 00000000..8b78295b --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/10-explore-paths-we-explored.md @@ -0,0 +1,28 @@ +# Substep 10: Explore Paths We Explored + +**Purpose**: Help user articulate alternative approaches they considered + +--- + +## Instruction + +Explore paths they explored. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 4: Paths We Explored) + +**Questions to explore**: +- "What other ways could we approach this?" +- "Are there alternative paths?" +- "What options have you considered?" + +**Keep it brief** - 2-3 paths explored briefly + +**If user only has one path**: That's fine - acknowledge it and move on + +--- + +## Next Step + +After exploring paths: +β†’ `11-explore-recommended-solution.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/11-explore-recommended-solution.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/11-explore-recommended-solution.md new file mode 100644 index 00000000..3351ce0e --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/11-explore-recommended-solution.md @@ -0,0 +1,26 @@ +# Substep 11: Explore Recommended Solution + +**Purpose**: Help user articulate their preferred approach and why + +--- + +## Instruction + +Explore the recommended solution. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 5: Recommended Solution) + +**Questions to explore**: +- "Which approach do you prefer?" +- "Why this one over the others?" +- "What makes this the right solution?" + +**Keep it brief** - Preferred approach and key reasons + +--- + +## Next Step + +After exploring recommended solution: +β†’ `12-explore-path-forward.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/12-explore-path-forward.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/12-explore-path-forward.md new file mode 100644 index 00000000..f9f841f7 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/12-explore-path-forward.md @@ -0,0 +1,38 @@ +# Substep 12: Explore The Path Forward + +**Purpose**: Help user articulate how the work will be done + +--- + +## Instruction + +Explore the path forward. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 6: The Path Forward) + +**Purpose**: Explain how the work will be done practically - which WDS phases will be used and the workflow approach. + +**Questions to explore**: +- "How do you envision the work being done?" +- "Which WDS phases do you think we'll need?" +- "What's the practical workflow you're thinking?" +- "Will we need user research, or do you already know your users?" +- "Do you need technical architecture planning, or is that already defined?" +- "What level of design detail do you need?" +- "How will this be handed off for implementation?" + +**Keep it brief** - High-level plan of the work approach + +**Help them think**: +- Which WDS phases apply (Trigger Mapping, Platform Requirements, UX Design, Design System, etc.) +- Practical workflow (research β†’ design β†’ handoff, or skip research, etc.) +- Level of detail needed +- Handoff approach + +--- + +## Next Step + +After exploring path forward: +β†’ `13-explore-value-we-create.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/13-explore-value-we-create.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/13-explore-value-we-create.md new file mode 100644 index 00000000..92f0cba0 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/13-explore-value-we-create.md @@ -0,0 +1,40 @@ +# Substep 13: Explore The Value We'll Create + +**Purpose**: Help user articulate what happens if we DO build this + +--- + +## Instruction + +Explore the value we'll create. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 7: The Value We'll Create) + +**Questions to explore**: +- "What's our ambition? What are we striving to accomplish?" +- "What happens if we DO build this?" +- "What benefits would we see?" +- "What outcomes are we expecting?" +- "How will we measure success?" +- "What metrics will tell us we're succeeding?" +- "What's the value we'd create?" + +**Best Practice: Frame as Positive Assumption with Success Metrics** + +**Help them articulate**: +- **Our Ambition**: What we're confidently striving to accomplish (enthusiastic, positive) +- **Success Metrics**: How we'll measure success (specific, measurable) +- **What Success Looks Like**: Clear outcomes (tangible results) +- **Monitoring Approach**: How we'll track these metrics (brief) + +**Keep it brief** - Key benefits, outcomes, and success metrics + +**Help them think**: Positive assumption ("We're confident this will work") + clear success metrics ("Here's how we'll measure it") = enthusiastic and scientific + +--- + +## Next Step + +After exploring value we'll create: +β†’ `14-explore-cost-of-inaction.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/14-explore-cost-of-inaction.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/14-explore-cost-of-inaction.md new file mode 100644 index 00000000..71074e2d --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/14-explore-cost-of-inaction.md @@ -0,0 +1,37 @@ +# Substep 14: Explore Cost of Inaction + +**Purpose**: Help user articulate what happens if we DON'T build this + +--- + +## Instruction + +Explore cost of inaction. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 8: Cost of Inaction) + +**Questions to explore**: +- "What happens if we DON'T build this?" +- "What are the risks of not acting?" +- "What opportunities would we miss?" +- "What's the cost of doing nothing?" +- "What gets worse if we don't act?" +- "What do we lose by waiting?" + +**Keep it brief** - Key consequences of not building + +**Can include**: +- Financial cost (lost revenue, increased costs) +- Opportunity cost (missed opportunities) +- Competitive risk (competitors gaining advantage) +- Operational impact (inefficiency, problems getting worse) + +**Help them think**: Make the case for why we can't afford NOT to do this + +--- + +## Next Step + +After exploring cost of inaction: +β†’ `15-explore-our-commitment.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/15-explore-our-commitment.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/15-explore-our-commitment.md new file mode 100644 index 00000000..22a2fce1 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/15-explore-our-commitment.md @@ -0,0 +1,33 @@ +# Substep 15: Explore Our Commitment + +**Purpose**: Help user articulate resources needed and potential risks + +--- + +## Instruction + +Explore our commitment. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 9: Our Commitment) + +**Questions to explore**: +- "What resources are we committing?" +- "What's the time commitment?" +- "What budget or team are we committing?" +- "What dependencies exist?" +- "What potential risks or drawbacks should we consider?" +- "What challenges might we face?" + +**Keep it brief** - High-level commitment and potential risks + +**Don't force precision** - Rough estimates are fine at this stage + +**Help them think**: Time, money, people, technology - what are we committing to make this happen? What risks or challenges should we acknowledge? + +--- + +## Next Step + +After exploring our commitment: +β†’ `16-explore-summary.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/16-explore-summary.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/16-explore-summary.md new file mode 100644 index 00000000..e250fb82 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/02-explore-sections/16-explore-summary.md @@ -0,0 +1,26 @@ +# Substep 16: Explore Summary + +**Purpose**: Help user create a summary of key points + +--- + +## Instruction + +Explore the summary. + +**Reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/section-guide.md` (Section 10: Summary) + +**Questions to explore**: +- "What are the key points?" +- "What should stakeholders remember?" +- "What's the main takeaway?" + +**Keep it brief** - Summary of key points (let readers draw their own conclusion) + +--- + +## Next Step + +After exploring all sections: +β†’ `../03-synthesize-present/17-reflect-back.md` + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/17-reflect-back.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/17-reflect-back.md new file mode 100644 index 00000000..ba414ccc --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/17-reflect-back.md @@ -0,0 +1,33 @@ +# Substep 17: Reflect Back What You've Captured + +**Purpose**: Reflect back understanding before synthesizing + +--- + +## Instruction + +**After covering all sections** (in whatever order made sense): + +Reflect back what you've captured: + +"I've explored [list sections covered] with you. Let me reflect back what I understand: + +- **The Realization**: [summarize their realization] +- **Why It Matters**: [summarize why it matters and who we help] +- **How We See It Working**: [summarize solution approach] +- **Recommended Solution**: [summarize preferred approach] +- **The Path Forward**: [summarize work approach] +- **The Value We'll Create**: [summarize value and success metrics] +- **Cost of Inaction**: [summarize consequences] +- **Our Commitment**: [summarize resources and risks] +- **Summary**: [summarize key points] + +Does this capture what you want in your alignment document? Anything you'd like to adjust or clarify?" + +--- + +## Next Step + +After reflecting back and confirming: +β†’ `18-synthesize-document.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18-synthesize-document.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18-synthesize-document.md new file mode 100644 index 00000000..6818879e --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/18-synthesize-document.md @@ -0,0 +1,41 @@ +# Substep 18: Synthesize Alignment Document + +**Purpose**: Create the alignment document from all explored sections + +--- + +## Instruction + +**After confirming understanding**: + +Help crystallize into a clear, compelling narrative using framework thinking: +- **Realization β†’ Why It Matters β†’ How We See It Working β†’ Value We'll Create** +- **Realization β†’ Agitate (Cost of Inaction) β†’ Solve (Solution) β†’ Commitment** + +**Framework check**: Does the alignment document flow logically? +- Realization is clear and evidence-backed +- Why it matters and who we help is understood +- Solution addresses the realization +- Commitment is reasonable and risks acknowledged +- Cost of inaction makes the case +- Value we'll create justifies the commitment + +**Create Alignment Document** + +**Output file**: `docs/1-project-brief/pitch.md` (deliverable name: "pitch") + +**Format**: Clear, brief, readable in 2-3 minutes + +**Structure**: Use the 10-section structure covered in the exploration + +**Template reference**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/pitch.template.md` + +**Ask**: "Does this present your idea in the best light?" + +--- + +## Next Step + +After creating the alignment document: +β†’ `19-present-for-approval.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/19-present-for-approval.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/19-present-for-approval.md new file mode 100644 index 00000000..058c8d10 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/03-synthesize-present/19-present-for-approval.md @@ -0,0 +1,44 @@ +# Substep 19: Present Alignment Document for Approval + +**Purpose**: Present the alignment document and guide next steps + +--- + +## Instruction + +**Present the alignment document for review and approval**: + +"I've created your alignment document at `docs/1-project-brief/pitch.md`. + +This alignment document is ready to share with your stakeholders. It's designed to be clear, brief, and compelling - readable in just 2-3 minutes. + +**Next steps**: +1. Share the alignment document with stakeholders for review +2. Gather their feedback - we can negotiate and make changes +3. Update the alignment document until everyone is on board +4. Once the alignment document is accepted and everyone is aligned on the idea, why, what, how, budget, and commitment +5. **After acceptance**, I'll generate the signoff document (contract/service agreement/signoff) to secure the commitment +6. Then we'll proceed to create the full Project Brief + +**Remember**: The alignment phase is collaborative - we can negotiate and iterate until everyone is on the same page. The signoff document comes after acceptance to formalize the commitment. WDS has your back - we'll help you get alignment and secure commitment before starting the work! + +Would you like to: +- Review the alignment document together and make any adjustments before sharing? +- Proceed to share it with stakeholders for feedback? +- Make changes based on stakeholder feedback? +- Or something else?" + +--- + +## Decision Point + +**If user wants to make changes**: +- Update the alignment document +- Return to this step after changes + +**If alignment document is accepted**: +β†’ `../04-generate-signoff/20-offer-signoff-document.md` + +**If user wants to skip signoff**: +β†’ Proceed to Project Brief workflow + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/20-offer-signoff-document.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/20-offer-signoff-document.md new file mode 100644 index 00000000..21a5218f --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/20-offer-signoff-document.md @@ -0,0 +1,38 @@ +# Substep 20: Offer to Generate Signoff Document + +**Purpose**: Offer to create signoff document after alignment acceptance + +--- + +## Instruction + +**After the alignment document is accepted by stakeholders**, offer to create a signoff document: + +"Great! The alignment document has been accepted and everyone is aligned on the idea, why, what, how, budget, and commitment. + +Now let's secure this commitment with a signoff document. This will formalize what everyone has agreed to and ensure everyone stays committed to making this project happen. + +**What type of document do you need?** + +1. **Project Contract** - If you're a consultant and the client has approved the alignment document +2. **Service Agreement** - If you're a founder/owner and suppliers have approved the alignment document +3. **Project Signoff Document** - If this is an internal company project and stakeholders have approved + - *Note: If you have an existing company signoff document format, you can upload it and I'll adapt it to match your company's format* +4. **Skip** - If you don't need a formal document right now + +Which applies to your situation? + +**Remember**: WDS helps with alignment - the alignment document got everyone on the same page, and this signoff document secures the commitment before we start building something that makes the world a better place!" + +--- + +## Decision Point + +**If user chooses "Skip"**: +- Acknowledge: "No problem! The alignment document is ready to share. You can always generate a signoff document later if needed." +- Proceed to Project Brief workflow + +**If user chooses document type**: +β†’ `21-determine-business-model.md` (same folder - for external contracts) +β†’ `../06-build-signoff-internal/34-build-internal-signoff.md` (for internal signoff) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/21-determine-business-model.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/21-determine-business-model.md new file mode 100644 index 00000000..8c70aa20 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/04-generate-signoff/21-determine-business-model.md @@ -0,0 +1,50 @@ +# Substep 21: Determine Business Model + +**Purpose**: Determine how the service will be paid for (for external contracts) + +--- + +## Instruction + +**Before building contract sections**, determine the business model: + +"First, let's determine the business model - how will this service be paid for? This helps us structure the contract correctly. + +**What business model fits this project?** + +1. **Fixed-Price Project** - Set price for a defined scope of work + - Best for: Projects with clear deliverables and scope + - Includes: Not-to-exceed clause, upfront payment recommended + - Example: "$50,000 for complete website redesign with 5 pages" + +2. **Hourly/Time-Based** - Pay for actual time worked + - Best for: Ongoing work, uncertain scope, flexible requirements + - Includes: Hourly rate, time tracking, optional not-to-exceed cap + - Example: "$150/hour, estimated 200 hours" + +3. **Retainer** - Monthly commitment with minimum hours + - Best for: Ongoing support, regular availability needed + - Includes: Monthly retainer amount, minimum hours, availability expectations, hourly rate for overage + - Example: "$5,000/month retainer for 20 hours minimum, $200/hour for additional hours" + +4. **Hybrid** - Combination of models (e.g., retainer + project work) + - Best for: Complex arrangements with multiple work types + - Includes: Multiple payment structures combined + +Which model fits your situation?" + +--- + +## After User Selects Business Model + +**Confirm understanding**: "So you've chosen [model]. This means [brief explanation of what this means for the contract]." + +**Note the selection**: This will determine which sections we include and how we configure payment terms, not-to-exceed, availability, etc. + +--- + +## Next Step + +After determining business model: +β†’ `../05-build-contract/22-build-section-01-project-overview.md` + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/22-build-section-01-project-overview.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/22-build-section-01-project-overview.md new file mode 100644 index 00000000..bd645129 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/22-build-section-01-project-overview.md @@ -0,0 +1,29 @@ +# Substep 22: Build Section 1 - Project Overview + +**Purpose**: Build the Project Overview section of the contract + +--- + +## Instruction + +**Section 1: Project Overview** + +**Background**: Establishes what the project is about + +**What it does**: Defines the realization and solution from the alignment document + +**Purpose**: Sets clear expectations and context + +**Content**: Pull from alignment document (pitch): +- **The Realization**: {{realization}} +- **Recommended Solution**: {{recommended_solution}} + +**Explain to user**: "This section establishes what the project is about. I'll pull the realization and recommended solution from your alignment document." + +--- + +## Next Step + +After building Project Overview: +β†’ `23-build-section-02-business-model.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/23-build-section-02-business-model.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/23-build-section-02-business-model.md new file mode 100644 index 00000000..45c7b3eb --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/23-build-section-02-business-model.md @@ -0,0 +1,66 @@ +# Substep 23: Build Section 2 - Business Model + +**Purpose**: Build the Business Model section based on user's selection + +--- + +## Instruction + +**Section 2: Business Model** + +**Background**: Defines how the service will be paid for - critical foundation for all payment terms + +**What it does**: Explains the selected business model and its terms + +**Purpose**: Sets clear expectations about payment structure, prevents misunderstandings + +**Content**: Based on user's selection from micro-21 + +**For each business model, include**: + +**If Fixed-Price Project**: +- Model name: "Fixed-Price Project" +- Description: "This contract uses a fixed-price model. The contractor commits to deliver the specified scope of work for the agreed price, regardless of actual time or costs incurred." +- Key terms: + - Total project price: {{total_amount}} + - Price includes: All work within the defined scope + - Price does NOT include: Work outside the original scope (requires change order) + - Payment structure: {{payment_structure}} (e.g., 50% upfront, 50% on completion) + - Not-to-exceed: Applies (see Section 10) + +**If Hourly/Time-Based**: +- Model name: "Hourly/Time-Based" +- Description: "This contract uses an hourly billing model. The client pays for actual time worked at the agreed hourly rate." +- Key terms: + - Hourly rate: {{hourly_rate}} + - Estimated hours: {{estimated_hours}} (if applicable) + - Estimated total: {{estimated_total}} (hourly_rate Γ— estimated_hours) + - Time tracking: {{time_tracking_method}} (e.g., detailed timesheets, time tracking software) + - Billing frequency: {{billing_frequency}} (e.g., weekly, bi-weekly, monthly) + - Not-to-exceed: {{not_to_exceed_applies}} (optional cap - see Section 10 if applicable) + +**If Retainer**: +- Model name: "Monthly Retainer" +- Description: "This contract uses a retainer model. The client pays a fixed monthly amount for a minimum number of hours, with additional hours billed at the overage rate." +- Key terms: + - Monthly retainer amount: {{monthly_retainer_amount}} + - Minimum hours per month: {{minimum_hours_per_month}} + - Effective hourly rate: {{effective_hourly_rate}} (retainer Γ· minimum hours) + - Overage hourly rate: {{overage_hourly_rate}} (for hours beyond minimum) + - Availability: {{availability_expectations}} (e.g., "Available during business hours, 2-3 day response time") + - Retainer period: {{retainer_period}} (e.g., "Monthly, renewable") + - Hour rollover: {{hour_rollover_policy}} (e.g., "Unused hours expire at month end" or "Up to X hours can roll over") + - Billing: Retainer due {{retainer_due_date}} (e.g., "on the 1st of each month") + +**If Hybrid**: +- Model name: "Hybrid Model" +- Description: "This contract combines multiple payment structures." +- Key terms: Combine terms from each component + +--- + +## Next Step + +After building Business Model section: +β†’ `24-build-section-03-scope-of-work.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/24-build-section-03-scope-of-work.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/24-build-section-03-scope-of-work.md new file mode 100644 index 00000000..46378a8a --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/24-build-section-03-scope-of-work.md @@ -0,0 +1,46 @@ +# Substep 24: Build Section 3 - Scope of Work + +**Purpose**: Build the Scope of Work section with IN scope, OUT of scope, and deliverables + +--- + +## Instruction + +**Section 3: Scope of Work** + +**Background**: Defines exactly what will be delivered and what won't be + +**What it does**: Lists path forward, deliverables, explicit IN scope, and explicit OUT of scope + +**Purpose**: Prevents scope creep and sets clear boundaries - critical for avoiding disputes + +**Why this matters**: +- Most contract disputes arise from unclear scope +- Clear IN/OUT scope prevents misunderstandings +- Protects both parties from scope creep +- Sets expectations upfront + +**Content to gather**: +1. **The Path Forward**: Pull from alignment document (path_forward) - how the work will be done +2. **Deliverables**: Pull from alignment document (deliverables_list) - what will be delivered +3. **IN Scope**: Ask user explicitly - "What work is explicitly included? Be specific about what's covered." +4. **OUT of Scope**: Ask user explicitly - "What work is explicitly NOT included? What would require a change order?" + +**Important**: Based on business model, adapt scope section: +- **Fixed-Price**: Must have very clear IN scope and OUT of scope (critical for fixed-price - this protects both parties) +- **Hourly**: Can be more flexible, but still define boundaries to prevent misunderstandings +- **Retainer**: Define what types of work are included in retainer vs. project work +- **Hybrid**: Define scope for each component separately + +**What to ask user**: +- "Let's be very clear about what's included and what's not. What work is explicitly IN scope for this contract?" +- "What work is explicitly OUT of scope? What would require a change order?" +- "Are there any assumptions about what's included that we should document?" + +--- + +## Next Step + +After building Scope of Work section: +β†’ `25-build-section-04-payment-terms.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/25-build-section-04-payment-terms.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/25-build-section-04-payment-terms.md new file mode 100644 index 00000000..b75ce457 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/25-build-section-04-payment-terms.md @@ -0,0 +1,81 @@ +# Substep 25: Build Section 4 - Our Commitment & Payment Terms + +**Purpose**: Build payment terms section tailored to business model + +--- + +## Instruction + +**Section 4: Our Commitment & Payment Terms** + +**Background**: Financial commitment needed and payment structure - tailored to business model + +**What it does**: States costs, payment schedule, and payment terms based on selected business model + +**Purpose**: Clear financial expectations - transparency builds trust + +**Why this matters**: +- Protects supplier from non-payment risk +- Ensures client commits financially to the project +- Provides cash flow for supplier to deliver quality work +- Prevents disputes about payment timing + +**Adapt based on business model**: + +**If Fixed-Price Project**: +- **User options for payment structure**: + - **Upfront payment** (recommended): + - **50% upfront, 50% on completion**: Fair split, supplier gets commitment, client retains leverage + - **100% upfront**: Full commitment, supplier assumes all risk, client gets best price + - **30% upfront, 70% on completion**: Lower upfront, more risk for supplier + - **Milestone payments**: Payments tied to specific deliverables or project phases + - **Payment on completion**: All payment at end (risky for supplier, not recommended) +- **Why upfront payment is fair**: + - **Supplier assumes risk**: In fixed-price contracts, supplier commits to deliver for a set price regardless of actual costs + - **Cost overruns are supplier's problem**: If work takes longer or costs more, supplier absorbs the loss + - **Client gets price certainty**: Client knows exact cost upfront + - **Upfront payment shows commitment**: Demonstrates client is serious about the project + - **Enables quality delivery**: Supplier can invest in resources, tools, and team needed to deliver +- **What to ask user**: + - "For fixed-price contracts, upfront payment is fair since you're assuming the risk. Would you like 50% upfront and 50% on completion, or 100% upfront?" + - "Upfront payment protects both parties - you show commitment, and I can deliver quality work without cash flow worries." +- **Content**: Total project price, payment schedule, payment method, due dates, late payment terms + +**If Hourly/Time-Based**: +- **Payment structure**: + - **Billing frequency**: {{billing_frequency}} (e.g., weekly, bi-weekly, monthly) + - **Payment terms**: {{payment_terms}} (e.g., Net 15, Net 30) + - **Time tracking**: {{time_tracking_method}} (detailed timesheets required) + - **Invoice format**: {{invoice_format}} (itemized by date, hours, description) +- **What to ask user**: + - "How often would you like to be invoiced? Weekly, bi-weekly, or monthly?" + - "What payment terms work for you? Net 15 or Net 30?" +- **Content**: Hourly rate, billing frequency, payment terms, time tracking requirements + +**If Retainer**: +- **Payment structure**: + - **Monthly retainer**: {{monthly_retainer_amount}} due {{retainer_due_date}} (e.g., "on the 1st of each month") + - **Minimum hours**: {{minimum_hours_per_month}} hours included + - **Overage billing**: {{overage_billing}} (e.g., "billed monthly for hours beyond minimum") + - **Hour rollover**: {{hour_rollover_policy}} +- **What to ask user**: + - "When should the retainer be due each month? (e.g., 1st of the month)" + - "How should we handle unused hours? Do they expire or can some roll over?" + - "How should overage hours be billed? Monthly or as they occur?" +- **Content**: Monthly retainer amount, due date, minimum hours, overage rate, rollover policy + +**If Hybrid**: +- **Payment structure**: Combine payment terms from each component +- **Content**: Payment terms for each component clearly separated + +**Content**: Pull from alignment document (our_commitment), add payment schedule and terms based on business model + +**Fairness note**: Tailor to business model - for fixed-price emphasize upfront payment fairness, for retainer emphasize commitment and availability + +--- + +## Next Step + +After building payment terms: +β†’ `26-build-section-05-timeline.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/26-build-section-05-timeline.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/26-build-section-05-timeline.md new file mode 100644 index 00000000..341cd4f7 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/26-build-section-05-timeline.md @@ -0,0 +1,31 @@ +# Substep 26: Build Section 5 - Timeline + +**Purpose**: Build the Timeline section + +--- + +## Instruction + +**Section 5: Timeline** + +**Background**: When work will happen + +**What it does**: Defines schedule and milestones + +**Purpose**: Sets expectations for delivery dates + +**Content**: Extract from Work Plan or Investment Required from alignment document + +**What to include**: +- Key milestones +- Delivery dates +- Critical deadlines + +--- + +## Next Step + +After building Timeline: +β†’ `27-build-section-06-availability.md` (same folder - if Retainer model) +β†’ `28-build-section-07-confidentiality.md` (same folder - if not Retainer) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/27-build-section-06-availability.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/27-build-section-06-availability.md new file mode 100644 index 00000000..6efad679 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/27-build-section-06-availability.md @@ -0,0 +1,38 @@ +# Substep 27: Build Section 6 - Availability (Retainer Only) + +**Purpose**: Build Availability section for retainer contracts + +--- + +## Instruction + +**Section 6: Availability** (Only for Retainer model) + +**Background**: Defines when contractor is available for retainer work + +**What it does**: Sets expectations for response times, working hours, availability windows + +**Purpose**: Ensures client knows when they can expect work to be done + +**Why this matters**: +- Retainer clients need to know when contractor is available +- Sets realistic expectations for response times +- Prevents misunderstandings about availability + +**What to include**: +- **Business hours**: {{business_hours}} (e.g., "Monday-Friday, 9am-5pm EST") +- **Response time**: {{response_time}} (e.g., "2-3 business days for non-urgent requests") +- **Availability for meetings**: {{meeting_availability}} (e.g., "Available for scheduled calls during business hours") +- **Urgent requests**: {{urgent_request_policy}} (e.g., "Urgent requests may incur additional fees") + +**What to ask user**: "What availability expectations do you have? What response times work for you?" + +**Content**: Define availability expectations based on retainer agreement + +--- + +## Next Step + +After building Availability (if applicable): +β†’ `28-build-section-07-confidentiality.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/28-build-section-07-confidentiality.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/28-build-section-07-confidentiality.md new file mode 100644 index 00000000..61039e5c --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/28-build-section-07-confidentiality.md @@ -0,0 +1,42 @@ +# Substep 28: Build Section 7 - Confidentiality Clause + +**Purpose**: Build the Confidentiality clause + +--- + +## Instruction + +**Section 7: Confidentiality Clause** + +**Background**: Protects sensitive information shared during the project + +**What it does**: Requires both parties to keep project information confidential + +**Purpose**: Protects proprietary information, business strategies, and trade secrets - mutual protection builds trust + +**Why this matters**: +- Without this clause, either party could share sensitive project details with competitors +- Protects your business secrets, customer data, and strategic plans +- Builds trust by showing mutual respect for confidentiality +- Prevents legal disputes about information sharing + +**User options**: +- **Standard confidentiality** (recommended): Both parties keep all project information confidential +- **Limited confidentiality**: Only specific information types are confidential (e.g., financial data only) +- **One-way confidentiality**: Only one party is bound (rare, usually for public projects) +- **Duration**: How long confidentiality lasts (typically 2-5 years, or indefinitely for trade secrets) +- **Exceptions**: What's NOT confidential (public info, independently developed, required by law) + +**What to ask user**: "Do you have sensitive information that needs protection? How long should confidentiality last? (Typically 2-5 years)" + +**Content**: Standard confidentiality language (see template), customized based on user choices + +**Fairness note**: "This protects both parties equally - your sensitive info stays private, and I'm protected too" + +--- + +## Next Step + +After building Confidentiality: +β†’ `29-build-section-08-not-to-exceed.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/29-build-section-08-not-to-exceed.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/29-build-section-08-not-to-exceed.md new file mode 100644 index 00000000..d9a2e62b --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/29-build-section-08-not-to-exceed.md @@ -0,0 +1,54 @@ +# Substep 29: Build Section 8 - Not to Exceed Clause (Conditional) + +**Purpose**: Build Not-to-Exceed clause based on business model + +--- + +## Instruction + +**Section 8: Not to Exceed Clause** (Conditional - applies to Fixed-Price and optionally Hourly) + +**Background**: Sets maximum budget cap - only applies to certain business models + +**What it does**: States that costs will not exceed a specified amount without approval + +**Purpose**: +- Protects both parties from unexpected cost overruns +- **Prevents scope creep** - Any work beyond original scope requires approval +- Fair budget protection for everyone + +**When this section applies**: +- **Fixed-Price Project**: βœ… REQUIRED - This is the project price cap +- **Hourly/Time-Based**: ⚠️ OPTIONAL - Can include optional not-to-exceed cap if desired +- **Retainer**: ❌ NOT APPLICABLE - Retainer already has monthly cap +- **Hybrid**: ⚠️ CONDITIONAL - May apply to fixed-price components + +**If applicable, include**: +- **Why this matters**: + - Without this clause, costs could spiral out of control (fixed-price) + - Protects your budget from unexpected expenses + - Prevents scope creep by requiring approval for additional work + - Ensures contractor gets paid fairly for extra work through change orders + - Creates clear boundaries that prevent misunderstandings +- **User options**: + - **Fixed budget cap**: Hard limit that cannot be exceeded without new agreement + - **Soft cap with buffer**: Cap with small percentage buffer (e.g., 10%) for minor overruns + - **Cap with change order process**: Cap exists, but change orders can adjust it with approval +- **What to ask user**: + - **For Fixed-Price**: "The not-to-exceed amount is [total_amount]. This protects both parties from cost overruns. Any work beyond the original scope requires a change order." + - **For Hourly**: "Would you like to set an optional not-to-exceed cap? This protects your budget while still allowing flexibility." +- **Content**: + - **Fixed-Price**: Not-to-exceed = total project price + - **Hourly**: Optional cap amount if user wants one +- **Fairness note**: "This protects your budget while ensuring I get paid fairly for additional work if needed through the change order process" + +--- + +## Decision Point + +**If section applies**: +β†’ `30-build-section-09-work-initiation.md` (same folder) + +**If section doesn't apply** (Retainer): +β†’ `30-build-section-09-work-initiation.md` (same folder - skip this section) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/30-build-section-09-work-initiation.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/30-build-section-09-work-initiation.md new file mode 100644 index 00000000..96b3fb11 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/30-build-section-09-work-initiation.md @@ -0,0 +1,41 @@ +# Substep 30: Build Section 9 - Work Initiation + +**Purpose**: Build the Work Initiation section + +--- + +## Instruction + +**Section 9: Work Initiation** + +**Background**: Specifies exactly when work can begin + +**What it does**: Defines start date or conditions before work begins + +**Purpose**: Prevents unauthorized work, establishes timeline, protects both parties + +**Why this matters**: +- Without this clause, work might begin before contract is fully executed +- Prevents disputes about when work actually started +- Protects contractor from doing unpaid work +- Protects client from unauthorized charges +- Establishes clear timeline expectations + +**User options**: +- **Upon contract signing**: Work begins immediately when both parties sign +- **Specific date**: Work begins on a set calendar date +- **After initial payment**: Work begins when first payment/deposit is received +- **After written notice**: Work begins when client sends written authorization +- **Conditional start**: Work begins after specific conditions are met (e.g., materials received, approvals obtained) + +**What to ask user**: "When should work begin? Options: immediately upon signing, a specific date, after initial payment, or when you give written notice?" + +**Content**: Ask user when work should begin, document the chosen option clearly + +--- + +## Next Step + +After building Work Initiation: +β†’ `31-build-section-10-terms-and-conditions.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/31-build-section-10-terms-and-conditions.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/31-build-section-10-terms-and-conditions.md new file mode 100644 index 00000000..081932cb --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/31-build-section-10-terms-and-conditions.md @@ -0,0 +1,38 @@ +# Substep 31: Build Section 10 - Terms and Conditions + +**Purpose**: Build the Terms and Conditions section + +--- + +## Instruction + +**Section 10: Terms and Conditions** + +**Background**: Legal framework for the agreement + +**What it does**: Covers changes, termination, IP ownership, dispute resolution, jurisdiction + +**Purpose**: Protects both parties legally + +**Key sections to include**: +- **Changes and Modifications**: How scope changes are handled (change orders) +- **Termination**: How to exit the contract (fair notice, payment for work done) +- **Intellectual Property**: Who owns what (usually client owns deliverables upon payment) +- **Dispute Resolution**: How conflicts are handled (mediation/arbitration/litigation) +- **Governing Law and Jurisdiction**: Which laws apply and where legal proceedings take place +- **Contract Language**: Language of the contract + +**Content**: Standard terms including governing law and jurisdiction (see template) + +**What to ask user**: +- "Which jurisdiction's laws should govern this contract? (e.g., 'State of California, USA', 'England and Wales')" +- "What language should this contract be in? (e.g., English, Spanish, French)" +- "If the contract is translated, which version should be the official one?" + +--- + +## Next Step + +After building Terms and Conditions: +β†’ `32-build-section-11-approval.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/32-build-section-11-approval.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/32-build-section-11-approval.md new file mode 100644 index 00000000..c8c1c004 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/32-build-section-11-approval.md @@ -0,0 +1,36 @@ +# Substep 32: Build Section 11 - Approval + +**Purpose**: Build the Approval section with signature lines + +--- + +## Instruction + +**Section 11: Approval** + +**Background**: Formal signoff + +**What it does**: Signature lines for both parties + +**Purpose**: Makes the contract legally binding + +**Content**: +- Client and contractor names +- Signature lines +- Date fields + +**For Project Contract**: +- Client signature +- Contractor signature + +**For Service Agreement**: +- Client/Owner signature +- Service Provider signature + +--- + +## Next Step + +After building Approval section: +β†’ `33-finalize-contract.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/33-finalize-contract.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/33-finalize-contract.md new file mode 100644 index 00000000..23c7f68d --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/05-build-contract/33-finalize-contract.md @@ -0,0 +1,40 @@ +# Substep 33: Finalize Contract + +**Purpose**: Finalize the contract document and present it + +--- + +## Instruction + +**After building all sections**: + +1. **Review the contract**: "I've built your contract section by section. Let me review it with you..." + +2. **Present the contract**: "Your contract is ready at `docs/1-project-brief/contract.md` (or `service-agreement.md`)." + +3. **Explain next steps**: + - "Review the contract thoroughly" + - "Both parties should sign before work begins" + - "Once signed, we can proceed to the Project Brief workflow" + +4. **Ask**: "Does everything look good? Any adjustments needed before signing?" + +--- + +## After Contract is Signed + +**Once contract is signed**: +- βœ… Alignment achieved +- βœ… Commitment secured +- βœ… Legal protection in place +- βœ… Ready to proceed to Project Brief + +**Next**: Full Project Brief workflow +β†’ `src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md` + +--- + +## State Update + +Update frontmatter of contract file with completion status. + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/34-build-internal-signoff.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/34-build-internal-signoff.md new file mode 100644 index 00000000..43b136bb --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/34-build-internal-signoff.md @@ -0,0 +1,65 @@ +# Substep 34: Build Internal Signoff Document + +**Purpose**: Build internal signoff document (alternative to external contract) + +--- + +## Instruction + +**For Internal Signoff Document**: + +**Focus areas** (not detailed scope/hours): +- Goals and success metrics +- Budget estimates +- Ownership and responsibility +- Approval workflow +- Timeline and milestones + +**Section 1: Project Overview** +- The Realization +- Recommended Solution + +**Section 2: Goals and Success Metrics** +- What we're trying to accomplish +- Success metrics +- How we'll measure success +- Key performance indicators (KPIs) + +**Section 3: Budget and Resources** +- Budget allocation (total budget estimate) +- Budget breakdown (if applicable) +- Resources needed (high-level) +- Not-to-exceed budget cap (if applicable) + +**Section 4: Ownership and Responsibility** +- Project Owner +- Process Owner +- Key Stakeholders +- Decision-Making Authority + +**Section 5: Approval and Sign-Off** +- Who needs to approve +- Approval stages +- Sign-off process +- Timeline for approval + +**Section 6: Timeline and Milestones** +- Key milestones +- Delivery dates +- Critical deadlines + +**Section 7: Optional Sections** +- Risks and considerations (optional) +- Confidentiality (optional) +- The Path Forward (optional - high-level overview) + +**Company Signoff Format (Optional)**: +- If user has existing company format, ask: "Do you have an existing company signoff document format? You can upload it and I'll adapt it to match your format." + +--- + +## Next Step + +After building internal signoff document: +β†’ `35-finalize-signoff.md` (same folder) + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/35-finalize-signoff.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/35-finalize-signoff.md new file mode 100644 index 00000000..8c4459f8 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/06-build-signoff-internal/35-finalize-signoff.md @@ -0,0 +1,39 @@ +# Substep 35: Finalize Signoff Document + +**Purpose**: Finalize the signoff document and present it + +--- + +## Instruction + +**After building the signoff document**: + +1. **Present the signoff**: "Your signoff document is ready at `docs/1-project-brief/signoff.md`." + +2. **Explain next steps**: + - "Share with stakeholders for approval" + - "Follow your company's approval workflow" + - "Get all required signatures" + - "Once approved, we can proceed to the Project Brief workflow" + +3. **Ask**: "Does everything look good? Any adjustments needed before seeking approval?" + +--- + +## After Signoff Document is Approved + +**Once signoff document is approved**: +- βœ… Internal alignment achieved +- βœ… Budget/resources committed +- βœ… Stakeholders on board +- βœ… Ready to proceed to Project Brief + +**Next**: Full Project Brief workflow +β†’ `src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md` + +--- + +## State Update + +Update frontmatter of signoff file with completion status. + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/README.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/README.md new file mode 100644 index 00000000..0482a7e6 --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/README.md @@ -0,0 +1,81 @@ +# Alignment & Signoff Substeps + +**Purpose**: Small, sequential instruction files for the Alignment & Signoff workflow + +--- + +## Overview + +These substeps break down the Alignment & Signoff workflow into small, focused steps that agents can follow sequentially. Each substep file contains a single, clear action. + +--- + +## Instruction Flow + +### Phase 1: Start & Understand (`01-start-understand/`) +1. `01-understand-situation.md` - Clarify user's situation +2. `02-determine-if-needed.md` - Determine if alignment & signoff is needed +3. `03-offer-extract-communications.md` - Offer to extract from communications +4. `04-extract-info.md` - Extract information (if provided) +5. `05-detect-starting-point.md` - Detect where user wants to start + +### Phase 2: Explore Sections (`02-explore-sections/`) - Flexible Order +6. `06-explore-realization.md` - Explore The Realization +7. `07-explore-solution.md` - Explore Solution (if starting with solution) +8. `08-explore-why-it-matters.md` - Explore Why It Matters +9. `09-explore-how-we-see-it-working.md` - Explore How We See It Working +10. `10-explore-paths-we-explored.md` - Explore Paths We Explored +11. `11-explore-recommended-solution.md` - Explore Recommended Solution +12. `12-explore-path-forward.md` - Explore The Path Forward +13. `13-explore-value-we-create.md` - Explore The Value We'll Create +14. `14-explore-cost-of-inaction.md` - Explore Cost of Inaction +15. `15-explore-our-commitment.md` - Explore Our Commitment +16. `16-explore-summary.md` - Explore Summary + +### Phase 3: Synthesize & Present (`03-synthesize-present/`) +17. `17-reflect-back.md` - Reflect back what you've captured +18. `18-synthesize-document.md` - Synthesize into alignment document +19. `19-present-for-approval.md` - Present for stakeholder approval + +### Phase 4: Generate Signoff (`04-generate-signoff/`) - After Acceptance +20. `20-offer-signoff-document.md` - Offer to generate signoff document +21. `21-determine-business-model.md` - Determine business model (external contracts) + +### Phase 5: Build External Contract (`05-build-contract/`) - If Selected +22. `22-build-section-01-project-overview.md` - Build Project Overview +23. `23-build-section-02-business-model.md` - Build Business Model +24. `24-build-section-03-scope-of-work.md` - Build Scope of Work (IN/OUT scope) +25. `25-build-section-04-payment-terms.md` - Build Payment Terms +26. `26-build-section-05-timeline.md` - Build Timeline +27. `27-build-section-06-availability.md` - Build Availability (Retainer only) +28. `28-build-section-07-confidentiality.md` - Build Confidentiality +29. `29-build-section-08-not-to-exceed.md` - Build Not-to-Exceed (Conditional) +30. `30-build-section-09-work-initiation.md` - Build Work Initiation +31. `31-build-section-10-terms-and-conditions.md` - Build Terms and Conditions +32. `32-build-section-11-approval.md` - Build Approval +33. `33-finalize-contract.md` - Finalize contract + +### Phase 6: Build Internal Signoff (`06-build-signoff-internal/`) - If Selected +34. `34-build-internal-signoff.md` - Build Internal Signoff Document +35. `35-finalize-signoff.md` - Finalize signoff document + +--- + +## Usage + +**For agents**: Follow these substeps sequentially. Each file contains a single, focused instruction with clear next steps. + +**Decision points**: Some substeps have decision points that route to different next steps based on user choices. + +**Flexible flow**: Section exploration (substeps 06-16) can be done in any order based on user's natural thinking flow. + +--- + +## Key Principles + +- **One instruction per file**: Each substep focuses on a single action +- **Clear next steps**: Each file specifies what comes next +- **Decision points**: Route to different paths based on user choices +- **Reference larger guides**: Substeps reference section-guide.md for detailed guidance +- **Linear flow**: Follow sequentially, but allow flexibility in section exploration order + diff --git a/src/modules/wds/workflows/1-project-brief/alignment-signoff/workflow.md b/src/modules/wds/workflows/1-project-brief/alignment-signoff/workflow.md new file mode 100644 index 00000000..01f5c73f --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/alignment-signoff/workflow.md @@ -0,0 +1,150 @@ +# Alignment & Signoff Workflow + +**Purpose**: Create alignment around your idea before starting the project + +**When to Use**: +- βœ… **Use Alignment & Signoff** if you need alignment with others: + - Consultant proposing a solution to a client + - Business hiring consultants/suppliers to build software + - Manager/employee seeking approval for an internal project + - Any scenario where stakeholders need to agree before starting + +- ⏭️ **Skip Alignment & Signoff** if you're doing it yourself: + - You have full autonomy and don't need approval + - Go straight to the Project Brief workflow + +**Why WDS Exists**: You're building systems that make the world a better place. When you need others involved, you need alignment first. + +--- + +## Workflow Overview + +**The Challenge**: When others are involved, you need alignment on: +- **The Idea** - What are we building? +- **Why** - Why should it be done? +- **What** - What does it contain? +- **How** - How will it be executed? +- **Budget** - What resources are needed? +- **Commitment** - What are we willing to commit to make it happen? + +**The Solution**: The alignment & signoff workflow helps you get all your ducks in a row through 10 sections that ensure everyone understands and agrees on these critical elements. + +**Key Features**: +- Makes the case for why the project matters +- Presents your idea in the best possible light +- Gets stakeholder buy-in before starting detailed work +- Can be read in 2-3 minutes +- **Allows for negotiation and iteration** - refine until everyone is on board + +**Key Principle**: WDS helps with alignment - getting everyone on the same page. The alignment phase is collaborative and iterative. Once approved, the signoff document formalizes that commitment. + +**The Journey**: + +1. **Create the Alignment Document** - Work through 10 sections to align on Idea, Why, What, How, Budget, and Commitment +2. **Share & Negotiate** - Present to stakeholders, gather feedback, iterate until everyone is on board +3. **Get Acceptance** - Once everyone agrees, you have alignment +4. **Secure Commitment** - Generate signoff document (contract, service agreement, or internal signoff) to formalize the commitment +5. **Proceed to Project Brief** - With alignment and commitment secured, dive into detailed planning + +**Different User Scenarios**: +- **Consultant proposing to client** β†’ Alignment Document β†’ Negotiation β†’ Acceptance β†’ Project Contract β†’ Project Brief +- **Business hiring consultants/suppliers** β†’ Alignment Document β†’ Negotiation β†’ Acceptance β†’ Service Agreement β†’ Project Brief +- **Manager/employee in company** β†’ Alignment Document β†’ Negotiation β†’ Acceptance β†’ Signoff Document β†’ Project Brief +- **Doing it yourself** β†’ Skip alignment & signoff, go straight to Project Brief + +**WDS Has Your Back**: We help you set up everything you need - from initial alignment through formal commitment, ensuring everyone is on the same page before work begins. + +**After pitch acceptance and signoff document**, you have: +- βœ… Alignment on the idea, why, what, how, budget, and commitment +- βœ… Formal commitment from all stakeholders +- βœ… Clear foundation for detailed project planning + +**Project initiation is complete**. Proceed to the full Project Brief workflow to dive into the detailed strategic planning. + +--- + +## Step-by-Step Process + +**Who handles this**: **Saga WDS Analyst Agent** - She specializes in helping you articulate your vision and create compelling alignment documents that get everyone aligned. + +**Getting started**: +- **You can start with either Mimir or Saga**: + - **Mimir WDS Orchestrator** - Great if you're new, unsure, or want emotional support and gentle guidance first. He'll help clarify your situation and can connect you with Saga. + - **Saga WDS Analyst Agent** - Perfect if you know you need alignment & signoff or want to go directly to the expert. She's professional, direct, and efficient - she can handle everything from understanding your situation to creating the alignment document and getting signoff. She's nice but plays no games - focused on getting things done. + +**Both can help**: Mimir provides emotional support and gentle coaching, Saga provides professional, efficient alignment & signoff creation. + +**Start here**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/01-start-understand/01-understand-situation.md` + +**Substeps Available**: +- **Full substep flow**: `src/modules/wds/workflows/1-project-brief/alignment-signoff/substeps/README.md` +- **35 substeps** organized into 6 phase folders + +**Step Files** (main workflow steps): +- `src/modules/wds/workflows/1-project-brief/alignment-signoff/steps/step-01-start.md` (references substeps) + +**Workflow Phases** (organized in subfolders): +1. **Start & Understand** (`01-start-understand/`) - substeps 01-05 +2. **Explore Sections** (`02-explore-sections/`) - substeps 06-16 (flexible order) +3. **Synthesize & Present** (`03-synthesize-present/`) - substeps 17-19 +4. **Generate Signoff** (`04-generate-signoff/`) - substeps 20-21 +5. **Build Contract** (`05-build-contract/`) - substeps 22-33 +6. **Build Internal Signoff** (`06-build-signoff-internal/`) - substeps 34-35 + +**Important**: The alignment phase allows for negotiation and iteration. You can update and refine the alignment document until everyone is on board. The signoff document (contract/service agreement/signoff) is generated AFTER the alignment document is accepted, ensuring everyone is aligned before formalizing the commitment. + +**After approval**: Proceed to full Project Brief workflow + +--- + +## Alignment Document Structure + +The alignment document (pitch) covers 10 sections: + +1. **The Realization** - What we've realized needs attention +2. **Why It Matters** - Why this matters and who we help +3. **How We See It Working** - Brief overview of the solution approach +4. **Paths We Explored** - 2-3 solution options we considered +5. **Recommended Solution** - Preferred approach and why +6. **The Path Forward** - How the work will be done (WDS phases and practical approach) +7. **The Value We'll Create** - What happens if we DO build this +8. **Cost of Inaction** - What happens if we DON'T build this +9. **Our Commitment** - Resources needed and potential risks +10. **Summary** - Summary of key points + +--- + +## Outputs + +**Alignment Document (Pitch)**: `docs/1-project-brief/pitch.md` (Always generated) +- Clear, brief, readable in 2-3 minutes +- Makes the case for the project +- Share with clients/stakeholders for approval + +**Signoff Document** (Generated AFTER alignment acceptance): +- **Project Contract**: `docs/1-project-brief/contract.md` - For consultant β†’ client (after client accepts alignment document) +- **Service Agreement**: `docs/1-project-brief/service-agreement.md` - For business β†’ suppliers (after suppliers accept alignment document) +- **Signoff Document**: `docs/1-project-brief/signoff.md` - For internal company projects (after stakeholders accept alignment document) +- Based on the accepted alignment document, includes scope, investment, timeline, deliverables, and commitment +- Formalizes the commitment - everyone has signed off on the idea, why, what, how, budget, and commitment +- Generated after alignment acceptance to secure commitment before starting work + +--- + +## After Alignment Acceptance and Signoff Document + +**Project Initiation Complete** βœ… + +Once the alignment document is accepted and the signoff document is finalized: +- **Alignment achieved** - Everyone agrees on the idea, why, what, how, budget, and commitment +- **Commitment secured** - Formal signoff from all stakeholders +- **Foundation established** - Clear understanding of what will be built and how +- Ready to proceed to detailed strategic planning + +**Next**: Full Project Brief workflow +β†’ `src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md` + +**Remember**: The alignment phase allows for negotiation and iteration. You can update the alignment document until everyone is on board. The signoff document is generated AFTER acceptance to formalize the commitment, ensuring everyone is aligned before starting the actual project work. + +**WDS Has Your Back**: We've helped you get alignment and secure commitment. Now you're ready to build something that makes the world a better place! πŸš€ + diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-00-pitch.md b/src/modules/wds/workflows/1-project-brief/complete/steps/step-00-pitch.md deleted file mode 100644 index a036e8a1..00000000 --- a/src/modules/wds/workflows/1-project-brief/complete/steps/step-00-pitch.md +++ /dev/null @@ -1,117 +0,0 @@ -# Step 0: Create Project Pitch - -## Purpose - -Establish the foundational case for why this project matters and should be built before diving into detailed strategic planning. - -## Context for Agent - -You are helping the user create a compelling pitch that makes the case for the project's existence. This pitch serves as the foundation that justifies investing time and resources into the project brief and subsequent design work. Think of this as the "elevator pitch" or "business case" that answers: "Why should we build this?" - -## Key Elements - -This step establishes the strategic justification for the project by exploring: - -- **Problem/Opportunity** - What problem are we solving or opportunity are we capturing? -- **Why Now?** - What makes this the right time to pursue this? -- **Proposed Solution** - High-level approach (detailed solution comes later) -- **Why This Will Work** - Credibility, feasibility, unique advantages -- **Expected Impact** - What outcomes will this create? -- **Investment Required** - What resources are needed? -- **Call to Action** - Decision point to proceed - -## Instructions - -1. **Introduce the pitch concept** - - Explain that before we dive into detailed strategic planning, we need to establish why this project matters - - Frame this as creating the "business case" or "elevator pitch" for the project - - Set expectation: This will be used to justify the project and guide decision-making - -2. **Explore the Problem/Opportunity** - - "What problem are we solving, or what opportunity are we capturing?" - - "Who is experiencing this problem or missing this opportunity?" - - "What happens if we don't address this?" - - Listen for: Pain points, market gaps, unmet needs, emerging trends - -3. **Understand Why Now** - - "What makes this the right time to pursue this project?" - - "What has changed that makes this urgent or timely?" - - Listen for: Market shifts, technology readiness, competitive threats, timing factors - -4. **Capture Proposed Solution (High-Level)** - - "At a high level, what kind of solution are we proposing?" - - "What's the general approach we're taking?" - - Keep this high-level - detailed solution design comes later - - Listen for: Solution type, general approach, key capabilities - -5. **Explore Why This Will Work** - - "What gives us confidence this will succeed?" - - "What unique advantages or capabilities do we have?" - - "What makes us the right team/approach for this?" - - Listen for: Unique assets, expertise, market position, competitive advantages - -6. **Define Expected Impact** - - "What outcomes are we expecting from this project?" - - "How will we measure success?" - - "What changes will this create?" - - Listen for: Business outcomes, user benefits, market impact, metrics - -7. **Clarify Investment Required** - - "What resources will this project require?" - - "What's the scope of investment we're considering?" - - Keep this at a high level - detailed planning comes later - - Listen for: Time, budget, team, technology, dependencies - -8. **Crystallize the Pitch** - - Synthesize all elements into a cohesive pitch statement - - Help craft a compelling narrative that ties everything together - - Use collaborative language: "What I'm hearing is..." or "It sounds like..." - - Ask: "Does this capture why this project matters and should be built?" - -## Pitch Framework (Optional Guide) - -If user needs structure, you can offer this framework: - -``` -**The Problem/Opportunity:** -[What we're addressing] - -**Why Now:** -[What makes this timely] - -**Our Proposed Solution:** -[High-level approach] - -**Why This Will Work:** -[Our unique advantages] - -**Expected Impact:** -[Outcomes we'll create] - -**Investment Required:** -[Resources needed] - -**Decision Point:** -[Why we should proceed] -``` - -## Next Step - -After capturing the pitch, proceed to step-01-init.md to begin the detailed Project Brief workflow. - -## State Update - -Update frontmatter of output file: - -```yaml -stepsCompleted: ['step-00-pitch.md'] -pitch: - problem_opportunity: '[captured problem/opportunity]' - why_now: '[captured timing rationale]' - proposed_solution: '[high-level solution approach]' - why_this_will_work: '[credibility/feasibility factors]' - expected_impact: '[expected outcomes]' - investment_required: '[resources needed]' - pitch_statement: '[synthesized pitch narrative]' -``` - diff --git a/src/modules/wds/workflows/1-project-brief/complete/workflow.md b/src/modules/wds/workflows/1-project-brief/complete/workflow.md index 2b6f6307..4047f985 100644 --- a/src/modules/wds/workflows/1-project-brief/complete/workflow.md +++ b/src/modules/wds/workflows/1-project-brief/complete/workflow.md @@ -55,6 +55,6 @@ Load and read full config from {project-root}/{bmad_folder}/wds/config.yaml and ### 2. First Step EXECUTION -Load, read full file and then execute `{project-root}/{bmad_folder}/wds/workflows/1-project-brief/complete/steps/step-00-pitch.md` to begin workflow. +Load, read full file and then execute `{project-root}/{bmad_folder}/wds/workflows/1-project-brief/complete/steps/step-01-init.md` to begin workflow. -**Note:** The pitch (step-00) establishes the foundational case for why the project matters and should be built. This is a prerequisite before proceeding to detailed strategic planning (step-01 and beyond). +**Note:** Alignment & Signoff is now a separate, optional workflow. If you need stakeholder approval before starting, use the alignment & signoff workflow first: `{project-root}/{bmad_folder}/wds/workflows/1-project-brief/alignment-signoff/workflow.md` diff --git a/src/modules/wds/workflows/1-project-brief/complete/instructions.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/instructions.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/instructions.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/instructions.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/project-brief.template.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/project-brief.template.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/project-brief.template.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/project-brief.template.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-01-init.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-01-init.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-01-init.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-01-init.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-02-vision.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-02-vision.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-02-vision.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-02-vision.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-03-positioning.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-03-positioning.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-03-positioning.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-03-positioning.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-04-business-model.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-04-business-model.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-04-business-model.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-04-business-model.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-05-business-customers.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-05-business-customers.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-05-business-customers.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-05-business-customers.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-06-target-users.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-06-target-users.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-06-target-users.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-06-target-users.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-07-success-criteria.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-07-success-criteria.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-07-success-criteria.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-07-success-criteria.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-08-competitive-landscape.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-08-competitive-landscape.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-08-competitive-landscape.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-08-competitive-landscape.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-09-constraints.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-09-constraints.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-09-constraints.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-09-constraints.md diff --git a/src/modules/wds/workflows/1-project-brief/complete/steps/step-10-synthesize.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-10-synthesize.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/complete/steps/step-10-synthesize.md rename to src/modules/wds/workflows/1-project-brief/project-brief/complete/steps/step-10-synthesize.md diff --git a/src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md b/src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md new file mode 100644 index 00000000..643ba30c --- /dev/null +++ b/src/modules/wds/workflows/1-project-brief/project-brief/complete/workflow.md @@ -0,0 +1,60 @@ +--- +name: Product Brief Workflow +description: Create comprehensive product briefs through collaborative step-by-step discovery +web_bundle: true +--- + +# Product Brief Workflow + +**Goal:** Create comprehensive product briefs through collaborative step-by-step discovery + +**Your Role:** In addition to your name, communication_style, and persona, you are also Saga, a product-focused Business Analyst collaborating with an expert peer. This is a partnership, not a client-vendor relationship. You bring structured thinking and facilitation skills, while user brings domain expertise and product vision. Work together as equals. + +--- + +## WORKFLOW ARCHITECTURE + +This uses **step-file architecture** for disciplined execution: + +### Core Principles + +- **Micro-file Design**: Each step is a self contained instruction file that is a part of an overall workflow that must be followed exactly +- **Just-In-Time Loading**: Only current step file is in memory - never load future step files until told to do so +- **Sequential Enforcement**: Sequence within step files must be completed in order, no skipping or optimization allowed +- **State Tracking**: Document progress in output file frontmatter using `stepsCompleted` array when a workflow produces a document +- **Append-Only Building**: Build documents by appending content as directed to output file + +### Step Processing Rules + +1. **READ COMPLETELY**: Always read entire step file before taking any action +2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate +3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection +4. **CHECK CONTINUATION**: If step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue) +5. **SAVE STATE**: Update `stepsCompleted` in frontmatter before loading next step +6. **LOAD NEXT**: When directed, load, read entire file, then execute next step file + +### Critical Rules (NO EXCEPTIONS) + +- πŸ›‘ **NEVER** load multiple step files simultaneously +- πŸ“– **ALWAYS** read entire step file before execution +- 🚫 **NEVER** skip steps or optimize the sequence +- πŸ’Ύ **ALWAYS** update frontmatter of output files when writing final output for a specific step +- 🎯 **ALWAYS** follow the exact instructions in step file +- ⏸️ **ALWAYS** halt at menus and wait for user input +- πŸ“‹ **NEVER** create mental todo lists from future steps + +--- + +## INITIALIZATION SEQUENCE + +### 1. Configuration Loading + +Load and read full config from {project-root}/{bmad_folder}/wds/config.yaml and resolve: + +- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `user_skill_level` + +### 2. First Step EXECUTION + +Load, read full file and then execute `{project-root}/{bmad_folder}/wds/workflows/1-project-brief/project-brief/complete/steps/step-01-init.md` to begin workflow. + +**Note:** Alignment & Signoff is now a separate, optional workflow. If you need stakeholder approval before starting, use the alignment & signoff workflow first: `{project-root}/{bmad_folder}/wds/workflows/1-project-brief/alignment-signoff/workflow.md` diff --git a/src/modules/wds/workflows/1-project-brief/simplified/instructions.md b/src/modules/wds/workflows/1-project-brief/project-brief/simplified/instructions.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/simplified/instructions.md rename to src/modules/wds/workflows/1-project-brief/project-brief/simplified/instructions.md diff --git a/src/modules/wds/workflows/1-project-brief/simplified/simplified-brief.template.md b/src/modules/wds/workflows/1-project-brief/project-brief/simplified/simplified-brief.template.md similarity index 100% rename from src/modules/wds/workflows/1-project-brief/simplified/simplified-brief.template.md rename to src/modules/wds/workflows/1-project-brief/project-brief/simplified/simplified-brief.template.md diff --git a/src/modules/wds/workflows/1-project-brief/workflow.yaml b/src/modules/wds/workflows/1-project-brief/workflow.yaml index b638160d..4af397de 100644 --- a/src/modules/wds/workflows/1-project-brief/workflow.yaml +++ b/src/modules/wds/workflows/1-project-brief/workflow.yaml @@ -26,12 +26,12 @@ installed_path: "{project-root}/{bmad_folder}/wds/workflows/1-project-brief" # Route to appropriate workflow based on brief_level workflows: simplified: - instructions: "{installed_path}/simplified/instructions.md" - template: "{installed_path}/simplified/simplified-brief.template.md" + instructions: "{installed_path}/project-brief/simplified/instructions.md" + template: "{installed_path}/project-brief/simplified/simplified-brief.template.md" complete: - instructions: "{installed_path}/complete/workflow.md" - template: "{installed_path}/complete/project-brief.template.md" - steps: "{installed_path}/complete/steps" + instructions: "{installed_path}/project-brief/complete/workflow.md" + template: "{installed_path}/project-brief/complete/project-brief.template.md" + steps: "{installed_path}/project-brief/complete/steps" # Output configuration output_file: "{output_folder}/A-Product-Brief/project-brief.md" diff --git a/src/modules/wds/workflows/project-analysis/agent-domains/saga-domain.md b/src/modules/wds/workflows/project-analysis/agent-domains/saga-domain.md index e9157bde..8839cbd2 100644 --- a/src/modules/wds/workflows/project-analysis/agent-domains/saga-domain.md +++ b/src/modules/wds/workflows/project-analysis/agent-domains/saga-domain.md @@ -9,6 +9,32 @@ --- +## Pre-Phase 1: Alignment & Signoff + +**What I do**: + +- **Understand their situation** - Ask clarifying questions: Are they a consultant? Manager? Founder? Doing it themselves? +- **Help them determine if alignment & signoff is needed** - Do they need stakeholder alignment, or can they go straight to Project Brief? +- Help articulate your vision and idea +- Create compelling alignment documents (pitch) +- Get stakeholder alignment on idea, why, what, how, budget, and commitment +- Generate signoff documents (contracts, service agreements, signoffs) + +**My style**: Professional, direct, and efficient. I'm nice but I play no games - we're here to get things done. If they need emotional support, they can go to Mimir. I focus on clarity and results. + +**When to offer**: + +- User mentions needing stakeholder buy-in or approval +- User is a consultant proposing to client +- User is a business hiring suppliers/consultants +- User is a manager/employee seeking internal approval +- User asks "Do I need alignment?" or "How do I get approval?" +- Any scenario requiring alignment before project begins + +**I can handle the full experience** - from initial support and clarification through creating the alignment document and securing signoff. Users don't need to go through Mimir first, though Mimir can also help route them to me. + +--- + ## Phase 1: Product Brief **What I do**: @@ -23,6 +49,7 @@ - Phase 1 not started - Phase 1 in progress but incomplete - Product brief needs updates +- **After pitch is accepted** - proceed to Product Brief --- @@ -47,6 +74,8 @@ ## When to Stay (Continue in Same Conversation) +βœ… User asks about creating an alignment document +βœ… User needs stakeholder alignment & signoff βœ… User asks about Product Brief βœ… User wants to do Trigger Mapping βœ… User needs user research diff --git a/src/modules/wds/workflows/workflow-init/project-initiation-conversation.md b/src/modules/wds/workflows/workflow-init/project-initiation-conversation.md index 30dbe0e4..6404f6b7 100644 --- a/src/modules/wds/workflows/workflow-init/project-initiation-conversation.md +++ b/src/modules/wds/workflows/workflow-init/project-initiation-conversation.md @@ -7,10 +7,35 @@ --- +## Project Initiation Overview + +**Project Initiation consists of**: +1. **Alignment & Signoff** (optional) - Get stakeholder alignment and secure commitment before starting + - Location: `src/modules/wds/workflows/1-project-brief/alignment-signoff/workflow.md` + - After alignment acceptance β†’ **Project Initiation Complete** βœ… + - **Output**: `docs/1-project-brief/pitch.md` (alignment document) - Contains work plan and approach +2. **Product Brief** - Strategic foundation +3. **Project Outline** - Plan which phases to include (this workflow) + +--- + ## Overview After completing the Product Brief, capture the user's intentions for each WDS phase through individual, focused questions. Each phase gets its own micro-step conversation. +**Important**: If a pitch was created, **reference it** during this conversation. The pitch contains: +- Work plan (which phases will be used) +- Practical workflow approach +- Level of detail needed +- Handoff approach + +**Use the pitch to inform**: +- Which phases are needed (from Work Plan section) +- What deliveries are required (from Work Plan and Investment sections) +- Timeline and approach (from Work Plan section) + +**Note**: If a pitch was created and approved, project initiation is already complete. This outline conversation happens after the Product Brief to plan the detailed phases, but should reference the pitch for context. + **Important**: - WDS v6 methodology is default (numbered folders: 1-8) @@ -24,6 +49,16 @@ After completing the Product Brief, capture the user's intentions for each WDS p **Goal**: Let user know you'll ask about their intentions for different project phases. +**Before starting**: Check if pitch document exists at `docs/1-project-brief/pitch.md` + +**If pitch exists**: +- Read the Work Plan section from the pitch +- Use it to inform your questions +- Reference it: "I see in your pitch that you mentioned [work plan details]. Let's use that as a starting point..." + +**If no pitch exists**: +- Proceed with standard questions + **Outcome to capture**: User understands and is ready to continue. **What NOT to do**: @@ -31,6 +66,7 @@ After completing the Product Brief, capture the user's intentions for each WDS p - Don't ask about methodology (v6 is default) - Don't show long lists of options - Keep it brief and warm +- Don't ignore the pitch if it exists - use it as context --- @@ -38,16 +74,34 @@ After completing the Product Brief, capture the user's intentions for each WDS p **Goal**: Determine if user needs Trigger Mapping phase. +**Before asking**: Check pitch document for Work Plan section - does it mention Trigger Mapping or user research? + **Context for agent**: - Critical for customer-facing products - Can be skipped for: internal tools, technical products, known users +- **Focus**: Define value chains that connect business goals to user needs + +**What Trigger Mapping defines**: + +- **One main value chain** (required): + - One business goal + - One main user group + - A primary user goal + - User fear the solution will add value to +- **Secondary value chains** (optional): + - Additional business goals, user groups, user goals, and fears **Questions to understand**: - Is this customer-facing or internal? - Do you already know your target users? -- Do you need help defining personas? +- Do you need help defining value chains (business goals β†’ user groups β†’ user goals β†’ user fears)? +- Can you identify the main value chain, or do you need help exploring it? + +**If pitch mentions work plan**: +- Reference it: "In your pitch, you mentioned [work plan detail about user research/trigger mapping]. Does that still align with your thinking?" +- Use pitch context to inform questions **Outcome to capture**: @@ -56,13 +110,15 @@ phase_2_trigger_mapping: active: true/false intent: "[User's exact words about this phase]" skip_reason: '[If skipping, capture why]' + value_chains_approach: 'Main value chain + optional secondary chains' ``` **Examples of user answers**: - "This is an internal tool, we know our users" β†’ active: false -- "Yes, I need help understanding my customers" β†’ active: true -- "I have personas already, just need to document them" β†’ active: true +- "Yes, I need help understanding my customers and defining value chains" β†’ active: true +- "I have personas already, just need to document the value chains" β†’ active: true +- "I know the main value chain but want to explore secondary ones" β†’ active: true --- @@ -178,17 +234,28 @@ phase_5_design_system: **Goal**: Understand handoff/documentation needs. +**Before asking**: Check pitch document for: +- Work Plan section (handoff approach) +- Investment Required section (what resources are needed) +- Recommended Solution (what's being delivered) + **Context for agent**: - Idunn WDS PM Agent handles this - Packages design for handoff - Creates PRD, epics, stories +- **Pitch defines what deliveries are needed** - use it as foundation **Questions to understand**: - Handing off to developers? - Implementing yourself? - Need organized backlog? +- What deliverables are needed? (Reference pitch Work Plan if available) + +**If pitch exists**: +- Reference the Work Plan: "Your pitch mentioned [handoff approach]. Let's confirm what deliverables you'll need..." +- Use pitch to understand delivery requirements **Outcome to capture**: @@ -303,11 +370,18 @@ phase_8_ongoing_development: - Skip reasons - Current date and timestamps - Initial status: phase_1 = "in_progress", others = "not_started" +- **Reference to pitch**: If pitch exists, add reference: `pitch_document: "docs/1-project-brief/pitch.md"` + +**If pitch document exists**: +- Reference it in the outline: "This outline is informed by the project pitch" +- The pitch's Work Plan section should align with the phases marked active +- Use pitch to validate phase selections and delivery requirements **After creating file**: - Confirm to user: "Project outline created" - Explain: "Other agents will read this to understand your goals" +- If pitch exists: "This outline aligns with the work plan from your pitch" ---