@withmata/blueprints 0.2.0

package/blueprints/discovery/product-discovery/templates/archetype-template.md

@@ -0,0 +1,143 @@
+# Customer Archetype: [Name]
+
+> [One sentence that captures the essence of this archetype]
+
+## Their World
+
+### Where They Live & Work
+
+[Paint a picture. Not just "San Francisco" but the texture of their environment.]
+
+- **Geography**: [Cities/regions where they're concentrated. Be specific.]
+- **Work Environment**: [Office? Remote? Co-working? What does their desk look like? What's open on their screen?]
+- **Company Context**: [What kind of companies? What stage? What's the culture like?]
+
+### The Pressures They're Under
+
+[What forces are shaping their daily reality? What keeps them up at night?]
+
+- [Pressure 1 — be specific and visceral]
+- [Pressure 2]
+- [Pressure 3]
+
+### Their Culture & Community
+
+[Who do they talk to? What do they read? What do they believe?]
+
+- **Communities**: [Slack groups, subreddits, Twitter circles, conferences]
+- **Influencers**: [Who do they trust? What blogs/podcasts do they follow?]
+- **Shared Beliefs**: [What does this tribe believe about their craft?]
+
+### A Day in Their Life
+
+[Walk through a typical day. Make it specific enough to visualize.]
+
+---
+
+## Their Relationship to the Problem
+
+### The Problem in Their Words
+
+> "[A real quote that captures how they talk about this problem]"
+
+### What They're Trying to Achieve
+
+[Not features. The underlying goal in their life/career.]
+
+### What They've Tried
+
+[Tools, workarounds, hacks. What's in their current toolkit?]
+
+| Solution Tried | What Worked | What Didn't |
+|---------------|-------------|-------------|
+| [Tool/approach] | [Benefit] | [Frustration] |
+
+### Why It's Not Working
+
+[The gap. Why current solutions fail them.]
+
+### How They Make Decisions
+
+[How do they evaluate and adopt new tools? Who's involved?]
+
+- **Discovery**: [How do they find new solutions?]
+- **Evaluation**: [What do they look for? How do they test?]
+- **Adoption**: [Who needs to approve? What's the process?]
+
+---
+
+## How Our Product Fits Into Their World
+
+### The Core Value We Provide
+
+[One sentence: What do we do for this archetype?]
+
+### What They Care About Most
+
+[Rank the 3-4 things that matter most to this archetype, in order]
+
+1. **[Priority 1]** — [Why this matters to them]
+2. **[Priority 2]** — [Why this matters to them]
+3. **[Priority 3]** — [Why this matters to them]
+
+### How Our Product Metrics Translate to Their Value
+
+| Our Metric | What It Means for Them |
+|-----------|----------------------|
+| [Product metric 1] | [Concrete value in their life] |
+| [Product metric 2] | [Concrete value in their life] |
+| [Product metric 3] | [Concrete value in their life] |
+
+### The Moment We Win Them
+
+[What's the "aha moment"? When do they realize this is different?]
+
+---
+
+## Personas Within This Archetype
+
+[These are the specific roles/variations within this archetype. They share the world above but differ in their position, decision-making power, and specific needs.]
+
+### Persona: [Role Name] — [First Name]
+
+**The Role**: [One sentence describing their position]
+
+| Attribute | Detail |
+|-----------|--------|
+| **Typical Title** | [Job title(s)] |
+| **Age Range** | [Range] |
+| **Experience** | [Years in role/industry] |
+| **Decision Power** | [Buyer / Approver / User / Influencer] |
+| **Budget Authority** | [What can they spend without approval?] |
+
+**What Makes Them Different**:
+[2-3 sentences on how this persona differs from others in the archetype]
+
+**Their Specific JTBD**:
+> When [specific situation for this role], I want to [action], so I can [outcome].
+
+**What They Care About Most**:
+- [Specific priority for this persona]
+- [Specific priority for this persona]
+
+**How the Product Creates Value for Them Specifically**:
+- [Product goal/metric] -> [What it means for this person's life/job]
+- [Product goal/metric] -> [What it means for this person's life/job]
+
+**In Their Voice**:
+> "[A quote that captures how this specific persona would describe their situation]"
+
+---
+
+### Persona: [Role Name] — [First Name]
+
+[Repeat structure for each persona variation]
+
+---
+
+## Research Sources
+
+[Where did this archetype understanding come from?]
+
+- [Source 1 — interviews, forums, reviews, etc.]
+- [Source 2]

package/blueprints/discovery/product-discovery/templates/product-brief.md

@@ -0,0 +1,65 @@
+# [Product Name] - Product Brief
+
+> **Note**: This document contains supporting research and detailed analysis.
+> For the distilled thesis, see `product-thesis.md`.
+
+## Market Context
+
+### Market Size (Directional)
+
+[TAM/SAM/SOM if available, but explicitly labeled as estimates/assumptions]
+
+**Note**: These are directional estimates based on [sources]. Actual market validation will come from customer conversations.
+
+### Market Trends
+
+[What's changing that makes this the right time?]
+
+## Detailed Competitive Analysis
+
+### Competitor Deep Dives
+
+[For each major competitor:]
+
+**[Competitor Name]**
+- **What they do**: [Description]
+- **Pricing**: [Model and price points]
+- **Strengths**: [What they do well]
+- **Weaknesses**: [Where they fall short]
+- **Customer sentiment**: [Summary of reviews/feedback]
+
+### Competitive Positioning Map
+
+[Where do competitors sit? Where do we fit?]
+
+## Detailed Positioning
+
+### Positioning Statement
+
+For [target user] who [need], [Product] is a [category] that [key benefit]. Unlike [competitors], we [key differentiator].
+
+### What We Are
+
+[Detailed description of the product vision]
+
+### What We Are NOT
+
+[Explicit boundaries — what we won't do]
+
+### Why Now?
+
+[Market timing: What's changed that makes this possible/necessary now?]
+
+## Risks & Mitigations
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|-----------|--------|------------|
+| [Risk 1] | [H/M/L] | [H/M/L] | [Strategy] |
+
+## Open Questions
+
+[Things that still need to be figured out]
+
+## Research Sources
+
+[All links and sources referenced in research]

package/blueprints/discovery/product-discovery/templates/product-thesis.md

@@ -0,0 +1,64 @@
+# [Product Name] - Product Thesis
+
+## Executive Summary
+
+[2-3 sentences: What is this product and why does it matter?]
+
+## Problem Statement
+
+[Clear articulation of the problem. Who has it, why it exists, what's at stake.]
+
+## Core Product Pillars
+
+**The 3-5 essential things that make this product what it is:**
+
+1. **[Pillar 1]** — [One sentence explanation]
+2. **[Pillar 2]** — [One sentence explanation]
+3. **[Pillar 3]** — [One sentence explanation]
+
+[Up to 5 max — force distillation]
+
+## Competitive Reality
+
+### Direct Competitors
+
+| Competitor | What They Do | Key Weakness |
+|------------|-------------|--------------|
+| [Name] | [Brief description] | [Specific gap] |
+
+### What Customers Are Actually Saying
+
+[Real quotes and complaints from reviews, forums, social media. This is the evidence that the gap exists.]
+
+- **[Competitor]**: "[Actual quote]" — [Source]
+- **[Competitor]**: "[Actual quote]" — [Source]
+
+### The Gap We're Filling
+
+[1-2 sentences: What are competitors NOT solving that we will?]
+
+## Success Metrics
+
+**How we'll know if the product is working:**
+
+| Metric | Target | Why This Matters |
+|--------|--------|-----------------|
+| [Metric 1] | [Target] | [Rationale] |
+| [Metric 2] | [Target] | [Rationale] |
+| [Metric 3] | [Target] | [Rationale] |
+
+[These are PRODUCT metrics only — not business/revenue metrics. Focus on: Does the product actually solve the problem?]
+
+## Target Users
+
+[Brief description of primary user type(s). Link to detailed archetypes.]
+
+See detailed archetypes: `users/archetype-[name].md`
+
+## Critical Assumptions
+
+[3-5 bullets: What must be true for this to work? These are the things to validate first.]
+
+---
+
+*Supporting research and detailed analysis: See `product-brief.md`*

package/blueprints/discovery/product-discovery/templates/research-summary.md

@@ -0,0 +1,43 @@
+# User Research Summary
+
+## Key Insights
+
+| Insight | Evidence | Implication for Product |
+|---------|----------|----------------------|
+| [Pattern observed] | [Source/quote] | [What this means for what we build] |
+
+## User Quotes
+
+[Direct quotes from forums, reviews, social media, interviews — organized by theme]
+
+### On [Problem/Theme 1]
+
+- "[Quote]" — [Source]
+- "[Quote]" — [Source]
+
+### On [Current Solutions]
+
+- "[Quote]" — [Source]
+
+### On [What They Want]
+
+- "[Quote]" — [Source]
+
+## Behavioral Patterns
+
+[Consistent behaviors observed across research]
+
+- [Pattern 1 — with evidence]
+- [Pattern 2 — with evidence]
+
+## Open Questions
+
+[What still needs validation through customer conversations?]
+
+| Question | Why It Matters | How to Test |
+|----------|---------------|-------------|
+| [Question 1] | [Impact on product] | [Method] |
+
+## Research Sources
+
+[All links and sources referenced]