@polderlabs/bizar 10.7.1 → 10.7.2

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 (142) hide show
  1. package/.claude/agents/_shared/AGENT_BASELINE.md +266 -0
  2. package/.claude/agents/_shared/CLAUDE_TOOLS.md +412 -0
  3. package/.claude/agents/_shared/SKILLS.md +109 -0
  4. package/.claude/agents/brand-designer.md +55 -0
  5. package/.claude/agents/exec-assistant.md +34 -0
  6. package/.claude/agents/help-desk.md +44 -0
  7. package/.claude/agents/it-lead.md +53 -0
  8. package/.claude/agents/knowledge-manager.md +49 -0
  9. package/.claude/agents/office-coordinator.md +39 -0
  10. package/.claude/agents/office-greeter.md +53 -0
  11. package/.claude/agents/office-manager.md +287 -0
  12. package/.claude/agents/principal-engineer.md +58 -0
  13. package/.claude/agents/qa-reviewer.md +51 -0
  14. package/.claude/agents/research-analyst.md +53 -0
  15. package/.claude/agents/senior-engineer.md +55 -0
  16. package/.claude/agents/support-tech.md +87 -0
  17. package/.claude/agents/vp-engineering.md +54 -0
  18. package/.claude/commands/audit.md +48 -0
  19. package/.claude/commands/bizar.md +22 -0
  20. package/.claude/commands/cron.md +36 -0
  21. package/.claude/commands/explain.md +17 -0
  22. package/.claude/commands/goal.md +99 -0
  23. package/.claude/commands/init.md +15 -0
  24. package/.claude/commands/learn.md +46 -0
  25. package/.claude/commands/plan.md +35 -0
  26. package/.claude/commands/plow-through.md +50 -0
  27. package/.claude/commands/pr-review.md +49 -0
  28. package/.claude/commands/setup-provider.md +96 -0
  29. package/.claude/commands/spec.md +47 -0
  30. package/.claude/commands/sprint.md +43 -0
  31. package/.claude/commands/tailscale-serve.md +100 -0
  32. package/.claude/commands/team.md +132 -0
  33. package/.claude/commands/test.md +62 -0
  34. package/.claude/commands/validate.md +68 -0
  35. package/.claude/commands/visual-plan.md +24 -0
  36. package/.claude/hooks/README.md +108 -0
  37. package/.claude/hooks/__tests__/pretooluse-editwrite.test.mjs +146 -0
  38. package/.claude/hooks/__tests__/sessionend-recall.test.mjs +256 -0
  39. package/.claude/hooks/__tests__/sessionstart-prime.test.mjs +325 -0
  40. package/.claude/hooks/__tests__/thinking-route.test.mjs +319 -0
  41. package/.claude/hooks/auto-instinct.sh +81 -0
  42. package/.claude/hooks/learning-extract.mjs +92 -0
  43. package/.claude/hooks/post-merge-audit.sh +93 -0
  44. package/.claude/hooks/posttooluse-editwrite.mjs +91 -0
  45. package/.claude/hooks/pretooluse-bash.mjs +87 -0
  46. package/.claude/hooks/pretooluse-editwrite.mjs +117 -0
  47. package/.claude/hooks/sessionend-recall.mjs +384 -0
  48. package/.claude/hooks/sessionstart-prime.mjs +278 -0
  49. package/.claude/hooks/thinking-route.mjs +314 -0
  50. package/.claude/hooks/worker-suggest.mjs +110 -0
  51. package/.claude/settings.json +167 -0
  52. package/.claude/skills/9router/SKILL.md +80 -0
  53. package/.claude/skills/9router-chat/SKILL.md +73 -0
  54. package/.claude/skills/9router-embeddings/SKILL.md +69 -0
  55. package/.claude/skills/9router-image/SKILL.md +86 -0
  56. package/.claude/skills/9router-stt/SKILL.md +79 -0
  57. package/.claude/skills/9router-tts/SKILL.md +80 -0
  58. package/.claude/skills/9router-web-fetch/SKILL.md +99 -0
  59. package/.claude/skills/9router-web-search/SKILL.md +91 -0
  60. package/.claude/skills/agent-browser/SKILL.md +64 -0
  61. package/.claude/skills/bizar/README.md +9 -0
  62. package/.claude/skills/bizar/SKILL.md +447 -0
  63. package/.claude/skills/cpp-coding-standards/README.md +28 -0
  64. package/.claude/skills/cpp-coding-standards/SKILL.md +634 -0
  65. package/.claude/skills/cpp-coding-standards/references/concurrency.md +320 -0
  66. package/.claude/skills/cpp-coding-standards/references/error-handling.md +229 -0
  67. package/.claude/skills/cpp-coding-standards/references/memory-safety.md +216 -0
  68. package/.claude/skills/cpp-coding-standards/references/modern-idioms.md +282 -0
  69. package/.claude/skills/cpp-coding-standards/references/review-checklist.md +96 -0
  70. package/.claude/skills/cpp-testing/README.md +28 -0
  71. package/.claude/skills/cpp-testing/SKILL.md +304 -0
  72. package/.claude/skills/cpp-testing/references/coverage.md +370 -0
  73. package/.claude/skills/cpp-testing/references/framework-compare.md +175 -0
  74. package/.claude/skills/cpp-testing/references/host-test-for-embedded.md +499 -0
  75. package/.claude/skills/cpp-testing/references/mocking.md +364 -0
  76. package/.claude/skills/cpp-testing/references/tdd-workflow.md +308 -0
  77. package/.claude/skills/cubesandbox/SKILL.md +148 -0
  78. package/.claude/skills/de-sloppify/SKILL.md +38 -0
  79. package/.claude/skills/de-sloppify/cleanup.mjs +253 -0
  80. package/.claude/skills/de-sloppify/cleanup.test.mjs +189 -0
  81. package/.claude/skills/embedded-esp-idf/README.md +41 -0
  82. package/.claude/skills/embedded-esp-idf/SKILL.md +439 -0
  83. package/.claude/skills/embedded-esp-idf/references/freertos-patterns.md +214 -0
  84. package/.claude/skills/embedded-esp-idf/references/host-tests.md +164 -0
  85. package/.claude/skills/embedded-esp-idf/references/idf-py-commands.md +157 -0
  86. package/.claude/skills/embedded-esp-idf/references/kconfig.md +159 -0
  87. package/.claude/skills/embedded-esp-idf/references/logging-discipline.md +118 -0
  88. package/.claude/skills/embedded-esp-idf/references/memory-and-iram.md +137 -0
  89. package/.claude/skills/embedded-esp-idf/references/nvs.md +121 -0
  90. package/.claude/skills/embedded-esp-idf/references/packed-structs.md +192 -0
  91. package/.claude/skills/embedded-esp-idf/scripts/idf_env.sh +47 -0
  92. package/.claude/skills/embedded-esp-idf/scripts/size_check.sh +77 -0
  93. package/.claude/skills/glyph/SKILL.md +163 -0
  94. package/.claude/skills/harness-engineering/SKILL.md +142 -0
  95. package/.claude/skills/lightrag/SKILL.md +81 -0
  96. package/.claude/skills/memory-protocol/SKILL.md +105 -0
  97. package/.claude/skills/obsidian/SKILL.md +306 -0
  98. package/.claude/skills/read-the-damn-docs/SKILL.md +113 -0
  99. package/.claude/skills/self-improvement/SKILL.md +64 -0
  100. package/.claude/skills/skillopt/SKILL.md +129 -0
  101. package/.claude/skills/thinking-archetypes/SKILL.md +90 -0
  102. package/.claude/skills/thinking-bayesian/SKILL.md +267 -0
  103. package/.claude/skills/thinking-bounded-rationality/SKILL.md +406 -0
  104. package/.claude/skills/thinking-circle-of-competence/SKILL.md +216 -0
  105. package/.claude/skills/thinking-cynefin/SKILL.md +70 -0
  106. package/.claude/skills/thinking-debiasing/SKILL.md +192 -0
  107. package/.claude/skills/thinking-dual-process/SKILL.md +282 -0
  108. package/.claude/skills/thinking-effectuation/SKILL.md +366 -0
  109. package/.claude/skills/thinking-feedback-loops/SKILL.md +464 -0
  110. package/.claude/skills/thinking-fermi-estimation/SKILL.md +263 -0
  111. package/.claude/skills/thinking-first-principles/SKILL.md +167 -0
  112. package/.claude/skills/thinking-five-whys-plus/SKILL.md +139 -0
  113. package/.claude/skills/thinking-inversion/SKILL.md +195 -0
  114. package/.claude/skills/thinking-jobs-to-be-done/SKILL.md +363 -0
  115. package/.claude/skills/thinking-kepner-tregoe/SKILL.md +154 -0
  116. package/.claude/skills/thinking-leverage-points/SKILL.md +390 -0
  117. package/.claude/skills/thinking-lindy-effect/SKILL.md +331 -0
  118. package/.claude/skills/thinking-map-territory/SKILL.md +111 -0
  119. package/.claude/skills/thinking-margin-of-safety/SKILL.md +330 -0
  120. package/.claude/skills/thinking-model-combination/SKILL.md +406 -0
  121. package/.claude/skills/thinking-model-router/SKILL.md +360 -0
  122. package/.claude/skills/thinking-model-selection/SKILL.md +341 -0
  123. package/.claude/skills/thinking-occams-razor/SKILL.md +129 -0
  124. package/.claude/skills/thinking-ooda/SKILL.md +127 -0
  125. package/.claude/skills/thinking-opportunity-cost/SKILL.md +360 -0
  126. package/.claude/skills/thinking-pre-mortem/SKILL.md +170 -0
  127. package/.claude/skills/thinking-probabilistic/SKILL.md +324 -0
  128. package/.claude/skills/thinking-red-team/SKILL.md +142 -0
  129. package/.claude/skills/thinking-regret-minimization/SKILL.md +335 -0
  130. package/.claude/skills/thinking-reversibility/SKILL.md +326 -0
  131. package/.claude/skills/thinking-scientific-method/SKILL.md +162 -0
  132. package/.claude/skills/thinking-second-order/SKILL.md +184 -0
  133. package/.claude/skills/thinking-socratic/SKILL.md +198 -0
  134. package/.claude/skills/thinking-steel-manning/SKILL.md +332 -0
  135. package/.claude/skills/thinking-systems/SKILL.md +238 -0
  136. package/.claude/skills/thinking-theory-of-constraints/SKILL.md +338 -0
  137. package/.claude/skills/thinking-thought-experiment/SKILL.md +354 -0
  138. package/.claude/skills/thinking-triz/SKILL.md +171 -0
  139. package/.claude/skills/thinking-via-negativa/SKILL.md +358 -0
  140. package/cli/install/postinstall.mjs +54 -28
  141. package/cli/install/postinstall.test.mjs +98 -0
  142. package/package.json +7 -2
