@v587d/capital-generation 2.6.4 → 2.7.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 (113) hide show
  1. package/CHANGELOG.md +89 -0
  2. package/README.md +82 -27
  3. package/THIRD_PARTY_NOTICES.md +43 -0
  4. package/capital-config/client.js +18 -2
  5. package/capital-config/client.src.cjs +161 -20
  6. package/capital-config/index.js +10 -0
  7. package/capital-config/package.json +1 -1
  8. package/capital-watchlist/client.js +48 -7
  9. package/capital-watchlist/client.src.cjs +383 -66
  10. package/capital-watchlist/holding-rules.js +64 -0
  11. package/capital-watchlist/index.js +117 -2
  12. package/capital-watchlist/package.json +2 -1
  13. package/chart-ui/package.json +1 -1
  14. package/lib/agents/selected-skills-provider.d.ts +26 -0
  15. package/lib/agents/selected-skills-provider.js +99 -0
  16. package/lib/index.d.ts +37 -0
  17. package/lib/index.js +45 -11
  18. package/lib/time/tools.d.ts +6 -0
  19. package/lib/time/tools.js +6 -1
  20. package/lib/watchlist/tools.d.ts +52 -0
  21. package/lib/watchlist/tools.js +146 -0
  22. package/lib/web-retriever/local-fetch.d.ts +1 -1
  23. package/lib/web-retriever/local-fetch.js +1 -1
  24. package/lib/web-retriever/wind-client.d.ts +1 -1
  25. package/lib/web-retriever/wind-client.js +1 -1
  26. package/package.json +13 -3
  27. package/preset/capital-generation/agent.patch.yml +7 -0
  28. package/preset/capital-generation/skills/capital-equity-research/SKILL.md +45 -0
  29. package/preset/capital-generation/skills/capital-event-impact/SKILL.md +29 -0
  30. package/preset/capital-generation/skills/capital-portfolio-review/SKILL.md +29 -0
  31. package/selected-skills/README.md +44 -0
  32. package/selected-skills/catalog.js +181 -0
  33. package/selected-skills/china-stock-research-skills/.github/ISSUE_TEMPLATE/bug_report.md +35 -0
  34. package/selected-skills/china-stock-research-skills/.github/ISSUE_TEMPLATE/skill_request.md +28 -0
  35. package/selected-skills/china-stock-research-skills/.github/PULL_REQUEST_TEMPLATE.md +15 -0
  36. package/selected-skills/china-stock-research-skills/CHANGELOG.md +59 -0
  37. package/selected-skills/china-stock-research-skills/CONTRIBUTING.md +121 -0
  38. package/selected-skills/china-stock-research-skills/GITHUB_PUBLISHING.md +259 -0
  39. package/selected-skills/china-stock-research-skills/INSTALL.md +151 -0
  40. package/selected-skills/china-stock-research-skills/LICENSE +21 -0
  41. package/selected-skills/china-stock-research-skills/PUBLISH_CHECKLIST.md +165 -0
  42. package/selected-skills/china-stock-research-skills/README.en.md +209 -0
  43. package/selected-skills/china-stock-research-skills/README.md +209 -0
  44. package/selected-skills/china-stock-research-skills/RELEASE_ASSETS.md +222 -0
  45. package/selected-skills/china-stock-research-skills/ROADMAP.md +45 -0
  46. package/selected-skills/china-stock-research-skills/SKILLS.md +85 -0
  47. package/selected-skills/china-stock-research-skills/UPSTREAM.md +11 -0
  48. package/selected-skills/china-stock-research-skills/examples/full-report-flow.md +20 -0
  49. package/selected-skills/china-stock-research-skills/examples/module-select-cases.md +26 -0
  50. package/selected-skills/china-stock-research-skills/examples/quickstart-prompts.md +25 -0
  51. package/selected-skills/china-stock-research-skills/skills/business-decomposition-order-quality/SKILL.md +55 -0
  52. package/selected-skills/china-stock-research-skills/skills/business-decomposition-order-quality/references/idc-order-ledger-guide.md +34 -0
  53. package/selected-skills/china-stock-research-skills/skills/business-decomposition-order-quality/references/order-quality-checklist.md +16 -0
  54. package/selected-skills/china-stock-research-skills/skills/china-stock-research-orchestrator/SKILL.md +75 -0
  55. package/selected-skills/china-stock-research-skills/skills/china-stock-research-orchestrator/references/final-output-contract.md +62 -0
  56. package/selected-skills/china-stock-research-skills/skills/china-stock-research-orchestrator/references/routing-matrix.md +34 -0
  57. package/selected-skills/china-stock-research-skills/skills/china-stock-research-orchestrator/references/sector-overlay-escalation-rules.md +38 -0
  58. package/selected-skills/china-stock-research-skills/skills/financial-health/SKILL.md +54 -0
  59. package/selected-skills/china-stock-research-skills/skills/financial-health/references/idc-balance-sheet-stress-guide.md +31 -0
  60. package/selected-skills/china-stock-research-skills/skills/financial-health/references/red-flag-checklist.md +14 -0
  61. package/selected-skills/china-stock-research-skills/skills/industry-competition-moat/SKILL.md +54 -0
  62. package/selected-skills/china-stock-research-skills/skills/industry-competition-moat/references/idc-value-chain-and-peers.md +42 -0
  63. package/selected-skills/china-stock-research-skills/skills/industry-competition-moat/references/moat-grid.md +13 -0
  64. package/selected-skills/china-stock-research-skills/skills/risk-warning-catalysts/SKILL.md +54 -0
  65. package/selected-skills/china-stock-research-skills/skills/risk-warning-catalysts/references/idc-monitoring-indicators.md +33 -0
  66. package/selected-skills/china-stock-research-skills/skills/risk-warning-catalysts/references/monitoring-dashboard.md +25 -0
  67. package/selected-skills/china-stock-research-skills/skills/shared/references/analysis-pattern-selector.md +24 -0
  68. package/selected-skills/china-stock-research-skills/skills/shared/references/asset-heavy-ramp-overlay.md +28 -0
  69. package/selected-skills/china-stock-research-skills/skills/shared/references/business-model-transition-overlay.md +28 -0
  70. package/selected-skills/china-stock-research-skills/skills/shared/references/citation-standard.md +48 -0
  71. package/selected-skills/china-stock-research-skills/skills/shared/references/company-disclosure-map.md +37 -0
  72. package/selected-skills/china-stock-research-skills/skills/shared/references/consumer-channel-brand-overlay.md +29 -0
  73. package/selected-skills/china-stock-research-skills/skills/shared/references/cyclical-price-driven-overlay.md +29 -0
  74. package/selected-skills/china-stock-research-skills/skills/shared/references/export-manufacturing-supply-chain-overlay.md +29 -0
  75. package/selected-skills/china-stock-research-skills/skills/shared/references/financial-kpi-dictionary.md +43 -0
  76. package/selected-skills/china-stock-research-skills/skills/shared/references/idc-heavy-asset-transition-overlay.md +73 -0
  77. package/selected-skills/china-stock-research-skills/skills/shared/references/language-output-standard.md +36 -0
  78. package/selected-skills/china-stock-research-skills/skills/shared/references/project-order-business-overlay.md +28 -0
  79. package/selected-skills/china-stock-research-skills/skills/shared/references/regulated-healthcare-policy-overlay.md +29 -0
  80. package/selected-skills/china-stock-research-skills/skills/shared/references/research-output-template.md +50 -0
  81. package/selected-skills/china-stock-research-skills/skills/shared/references/sector-adaptation-checklist.md +42 -0
  82. package/selected-skills/china-stock-research-skills/skills/shared/references/source-registry.md +49 -0
  83. package/selected-skills/china-stock-research-skills/skills/shared/templates/catalyst-calendar.md +5 -0
  84. package/selected-skills/china-stock-research-skills/skills/shared/templates/company-fact-sheet.md +25 -0
  85. package/selected-skills/china-stock-research-skills/skills/shared/templates/evidence-table.md +5 -0
  86. package/selected-skills/china-stock-research-skills/skills/shared/templates/idc-project-ledger.md +5 -0
  87. package/selected-skills/china-stock-research-skills/skills/shared/templates/valuation-scenario-table.md +7 -0
  88. package/selected-skills/china-stock-research-skills/skills/strategy-business-transition/SKILL.md +55 -0
  89. package/selected-skills/china-stock-research-skills/skills/strategy-business-transition/references/idc-transition-markers.md +27 -0
  90. package/selected-skills/china-stock-research-skills/skills/strategy-business-transition/references/transition-scorecard.md +13 -0
  91. package/selected-skills/china-stock-research-skills/skills/valuation-investment-strategy/SKILL.md +55 -0
  92. package/selected-skills/china-stock-research-skills/skills/valuation-investment-strategy/references/idc-valuation-overlays.md +31 -0
  93. package/selected-skills/china-stock-research-skills/skills/valuation-investment-strategy/references/method-selection.md +14 -0
  94. package/selected-skills/investment-skills/.github/workflows/validate.yml +25 -0
  95. package/selected-skills/investment-skills/.tbd/config.yml +107 -0
  96. package/selected-skills/investment-skills/LICENSE +21 -0
  97. package/selected-skills/investment-skills/Makefile +29 -0
  98. package/selected-skills/investment-skills/README.md +253 -0
  99. package/selected-skills/investment-skills/UPSTREAM.md +12 -0
  100. package/selected-skills/investment-skills/docs/development.md +37 -0
  101. package/selected-skills/investment-skills/docs/roadmap.md +25 -0
  102. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +192 -0
  103. package/selected-skills/investment-skills/skills/buffett-investment-framework/agents/openai.yaml +4 -0
  104. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/00-source-key.md +82 -0
  105. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/01-decision-posture.md +242 -0
  106. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/02-business-economics.md +188 -0
  107. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/03-management-governance.md +213 -0
  108. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/04-financial-reality.md +192 -0
  109. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/05-valuation.md +166 -0
  110. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/06-capital-allocation.md +238 -0
  111. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/07-risk-monitoring.md +189 -0
  112. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/08-specialized-overlays.md +309 -0
  113. package/selected-skills/investment-skills/skills/buffett-investment-framework/scripts/framework.py +470 -0
