@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,304 @@
1
+ # Design Sprint Framework
2
+
3
+ ## Overview
4
+ The Design Sprint is a 5-day process developed at Google Ventures (now GV) by Jake Knapp. It's designed to answer critical business questions through rapid prototyping and user testing. The sprint compresses months of work into a single week, helping teams shortcut the endless debate cycle and validate ideas with real users.
5
+
6
+ ## When to Use
7
+ - Kick off a new product or feature
8
+ - When facing a critical business challenge
9
+ - Need to make a major decision quickly
10
+ - Want to explore new opportunities
11
+ - Before investing significant resources
12
+ - When team alignment is needed
13
+
14
+ ## The 5-Day Process
15
+
16
+ ### Monday: Map & Target
17
+ **Goal**: Understand the problem and pick a target
18
+
19
+ **Activities**:
20
+ 1. **Start at the End**: Define long-term goal and sprint questions
21
+ 2. **Map**: Create a simple map of the customer journey
22
+ 3. **Ask the Experts**: Interview stakeholders and experts
23
+ 4. **Target**: Choose a specific target customer and moment to focus on
24
+
25
+ **Key Outputs**:
26
+ - Long-term goal
27
+ - Sprint questions
28
+ - Customer journey map
29
+ - Target for the sprint
30
+
31
+ **Time Breakdown**:
32
+ - 10am: Introductions and sprint overview
33
+ - 10:30am: Long-term goal
34
+ - 11:30am: Sprint questions
35
+ - 1pm: Map
36
+ - 2pm: Ask the Experts
37
+ - 4pm: Target
38
+
39
+ ### Tuesday: Sketch
40
+ **Goal**: Generate solutions
41
+
42
+ **Activities**:
43
+ 1. **Lightning Demos**: Look at existing solutions for inspiration
44
+ 2. **Divide or Swarm**: Choose to work on one piece or all together
45
+ 3. **Four-Step Sketch**:
46
+ - Notes (20 min)
47
+ - Ideas (20 min)
48
+ - Crazy 8s (8 min)
49
+ - Solution sketch (30-90 min)
50
+
51
+ **Key Outputs**:
52
+ - Collection of solution sketches
53
+ - Detailed storyboards from each team member
54
+
55
+ **Time Breakdown**:
56
+ - 10am: Lightning Demos
57
+ - 12pm: Divide or Swarm
58
+ - 1pm: Four-step sketch begins
59
+ - 4pm: Solution sketches complete
60
+
61
+ ### Wednesday: Decide
62
+ **Goal**: Choose the best solutions and create a storyboard
63
+
64
+ **Activities**:
65
+ 1. **Art Museum**: Display all solutions
66
+ 2. **Heat Map**: Silent voting on interesting parts
67
+ 3. **Speed Critique**: Quick discussion of highlights
68
+ 4. **Straw Poll**: Everyone picks their favorite
69
+ 5. **Supervote**: Decider makes final choice
70
+ 6. **Storyboard**: Create step-by-step plan for prototype
71
+
72
+ **Key Outputs**:
73
+ - Winning solution(s)
74
+ - Detailed storyboard for prototype
75
+
76
+ **Time Breakdown**:
77
+ - 10am: Sticky Decision
78
+ - 11:30am: Speed Critique
79
+ - 1pm: Straw Poll
80
+ - 1:30pm: Supervote
81
+ - 2pm: Storyboard
82
+
83
+ ### Thursday: Prototype
84
+ **Goal**: Build a realistic prototype
85
+
86
+ **Activities**:
87
+ 1. **Assign Roles**:
88
+ - Maker(s): Build the prototype
89
+ - Stitcher: Ensure consistency
90
+ - Writer: Create realistic copy
91
+ - Asset Collector: Gather needed materials
92
+ - Interviewer: Prepare for Friday's tests
93
+ 2. **Build the Prototype**: Focus on the customer-facing surface
94
+ 3. **Stitch it Together**: Make sure everything flows
95
+ 4. **Trial Run**: Test internally
96
+
97
+ **Key Outputs**:
98
+ - Realistic prototype
99
+ - Interview script
100
+ - Testing logistics confirmed
101
+
102
+ **Tools Often Used**:
103
+ - Figma/Sketch (design)
104
+ - InVision/Marvel (clickable prototypes)
105
+ - Keynote/PowerPoint (quick and dirty)
106
+ - Squarespace/Webflow (landing pages)
107
+
108
+ ### Friday: Test
109
+ **Goal**: Learn from target customers
110
+
111
+ **Activities**:
112
+ 1. **Interviews**: 5 one-on-one interviews
113
+ 2. **Observe**: Watch customers use the prototype
114
+ 3. **Take Notes**: Capture reactions and feedback
115
+ 4. **Learn Together**: Identify patterns
116
+ 5. **Next Steps**: Decide what to do next
117
+
118
+ **Key Outputs**:
119
+ - Customer feedback patterns
120
+ - Validated/invalidated assumptions
121
+ - Clear next steps
122
+
123
+ **Interview Schedule**:
124
+ - 9am: Interview #1
125
+ - 10am: Interview #2
126
+ - 11am: Interview #3
127
+ - 1pm: Interview #4
128
+ - 2pm: Interview #5
129
+ - 3pm: Debrief
130
+
131
+ ## Key Roles
132
+
133
+ ### Decider
134
+ - CEO, product manager, or whoever has decision authority
135
+ - Makes final calls when team is stuck
136
+ - Commits to sprint outcomes
137
+
138
+ ### Facilitator
139
+ - Runs the sprint process
140
+ - Keeps team on track
141
+ - Manages time and energy
142
+
143
+ ### Team Members (5-7 total)
144
+ - Designer
145
+ - Engineer/Developer
146
+ - Product Manager
147
+ - Marketing
148
+ - Customer Service
149
+ - Finance (if relevant)
150
+
151
+ ## Essential Supplies
152
+
153
+ ### Physical
154
+ - Whiteboards (lots of them)
155
+ - Sticky notes (various colors)
156
+ - Markers (thick and thin)
157
+ - Dot stickers (for voting)
158
+ - Timer
159
+ - Snacks and coffee
160
+
161
+ ### Digital
162
+ - Prototyping tools
163
+ - Video conferencing (for remote)
164
+ - Digital whiteboard tools (Miro, Figma)
165
+ - Calendar blocking
166
+
167
+ ## Sprint Questions Examples
168
+
169
+ Good sprint questions help focus the week:
170
+ - "Will customers understand our value proposition?"
171
+ - "Can we simplify the onboarding process?"
172
+ - "Will enterprise customers pay for this feature?"
173
+ - "Can we make this 10x better than competitors?"
174
+
175
+ ## Common Variations
176
+
177
+ ### Design Sprint 2.0
178
+ - Shortened to 4 days
179
+ - Monday activities condensed
180
+ - More emphasis on recruiting users early
181
+
182
+ ### Remote Design Sprint
183
+ - All activities adapted for video conferencing
184
+ - Digital collaboration tools
185
+ - Asynchronous elements where possible
186
+
187
+ ### Enterprise Design Sprint
188
+ - Extended timeline (2-3 weeks)
189
+ - More stakeholders involved
190
+ - Additional validation rounds
191
+
192
+ ## Best Practices
193
+
194
+ ### Before the Sprint
195
+ 1. **Get buy-in**: Ensure leadership support
196
+ 2. **Clear calendars**: No other meetings
197
+ 3. **Recruit users**: Start early (2 weeks before)
198
+ 4. **Prepare space**: Dedicate a war room
199
+ 5. **Set expectations**: This is about learning, not perfection
200
+
201
+ ### During the Sprint
202
+ 1. **No devices**: Laptops closed except when needed
203
+ 2. **Time box everything**: Stick to the schedule
204
+ 3. **Defer discussions**: Use a "parking lot"
205
+ 4. **Trust the process**: Even when skeptical
206
+ 5. **Document everything**: Photos, notes, recordings
207
+
208
+ ### After the Sprint
209
+ 1. **Share results immediately**: Strike while iron is hot
210
+ 2. **Plan next steps**: Don't lose momentum
211
+ 3. **Archive materials**: Future reference
212
+ 4. **Celebrate**: Acknowledge the team effort
213
+
214
+ ## Common Mistakes
215
+
216
+ 1. **Wrong challenge**: Picking something too big or too small
217
+ 2. **Missing decider**: No authority to implement results
218
+ 3. **Too many people**: More than 7 slows progress
219
+ 4. **Skipping steps**: Each day builds on the previous
220
+ 5. **Perfect prototype**: Good enough beats perfect
221
+ 6. **Wrong test users**: Must match target customer
222
+ 7. **Leading questions**: Let users show you
223
+ 8. **Ignoring results**: Must act on learnings
224
+
225
+ ## Measuring Success
226
+
227
+ Success isn't just a validated prototype:
228
+ - **Team alignment**: Everyone understands the direction
229
+ - **Fast learning**: Months of debates resolved in days
230
+ - **Clear next steps**: Know exactly what to do
231
+ - **Risk reduction**: Avoided costly mistakes
232
+ - **Energy boost**: Team excited about path forward
233
+
234
+ ## Tools and Resources
235
+
236
+ ### Books
237
+ - "Sprint" by Jake Knapp
238
+ - "Design Sprint" by Richard Banfield
239
+
240
+ ### Online Resources
241
+ - designsprintkit.withgoogle.com
242
+ - sprintstories.com
243
+ - ajsmart.com/design-sprint
244
+
245
+ ### Software
246
+ - Figma (collaborative design)
247
+ - Miro (digital whiteboard)
248
+ - Calendly (user recruiting)
249
+ - Zoom (remote testing)
250
+
251
+ ## When NOT to Use Design Sprint
252
+
253
+ - Problem is already well-understood
254
+ - Solution is obvious or mandated
255
+ - Can't get the right people
256
+ - No budget/authority to implement
257
+ - Timeline doesn't allow for it
258
+
259
+ ## Design Sprint vs Other Methods
260
+
261
+ ### vs Lean Startup
262
+ - Design Sprint: 5 days, high fidelity prototype
263
+ - Lean Startup: Ongoing, multiple experiments
264
+
265
+ ### vs Agile
266
+ - Design Sprint: Upfront validation
267
+ - Agile: Iterative development
268
+
269
+ ### vs Design Thinking
270
+ - Design Sprint: Time-boxed, specific process
271
+ - Design Thinking: Flexible, longer timeline
272
+
273
+ ## Real-World Examples
274
+
275
+ ### Slack
276
+ Used design sprints to redesign onboarding, resulting in 30% improvement in activation.
277
+
278
+ ### Uber
279
+ Validated new driver app features before development.
280
+
281
+ ### Blue Bottle Coffee
282
+ Tested online subscription service concept.
283
+
284
+ ### KLM
285
+ Improved booking flow, increasing conversions by 25%.
286
+
287
+ ## Modified Sprint Formats
288
+
289
+ ### 3-Day Sprint
290
+ - Day 1: Map and Sketch
291
+ - Day 2: Decide and Prototype
292
+ - Day 3: Test
293
+
294
+ ### Concept Sprint
295
+ - Focus on exploring multiple concepts
296
+ - Less emphasis on detailed prototype
297
+ - More breadth, less depth
298
+
299
+ ### Validation Sprint
300
+ - Start with existing prototype
301
+ - Focus entirely on testing variations
302
+ - Iterate based on feedback
303
+
304
+ The Design Sprint is powerful because it compresses time, focuses effort, and delivers clear results. It's not right for every situation, but when you need to move fast and reduce risk, it's one of the best tools available.
@@ -0,0 +1,337 @@
1
+ # Foundation Sprint Framework
2
+
3
+ ## Overview
4
+ The Foundation Sprint is a collaborative workshop process designed to align teams on product vision, strategy, and roadmap before diving into development. Created by the team at Voltage Control, it focuses on establishing a solid foundation for product development by ensuring all stakeholders share a common understanding of the problem space, target users, and success metrics.
5
+
6
+ ## When to Use
7
+ - Starting a new product or major initiative
8
+ - When team lacks alignment on product direction
9
+ - Before significant investment in development
10
+ - When multiple stakeholders have different visions
11
+ - Establishing product strategy and roadmap
12
+ - Creating shared mental models across teams
13
+
14
+ ## Core Components
15
+
16
+ ### Duration
17
+ Typically 2-5 days, depending on complexity and team size
18
+
19
+ ### Key Principles
20
+ 1. **Diverge then Converge**: Explore many options before narrowing
21
+ 2. **Inclusive Participation**: All voices matter
22
+ 3. **Visual Thinking**: Make abstract concepts concrete
23
+ 4. **Bias Toward Action**: Move from talk to tangible outputs
24
+ 5. **Shared Understanding**: Align on fundamentals
25
+
26
+ ## The Foundation Sprint Process
27
+
28
+ ### Pre-Sprint Preparation
29
+ 1. **Stakeholder Interviews**: Understand different perspectives
30
+ 2. **Research Synthesis**: Compile existing knowledge
31
+ 3. **Participant Selection**: Ensure right people in room
32
+ 4. **Logistics Planning**: Space, materials, schedule
33
+ 5. **Pre-work Assignment**: Background reading/research
34
+
35
+ ### Day 1: Discover & Define
36
+
37
+ #### Morning: Problem Space
38
+ - **Welcome & Introductions**: Set collaborative tone
39
+ - **Sprint Goals**: What success looks like
40
+ - **Problem Statement Workshop**: Define the core problem
41
+ - **Stakeholder Mapping**: Identify all affected parties
42
+ - **Current State Journey Mapping**: How things work today
43
+
44
+ #### Afternoon: User Understanding
45
+ - **Persona Development**: Create detailed user profiles
46
+ - **Empathy Mapping**: Understand user thoughts/feelings
47
+ - **Jobs to be Done**: What users are trying to accomplish
48
+ - **Pain Points Prioritization**: Rank biggest frustrations
49
+
50
+ ### Day 2: Envision & Explore
51
+
52
+ #### Morning: Solution Space
53
+ - **Vision Statement**: Craft inspiring future state
54
+ - **Success Metrics Definition**: How we'll measure progress
55
+ - **Competitive Landscape**: What others are doing
56
+ - **Capability Assessment**: What we can build on
57
+
58
+ #### Afternoon: Ideation
59
+ - **How Might We**: Reframe problems as opportunities
60
+ - **Crazy 8s**: Rapid idea generation
61
+ - **Solution Sketching**: Detailed concept development
62
+ - **Concept Clustering**: Group similar ideas
63
+
64
+ ### Day 3: Prioritize & Plan
65
+
66
+ #### Morning: Decision Making
67
+ - **Concept Presentation**: Share developed ideas
68
+ - **Assumption Mapping**: What we believe vs know
69
+ - **Risk Assessment**: Identify biggest uncertainties
70
+ - **Prioritization Matrix**: Effort vs impact analysis
71
+
72
+ #### Afternoon: Roadmapping
73
+ - **MVP Definition**: Minimum viable product scope
74
+ - **Feature Prioritization**: Must-have vs nice-to-have
75
+ - **Timeline Development**: Realistic phases
76
+ - **Resource Planning**: What we need to succeed
77
+
78
+ ### Day 4: Validate & Refine (Optional)
79
+
80
+ #### Morning: Testing Prep
81
+ - **Prototype Planning**: What to test
82
+ - **Research Questions**: What we need to learn
83
+ - **Participant Recruiting**: Find target users
84
+
85
+ #### Afternoon: User Feedback
86
+ - **Concept Testing**: Share ideas with users
87
+ - **Feedback Synthesis**: Identify patterns
88
+ - **Iteration Planning**: How to improve
89
+
90
+ ### Day 5: Align & Commit (Optional)
91
+
92
+ #### Morning: Final Refinements
93
+ - **Incorporate Feedback**: Update based on learning
94
+ - **Final Presentations**: Polished concepts
95
+ - **Decision Time**: Go/no-go/pivot
96
+
97
+ #### Afternoon: Next Steps
98
+ - **Action Planning**: Who does what when
99
+ - **Communication Plan**: How to share outcomes
100
+ - **Success Criteria**: Clear definition of done
101
+ - **Team Charter**: Working agreements
102
+
103
+ ## Key Deliverables
104
+
105
+ ### Strategic Outputs
106
+ 1. **Product Vision Statement**: Clear, inspiring direction
107
+ 2. **Problem Statement**: Well-defined challenge
108
+ 3. **Success Metrics**: Measurable goals
109
+ 4. **Strategic Priorities**: What matters most
110
+
111
+ ### Tactical Outputs
112
+ 1. **User Personas**: Detailed target profiles
113
+ 2. **Journey Maps**: Current and future state
114
+ 3. **Feature Roadmap**: Phased development plan
115
+ 4. **MVP Scope**: First release definition
116
+
117
+ ### Team Outputs
118
+ 1. **Shared Vocabulary**: Common language
119
+ 2. **Aligned Understanding**: Same mental models
120
+ 3. **Team Charter**: How we work together
121
+ 4. **Decision Framework**: How choices get made
122
+
123
+ ## Facilitation Techniques
124
+
125
+ ### Divergent Thinking Tools
126
+ - **Brainstorming**: Classic idea generation
127
+ - **Mind Mapping**: Visual exploration
128
+ - **SCAMPER**: Systematic creativity
129
+ - **Six Thinking Hats**: Different perspectives
130
+
131
+ ### Convergent Thinking Tools
132
+ - **Dot Voting**: Democratic prioritization
133
+ - **MoSCoW**: Must/Should/Could/Won't
134
+ - **Impact/Effort Matrix**: Strategic prioritization
135
+ - **Paired Comparison**: Systematic ranking
136
+
137
+ ### Visual Tools
138
+ - **Storyboarding**: Narrative sequences
139
+ - **Service Blueprints**: System visualization
140
+ - **Concept Models**: Abstract relationships
141
+ - **Wireframing**: Basic interfaces
142
+
143
+ ## Roles and Responsibilities
144
+
145
+ ### Facilitator
146
+ - Guide process
147
+ - Manage time and energy
148
+ - Ensure participation
149
+ - Synthesize outputs
150
+
151
+ ### Product Owner/Sponsor
152
+ - Provide vision
153
+ - Make key decisions
154
+ - Remove blockers
155
+ - Champion outcomes
156
+
157
+ ### Core Team Members
158
+ - Active participation
159
+ - Domain expertise
160
+ - Creative input
161
+ - Commitment to outcomes
162
+
163
+ ### Subject Matter Experts
164
+ - Specific knowledge
165
+ - Reality checks
166
+ - Technical feasibility
167
+ - Constraint awareness
168
+
169
+ ## Common Variations
170
+
171
+ ### Mini Foundation Sprint (1-2 days)
172
+ - Compressed timeline
173
+ - Focus on critical elements
174
+ - Smaller team
175
+ - Clear constraints
176
+
177
+ ### Extended Foundation Sprint (1-2 weeks)
178
+ - More research integration
179
+ - Multiple stakeholder groups
180
+ - Complex products
181
+ - Detailed planning
182
+
183
+ ### Remote Foundation Sprint
184
+ - Digital collaboration tools
185
+ - Asynchronous elements
186
+ - Shorter sessions
187
+ - More breaks
188
+
189
+ ## Success Factors
190
+
191
+ ### Before the Sprint
192
+ 1. **Leadership Buy-in**: Commitment to outcomes
193
+ 2. **Right Participants**: Decision makers present
194
+ 3. **Clear Scope**: Bounded problem space
195
+ 4. **Research Ready**: Background information available
196
+
197
+ ### During the Sprint
198
+ 1. **Full Participation**: No multitasking
199
+ 2. **Open Communication**: Psychological safety
200
+ 3. **Visual Documentation**: Capture everything
201
+ 4. **Time Management**: Stay on schedule
202
+
203
+ ### After the Sprint
204
+ 1. **Quick Follow-through**: Maintain momentum
205
+ 2. **Broad Communication**: Share outcomes
206
+ 3. **Regular Check-ins**: Track progress
207
+ 4. **Iteration Cycles**: Refine as you learn
208
+
209
+ ## Common Pitfalls
210
+
211
+ 1. **Too Broad Scope**: Trying to solve everything
212
+ 2. **Missing Stakeholders**: Key voices absent
213
+ 3. **Rushing Process**: Not allowing divergence
214
+ 4. **Analysis Paralysis**: Over-thinking decisions
215
+ 5. **Poor Follow-through**: Losing momentum after
216
+ 6. **Skipping Research**: Not grounding in reality
217
+ 7. **Dominating Voices**: Loudest person wins
218
+
219
+ ## Measuring Success
220
+
221
+ ### Short-term Indicators
222
+ - Team alignment score
223
+ - Clarity of outputs
224
+ - Stakeholder satisfaction
225
+ - Actionable next steps
226
+
227
+ ### Long-term Indicators
228
+ - Product success metrics
229
+ - Team velocity
230
+ - Reduced pivots/rework
231
+ - Time to market
232
+
233
+ ## Integration with Other Methods
234
+
235
+ ### With Design Sprint
236
+ - Foundation Sprint first for strategy
237
+ - Design Sprint for specific features
238
+ - Complementary approaches
239
+
240
+ ### With Lean Canvas
241
+ - Use canvas as input/output
242
+ - Foundation Sprint adds depth
243
+ - More collaborative process
244
+
245
+ ### With Agile Development
246
+ - Foundation Sprint sets vision
247
+ - Agile executes iteratively
248
+ - Regular realignment
249
+
250
+ ## Tools and Resources
251
+
252
+ ### Physical Tools
253
+ - Wall space/whiteboards
254
+ - Sticky notes (lots!)
255
+ - Markers and pens
256
+ - Dot stickers
257
+ - Timer
258
+ - Camera
259
+
260
+ ### Digital Tools
261
+ - Miro/Mural (virtual whiteboard)
262
+ - Figma (collaborative design)
263
+ - Notion (documentation)
264
+ - Zoom (remote facilitation)
265
+
266
+ ### Templates
267
+ - Journey map templates
268
+ - Persona templates
269
+ - Roadmap templates
270
+ - Vision canvas
271
+
272
+ ## Real-World Applications
273
+
274
+ ### Startup Examples
275
+ - **Early Stage**: Define product direction
276
+ - **Pivot Point**: Realign on new direction
277
+ - **Scale Phase**: Align growing team
278
+
279
+ ### Enterprise Examples
280
+ - **Innovation Projects**: New venture development
281
+ - **Digital Transformation**: Modernization efforts
282
+ - **Cross-functional Initiatives**: Break down silos
283
+
284
+ ### Non-profit Examples
285
+ - **Program Development**: New initiative planning
286
+ - **Strategic Planning**: Organization direction
287
+ - **Stakeholder Alignment**: Board and staff unity
288
+
289
+ ## Customization Guidelines
290
+
291
+ ### By Industry
292
+ - **B2B Software**: Focus on workflow and ROI
293
+ - **Consumer Apps**: Emphasize user delight
294
+ - **Healthcare**: Include compliance/safety
295
+ - **Education**: Consider all stakeholders
296
+
297
+ ### By Stage
298
+ - **Idea Stage**: Heavy on exploration
299
+ - **Growth Stage**: Focus on optimization
300
+ - **Enterprise**: Include change management
301
+
302
+ ### By Team
303
+ - **Small Teams**: More informal, faster
304
+ - **Large Teams**: More structure needed
305
+ - **Distributed Teams**: Async elements
306
+
307
+ ## Facilitator Tips
308
+
309
+ 1. **Energy Management**: Plan breaks and energizers
310
+ 2. **Inclusive Techniques**: Draw out quiet voices
311
+ 3. **Visual Preference**: Make everything visible
312
+ 4. **Parking Lot**: Capture off-topic items
313
+ 5. **Flexibility**: Adapt to team needs
314
+ 6. **Documentation**: Photograph everything
315
+ 7. **Time Boxing**: Keep things moving
316
+
317
+ ## Next Steps After Sprint
318
+
319
+ ### Immediate (Week 1)
320
+ - Compile all outputs
321
+ - Share with stakeholders
322
+ - Schedule follow-ups
323
+ - Begin quick wins
324
+
325
+ ### Short-term (Month 1)
326
+ - Execute on roadmap
327
+ - Test key assumptions
328
+ - Regular check-ins
329
+ - Iterate based on learning
330
+
331
+ ### Long-term (Quarterly)
332
+ - Measure against success metrics
333
+ - Reassess priorities
334
+ - Team retrospectives
335
+ - Plan next foundation work
336
+
337
+ The Foundation Sprint provides the strategic clarity and team alignment necessary for successful product development. By investing time upfront to build shared understanding, teams can move faster and with more confidence throughout the development process.