@@ -0,0 +1,366 @@
1
+ ---
2
+ name: thinking-effectuation
3
+ description: Start with means, not goals; co-create with partners; leverage contingencies. Use for startup strategy, innovation projects, and uncertain/novel domains where planning is unreliable.
4
+ ---
5
+
6
+ # Effectuation
7
+
8
+ ## Overview
9
+
10
+ Effectuation, developed by Saras Sarasvathy from studying expert entrepreneurs, inverts traditional causal reasoning. Instead of starting with a goal and finding resources, effectuators start with available means and discover goals through action. This approach is more robust in highly uncertain environments where prediction is unreliable.
11
+
12
+ **Core Principle:** When you can't predict the future, don't try. Instead, focus on what you can control and let the future emerge from your actions.
13
+
14
+ ## When to Use
15
+
16
+ - Startup and new product development
17
+ - Innovation in uncertain domains
18
+ - When prediction is unreliable
19
+ - Entering new markets
20
+ - When resources are constrained
21
+ - Side projects and experiments
22
+ - Career pivots
23
+
24
+ Decision flow:
25
+
26
+ ```
27
+ Facing uncertainty about outcomes?
28
+ → Can you predict the future reliably? → no → USE EFFECTUATION
29
+ → Do you have fixed goals but uncertain resources? → yes → Traditional planning
30
+ → Do you have available means but uncertain goals? → yes → USE EFFECTUATION
31
+ ```
32
+
33
+ ## When NOT to Use
34
+
35
+ - **Use effectuation only under genuine (Knightian) uncertainty** — where outcomes can't be assigned meaningful probabilities because the market/technology/problem is novel. That's where "create the future through action" beats prediction.
36
+ - **For predictable markets with a known model, use causal planning instead.** If the market exists, the unit economics are knowable, and the path is a known sequence of steps, set the goal and plan to it — effectuation's "let goals emerge" wastes time you don't need to spend exploring.
37
+ - **Not when the cost of a wrong action exceeds affordable loss.** Effectuation assumes you can afford to act-and-learn; if a single misstep is ruinous, plan and de-risk first.
38
+
39
+ ## Trigger Card
40
+
41
+ When starting a new initiative in an uncertain domain where planning is unreliable:
42
+
43
+ 1. **Inventory your means** — who you are, what you know, who you know. Start from what's available, not from a distant goal.
44
+ 2. **Take an affordable-loss step** — what can you act on now where the downside is survivable if it fails? Act; don't plan.
45
+ 3. **Co-create with committed partners** — find stakeholders willing to make real commitments, then let the direction emerge from their input.
46
+
47
+ If the market and path are predictable, use causal planning instead. If a single misstep is ruinous, de-risk before acting.
48
+
49
+ ## Causal vs Effectual Reasoning
50
+
51
+ ### Causal (Traditional)
52
+
53
+ ```
54
+ 1. Set a goal
55
+ 2. Plan to achieve the goal
56
+ 3. Gather necessary resources
57
+ 4. Execute the plan
58
+ 5. Measure against the goal
59
+
60
+ Example:
61
+ Goal: Build a $10M company
62
+ Plan: Build product X for market Y
63
+ Resources: Raise $2M, hire 10 people
64
+ Execute: 18-month development plan
65
+ Measure: Revenue against projections
66
+ ```
67
+
68
+ ### Effectual (Entrepreneurial)
69
+
70
+ ```
71
+ 1. Start with your means
72
+ 2. Take action with acceptable loss
73
+ 3. Build partnerships
74
+ 4. Leverage contingencies
75
+ 5. Goals emerge from action
76
+
77
+ Example:
78
+ Means: I know databases, have some savings, know other engineers
79
+ Action: Build a small tool, see who's interested
80
+ Partners: Three early users want to co-create
81
+ Contingency: One user has a different problem that's bigger
82
+ Emerging goal: Pivot to new problem, user becomes co-founder
83
+ ```
84
+
85
+ ## The Five Principles of Effectuation
86
+
87
+ ### 1. Bird in Hand (Start with Means)
88
+
89
+ Begin with what you have:
90
+
91
+ ```markdown
92
+ ## My Means Inventory
93
+
94
+ Who I am:
95
+ - Skills: [List skills]
96
+ - Preferences: [What I enjoy]
97
+ - Values: [What matters to me]
98
+
99
+ What I know:
100
+ - Domain expertise: [Areas of knowledge]
101
+ - Unique insights: [What I see that others don't]
102
+ - Technical skills: [What I can build]
103
+
104
+ Who I know:
105
+ - Potential partners: [People who might join]
106
+ - Potential customers: [People who might buy]
107
+ - Resources: [People who can help]
108
+
109
+ What can I do with THESE means?
110
+ (Don't start with "what's needed"—start with "what I have")
111
+ ```
112
+
113
+ ### 2. Affordable Loss (Acceptable Downside)
114
+
115
+ Focus on what you can afford to lose, not expected return:
116
+
117
+ ```markdown
118
+ ## Affordable Loss Analysis
119
+
120
+ I can afford to lose:
121
+ - Time: 6 months of evenings/weekends
122
+ - Money: $5K of savings
123
+ - Opportunity: Delay of other projects
124
+ - Reputation: Minor if it fails quietly
125
+
126
+ I cannot afford to lose:
127
+ - Day job income
128
+ - Family time beyond X hours
129
+ - More than $5K
130
+
131
+ Action: Design the experiment to fit within affordable loss
132
+ Don't calculate expected return—calculate maximum loss
133
+ Can I live with maximum loss? If yes, proceed.
134
+ ```
135
+
136
+ ### 3. Crazy Quilt (Partnerships)
137
+
138
+ Co-create with anyone who commits:
139
+
140
+ ```markdown
141
+ ## Partnership Building
142
+
143
+ Instead of: Finding resources for my predetermined plan
144
+ Do: Let partners shape the venture
145
+
146
+ Approach:
147
+ 1. Share what I'm working on
148
+ 2. Anyone who commits becomes a partner
149
+ 3. They bring their means and constraints
150
+ 4. The venture adapts to include them
151
+
152
+ Example:
153
+ - I start with: Database tool idea
154
+ - Partner 1 commits: Brings sales experience, shifts to B2B
155
+ - Partner 2 commits: Brings design, shifts to user-facing product
156
+ - Customer 1 commits: Brings specific use case, shapes roadmap
157
+
158
+ The venture becomes what committed partners make it.
159
+ ```
160
+
161
+ ### 4. Lemonade (Leverage Contingencies)
162
+
163
+ Treat surprises as opportunities:
164
+
165
+ ```markdown
166
+ ## Contingency Response
167
+
168
+ Causal mindset: "That wasn't in the plan—it's a problem"
169
+ Effectual mindset: "That's unexpected—how can we use it?"
170
+
171
+ Examples:
172
+ - Competitor launches similar product
173
+ Causal: "Our plan is threatened"
174
+ Effectual: "They validated market, potential acquirer, potential partner"
175
+
176
+ - Key hire falls through
177
+ Causal: "We're behind plan"
178
+ Effectual: "Maybe we don't need that role; what can we do with who we have?"
179
+
180
+ - Customer wants something different
181
+ Causal: "That's not our product"
182
+ Effectual: "Maybe that IS our product"
183
+ ```
184
+
185
+ ### 5. Pilot in the Plane (Control, Don't Predict)
186
+
187
+ Focus on what you can control:
188
+
189
+ ```markdown
190
+ ## Control vs Predict
191
+
192
+ Can't control/predict:
193
+ - Market movements
194
+ - Competitor actions
195
+ - Customer adoption rate
196
+ - Economic conditions
197
+ - Technology shifts
198
+
199
+ Can control:
200
+ - Who I work with
201
+ - What I build this week
202
+ - How I respond to feedback
203
+ - What partnerships I form
204
+ - How much I risk
205
+
206
+ Strategy: Maximize actions on controllable factors
207
+ Don't waste energy predicting uncontrollable factors
208
+ Create the future through action, not prediction
209
+ ```
210
+
211
+ ## Effectuation Process
212
+
213
+ ### Step 1: Inventory Your Means
214
+
215
+ ```markdown
216
+ ## Means Inventory
217
+
218
+ ### Who I Am
219
+ - Background: [Experience, skills, identity]
220
+ - Passions: [What energizes me]
221
+ - Values: [What I won't compromise]
222
+
223
+ ### What I Know
224
+ - Professional knowledge: [Domains]
225
+ - Technical skills: [Abilities]
226
+ - Market insights: [What I understand that others might not]
227
+
228
+ ### Who I Know
229
+ - Close network: [People who would take my call]
230
+ - Extended network: [People who know people]
231
+ - Communities: [Groups I'm part of]
232
+ ```
233
+
234
+ ### Step 2: Define Affordable Loss
235
+
236
+ ```markdown
237
+ ## Affordable Loss
238
+
239
+ Time I can invest: [Hours/week, months]
240
+ Money I can lose: [$X]
241
+ Reputation at stake: [What's the downside?]
242
+ Opportunity cost: [What else am I not doing?]
243
+
244
+ Maximum I'm willing to lose: [Clear boundary]
245
+ ```
246
+
247
+ ### Step 3: Take Action
248
+
249
+ ```markdown
250
+ ## Next Action
251
+
252
+ Given my means and affordable loss:
253
+ What's the smallest action that could create information?
254
+
255
+ Options:
256
+ 1. [Action] - Teaches me [what]
257
+ 2. [Action] - Teaches me [what]
258
+ 3. [Action] - Teaches me [what]
259
+
260
+ Selected action: [Action with best learning/risk ratio]
261
+ ```
262
+
263
+ ### Step 4: Seek Commitments
264
+
265
+ ```markdown
266
+ ## Partnership Outreach
267
+
268
+ Who might be interested in co-creating?
269
+
270
+ | Person | Their Means | Ask | Commitment |
271
+ |--------|-------------|-----|------------|
272
+ | [Name] | [Skills/resources] | [What to ask] | [What they commit] |
273
+
274
+ Each commitment expands my means and shapes the direction.
275
+ ```
276
+
277
+ ### Step 5: Adapt and Iterate
278
+
279
+ ```markdown
280
+ ## Iteration Log
281
+
282
+ | Action | Outcome | Surprise | How to leverage |
283
+ |--------|---------|----------|-----------------|
284
+ | | | | |
285
+
286
+ After each action:
287
+ - What did I learn?
288
+ - What commitments emerged?
289
+ - What contingencies can I leverage?
290
+ - What's the next action?
291
+ ```
292
+
293
+ ## Effectuation Template
294
+
295
+ ```markdown
296
+ # Effectuation Analysis: [Venture/Project]
297
+
298
+ ## Means Inventory
299
+ Who I am: [Identity, skills, values]
300
+ What I know: [Knowledge, expertise]
301
+ Who I know: [Network, relationships]
302
+
303
+ ## Affordable Loss
304
+ Can afford: [Time, money, reputation]
305
+ Cannot afford: [Boundaries]
306
+ Maximum loss I'm willing to accept: [Clear number]
307
+
308
+ ## Current Commitments
309
+ | Partner | Their Means | Commitment |
310
+ |---------|-------------|------------|
311
+ | | | |
312
+
313
+ ## Contingencies Available
314
+ | Surprise | Potential Leverage |
315
+ |----------|-------------------|
316
+ | | |
317
+
318
+ ## Next Action
319
+ Action: [Specific, small action]
320
+ Affordable loss: [What's at stake]
321
+ Learning goal: [What I'll know after]
322
+
323
+ ## Emerging Direction
324
+ Where seems to be going: [Current trajectory]
325
+ How it differs from start: [Evolution]
326
+ ```
327
+
328
+ ## When to Use Causal vs Effectual
329
+
330
+ | Context | Approach | Why |
331
+ |---------|----------|-----|
332
+ | Existing market, proven model | Causal | Prediction is reliable |
333
+ | New market, unproven model | Effectual | Prediction is unreliable |
334
+ | Abundant resources | Causal | Can afford to plan extensively |
335
+ | Constrained resources | Effectual | Must work with what you have |
336
+ | Clear goal | Causal | Plan toward the goal |
337
+ | Exploring opportunities | Effectual | Goals emerge from action |
338
+ | Risk can be calculated | Causal | Expected return is meaningful |
339
+ | Risk is uncertain | Effectual | Affordable loss is meaningful |
340
+
341
+ ## Verification Checklist
342
+
343
+ - [ ] Inventoried available means
344
+ - [ ] Defined affordable loss (not expected return)
345
+ - [ ] Sought commitments, not just resources
346
+ - [ ] Treating surprises as opportunities
347
+ - [ ] Focusing on what I can control
348
+ - [ ] Taking action to learn, not to execute plan
349
+ - [ ] Letting goals emerge from action
350
+
351
+ ## Key Questions
352
+
353
+ - "What can I do with what I have?"
354
+ - "What am I willing to lose?"
355
+ - "Who might want to co-create this?"
356
+ - "How can I leverage this surprise?"
357
+ - "What can I control right now?"
358
+ - "What's the smallest action that teaches me something?"
359
+
360
+ ## Sarasvathy's Wisdom
361
+
362
+ "Effectual reasoning does not begin with a specific goal. Instead, it begins with a given set of means and allows goals to emerge contingently over time from the varied imaginations and diverse aspirations of the founders and the people they interact with."
363
+
364
+ "In the face of an uncertain future, entrepreneurs use effectual logic to fabricate—make—the future, rather than try to find or predict it."
365
+
366
+ You can't predict the future. But you can create it through action. Start with your means, take affordable risks, build with partners, leverage surprises, and control what you can. The goal will find you.