@c0x12c/ai-toolkit 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (255) hide show
  1. package/.claude-plugin/marketplace.json +16 -0
  2. package/.claude-plugin/plugin.json +12 -0
  3. package/README.md +439 -0
  4. package/VERSION +1 -0
  5. package/agents/design-critic.md +127 -0
  6. package/agents/idea-killer.md +72 -0
  7. package/agents/infrastructure-expert.md +49 -0
  8. package/agents/micronaut-backend-expert.md +45 -0
  9. package/agents/phase-reviewer.md +150 -0
  10. package/agents/research-planner.md +70 -0
  11. package/agents/solution-architect-cto.md +49 -0
  12. package/agents/sre-architect.md +49 -0
  13. package/agents/team-coordinator.md +111 -0
  14. package/bin/cli.js +780 -0
  15. package/claude-md/00-header.md +39 -0
  16. package/claude-md/01-core.md +105 -0
  17. package/claude-md/05-database.md +20 -0
  18. package/claude-md/11-backend-micronaut.md +19 -0
  19. package/claude-md/20-frontend-react.md +44 -0
  20. package/claude-md/25-ux-design.md +56 -0
  21. package/claude-md/30-infrastructure.md +24 -0
  22. package/claude-md/30-project-mgmt.md +119 -0
  23. package/claude-md/40-product.md +39 -0
  24. package/claude-md/50-ops.md +34 -0
  25. package/claude-md/60-research.md +27 -0
  26. package/claude-md/90-footer.md +21 -0
  27. package/commands/spartan/brainstorm.md +134 -0
  28. package/commands/spartan/brownfield.md +157 -0
  29. package/commands/spartan/build.md +435 -0
  30. package/commands/spartan/careful.md +94 -0
  31. package/commands/spartan/commit-message.md +112 -0
  32. package/commands/spartan/content.md +17 -0
  33. package/commands/spartan/context-save.md +161 -0
  34. package/commands/spartan/contribute.md +140 -0
  35. package/commands/spartan/daily.md +42 -0
  36. package/commands/spartan/debug.md +308 -0
  37. package/commands/spartan/deep-dive.md +55 -0
  38. package/commands/spartan/deploy.md +207 -0
  39. package/commands/spartan/e2e.md +264 -0
  40. package/commands/spartan/env-setup.md +166 -0
  41. package/commands/spartan/epic.md +199 -0
  42. package/commands/spartan/fe-review.md +181 -0
  43. package/commands/spartan/figma-to-code.md +260 -0
  44. package/commands/spartan/forensics.md +46 -0
  45. package/commands/spartan/freeze.md +84 -0
  46. package/commands/spartan/fundraise.md +53 -0
  47. package/commands/spartan/gate-review.md +229 -0
  48. package/commands/spartan/gsd-upgrade.md +376 -0
  49. package/commands/spartan/guard.md +42 -0
  50. package/commands/spartan/init-project.md +178 -0
  51. package/commands/spartan/init-rules.md +298 -0
  52. package/commands/spartan/interview.md +154 -0
  53. package/commands/spartan/kickoff.md +73 -0
  54. package/commands/spartan/kotlin-service.md +109 -0
  55. package/commands/spartan/lean-canvas.md +222 -0
  56. package/commands/spartan/lint-rules.md +122 -0
  57. package/commands/spartan/map-codebase.md +124 -0
  58. package/commands/spartan/migration.md +82 -0
  59. package/commands/spartan/next-app.md +317 -0
  60. package/commands/spartan/next-feature.md +212 -0
  61. package/commands/spartan/onboard.md +326 -0
  62. package/commands/spartan/outreach.md +16 -0
  63. package/commands/spartan/phase.md +142 -0
  64. package/commands/spartan/pitch.md +18 -0
  65. package/commands/spartan/plan.md +210 -0
  66. package/commands/spartan/pr-ready.md +202 -0
  67. package/commands/spartan/project.md +106 -0
  68. package/commands/spartan/qa.md +222 -0
  69. package/commands/spartan/research.md +254 -0
  70. package/commands/spartan/review.md +132 -0
  71. package/commands/spartan/scan-rules.md +173 -0
  72. package/commands/spartan/sessions.md +143 -0
  73. package/commands/spartan/spec.md +131 -0
  74. package/commands/spartan/startup.md +257 -0
  75. package/commands/spartan/team.md +570 -0
  76. package/commands/spartan/teardown.md +161 -0
  77. package/commands/spartan/testcontainer.md +97 -0
  78. package/commands/spartan/tf-cost.md +123 -0
  79. package/commands/spartan/tf-deploy.md +116 -0
  80. package/commands/spartan/tf-drift.md +100 -0
  81. package/commands/spartan/tf-import.md +107 -0
  82. package/commands/spartan/tf-module.md +121 -0
  83. package/commands/spartan/tf-plan.md +100 -0
  84. package/commands/spartan/tf-review.md +106 -0
  85. package/commands/spartan/tf-scaffold.md +109 -0
  86. package/commands/spartan/tf-security.md +147 -0
  87. package/commands/spartan/think.md +221 -0
  88. package/commands/spartan/unfreeze.md +13 -0
  89. package/commands/spartan/update.md +134 -0
  90. package/commands/spartan/ux.md +1233 -0
  91. package/commands/spartan/validate.md +193 -0
  92. package/commands/spartan/web-to-prd.md +706 -0
  93. package/commands/spartan/workstreams.md +109 -0
  94. package/commands/spartan/write.md +16 -0
  95. package/commands/spartan.md +386 -0
  96. package/frameworks/00-framework-comparison-guide.md +317 -0
  97. package/frameworks/01-lean-canvas.md +196 -0
  98. package/frameworks/02-design-sprint.md +304 -0
  99. package/frameworks/03-foundation-sprint.md +337 -0
  100. package/frameworks/04-business-model-canvas.md +391 -0
  101. package/frameworks/05-customer-development.md +426 -0
  102. package/frameworks/06-jobs-to-be-done.md +358 -0
  103. package/frameworks/07-mom-test.md +392 -0
  104. package/frameworks/08-value-proposition-canvas.md +488 -0
  105. package/frameworks/09-javelin-board.md +428 -0
  106. package/frameworks/10-build-measure-learn.md +467 -0
  107. package/frameworks/11-mvp-approaches.md +533 -0
  108. package/frameworks/think-before-build.md +593 -0
  109. package/lib/assembler.js +197 -0
  110. package/lib/assembler.test.js +159 -0
  111. package/lib/detector.js +166 -0
  112. package/lib/detector.test.js +221 -0
  113. package/lib/packs.js +16 -0
  114. package/lib/resolver.js +272 -0
  115. package/lib/resolver.test.js +298 -0
  116. package/lib/worktree.sh +104 -0
  117. package/package.json +50 -0
  118. package/packs/backend-micronaut.yaml +35 -0
  119. package/packs/backend-nodejs.yaml +15 -0
  120. package/packs/backend-python.yaml +15 -0
  121. package/packs/core.yaml +37 -0
  122. package/packs/database.yaml +21 -0
  123. package/packs/frontend-react.yaml +24 -0
  124. package/packs/infrastructure.yaml +40 -0
  125. package/packs/ops.yaml +16 -0
  126. package/packs/packs.compiled.json +371 -0
  127. package/packs/product.yaml +22 -0
  128. package/packs/project-mgmt.yaml +24 -0
  129. package/packs/research.yaml +39 -0
  130. package/packs/shared-backend.yaml +14 -0
  131. package/packs/ux-design.yaml +21 -0
  132. package/rules/backend-micronaut/API_DESIGN.md +313 -0
  133. package/rules/backend-micronaut/BATCH_PROCESSING.md +92 -0
  134. package/rules/backend-micronaut/CONTROLLERS.md +388 -0
  135. package/rules/backend-micronaut/KOTLIN.md +414 -0
  136. package/rules/backend-micronaut/RETROFIT_PLACEMENT.md +290 -0
  137. package/rules/backend-micronaut/SERVICES_AND_BEANS.md +325 -0
  138. package/rules/core/NAMING_CONVENTIONS.md +208 -0
  139. package/rules/core/SKILL_AUTHORING.md +174 -0
  140. package/rules/core/TIMEZONE.md +316 -0
  141. package/rules/database/ORM_AND_REPO.md +289 -0
  142. package/rules/database/SCHEMA.md +146 -0
  143. package/rules/database/TRANSACTIONS.md +311 -0
  144. package/rules/frontend-react/FRONTEND.md +344 -0
  145. package/rules/infrastructure/MODULES.md +260 -0
  146. package/rules/infrastructure/NAMING.md +196 -0
  147. package/rules/infrastructure/PROVIDERS.md +309 -0
  148. package/rules/infrastructure/SECURITY.md +310 -0
  149. package/rules/infrastructure/STATE_AND_BACKEND.md +237 -0
  150. package/rules/infrastructure/STRUCTURE.md +234 -0
  151. package/rules/infrastructure/VARIABLES.md +285 -0
  152. package/rules/shared-backend/ARCHITECTURE.md +46 -0
  153. package/rules/ux-design/DESIGN_PROCESS.md +176 -0
  154. package/skills/api-endpoint-creator/SKILL.md +455 -0
  155. package/skills/api-endpoint-creator/error-handling-guide.md +244 -0
  156. package/skills/api-endpoint-creator/examples.md +522 -0
  157. package/skills/api-endpoint-creator/testing-patterns.md +302 -0
  158. package/skills/article-writing/SKILL.md +109 -0
  159. package/skills/article-writing/examples.md +59 -0
  160. package/skills/backend-api-design/SKILL.md +84 -0
  161. package/skills/backend-api-design/code-patterns.md +138 -0
  162. package/skills/brainstorm/SKILL.md +95 -0
  163. package/skills/browser-qa/SKILL.md +87 -0
  164. package/skills/browser-qa/playwright-snippets.md +110 -0
  165. package/skills/ci-cd-patterns/SKILL.md +108 -0
  166. package/skills/ci-cd-patterns/workflows.md +149 -0
  167. package/skills/competitive-teardown/SKILL.md +93 -0
  168. package/skills/competitive-teardown/example-analysis.md +50 -0
  169. package/skills/content-engine/SKILL.md +131 -0
  170. package/skills/content-engine/examples.md +72 -0
  171. package/skills/database-patterns/SKILL.md +72 -0
  172. package/skills/database-patterns/code-templates.md +114 -0
  173. package/skills/database-table-creator/SKILL.md +141 -0
  174. package/skills/database-table-creator/examples.md +552 -0
  175. package/skills/database-table-creator/kotlin-templates.md +400 -0
  176. package/skills/database-table-creator/migration-template.sql +68 -0
  177. package/skills/database-table-creator/validation-checklist.md +337 -0
  178. package/skills/deep-research/SKILL.md +80 -0
  179. package/skills/design-intelligence/SKILL.md +268 -0
  180. package/skills/design-workflow/SKILL.md +127 -0
  181. package/skills/design-workflow/checklists.md +45 -0
  182. package/skills/idea-validation/SKILL.md +129 -0
  183. package/skills/idea-validation/example-report.md +50 -0
  184. package/skills/investor-materials/SKILL.md +122 -0
  185. package/skills/investor-materials/example-outline.md +70 -0
  186. package/skills/investor-outreach/SKILL.md +112 -0
  187. package/skills/investor-outreach/examples.md +76 -0
  188. package/skills/kotlin-best-practices/SKILL.md +58 -0
  189. package/skills/kotlin-best-practices/code-patterns.md +132 -0
  190. package/skills/market-research/SKILL.md +99 -0
  191. package/skills/security-checklist/SKILL.md +65 -0
  192. package/skills/security-checklist/audit-reference.md +95 -0
  193. package/skills/service-debugging/SKILL.md +116 -0
  194. package/skills/service-debugging/common-issues.md +65 -0
  195. package/skills/startup-pipeline/SKILL.md +152 -0
  196. package/skills/terraform-best-practices/SKILL.md +244 -0
  197. package/skills/terraform-module-creator/SKILL.md +284 -0
  198. package/skills/terraform-review/SKILL.md +222 -0
  199. package/skills/terraform-security-audit/SKILL.md +280 -0
  200. package/skills/terraform-service-scaffold/SKILL.md +574 -0
  201. package/skills/testing-strategies/SKILL.md +116 -0
  202. package/skills/testing-strategies/examples.md +103 -0
  203. package/skills/testing-strategies/integration-test-setup.md +71 -0
  204. package/skills/ui-ux-pro-max/SKILL.md +238 -0
  205. package/skills/ui-ux-pro-max/data/charts.csv +26 -0
  206. package/skills/ui-ux-pro-max/data/colors.csv +97 -0
  207. package/skills/ui-ux-pro-max/data/icons.csv +101 -0
  208. package/skills/ui-ux-pro-max/data/landing.csv +31 -0
  209. package/skills/ui-ux-pro-max/data/products.csv +97 -0
  210. package/skills/ui-ux-pro-max/data/react-performance.csv +45 -0
  211. package/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -0
  212. package/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -0
  213. package/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -0
  214. package/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -0
  215. package/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -0
  216. package/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -0
  217. package/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -0
  218. package/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -0
  219. package/skills/ui-ux-pro-max/data/stacks/react.csv +54 -0
  220. package/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -0
  221. package/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -0
  222. package/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -0
  223. package/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -0
  224. package/skills/ui-ux-pro-max/data/styles.csv +68 -0
  225. package/skills/ui-ux-pro-max/data/typography.csv +58 -0
  226. package/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -0
  227. package/skills/ui-ux-pro-max/data/ux-guidelines.csv +100 -0
  228. package/skills/ui-ux-pro-max/data/web-interface.csv +31 -0
  229. package/skills/ui-ux-pro-max/python-setup.md +146 -0
  230. package/skills/ui-ux-pro-max/scripts/core.py +253 -0
  231. package/skills/ui-ux-pro-max/scripts/design_system.py +1067 -0
  232. package/skills/ui-ux-pro-max/scripts/search.py +114 -0
  233. package/skills/web-to-prd/SKILL.md +478 -0
  234. package/templates/build-config.yaml +44 -0
  235. package/templates/commands-config.yaml +55 -0
  236. package/templates/competitor-analysis.md +60 -0
  237. package/templates/content/AGENT_TEMPLATE.md +47 -0
  238. package/templates/content/COMMAND_TEMPLATE.md +27 -0
  239. package/templates/content/RULE_TEMPLATE.md +40 -0
  240. package/templates/content/SKILL_TEMPLATE.md +41 -0
  241. package/templates/design-config.md +105 -0
  242. package/templates/design-doc.md +207 -0
  243. package/templates/epic.md +100 -0
  244. package/templates/feature-spec.md +181 -0
  245. package/templates/idea-canvas.md +47 -0
  246. package/templates/implementation-plan.md +159 -0
  247. package/templates/prd-template.md +86 -0
  248. package/templates/preamble.md +89 -0
  249. package/templates/project-readme.md +35 -0
  250. package/templates/quality-gates.md +230 -0
  251. package/templates/spartan-config.yaml +164 -0
  252. package/templates/user-interview.md +69 -0
  253. package/templates/validation-checklist.md +108 -0
  254. package/templates/workflow-backend-micronaut.md +409 -0
  255. package/templates/workflow-frontend-react.md +233 -0