@@ -0,0 +1,309 @@
1
+ # Specialized Industry and Instrument Overlays
2
+
3
+ Use these cards as evidence-bounded analytical prompts derived from Buffett and
4
+ Berkshire writings. Apply them to supplied evidence, preserve each card’s limits, and
5
+ return unresolved findings when prerequisites are missing.
6
+
7
+ Read this file when adding a triggered insurance, banking, consumer, infrastructure,
8
+ technology, commodity, or instrument check.
9
+ Load only the cards selected by the router; do not load the whole module by default.
10
+ Abbreviated corroboration citations resolve in the [source key](00-source-key.md).
11
+
12
+ ## Card Index
13
+
14
+ | Card | Decision question |
15
+ | --- | --- |
16
+ | [S01](#s01) | Does float create durable financing value or conceal expensive, unstable underwriting? |
17
+ | [S02](#s02) | Are risks identifiable and priced for full expected cost, and will management shrink when terms are inadequate? |
18
+ | [S03](#s03) | How much reported underwriting profit survives accident-year, reserve-development, incentive, and cycle scrutiny? |
19
+ | [S04](#s04) | Can one event or common cause impair solvency, liquidity, claims payment, or post-shock capacity? |
20
+ | [S05](#s05) | Can claims, collateral, refinancing, or counterparties force cash shortfalls when the same shock weakens the chain? |
21
+ | [S06](#s06) | What prevents this apparently commodity-like insurer from earning commodity returns? |
22
+ | [S07](#s07) | Can modest asset or underwriting errors overwhelm thin equity or trigger confidence-sensitive funding loss? |
23
+ | [S08](#s08) | Do loyalty, pricing, distribution, inventory, and format cause durable returns, or does the brand depend on a weakening channel? |
24
+ | [S09](#s09) | Do essential demand and network position earn adequate owner returns after obligations, regulation, maintenance, and financing stress? |
25
+ | [S10](#s10) | Can important economics be forecast despite obsolescence, distribution change, network effects, and shifting attention? |
26
+ | [S11](#s11) | Do normalized owner returns arise from durable advantage or favorable price, cycle, or underinvestment? |
27
+ | [S12](#s12) | Are event, duration, cash-flow, downside, and optionality mechanics understandable and adequately evidenced? |
28
+
29
+ ## Complete Cards
30
+
31
+ <a id="s01"></a>
32
+
33
+ ### S01 — Insurance: Value Float by Amount, Cost, Duration, and Outlook
34
+
35
+ - **Decision question:** Does float create durable financing value or conceal expensive,
36
+ unstable underwriting?
37
+ - **Guidance:** Analyze amount, normalized underwriting cost, claim-payment duration,
38
+ runoff, and outlook; compare full cost with realistic funding.
39
+ - **Use when:** Material property-casualty operations or investable funds received
40
+ before uncertain claims are paid.
41
+ - **Analytical actions:** Reconcile float; estimate cycle-normalized cost and duration;
42
+ stress runoff, reserve deterioration, yield, and cash use.
43
+ - **Output:** A float ledger and scenario table with funding comparison, required
44
+ capital, and unresolved reserve effects.
45
+ - **Limits:** Float remains a liability and long duration adds reserve uncertainty; an
46
+ equity analogy requires supported low cost and durability.
47
+ - **Source basis:**
48
+ - **Berkshire Hathaway 1986 annual letter** — *defines*: float.
49
+ - **Berkshire Hathaway 2001 annual letter** — *qualifies*: float value depends on
50
+ relative funding cost.
51
+ - **Corroboration:** OM1996; BH2002; BH2014; LOW ch.7 (early float recognition).
52
+
53
+ <a id="s02"></a>
54
+
55
+ ### S02 — Insurance: Underwrite Exposure and Price Rather than Volume
56
+
57
+ - **Decision question:** Are risks identifiable and priced for full expected cost, and
58
+ will management shrink when terms are inadequate?
59
+ - **Guidance:** Evaluate exposure, conservative severity, full-cost pricing, and
60
+ demonstrated willingness to reject uneconomic volume.
61
+ - **Use when:** Insurance underwriting where premium growth may obscure risk selection
62
+ and expected loss.
63
+ - **Analytical actions:** Define exposure, limits, and aggregation; compare price with
64
+ loss, expense, capital, and uncertainty; review cohort and volume decisions.
65
+ - **Output:** An underwriting-discipline scorecard with exposure, price adequacy,
66
+ expected economics, volume decisions, and unresolved models.
67
+ - **Limits:** Shrinking is not always correct and no model removes uncertainty; missing
68
+ exposure or loss assumptions block a conclusion.
69
+ - **Source basis:**
70
+ - **Berkshire Hathaway 1977 annual letter** — *implements*: accept lower volume when
71
+ insurance rates are inadequate.
72
+ - **Berkshire Hathaway 2010 annual letter** — *implements*: apply four disciplines to
73
+ insurance underwriting.
74
+ - **Corroboration:** BH2014; BH2023; BH2025; LOW ch.7 (pricing-over-volume origin).
75
+
76
+ <a id="s03"></a>
77
+
78
+ ### S03 — Insurance: Reconstruct Reserves and Earnings Through the Cycle
79
+
80
+ - **Decision question:** How much reported underwriting profit survives accident-year,
81
+ reserve-development, incentive, and cycle scrutiny?
82
+ - **Guidance:** Treat earnings as provisional until accident-year development,
83
+ prior-year revisions, settlement maturity, cycles, and quiet years are reconciled.
84
+ - **Use when:** Material loss reserves, long-tail claims, catastrophe exposure, changing
85
+ assumptions, or unusually smooth results.
86
+ - **Analytical actions:** Build accident- and calendar-year bridges; separate current
87
+ underwriting from reserve changes; normalize cycles.
88
+ - **Output:** A reserve-development and normalization table with uncertainty ranges,
89
+ revisions, and unresolved accident years.
90
+ - **Limits:** Reserve error may be innocent and even multiyear windows miss rare losses;
91
+ absent triangles leave earnings unresolved.
92
+ - **Source basis:**
93
+ - **Berkshire Hathaway 1984 annual letter** — *supports*: property casualty statements
94
+ are provisional.
95
+ - **Berkshire Hathaway 1993 annual letter** — *qualifies*: loss free years do not
96
+ establish catastrophe profitability.
97
+ - **Corroboration:** BH2002; BH2023; LOW ch.10 (GEICO reserving crisis).
98
+
99
+ <a id="s04"></a>
100
+
101
+ ### S04 — Insurance: Test Aggregate Tail Loss Against Distress Capacity
102
+
103
+ - **Decision question:** Can one event or common cause impair solvency, liquidity,
104
+ claims payment, or post-shock capacity?
105
+ - **Guidance:** Aggregate policies, businesses, investments, counterparties, collateral,
106
+ and funding; work backward from intolerable outcomes.
107
+ - **Use when:** Catastrophe, systemic, liability, cyber, terrorism, or other nonlinear,
108
+ correlated exposure.
109
+ - **Analytical actions:** Enumerate common causes; estimate ranges under model breaks;
110
+ compare loss with regulatory, covenant, claims, and post-shock needs.
111
+ - **Output:** An aggregate-tail ledger with loss ranges, liquidity timing, binding
112
+ capacity, and unresolved correlations.
113
+ - **Limits:** Scenarios are never exhaustive and no universal buffer applies; preserve
114
+ false precision as unresolved.
115
+ - **Source basis:**
116
+ - **Berkshire Hathaway 1996 annual letter** — *implements*: reverse engineer
117
+ aggregated tail risk from intolerable outcomes.
118
+ - **Berkshire Hathaway 2012 annual letter** — *qualifies*: insurance capacity must
119
+ remain proportionate to enterprise resources.
120
+ - **Corroboration:** BH2002; BH2014; LOW ch.23 (super-cat exposure growth).
121
+
122
+ <a id="s05"></a>
123
+
124
+ ### S05 — Insurance: Test Crisis Liquidity and the Risk-Transfer Chain
125
+
126
+ - **Decision question:** Can claims, collateral, refinancing, or counterparties force
127
+ cash shortfalls when the same shock weakens the chain?
128
+ - **Guidance:** Analyze claims liquidity and the complete transfer chain together,
129
+ including ability, duration, collateral, jurisdiction, and weakest link.
130
+ - **Use when:** Losses are ceded, collateralized, long-tailed, externally financed, or
131
+ dependent on multiple transfer parties.
132
+ - **Analytical actions:** Map gross loss, ceded layers, collateral, timing, and parties;
133
+ stress simultaneous claims and failures; identify unrefinanced liquidity.
134
+ - **Output:** A risk-transfer and liquidity map showing gross and net timing,
135
+ dependencies, collateral, and unresolved recoverability.
136
+ - **Limits:** Retention is not automatically safer and legal rights do not ensure prompt
137
+ collection; unverified recoveries stay unavailable.
138
+ - **Source basis:**
139
+ - **Berkshire Hathaway 2001 annual letter** — *implements*: stress test entire
140
+ reinsurance counterparty chain.
141
+ - **Berkshire Hathaway 2004 annual letter** — *supports*: reinsurer solvency is
142
+ material counterparty risk.
143
+ - **Corroboration:** BH2002; BH2014.
144
+
145
+ <a id="s06"></a>
146
+
147
+ ### S06 — Insurance: Require Discipline and Structure for a Moat
148
+
149
+ - **Decision question:** What prevents this apparently commodity-like insurer from
150
+ earning commodity returns?
151
+ - **Guidance:** Look for low cost or niche, distribution, underwriting skill, capital,
152
+ and a culture willing to sacrifice volume; do not infer a moat from growth.
153
+ - **Use when:** An insurer is claimed to have durable competitive advantage.
154
+ - **Analytical actions:** Name and compare the mechanism; test price, retention,
155
+ acquisition cost, losses, distribution, and capital through a cycle; seek persistence.
156
+ - **Output:** An insurance-moat map with competitor evidence, cycle indicators, erosion
157
+ signals, and unresolved causal links.
158
+ - **Limits:** Berkshire and GEICO are favorable cases, not base rates; unobserved causal
159
+ outcomes leave the moat unresolved.
160
+ - **Source basis:**
161
+ - **Berkshire Hathaway 1987 annual letter** — *supports*: commodity insurance rewards
162
+ low cost or niche.
163
+ - **Berkshire Hathaway 1999 annual letter** — *qualifies*: reinsurance advantage
164
+ combines distribution skill culture and capital.
165
+ - **Corroboration:** BH2014; BH2023; LOW ch.10 (GEICO expense-ratio edge).
166
+
167
+ <a id="s07"></a>
168
+
169
+ ### S07 — Banking: Assess Funding, Credit, Leverage, and Culture
170
+
171
+ - **Decision question:** Can modest asset or underwriting errors overwhelm thin equity
172
+ or trigger confidence-sensitive funding loss?
173
+ - **Guidance:** Analyze asset quality, vintages, funding, liquidity, leverage,
174
+ incentives, and bad-news flow as one bank-specific fragility system.
175
+ - **Use when:** Banks, deposit-taking lenders, or businesses dependent on
176
+ confidence-sensitive funding.
177
+ - **Analytical actions:** Segment credit and concentration; stress funding loss, credit,
178
+ and liquidity together; compare incentives and reporting with outcomes.
179
+ - **Output:** A banking resilience matrix covering loss, runoff, liquidity, capital,
180
+ culture indicators, and unresolved disclosures.
181
+ - **Limits:** Regimes and protections differ materially; missing asset or funding detail
182
+ blocks the branch.
183
+ - **Source basis:**
184
+ - **Berkshire Hathaway 2006 annual letter** — *illustrates*: teaser mortgages defer
185
+ and amplify payment stress.
186
+ - **Berkshire Hathaway 2010 annual letter** — *supports*: leverage can destroy
187
+ survival when refinancing disappears.
188
+ - **Corroboration:** EWB §II.G; OM1996; BH2002; LOW ch.19 (deposit-insurance moral
189
+ hazard).
190
+
191
+ <a id="s08"></a>
192
+
193
+ ### S08 — Consumer and Retail: Separate Brand Economics from Fragile Distribution
194
+
195
+ - **Decision question:** Do loyalty, pricing, distribution, inventory, and format cause
196
+ durable returns, or does the brand depend on a weakening channel?
197
+ - **Guidance:** Test customer behavior and price separately from distribution access,
198
+ delivered value, inventory risk, and format durability.
199
+ - **Use when:** Consumer products, retail, restaurants, or similar brand and channel
200
+ dependence.
201
+ - **Analytical actions:** Measure price, volume, retention, mix, and channel economics;
202
+ trace inventory and format risks; identify channel shifts and alternatives.
203
+ - **Output:** A franchise and distribution scorecard with behavior, unit economics,
204
+ dependencies, and erosion indicators.
205
+ - **Limits:** Exceptional management can overcome some weak economics; missing cohort,
206
+ channel, or inventory evidence leaves durability unresolved.
207
+ - **Source basis:**
208
+ - **Berkshire Hathaway 1983 annual letter** — *supports*: consumer franchise and low
209
+ cost position create goodwill.
210
+ - **Berkshire Hathaway 1988 annual letter** — *qualifies*: exceptional management can
211
+ overcome mediocre industry economics.
212
+ - **Corroboration:** EWB §II.E; EWB §V.C; LOW ch.18 (Coca-Cola franchise case).
213
+
214
+ <a id="s09"></a>
215
+
216
+ ### S09 — Infrastructure: Evaluate Regulation, Irreplaceability, and Maintenance Capital
217
+
218
+ - **Decision question:** Do essential demand and network position earn adequate owner
219
+ returns after obligations, regulation, maintenance, and financing stress?
220
+ - **Guidance:** Evaluate regulated return, irreplaceability, service duties, required
221
+ capital, political legitimacy, and stressed financing together.
222
+ - **Use when:** Utilities, railways, pipelines, networks, and regulated or essential
223
+ capital-intensive infrastructure.
224
+ - **Analytical actions:** Reconcile allowed and realized returns; separate maintenance,
225
+ replacement, and expansion; stress lag, affordability, utilization, and debt service.
226
+ - **Output:** An infrastructure bridge covering rate mechanism, capital, returns,
227
+ financing, constraints, and unresolved regulation.
228
+ - **Limits:** Irreplaceability does not guarantee owner returns; missing rate or
229
+ maintenance evidence blocks the judgment.
230
+ - **Source basis:**
231
+ - **Berkshire Hathaway 2015 annual letter** — *implements*: regulated investment
232
+ requires reasonable returns and constituency approval.
233
+ - **Berkshire Hathaway 2003 annual letter** — *qualifies*: stable ring fenced utility
234
+ cash flows can support subsidiary debt.
235
+ - **Corroboration:** OM1996; BH2014.
236
+
237
+ <a id="s10"></a>
238
+
239
+ ### S10 — Technology and Media: Test Whether Disruption Strengthens or Destroys the Moat
240
+
241
+ - **Decision question:** Can important economics be forecast despite obsolescence,
242
+ distribution change, network effects, and shifting attention?
243
+ - **Guidance:** Identify the protection mechanism, then test technical substitution,
244
+ platform control, distribution, behavior, and reinvestment; stop if forecastability
245
+ cannot be bounded.
246
+ - **Use when:** Technology, software, platforms, media, advertising, or rapid technical
247
+ and distribution change.
248
+ - **Analytical actions:** Map mechanism and dependencies; track retention, switching,
249
+ network density, distribution, attention, and innovation spend; define exit
250
+ indicators.
251
+ - **Output:** A disruption and forecastability map with dependencies, erosion
252
+ indicators, and an estimable or outside-boundary result.
253
+ - **Limits:** Leadership, reputation, or network size alone is insufficient; unbounded
254
+ critical economics stop the branch.
255
+ - **Source basis:**
256
+ - **Berkshire Hathaway 1993 annual letter** — *qualifies*: stay with easy to
257
+ understand businesses.
258
+ - **Berkshire Hathaway 2005 annual letter** — *defines*: widening the moat.
259
+ - **Corroboration:** EWB §II.E; BH2014; LOW ch.18 (competence-bounded selection).
260
+
261
+ <a id="s11"></a>
262
+
263
+ ### S11 — Energy and Commodities: Normalize Cycles, Inflation, and Capital Intensity
264
+
265
+ - **Decision question:** Do normalized owner returns arise from durable advantage or
266
+ favorable price, cycle, or underinvestment?
267
+ - **Guidance:** Separate price exposure from controllable advantage and normalize
268
+ volume, price, utilization, depletion, capital, regulation, and financing.
269
+ - **Use when:** Producers, processors, commodity-linked assets, or energy businesses.
270
+ - **Analytical actions:** Build price-volume-cost and cycle bridges; estimate
271
+ maintenance, depletion, and working capital; test cost claims under adverse prices and
272
+ capacity.
273
+ - **Output:** A normalized commodity table with cycle range, capital burden, cost
274
+ position, inflation exposure, and unresolved assumptions.
275
+ - **Limits:** Low-cost producers may be exceptions and price forecasts remain uncertain;
276
+ missing reserves or replacement data blocks owner cash.
277
+ - **Source basis:**
278
+ - **Berkshire Hathaway 1978 annual letter** — *supports*: commodity capital intensity
279
+ depresses returns.
280
+ - **Berkshire Hathaway 1985 annual letter** — *qualifies*: commodity cost saving capex
281
+ becomes industry price reduction.
282
+ - **Corroboration:** EWB §I.C; EWB §V.C; OM1996; BH2014.
283
+
284
+ <a id="s12"></a>
285
+
286
+ ### S12 — Special Instruments: Analyze Event Probability, Duration, Downside, and Optionality
287
+
288
+ - **Decision question:** Are event, duration, cash-flow, downside, and optionality
289
+ mechanics understandable and adequately evidenced?
290
+ - **Guidance:** Route each instrument to atomic contractual cash-flow,
291
+ event-probability, duration, upside, failure-downside, and enforceability analysis;
292
+ frozen evidence supports only announced-event arbitrage.
293
+ - **Use when:** Announced-event arbitrage, workout, preferred, convertible, or unusual
294
+ contractual claim rather than ordinary equity.
295
+ - **Analytical actions:** Identify contract, event, states, and legal dependencies;
296
+ estimate probability, duration, terms, and failure loss; stop unsupported branches.
297
+ - **Output:** A state-contingent worksheet with event states, probability inputs,
298
+ duration, payoff and loss ranges, legal dependencies, and unsupported branches.
299
+ - **Limits:** No universal return, probability, diversification, or legal checklist
300
+ applies; unsupported instruments remain unresolved.
301
+ - **Source basis:**
302
+ - **Berkshire Hathaway 1988 annual letter** — *defines*: risk arbitrage.
303
+ - **Berkshire Hathaway 1988 annual letter** — *implements*: four question arbitrage
304
+ analysis.
305
+ - **Corroboration:** EWB §II.B; BPL1964.
306
+
307
+ <!-- This document follows common-doc-guidelines.md.
308
+ See github.com/jlevy/practical-prose and review guidelines before editing.
309
+ -->