@polderlabs/bizar 10.7.0 → 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 (148) 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/bizar-dash/skills/publishing/SKILL.md +2 -1
  141. package/cli/install/postinstall.mjs +54 -28
  142. package/cli/install/postinstall.test.mjs +98 -0
  143. package/cli/provision.mjs +29 -0
  144. package/install.sh +7 -0
  145. package/package.json +7 -2
  146. package/scripts/git-hooks/__tests__/commit-msg.test.mjs +61 -0
  147. package/scripts/git-hooks/commit-msg +38 -0
  148. package/scripts/install-hooks.sh +9 -0
@@ -0,0 +1,360 @@
1
+ ---
2
+ name: thinking-model-router
3
+ description: Route to the right mental model based on your domain and problem type. The single entry point for all thinking skills.
4
+ ---
5
+
6
+ # Model Router
7
+
8
+ ## Overview
9
+
10
+ This is the **master routing skill** for all mental models. Instead of knowing 38 frameworks, start here. Identify your domain and problem type, and this skill points you to the right model(s). Think of it as the "which tool do I use?" guide.
11
+
12
+ **Core Principle:** Don't memorize models—memorize how to find the right one. Domain + Problem Type → Model.
13
+
14
+ ## Short-Circuit: Skip the Router
15
+
16
+ **If you already know the right model, invoke it directly — don't route.** This skill is for when you're *unsure* which model fits. If the problem obviously calls for a specific model (e.g., "where's the bottleneck?" → theory-of-constraints; "how would an attacker break this?" → red-team), go straight to it. Routing is overhead you only pay when the match isn't obvious. Likewise, if no model clearly helps, just reason directly — don't force one.
17
+
18
+ ## Quick Router
19
+
20
+ ### Step 1: What's Your Domain?
21
+
22
+ | Domain | You're working on... |
23
+ |--------|---------------------|
24
+ | **Coding/Debugging** | Bugs, errors, performance issues, root cause |
25
+ | **Architecture** | System design, technical decisions, scalability |
26
+ | **Product** | Features, user needs, prioritization, roadmap |
27
+ | **Business Strategy** | Competition, growth, market, organization |
28
+ | **Personal Decisions** | Career, life choices, major commitments |
29
+ | **Abstract/Analytical** | Arguments, ideas, theories, pure reasoning |
30
+ | **Risk/Safety** | What could go wrong, preparation, resilience |
31
+ | **Innovation** | New ideas, breakthroughs, creative solutions |
32
+
33
+ ### Step 2: What's Your Problem Type?
34
+
35
+ | Type | You need to... |
36
+ |------|----------------|
37
+ | **Diagnose** | Find root cause, understand why |
38
+ | **Decide** | Choose between options |
39
+ | **Understand** | Grasp how something works |
40
+ | **Create** | Generate new solutions |
41
+ | **Evaluate** | Judge quality or validity |
42
+ | **Predict** | Forecast outcomes |
43
+ | **Optimize** | Improve performance |
44
+
45
+ ---
46
+
47
+ ## Domain → Model Maps
48
+
49
+ ### 🖥️ Coding & Debugging
50
+
51
+ ```
52
+ PROBLEM → MODEL(S)
53
+ ─────────────────────────────────────────────────────
54
+ Bug with unknown cause → Scientific Method, 5 Whys Plus
55
+ Performance degradation → Theory of Constraints, Systems Thinking
56
+ Spans multiple services → Systems Thinking, Feedback Loops
57
+ Incident postmortem → 5 Whys Plus, Systems Thinking
58
+ Flaky/intermittent behavior → Scientific Method (hypothesis testing)
59
+ "It works on my machine" → Map-Territory (model vs reality gap)
60
+ ```
61
+
62
+ **Default for debugging:** Start with **5 Whys Plus**, escalate to **Systems Thinking** if it spans components.
63
+
64
+ ---
65
+
66
+ ### 🏗️ Architecture & Technical Decisions
67
+
68
+ ```
69
+ PROBLEM → MODEL(S)
70
+ ─────────────────────────────────────────────────────
71
+ Technology choice → Lindy Effect, Reversibility
72
+ Build vs buy → Opportunity Cost, First Principles
73
+ Scalability design → Systems Thinking, Leverage Points
74
+ Microservices vs monolith → Cynefin, Reversibility
75
+ Database selection → Lindy Effect, Theory of Constraints
76
+ API design tradeoffs → TRIZ (resolve contradictions)
77
+ Should we rewrite? → Second-Order, Opportunity Cost
78
+ ```
79
+
80
+ **Default for architecture:** Start with **Reversibility** (is this Type 1 or Type 2?), then **Systems Thinking** for interconnections.
81
+
82
+ ---
83
+
84
+ ### 📦 Product & Feature Development
85
+
86
+ ```
87
+ PROBLEM → MODEL(S)
88
+ ─────────────────────────────────────────────────────
89
+ What should we build? → Jobs to be Done
90
+ Feature prioritization → Opportunity Cost, Theory of Constraints
91
+ Why aren't users engaging? → Jobs to be Done, 5 Whys Plus
92
+ New product exploration → Effectuation, First Principles
93
+ Should we pivot? → Regret Minimization, Reversibility
94
+ Product-market fit → Jobs to be Done, Bayesian
95
+ Roadmap planning → Theory of Constraints, Opportunity Cost
96
+ A/B test interpretation → Bayesian, Probabilistic
97
+ ```
98
+
99
+ **Default for product:** Start with **Jobs to be Done** (what job is the user hiring this for?).
100
+
101
+ ---
102
+
103
+ ### 📈 Business Strategy
104
+
105
+ ```
106
+ PROBLEM → MODEL(S)
107
+ ─────────────────────────────────────────────────────
108
+ Competitive analysis → Red Team, Second-Order
109
+ Market entry → Cynefin, Effectuation
110
+ Growth strategy → Feedback Loops, Leverage Points
111
+ Organizational dysfunction → Archetypes, Systems Thinking
112
+ Resource allocation → Theory of Constraints, Opportunity Cost
113
+ Startup strategy → Effectuation, Margin of Safety
114
+ M&A evaluation → Pre-mortem, Steel-manning
115
+ Pricing decisions → First Principles, Fermi Estimation
116
+ ```
117
+
118
+ **Default for strategy:** Start with **Cynefin** (what domain is this problem in?), then match approach.
119
+
120
+ ---
121
+
122
+ ### 🧑 Personal & Career Decisions
123
+
124
+ ```
125
+ PROBLEM → MODEL(S)
126
+ ─────────────────────────────────────────────────────
127
+ Should I take this job? → Regret Minimization, Reversibility
128
+ Career direction → Circle of Competence, Regret Minimization
129
+ Major life decision → Regret Minimization, Pre-mortem
130
+ Learning what to learn → Circle of Competence, Lindy Effect
131
+ Negotiation prep → Steel-manning, Red Team
132
+ Should I start a company? → Effectuation, Margin of Safety, Pre-mortem
133
+ Time allocation → Opportunity Cost, Theory of Constraints
134
+ ```
135
+
136
+ **Default for personal:** Start with **Regret Minimization** (what will 80-year-old you think?).
137
+
138
+ ---
139
+
140
+ ### 🧠 Abstract & Analytical Thinking
141
+
142
+ ```
143
+ PROBLEM → MODEL(S)
144
+ ─────────────────────────────────────────────────────
145
+ Evaluating an argument → Steel-manning, Bayesian
146
+ Challenging assumptions → First Principles, Socratic
147
+ Estimating unknowns → Fermi Estimation, Probabilistic
148
+ Updating beliefs → Bayesian, Probabilistic
149
+ Exploring edge cases → Thought Experiment, Inversion
150
+ Finding logical flaws → Inversion, Steel-manning
151
+ Complex causation → Systems Thinking, Feedback Loops
152
+ Philosophical questions → Thought Experiment, First Principles
153
+ ```
154
+
155
+ **Default for abstract:** Start with **Steel-manning** (argue the strongest opposing view first).
156
+
157
+ ---
158
+
159
+ ### ⚠️ Risk & Safety
160
+
161
+ ```
162
+ PROBLEM → MODEL(S)
163
+ ─────────────────────────────────────────────────────
164
+ What could go wrong? → Pre-mortem, Red Team
165
+ Security review → Red Team, Inversion
166
+ Disaster preparation → Pre-mortem, Margin of Safety
167
+ Avoiding catastrophic failure → Margin of Safety, Via Negativa
168
+ Stress-testing plans → Red Team, Pre-mortem
169
+ Probability of failure → Probabilistic, Bayesian
170
+ Building resilience → Via Negativa, Margin of Safety
171
+ ```
172
+
173
+ **Default for risk:** Start with **Pre-mortem** (assume failure, explain why).
174
+
175
+ ---
176
+
177
+ ### 💡 Innovation & Creativity
178
+
179
+ ```
180
+ PROBLEM → MODEL(S)
181
+ ─────────────────────────────────────────────────────
182
+ Breakthrough needed → First Principles, TRIZ
183
+ Stuck on contradictions → TRIZ
184
+ Limited resources → Effectuation, Via Negativa
185
+ Simplification → Via Negativa, Occam's Razor
186
+ Challenging "impossible" → First Principles, TRIZ
187
+ New market creation → Effectuation, Jobs to be Done
188
+ Removing complexity → Via Negativa, Occam's Razor
189
+ ```
190
+
191
+ **Default for innovation:** Start with **First Principles** (strip to fundamentals, rebuild).
192
+
193
+ ---
194
+
195
+ ## Quick Reference Card
196
+
197
+ ```
198
+ ┌─────────────────────────────────────────────────────────────────┐
199
+ │ MENTAL MODEL QUICK ROUTER │
200
+ ├─────────────────────────────────────────────────────────────────┤
201
+ │ │
202
+ │ "Why is this broken?" → 5 Whys Plus, Scientific Method │
203
+ │ "How does this system work?" → Systems Thinking, Feedback Loops│
204
+ │ "What should we build?" → Jobs to be Done │
205
+ │ "Should I do this?" → Reversibility, Regret Min │
206
+ │ "What could go wrong?" → Pre-mortem, Red Team │
207
+ │ "How do I innovate?" → First Principles, TRIZ │
208
+ │ "What's the probability?" → Bayesian, Probabilistic │
209
+ │ "Where's the bottleneck?" → Theory of Constraints │
210
+ │ "What am I giving up?" → Opportunity Cost │
211
+ │ "Is this argument valid?" → Steel-manning │
212
+ │ "Will this technology last?" → Lindy Effect │
213
+ │ "How complex is this?" → Cynefin │
214
+ │ "What to remove?" → Via Negativa │
215
+ │ "Is this safe enough?" → Margin of Safety │
216
+ │ │
217
+ └─────────────────────────────────────────────────────────────────┘
218
+ ```
219
+
220
+ ## Decision Flow
221
+
222
+ ```
223
+ START HERE
224
+
225
+
226
+ ┌─────────────────────┐
227
+ │ What's your domain? │
228
+ └──────────┬──────────┘
229
+
230
+ ┌─────┴─────┬──────────┬──────────┬──────────┐
231
+ ▼ ▼ ▼ ▼ ▼
232
+ Coding Architecture Product Strategy Personal
233
+ │ │ │ │ │
234
+ ▼ ▼ ▼ ▼ ▼
235
+ ┌─────────────────────┐
236
+ │ What problem type? │
237
+ │ Diagnose/Decide/ │
238
+ │ Understand/Create/ │
239
+ │ Evaluate/Predict │
240
+ └──────────┬──────────┘
241
+
242
+
243
+ ┌─────────────────────┐
244
+ │ Look up in domain │
245
+ │ table above │
246
+ └──────────┬──────────┘
247
+
248
+
249
+ ┌─────────────────────┐
250
+ │ Single model enough?│
251
+ └──────────┬──────────┘
252
+
253
+ ┌──────┴──────┐
254
+ ▼ ▼
255
+ YES NO
256
+ │ │
257
+ ▼ ▼
258
+ Apply it Use Model Combination
259
+ (Sequential/Parallel/Nested)
260
+ ```
261
+
262
+ ## Model Inventory by Category
263
+
264
+ ### Diagnostic Models (Find root cause)
265
+ - `5 Whys Plus` - Iterative "why" with bias guards
266
+ - `Scientific Method` - Hypothesis → Test → Learn
267
+ - `Kepner-Tregoe` - Systematic problem/decision analysis
268
+
269
+ ### Decision Models (Choose wisely)
270
+ - `Reversibility` - Type 1 vs Type 2 decisions
271
+ - `Regret Minimization` - What will future-you think?
272
+ - `Opportunity Cost` - What are you giving up?
273
+ - `Bayesian` - Update beliefs with evidence
274
+ - `Probabilistic` - Calibrated probability estimates
275
+
276
+ ### Systems Models (Understand interconnections)
277
+ - `Systems Thinking` - Feedback, emergence, non-linearity
278
+ - `Feedback Loops` - Reinforcing and balancing loops
279
+ - `Theory of Constraints` - Find and exploit the bottleneck
280
+ - `Leverage Points` - Where small changes have big effects
281
+ - `Archetypes` - Recurring system patterns
282
+
283
+ ### Risk Models (Prepare for failure)
284
+ - `Pre-mortem` - Assume failure, explain why
285
+ - `Red Team` - Attack your own plan
286
+ - `Margin of Safety` - Build in buffers
287
+ - `Inversion` - Identify paths to failure, avoid them
288
+
289
+ ### Innovation Models (Create breakthroughs)
290
+ - `First Principles` - Strip to fundamentals, rebuild
291
+ - `TRIZ` - Resolve technical contradictions
292
+ - `Effectuation` - Start with means, not goals
293
+ - `Via Negativa` - Improve by removing
294
+
295
+ ### Evaluation Models (Judge quality)
296
+ - `Steel-manning` - Argue strongest opposing view
297
+ - `Lindy Effect` - Older = likely to last longer
298
+ - `Circle of Competence` - Know your expertise boundaries
299
+ - `Occam's Razor` - Prefer simpler explanations
300
+
301
+ ### Context Models (Match approach to situation)
302
+ - `Cynefin` - Clear/Complicated/Complex/Chaotic domains
303
+ - `Model Selection` - Choose the right model
304
+ - `Model Combination` - Use multiple models together
305
+
306
+ ### Product Models (Build the right thing)
307
+ - `Jobs to be Done` - What job is user hiring this for?
308
+ - `Thought Experiment` - Structured imagination
309
+
310
+ ### Estimation Models (Size unknowns)
311
+ - `Fermi Estimation` - Order-of-magnitude calculations
312
+
313
+ ## When to Combine Models
314
+
315
+ Use **Model Combination** when:
316
+
317
+ | Situation | Combination Pattern | Example |
318
+ |-----------|--------------------| --------|
319
+ | High-stakes decision | Sequential | Reversibility → Pre-mortem → Opportunity Cost |
320
+ | System diagnosis | Nested | Cynefin (macro) → ToC (meso) → OODA (micro) |
321
+ | Validating strategy | Parallel | Red Team + Steel-manning + Second-Order |
322
+ | Innovation under constraints | Sequential | First Principles → TRIZ → Effectuation |
323
+ | Career decision | Temporal | 5 Whys (past) → Circle of Competence (present) → Regret Min (future) |
324
+
325
+ ## Template
326
+
327
+ ```markdown
328
+ # Model Router Analysis
329
+
330
+ ## Context
331
+ Domain: [Coding/Architecture/Product/Strategy/Personal/Abstract/Risk/Innovation]
332
+ Problem: [Brief description]
333
+ Problem Type: [Diagnose/Decide/Understand/Create/Evaluate/Predict/Optimize]
334
+
335
+ ## Routed Models
336
+ Primary: [Main model to use]
337
+ Secondary: [If needed]
338
+ Combination pattern: [Sequential/Parallel/Nested/None]
339
+
340
+ ## Application
341
+ [Apply the selected model(s) here]
342
+
343
+ ## Verification
344
+ - [ ] Domain correctly identified
345
+ - [ ] Problem type matches
346
+ - [ ] Model fits the situation
347
+ - [ ] Considered if combination needed
348
+ ```
349
+
350
+ ## Key Questions
351
+
352
+ - "What domain am I operating in?"
353
+ - "What type of problem is this—diagnose, decide, understand, create, or evaluate?"
354
+ - "What's the default model for this domain + type?"
355
+ - "Does one model cover it, or do I need to combine?"
356
+ - "Am I using a model because it fits, or because it's familiar?"
357
+
358
+ ---
359
+
360
+ **Remember:** You don't need to know all 38 models. You need to know how to find the right one. Start with domain, identify problem type, look it up, apply. That's it.
@@ -0,0 +1,341 @@
1
+ ---
2
+ name: thinking-model-selection
3
+ description: Choose the right mental model for the problem at hand. Use when facing new problems, when current approaches fail, or when you need to match tool to context.
4
+ ---
5
+
6
+ # Model Selection
7
+
8
+ > **Overlaps thinking-model-router.** If you already know which model fits, skip routing entirely and just invoke that model. If you don't, **thinking-model-router** is the single entry point — start there. This skill goes deeper on *how* to classify a problem and *when to abandon* a model once chosen. (Audit recommends merging this into thinking-model-router; for now, prefer the router as the front door.)
9
+
10
+ ## Overview
11
+
12
+ Every mental model has a domain where it excels and domains where it fails. Model selection is the meta-skill of recognizing which model fits which problem. The expert doesn't just know many models—they know when to apply each one. Using the wrong model is often worse than using no model at all.
13
+
14
+ **Core Principle:** The map is not the territory. Choose the map that best serves your journey.
15
+
16
+ ## When to Use
17
+
18
+ - Facing a new problem type
19
+ - Current approach isn't working
20
+ - Multiple stakeholders suggest different frameworks
21
+ - Deciding how to structure analysis
22
+ - Teaching others which tools to use
23
+ - Building decision-making processes
24
+
25
+ Decision flow:
26
+
27
+ ```
28
+ Facing a problem?
29
+ → Have you identified the problem type? → no → CLASSIFY THE PROBLEM FIRST
30
+ → Does your usual model fit? → no → CONSIDER ALTERNATIVES
31
+ → Are you using a model by habit? → yes → QUESTION THE FIT
32
+ ```
33
+
34
+ ## When NOT to Use
35
+
36
+ - **You don't know which thinking tool to reach for.** Start with `thinking-model-router` — it is the single entry point that routes to the right skill. This skill goes deeper on *how* to classify problems and match models, but only after the router has narrowed the field.
37
+ - **You've already classified the problem type.** If you know it's a debugging problem, just invoke `thinking-scientific-method` or `thinking-five-whys-plus` directly. Don't run a full model-selection exercise to confirm what you already know.
38
+ - **The problem is routine and your default approach fits.** Model selection adds overhead; on a familiar problem, use the model you know works.
39
+ - **You're tempted to run this as a first step on every task.** That turns a meta-skill into a tax. Most tasks don't need model selection — they need execution. Reserve this for when your usual approach has demonstrably failed.
40
+
41
+ > **Redirect:** For nearly all cases, start with `thinking-model-router` — it classifies the problem and dispatches to the right skill in one pass. This skill is the reference for *how* that classification works, not a replacement for the router.
42
+
43
+ ## Trigger Card
44
+
45
+ When your usual problem-solving approach has demonstrably failed and you need to match a different tool to the task:
46
+
47
+ 1. **Classify the problem:** Diagnostic / Decision / Understanding / Creative / Evaluation.
48
+ 2. **Check the constraint:** Time pressure? Information gaps? High stakes? Complexity?
49
+ 3. **Match:** Use the Problem-Model Matching table below to find the category → select the specific model.
50
+ 4. **Set an exit criterion:** If no insight in 15+ minutes or key facts don't fit, switch.
51
+
52
+ If you don't know which approach to use at all, start with `thinking-model-router` — it does the classification and dispatch in one pass.
53
+
54
+ ## Problem-Model Matching
55
+
56
+ ### Step 1: Classify the Problem
57
+
58
+ ```markdown
59
+ ## Problem Classification
60
+
61
+ Problem: [Describe the problem]
62
+
63
+ Problem dimensions:
64
+ | Dimension | Assessment |
65
+ |-----------|------------|
66
+ | Predictability | Can outcomes be predicted? [High/Medium/Low] |
67
+ | Complexity | How many interacting parts? [Simple/Complicated/Complex] |
68
+ | Time horizon | When do consequences matter? [Immediate/Short/Long] |
69
+ | Reversibility | Can decisions be undone? [Easily/With difficulty/Not at all] |
70
+ | Information | How much do you know? [Complete/Partial/Minimal] |
71
+ | Stakeholders | Who's affected? [Individual/Team/Organization/Society] |
72
+ ```
73
+
74
+ ### Step 2: Match to Model Categories
75
+
76
+ ```markdown
77
+ ## Model Category Matching
78
+
79
+ Based on classification, which category fits?
80
+
81
+ | Problem Type | Model Category | Examples |
82
+ |--------------|----------------|----------|
83
+ | Root cause unknown | Diagnostic models | 5 Whys, Scientific Method, Kepner-Tregoe |
84
+ | Decision under uncertainty | Probabilistic models | Bayesian, Expected Value, Regret Minimization |
85
+ | System behavior | Systems models | Feedback Loops, Leverage Points, Archetypes |
86
+ | Cognitive bias risk | Debiasing models | Pre-mortem, Red Team, Steel-manning |
87
+ | Resource allocation | Constraint models | Theory of Constraints, Opportunity Cost |
88
+ | Innovation/exploration | Generative models | First Principles, TRIZ, Effectuation |
89
+ | Domain classification | Meta models | Cynefin, Circle of Competence |
90
+ ```
91
+
92
+ ### Step 3: Select Specific Model
93
+
94
+ ```markdown
95
+ ## Model Selection
96
+
97
+ Category: [From Step 2]
98
+
99
+ Candidate models:
100
+ | Model | Fit Score | Strengths for This Problem | Weaknesses |
101
+ |-------|-----------|---------------------------|------------|
102
+ | [Model 1] | [1-5] | [Why it fits] | [Limitations] |
103
+ | [Model 2] | [1-5] | [Why it fits] | [Limitations] |
104
+ | [Model 3] | [1-5] | [Why it fits] | [Limitations] |
105
+
106
+ Selected model: [Choice]
107
+ Rationale: [Why this model for this problem]
108
+ ```
109
+
110
+ ## Model Selection Matrix
111
+
112
+ ### By Problem Type
113
+
114
+ ```
115
+ DIAGNOSTIC PROBLEMS (What's causing this?)
116
+ ├── Known categories exist → Kepner-Tregoe (systematic analysis)
117
+ ├── Need pam root cause → 5 Whys Plus (iterative drilling)
118
+ ├── Hypothesis-driven → Scientific Method (test and falsify)
119
+ └── System-wide issue → Feedback Loops (find reinforcing patterns)
120
+
121
+ DECISION PROBLEMS (What should we do?)
122
+ ├── High stakes, irreversible → Regret Minimization, Pre-mortem
123
+ ├── Under uncertainty → Bayesian, Probabilistic Thinking
124
+ ├── Resource constrained → Opportunity Cost, Theory of Constraints
125
+ ├── Multiple options → Kepner-Tregoe (decision analysis)
126
+ └── Type 1 vs Type 2 → Reversibility Framework
127
+
128
+ UNDERSTANDING PROBLEMS (How does this work?)
129
+ ├── Complex system → Systems Thinking, Feedback Loops
130
+ ├── Human behavior → Jobs to Be Done, Incentive Analysis
131
+ ├── Organizational → Archetypes, Leverage Points
132
+ └── Competitive → Red Team, Game Theory
133
+
134
+ CREATIVE PROBLEMS (How might we...?)
135
+ ├── Break assumptions → First Principles, TRIZ
136
+ ├── Limited resources → Effectuation, Via Negativa
137
+ ├── Technical contradiction → TRIZ
138
+ └── Unknown territory → Thought Experiments, Cynefin (probe)
139
+
140
+ EVALUATION PROBLEMS (Is this good?)
141
+ ├── Arguments/proposals → Steel-manning, Red Team
142
+ ├── Predictions → Probabilistic, Calibration
143
+ ├── Longevity → Lindy Effect
144
+ ├── Safety → Margin of Safety, Pre-mortem
145
+ └── Expertise fit → Circle of Competence
146
+ ```
147
+
148
+ ### By Domain
149
+
150
+ ```markdown
151
+ ## Domain-Model Mapping
152
+
153
+ | Domain | Primary Models | Why |
154
+ |--------|---------------|-----|
155
+ | Debugging | Scientific Method, 5 Whys | Hypothesis-differential localization, root cause |
156
+ | Architecture | Systems Thinking, Leverage Points | Interconnections, intervention |
157
+ | Product | Jobs to Be Done, Cynefin | User needs, complexity |
158
+ | Strategy | Red Team, Pre-mortem | Adversarial, risk |
159
+ | Performance | Theory of Constraints, Fermi | Bottlenecks, estimation |
160
+ | Decisions | Reversibility, Regret Minimization | Stakes assessment |
161
+ | Innovation | First Principles, TRIZ | Breakthrough thinking |
162
+ | Risk | Margin of Safety, Probabilistic | Uncertainty handling |
163
+ ```
164
+
165
+ ## Model Failure Modes
166
+
167
+ ### Using the Wrong Model
168
+
169
+ ```markdown
170
+ ## Model Mismatch Indicators
171
+
172
+ Signs you're using the wrong model:
173
+ - Analysis feels forced or awkward
174
+ - Key aspects don't fit the framework
175
+ - You're ignoring important factors
176
+ - Results don't match intuition consistently
177
+ - Stakeholders don't recognize the framing
178
+
179
+ Common mismatches:
180
+ | Situation | Wrong Model | Right Model |
181
+ |-----------|-------------|-------------|
182
+ | Complex adaptive system | Root cause analysis | Systems thinking |
183
+ | Simple process problem | Systems thinking | Checklist/SOP |
184
+ | Uncertain future | Detailed planning | Effectuation |
185
+ | Known domain | First principles | Best practices |
186
+ | Political problem | Technical analysis | Stakeholder mapping |
187
+ ```
188
+
189
+ ### Model Overuse
190
+
191
+ ```markdown
192
+ ## Model Overuse Patterns
193
+
194
+ "When you have a hammer, everything looks like a nail"
195
+
196
+ Signs of overuse:
197
+ - You use the same model for every problem
198
+ - You haven't learned new models recently
199
+ - Problems that don't fit are "forced" into the model
200
+ - You dismiss problems that don't fit your model
201
+
202
+ Fix: Deliberately practice with unfamiliar models
203
+ Ask: "What model would someone else use?"
204
+ Rotate models intentionally
205
+ ```
206
+
207
+ ## Model Selection Process
208
+
209
+ ### Quick Selection (< 2 minutes)
210
+
211
+ ```markdown
212
+ ## Quick Model Selection
213
+
214
+ 1. What type of problem? [Diagnostic/Decision/Understanding/Creative/Evaluation]
215
+ 2. What's the constraint? [Time/Information/Stakes/Complexity]
216
+ 3. What's the default model for this type?
217
+ 4. Any reason NOT to use the default?
218
+ 5. Proceed or reconsider
219
+
220
+ Default models by type:
221
+ - Diagnostic → 5 Whys Plus
222
+ - Decision → Reversibility check first
223
+ - Understanding → Systems Thinking
224
+ - Creative → First Principles
225
+ - Evaluation → Steel-manning
226
+ ```
227
+
228
+ ### Deliberate Selection (> 5 minutes)
229
+
230
+ ```markdown
231
+ ## Deliberate Model Selection
232
+
233
+ 1. Characterize the problem fully
234
+ 2. Identify 3-5 candidate models
235
+ 3. Score each on fit
236
+ 4. Consider combining models
237
+ 5. Select and document rationale
238
+ 6. Plan to reassess if model doesn't illuminate
239
+
240
+ Selection criteria:
241
+ | Criterion | Weight | Model A | Model B | Model C |
242
+ |-----------|--------|---------|---------|---------|
243
+ | Problem fit | 30% | | | |
244
+ | Available info | 20% | | | |
245
+ | Time to apply | 15% | | | |
246
+ | Stakeholder acceptance | 15% | | | |
247
+ | My competence with model | 20% | | | |
248
+ ```
249
+
250
+ ## Model Selection Template
251
+
252
+ ```markdown
253
+ # Model Selection: [Problem]
254
+
255
+ ## Problem Characterization
256
+ Type: [Diagnostic/Decision/Understanding/Creative/Evaluation]
257
+ Complexity: [Simple/Complicated/Complex/Chaotic]
258
+ Stakes: [Low/Medium/High]
259
+ Reversibility: [High/Medium/Low]
260
+ Information: [Complete/Partial/Minimal]
261
+
262
+ ## Candidate Models
263
+ | Model | Fit | Strengths | Weaknesses |
264
+ |-------|-----|-----------|------------|
265
+ | | | | |
266
+
267
+ ## Selected Model
268
+ Model: [Choice]
269
+ Rationale: [Why this model]
270
+
271
+ ## Fallback
272
+ If selected model doesn't work: [Alternative]
273
+ Signs to switch: [Indicators]
274
+
275
+ ## Application Plan
276
+ How I'll use this model:
277
+ 1. [Step]
278
+ 2. [Step]
279
+ ```
280
+
281
+ ## Meta-Model Guidelines
282
+
283
+ ### When to Use Multiple Models
284
+
285
+ ```markdown
286
+ ## Model Combination Triggers
287
+
288
+ Use multiple models when:
289
+ - Problem spans multiple types
290
+ - Single model leaves blind spots
291
+ - Stakes are very high
292
+ - Time allows deeper analysis
293
+
294
+ Combination patterns:
295
+ - Sequential: Use A to narrow, then B to decide
296
+ - Parallel: Use A and B independently, compare results
297
+ - Nested: Use A at macro level, B at micro level
298
+ ```
299
+
300
+ ### When to Abandon a Model
301
+
302
+ ```markdown
303
+ ## Model Exit Criteria
304
+
305
+ Stop using a model when:
306
+ - 15+ minutes with no insight
307
+ - Key facts don't fit the framework
308
+ - You're forcing the analysis
309
+ - Someone suggests a better fit
310
+
311
+ Don't stop just because:
312
+ - The answer is uncomfortable
313
+ - It requires more work
314
+ - Results disagree with intuition (investigate why)
315
+ ```
316
+
317
+ ## Verification Checklist
318
+
319
+ - [ ] Classified the problem type
320
+ - [ ] Considered multiple candidate models
321
+ - [ ] Checked for model-problem fit
322
+ - [ ] Avoided using model out of habit
323
+ - [ ] Have a fallback if model doesn't work
324
+ - [ ] Can articulate why this model fits
325
+
326
+ ## Key Questions
327
+
328
+ - "What type of problem is this really?"
329
+ - "What model would an expert in this domain use?"
330
+ - "Am I using this model because it fits, or because I know it?"
331
+ - "What aspects of the problem does this model ignore?"
332
+ - "What model would give a different answer?"
333
+ - "When should I switch to a different model?"
334
+
335
+ ## Munger's Wisdom
336
+
337
+ "You've got to have models in your head. And you've got to array your experience—both vicarious and direct—on this latticework of models in your head."
338
+
339
+ "You must know the big ideas in the big disciplines, and use them routinely—all of them, not just a few."
340
+
341
+ The power isn't in any single model—it's in having many models and knowing when each applies. A tool is only useful when matched to the task. The meta-skill of model selection multiplies the value of every model you know.