@@ -0,0 +1,488 @@
1
+ # Value Proposition Canvas
2
+
3
+ ## Overview
4
+ The Value Proposition Canvas is a tool created by Alexander Osterwalder, Yves Pigneur, and Alan Smith as a detailed zoom-in of the Business Model Canvas. It helps you design, test, and build products and services that customers actually want by ensuring a fit between what you offer (Value Map) and what customers need (Customer Profile). The canvas visualizes the relationship between customer jobs, pains, gains, and your products, pain relievers, and gain creators.
5
+
6
+ ## When to Use
7
+ - Designing new value propositions
8
+ - Improving existing products or services
9
+ - Understanding why products aren't resonating
10
+ - Aligning teams on customer needs
11
+ - Prioritizing feature development
12
+ - Creating marketing messages
13
+ - Analyzing competitor positioning
14
+ - Validating product-market fit
15
+
16
+ ## The Two Sides of the Canvas
17
+
18
+ ### Customer Profile (Right Side)
19
+ Understanding your customer segment in detail
20
+
21
+ ### Value Map (Left Side)
22
+ How your products and services create value
23
+
24
+ ### The Fit
25
+ When your value map addresses the most important jobs, pains, and gains
26
+
27
+ ## Customer Profile Components
28
+
29
+ ### 1. Customer Jobs
30
+ **Definition**: Tasks customers are trying to complete, problems they're solving, or needs they're satisfying
31
+
32
+ **Types of Jobs**:
33
+
34
+ **Functional Jobs**:
35
+ - Core tasks to complete
36
+ - Problems to solve
37
+ - Needs to satisfy
38
+
39
+ Examples:
40
+ - "File my taxes accurately"
41
+ - "Get from A to B"
42
+ - "Stay healthy"
43
+
44
+ **Social Jobs**:
45
+ - How they want to be perceived
46
+ - Status they seek
47
+ - Roles they play
48
+
49
+ Examples:
50
+ - "Look successful"
51
+ - "Be a good parent"
52
+ - "Gain peer respect"
53
+
54
+ **Emotional Jobs**:
55
+ - Feelings they seek
56
+ - Emotional states desired
57
+ - What they want to avoid feeling
58
+
59
+ Examples:
60
+ - "Feel secure"
61
+ - "Reduce anxiety"
62
+ - "Experience joy"
63
+
64
+ **Supporting Jobs**:
65
+ - Buyer jobs (comparing options)
66
+ - Co-creator jobs (participating in design)
67
+ - Transferrer jobs (disposing of product)
68
+
69
+ **Job Context Matters**:
70
+ - When does the job arise?
71
+ - Where does it happen?
72
+ - With whom?
73
+ - What constraints exist?
74
+
75
+ ### 2. Pains
76
+ **Definition**: Negative emotions, undesired costs, situations, and risks customers experience before, during, or after getting the job done
77
+
78
+ **Types of Pains**:
79
+
80
+ **Undesired Outcomes**:
81
+ - Functional: Solution doesn't work
82
+ - Social: Makes me look bad
83
+ - Emotional: Feel frustrated
84
+ - Ancillary: Negative side effects
85
+
86
+ **Obstacles**:
87
+ - Lack of time
88
+ - Missing knowledge
89
+ - No budget
90
+ - Geographic distance
91
+
92
+ **Risks**:
93
+ - Financial risk
94
+ - Social risk
95
+ - Technical risk
96
+ - What could go wrong?
97
+
98
+ **Pain Severity**:
99
+ - Extreme: Show-stopper
100
+ - Moderate: Very annoying
101
+ - Light: Minor irritation
102
+
103
+ **Questions to Uncover Pains**:
104
+ - What's frustrating about current solutions?
105
+ - What are the main difficulties?
106
+ - What negative consequences do they fear?
107
+ - What's keeping them awake at night?
108
+ - What common mistakes do they make?
109
+ - What barriers prevent adoption?
110
+
111
+ ### 3. Gains
112
+ **Definition**: Outcomes and benefits customers want, including functional utility, social gains, positive emotions, and cost savings
113
+
114
+ **Types of Gains**:
115
+
116
+ **Required Gains**:
117
+ - Basic expectations
118
+ - Without these, solution doesn't work
119
+ - Minimum requirements
120
+
121
+ **Expected Gains**:
122
+ - What customers naturally expect
123
+ - Standard benefits
124
+ - Normal performance
125
+
126
+ **Desired Gains**:
127
+ - Beyond expectations
128
+ - Would love to have
129
+ - Differentiators
130
+
131
+ **Unexpected Gains**:
132
+ - Delightful surprises
133
+ - Exceed imagination
134
+ - Create wow moments
135
+
136
+ **Questions to Uncover Gains**:
137
+ - What would make their job easier?
138
+ - What outcomes exceed expectations?
139
+ - What would increase likelihood of adoption?
140
+ - What do they dream about?
141
+ - How do they measure success?
142
+ - What would they pay more for?
143
+
144
+ ## Value Map Components
145
+
146
+ ### 1. Products & Services
147
+ **Definition**: List of what you offer, including physical products, intangible services, digital products, and financial products
148
+
149
+ **Types**:
150
+ - **Physical**: Manufactured goods
151
+ - **Intangible**: Services, consultations
152
+ - **Digital**: Software, apps, content
153
+ - **Financial**: Insurance, financing
154
+
155
+ **Ranking**:
156
+ - Essential products/services
157
+ - Important ones
158
+ - Nice-to-have additions
159
+
160
+ ### 2. Pain Relievers
161
+ **Definition**: How your products and services alleviate customer pains
162
+
163
+ **Effective Pain Relievers**:
164
+ - Address extreme pains first
165
+ - Be specific about how
166
+ - Focus on few but important ones
167
+ - Differentiate from competition
168
+
169
+ **Examples**:
170
+ - "Saves you 2 hours per day"
171
+ - "Eliminates manual data entry"
172
+ - "Reduces error rate by 90%"
173
+ - "No technical knowledge required"
174
+
175
+ **Questions for Design**:
176
+ - Which pains do we eliminate?
177
+ - How do we reduce frustrations?
178
+ - What risks do we minimize?
179
+ - Which obstacles do we remove?
180
+ - What negative outcomes do we prevent?
181
+
182
+ ### 3. Gain Creators
183
+ **Definition**: How your products and services create customer gains
184
+
185
+ **Effective Gain Creators**:
186
+ - Focus on gains customers care about
187
+ - Be specific and measurable
188
+ - Differentiate your offering
189
+ - Surprise and delight
190
+
191
+ **Examples**:
192
+ - "Increases productivity by 40%"
193
+ - "Makes you look professional"
194
+ - "Integrates with tools you use"
195
+ - "Provides instant results"
196
+
197
+ **Questions for Design**:
198
+ - Which gains do we create?
199
+ - How do we exceed expectations?
200
+ - What delights customers?
201
+ - How do we make jobs easier?
202
+ - What positive outcomes do we enable?
203
+
204
+ ## Achieving Fit
205
+
206
+ ### What is Fit?
207
+ Fit happens when customers get excited about your value proposition because it addresses important jobs, alleviates extreme pains, and creates essential gains.
208
+
209
+ ### Three Types of Fit
210
+
211
+ 1. **Problem-Solution Fit** (Conceptual)
212
+ - Evidence: Customers care about jobs, pains, gains
213
+ - Validation: Customer interviews confirm importance
214
+ - Stage: Pre-product
215
+
216
+ 2. **Product-Market Fit** (Proven in Market)
217
+ - Evidence: Customers buy, use, and refer
218
+ - Validation: Sales traction and retention
219
+ - Stage: Early growth
220
+
221
+ 3. **Business Model Fit** (Scalable)
222
+ - Evidence: Profitable and growing
223
+ - Validation: Unit economics work
224
+ - Stage: Scale-up
225
+
226
+ ### Fit is Not:
227
+ - Addressing every job, pain, and gain
228
+ - Nice-to-have features
229
+ - What you think customers need
230
+ - Static (markets evolve)
231
+
232
+ ## Using the Canvas: Step-by-Step
233
+
234
+ ### Step 1: Select Customer Segment
235
+ - Choose one specific segment
236
+ - Be precise about who they are
237
+ - Consider creating multiple canvases
238
+
239
+ ### Step 2: Map Customer Profile
240
+
241
+ **Jobs**:
242
+ 1. Brainstorm all jobs
243
+ 2. Distinguish job types
244
+ 3. Rank by importance
245
+ 4. Add context details
246
+
247
+ **Pains**:
248
+ 1. List all pains per job
249
+ 2. Specify severity
250
+ 3. Make concrete
251
+ 4. Rank by intensity
252
+
253
+ **Gains**:
254
+ 1. List desired outcomes
255
+ 2. Distinguish gain types
256
+ 3. Make measurable
257
+ 4. Rank by importance
258
+
259
+ ### Step 3: Map Value Proposition
260
+
261
+ **Products & Services**:
262
+ 1. List your offerings
263
+ 2. Link to customer jobs
264
+ 3. Rank by importance
265
+
266
+ **Pain Relievers**:
267
+ 1. List how you address pains
268
+ 2. Be specific
269
+ 3. Link to customer pains
270
+ 4. Focus on extreme pains
271
+
272
+ **Gain Creators**:
273
+ 1. List how you create gains
274
+ 2. Make measurable
275
+ 3. Link to customer gains
276
+ 4. Focus on essential gains
277
+
278
+ ### Step 4: Achieve Fit
279
+ 1. Check connections
280
+ 2. Verify importance alignment
281
+ 3. Test with customers
282
+ 4. Iterate based on feedback
283
+
284
+ ## Best Practices
285
+
286
+ ### Do's
287
+ 1. **One segment at a time**: Don't mix different customers
288
+ 2. **Use customer language**: Their words, not yours
289
+ 3. **Be specific**: Vague descriptions don't help
290
+ 4. **Prioritize ruthlessly**: Can't address everything
291
+ 5. **Test assumptions**: Validate with real customers
292
+ 6. **Iterate frequently**: Canvas is living document
293
+ 7. **Visual thinking**: Use colors, sizes, symbols
294
+
295
+ ### Don'ts
296
+ 1. **Don't mix segments**: Each needs own canvas
297
+ 2. **Don't list features**: Focus on value created
298
+ 3. **Don't assume**: Test everything
299
+ 4. **Don't be generic**: Specificity wins
300
+ 5. **Don't stop at first version**: Keep refining
301
+ 6. **Don't work in isolation**: Involve team and customers
302
+
303
+ ## Testing and Validation
304
+
305
+ ### Customer Profile Testing
306
+
307
+ **Jobs Testing**:
308
+ - Interview: "What are you trying to get done?"
309
+ - Observe: Watch them in context
310
+ - Data: Analyze support tickets
311
+
312
+ **Pains Testing**:
313
+ - Survey: Rank pain severity
314
+ - Interview: "What's most frustrating?"
315
+ - Measure: Time/money wasted
316
+
317
+ **Gains Testing**:
318
+ - Interview: "What would success look like?"
319
+ - Survey: Rank gain importance
320
+ - Experiment: A/B test different gains
321
+
322
+ ### Value Map Testing
323
+
324
+ **Pain Reliever Testing**:
325
+ - Prototype: Show how you relieve pain
326
+ - Measure: Before/after metrics
327
+ - Feedback: "Does this solve your problem?"
328
+
329
+ **Gain Creator Testing**:
330
+ - Demo: Show gains in action
331
+ - Measure: Actual vs promised gains
332
+ - Testimonial: Capture success stories
333
+
334
+ ### Fit Testing Methods
335
+
336
+ 1. **Problem Interviews**: Validate jobs, pains, gains exist
337
+ 2. **Solution Interviews**: Test if value prop resonates
338
+ 3. **Concierge MVP**: Manually deliver value
339
+ 4. **Wizard of Oz**: Fake the backend
340
+ 5. **Landing Pages**: Test demand
341
+ 6. **Prototypes**: Test specific features
342
+ 7. **Pilots**: Full solution, limited scope
343
+
344
+ ## Common Patterns
345
+
346
+ ### B2B Software Pattern
347
+ **Jobs**: Efficiency, insights, compliance
348
+ **Pains**: Manual processes, errors, time waste
349
+ **Gains**: Automation, accuracy, time savings
350
+ **Products**: SaaS platform
351
+ **Pain Relievers**: Automation, integration
352
+ **Gain Creators**: Reports, predictions
353
+
354
+ ### Consumer App Pattern
355
+ **Jobs**: Entertainment, connection, convenience
356
+ **Pains**: Boredom, isolation, complexity
357
+ **Gains**: Fun, social status, simplicity
358
+ **Products**: Mobile app
359
+ **Pain Relievers**: Easy UI, instant access
360
+ **Gain Creators**: Social features, achievements
361
+
362
+ ### Service Business Pattern
363
+ **Jobs**: Expertise, convenience, results
364
+ **Pains**: Lack knowledge, no time, risk
365
+ **Gains**: Peace of mind, status, outcomes
366
+ **Products**: Consulting, done-for-you
367
+ **Pain Relievers**: Expertise, guarantees
368
+ **Gain Creators**: Results, convenience
369
+
370
+ ## Integration with Other Tools
371
+
372
+ ### With Business Model Canvas
373
+ - VPC zooms into two blocks: Customer Segments and Value Propositions
374
+ - Use VPC to detail each segment
375
+ - Ensure alignment with other blocks
376
+
377
+ ### With Lean Canvas
378
+ - VPC expands Problem and Solution boxes
379
+ - More detailed customer understanding
380
+ - Validates problem-solution fit
381
+
382
+ ### With Jobs to be Done
383
+ - Customer Jobs = JTBD
384
+ - Pains = Obstacles to job completion
385
+ - Gains = Successful job outcomes
386
+
387
+ ### With Design Sprint
388
+ - Use VPC on Monday for understanding
389
+ - Reference during ideation
390
+ - Test fit on Friday
391
+
392
+ ## Advanced Techniques
393
+
394
+ ### Competitive Analysis
395
+ 1. Map competitor's value proposition
396
+ 2. Identify gaps in their offering
397
+ 3. Find underserved pains/gains
398
+ 4. Position your differentiators
399
+
400
+ ### Portfolio Management
401
+ 1. Create VPC for each product
402
+ 2. Identify overlaps and gaps
403
+ 3. Optimize resource allocation
404
+ 4. Plan product evolution
405
+
406
+ ### Innovation Opportunities
407
+ 1. Look for extreme unaddressed pains
408
+ 2. Find gains nobody delivers
409
+ 3. Combine pain relievers uniquely
410
+ 4. Create unexpected gains
411
+
412
+ ## Digital Tools
413
+
414
+ - **Strategyzer**: Official VPC app
415
+ - **Miro/Mural**: Templates available
416
+ - **Canvanizer**: Free online tool
417
+ - **RealtimeBoard**: Collaborative canvas
418
+ - **Physical**: Print templates, sticky notes
419
+
420
+ ## Common Mistakes
421
+
422
+ 1. **Feature Listing**: Describing features not value
423
+ - Wrong: "AI-powered algorithm"
424
+ - Right: "Reduces analysis time by 80%"
425
+
426
+ 2. **Vague Descriptions**: Too generic to be useful
427
+ - Wrong: "Makes life easier"
428
+ - Right: "Eliminates 3 hours of weekly reporting"
429
+
430
+ 3. **Inside-Out Thinking**: Your perspective not theirs
431
+ - Wrong: "Our innovative platform"
432
+ - Right: "Get answers in seconds not hours"
433
+
434
+ 4. **Everything Syndrome**: Trying to address all pains/gains
435
+ - Focus on top 3-5 most important
436
+
437
+ 5. **Static Canvas**: Not updating with learnings
438
+ - Schedule regular reviews
439
+ - Update after each customer test
440
+
441
+ ## Measuring Success
442
+
443
+ ### Leading Indicators
444
+ - Customer excitement level
445
+ - Willingness to pay
446
+ - Referral likelihood
447
+ - Feature requests align with canvas
448
+
449
+ ### Lagging Indicators
450
+ - Customer acquisition rate
451
+ - Retention/churn
452
+ - Net Promoter Score
453
+ - Revenue growth
454
+
455
+ ## Quick Start Workshop
456
+
457
+ ### 2-Hour VPC Session
458
+
459
+ **Prep (15 min)**:
460
+ - Select one customer segment
461
+ - Gather customer insights
462
+ - Print canvases
463
+
464
+ **Customer Profile (45 min)**:
465
+ - 15 min: Jobs brainstorm
466
+ - 15 min: Pains brainstorm
467
+ - 15 min: Gains brainstorm
468
+
469
+ **Value Map (45 min)**:
470
+ - 15 min: List products/services
471
+ - 15 min: Design pain relievers
472
+ - 15 min: Design gain creators
473
+
474
+ **Fit Check (15 min)**:
475
+ - Draw connections
476
+ - Identify gaps
477
+ - Plan validation
478
+
479
+ ## Next Steps
480
+
481
+ 1. **Test Your Canvas**: Don't assume, validate
482
+ 2. **Talk to Customers**: Use Mom Test questions
483
+ 3. **Build Prototypes**: Test specific elements
484
+ 4. **Measure Results**: Track if value is delivered
485
+ 5. **Iterate**: Update based on learnings
486
+ 6. **Scale**: When fit is proven
487
+
488
+ The Value Proposition Canvas is a thinking tool that helps you design products and services customers want. It works best when you use real customer insights, test your assumptions, and iterate based on feedback. Remember: the goal isn't a pretty canvas—it's creating value customers care about.