@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,166 @@
1
+ # Valuation and Price Discipline
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 selecting a valuation method, normalizing the base, testing growth,
8
+ sensitivity, or price.
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
+ | [V01](#v01) | What conservative range represents the present value of cash owners can remove over the business’s remaining life? |
17
+ | [V02](#v02) | Which method fits predictability, assets, growth, and capital structure, and what can simpler measures legitimately check? |
18
+ | [V03](#v03) | Which reconciled earnings or owner-cash base should valuation capitalize across the relevant cycle? |
19
+ | [V04](#v04) | Does projected growth increase future owner cash after funding its capital requirements? |
20
+ | [V05](#v05) | Which assumptions drive the range, how fragile are they, and which missing facts block a conclusion? |
21
+ | [V06](#v06) | Is the price-value gap adequate for uncertainty, resilience, financing, and downside shown by the evidence? |
22
+
23
+ ## Complete Cards
24
+
25
+ <a id="v01"></a>
26
+
27
+ ### V01 — Define Intrinsic Value as a Range of Owner Cash
28
+
29
+ - **Decision question:** What conservative range represents the present value of cash
30
+ owners can remove over the business’s remaining life?
31
+ - **Guidance:** Model owner cash, reinvestment, timing, and discounting explicitly and
32
+ express value as a range reflecting uncertainty.
33
+ - **Use when:** Evidence supports an explicit owner-cash valuation rather than only
34
+ asset or relative checks.
35
+ - **Analytical actions:** Define removable owner cash; build supported cash-flow and
36
+ terminal scenarios; state discounting assumptions and range-invalidating variables.
37
+ - **Output:** An intrinsic-value range tied to operating, reinvestment, timing, and
38
+ discount assumptions.
39
+ - **Limits:** Analysts can produce different ranges; no universal discount rate or
40
+ terminal method applies, and unbounded cash flows leave value unresolved.
41
+ - **Source basis:**
42
+ - **Berkshire Hathaway 1994 annual letter** — *defines*: intrinsic value discounted
43
+ owner cash.
44
+ - **Berkshire Hathaway 1999 annual letter** — *implements*: estimate intrinsic value
45
+ as a range.
46
+ - **Corroboration:** EWB §II.D; EWB §V.E; OM1996; BH2014.
47
+
48
+ <a id="v02"></a>
49
+
50
+ ### V02 — Match the Valuation Method to Business Economics and Use Shortcuts Only as Checks
51
+
52
+ - **Decision question:** Which method fits predictability, assets, growth, and capital
53
+ structure, and what can simpler measures legitimately check?
54
+ - **Guidance:** Select the method from the economics and evidence; treat multiples and
55
+ book value as checks unless linked to owner cash or realizable assets.
56
+ - **Use when:** Before valuing an asset-heavy, cyclical, financial, high-growth, or
57
+ structurally changing business.
58
+ - **Analytical actions:** Classify value drivers and forecastability; justify the
59
+ primary method and checks; explain why rejected methods misstate economics.
60
+ - **Output:** A valuation-method memo naming the primary method, checks, rejected
61
+ alternatives, and unresolved method risk.
62
+ - **Limits:** No method repairs unforecastable inputs; if no method has defensible
63
+ inputs, valuation remains unresolved.
64
+ - **Source basis:**
65
+ - **Berkshire Hathaway 1989 annual letter** — *defines*: intrinsic value discounted
66
+ future cash flows.
67
+ - **Berkshire Hathaway 1989 annual letter** — *qualifies*: book value is an imperfect
68
+ proxy for intrinsic value.
69
+ - **Corroboration:** EWB §V.D; OM1996; BH2002; BH2014.
70
+
71
+ <a id="v03"></a>
72
+
73
+ ### V03 — Select a Defensible Normalized Base for Valuation
74
+
75
+ - **Decision question:** Which reconciled earnings or owner-cash base should valuation
76
+ capitalize across the relevant cycle?
77
+ - **Guidance:** Derive the base from F05 while preserving segment differences, cycles,
78
+ unusual items, acquisition effects, and genuine costs.
79
+ - **Use when:** Valuation depends on normalized earnings, margins, cash conversion, or
80
+ cycle position.
81
+ - **Analytical actions:** Compare reported and normalized periods; justify cycle and
82
+ segment weights; show alternative bases and valuation consequences.
83
+ - **Output:** A valuation-base bridge with selected range, rejected periods, cycle
84
+ rationale, and sensitivities.
85
+ - **Limits:** Cycle endpoints are uncertain and structural change can invalidate
86
+ history; an indefensible period leaves the base unresolved.
87
+ - **Source basis:**
88
+ - **Berkshire Hathaway 1983 annual letter** — *implements*: separate operating
89
+ earnings from unusual gains.
90
+ - **Berkshire Hathaway 2019 annual letter** — *qualifies*: separate operating earnings
91
+ from investment gyrations.
92
+ - **Corroboration:** EWB §V.B; BH2002; BH2023.
93
+
94
+ <a id="v04"></a>
95
+
96
+ ### V04 — Value Growth Only Through Incremental Capital Economics
97
+
98
+ - **Decision question:** Does projected growth increase future owner cash after funding
99
+ its capital requirements?
100
+ - **Guidance:** Credit growth only through supported changes in owner cash and
101
+ incremental returns; reduce expectations for capital hunger or return decay.
102
+ - **Use when:** Growth contributes materially to valuation or thesis.
103
+ - **Analytical actions:** Reconcile growth with incremental capital and owner cash;
104
+ compare returns with opportunity cost; sensitize scale, runway, and funding.
105
+ - **Output:** A growth-value bridge separating revenue growth, required capital,
106
+ incremental return, and owner-cash contribution.
107
+ - **Limits:** Future returns are unobserved; unbounded funding or incremental returns
108
+ leave growth value unresolved.
109
+ - **Source basis:**
110
+ - **Berkshire Hathaway 1992 annual letter** — *supports*: growth creates value only
111
+ above cost of incremental capital.
112
+ - **Berkshire Hathaway 2000 annual letter** — *supports*: growth affects value only
113
+ through cash flow economics.
114
+ - **Corroboration:** EWB §II.D; EWB §III.C; CM50-2015; LOW ch.10 (cable-TV rejection
115
+ case).
116
+
117
+ <a id="v05"></a>
118
+
119
+ ### V05 — Expose Assumptions, Sensitivities, and Missing Evidence
120
+
121
+ - **Decision question:** Which assumptions drive the range, how fragile are they, and
122
+ which missing facts block a conclusion?
123
+ - **Guidance:** Make operating, reinvestment, discounting, and terminal assumptions
124
+ explicit; test plausible combinations and identify invalidating evidence.
125
+ - **Use when:** Every material valuation, especially when forecast or model dependence
126
+ is high.
127
+ - **Analytical actions:** Rank drivers by impact and uncertainty; run supported scenario
128
+ combinations; map each missing input to the blocked conclusion.
129
+ - **Output:** A sensitivity and missing-evidence register tied to the value range and
130
+ invalidation conditions.
131
+ - **Limits:** Sensitivity cannot validate bad assumptions or assign unsupported
132
+ probabilities; unsupported bounds require no value conclusion.
133
+ - **Source basis:**
134
+ - **Berkshire Hathaway 1999 annual letter** — *implements*: estimate intrinsic value
135
+ as a range.
136
+ - **Berkshire Hathaway 2020 annual letter** — *illustrates*: Precision Castparts
137
+ overpayment from earnings overestimate.
138
+ - **Corroboration:** EWB §II.D; BH2002; BH2014.
139
+
140
+ <a id="v06"></a>
141
+
142
+ ### V06 — Require a Margin of Safety Proportionate to Uncertainty
143
+
144
+ - **Decision question:** Is the price-value gap adequate for uncertainty, resilience,
145
+ financing, and downside shown by the evidence?
146
+ - **Guidance:** Compare price with the conservative end of a supported range and require
147
+ more room for greater uncertainty; a discount cannot cure fragility.
148
+ - **Use when:** A defensible value range and downside analysis exist and price is in
149
+ scope.
150
+ - **Analytical actions:** Quantify scenario gaps; tie required room to named
151
+ uncertainty; test whether the discount survives adverse assumptions.
152
+ - **Output:** A price-value table with scenario gaps, uncertainty drivers, and an
153
+ adequate, inadequate, or unresolved analytical finding.
154
+ - **Limits:** No universal discount applies; missing price or value leaves the result
155
+ unresolved, and the finding is not trade authority.
156
+ - **Source basis:**
157
+ - **Warren Buffett’s 1984 essay “The Superinvestors of Graham-and-Doddsville”** —
158
+ *defines*: margin of safety.
159
+ - **Berkshire Hathaway 2020 annual letter** — *illustrates*: Precision Castparts
160
+ overpayment from earnings overestimate.
161
+ - **Corroboration:** EWB §II.D; BH2025; LOW ch.5 (franchise-value margin evolution); LOW
162
+ ch.8 (Washington Post discount case).
163
+
164
+ <!-- This document follows common-doc-guidelines.md.
165
+ See github.com/jlevy/practical-prose and review guidelines before editing.
166
+ -->
@@ -0,0 +1,238 @@
1
+ # Capital Allocation
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 reviewing retention, distributions, repurchases, issuance,
8
+ acquisitions, or reserves.
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
+ | [C01](#c01) | How does the decision change each continuing owner’s long-term economics after financing, dilution, tax, risk, and alternatives? |
17
+ | [C02](#c02) | What capital and true liquidity must remain unavailable so operations and obligations survive correlated adversity? |
18
+ | [C03](#c03) | Which route offers the strongest supported owner outcome after tax, risk, scale, timing, financing, and friction? |
19
+ | [C04](#c04) | Is retained capital likely to increase per-share owner value more than distribution or another feasible route? |
20
+ | [C05](#c05) | After protected reserves and productive uses, is capital genuinely surplus? |
21
+ | [C06](#c06) | Will repurchase materially improve continuing-owner value without weakening resilience or unfairly transferring value? |
22
+ | [C07](#c07) | Does issuing equity give owners at least as much durable value and resilience as the interest surrendered? |
23
+ | [C08](#c08) | Does the complete exchange improve continuing-owner value under defensible stand-alone and downside cases? |
24
+ | [C09](#c09) | Has commitment manufactured confidence through selective information, incentives, or optimistic assumptions? |
25
+
26
+ ## Complete Cards
27
+
28
+ <a id="c01"></a>
29
+
30
+ ### C01 — Optimize Long-Term Per-Share Owner Value
31
+
32
+ - **Decision question:** How does the decision change each continuing owner’s long-term
33
+ economics after financing, dilution, tax, risk, and alternatives?
34
+ - **Guidance:** Use per-share intrinsic-value effects as the objective; do not
35
+ substitute aggregate growth, EPS, book value, or corporate size.
36
+ - **Use when:** Material deployment, financing, payout, acquisition, issuance, or
37
+ discretionary spending.
38
+ - **Analytical actions:** Bridge enterprise to per-share effects; trace dilution,
39
+ claims, taxes, downside, and opportunity cost; separate accounting optics from
40
+ economics.
41
+ - **Output:** A per-share value bridge showing value contributed and surrendered,
42
+ affected owners, assumptions, and unresolved effects.
43
+ - **Limits:** Value is estimated and stakeholder or legal constraints may dominate; an
44
+ unsupported bridge stays unresolved and authorizes nothing.
45
+ - **Source basis:**
46
+ - **Berkshire Hathaway 1994 annual letter** — *implements*: allocate capital by per
47
+ share intrinsic value not near term EPS.
48
+ - **Berkshire Hathaway 1982 annual letter** — *qualifies*: EPS dilution is not value
49
+ dilution.
50
+ - **Corroboration:** EWB §I.A; OM1996; BH2022; LOW ch.10 (Washington Post per-share
51
+ case).
52
+
53
+ <a id="c02"></a>
54
+
55
+ ### C02 — Set the Allocation Reserve Before Optional Return
56
+
57
+ - **Decision question:** What capital and true liquidity must remain unavailable so
58
+ operations and obligations survive correlated adversity?
59
+ - **Guidance:** Establish operating, claims, covenant, regulatory, and calamity reserves
60
+ before optional uses; accept foregone return when refinancing dependence would make
61
+ survival fragile.
62
+ - **Use when:** Optional deployment competes with working capital, debt, collateral,
63
+ claims, regulated capital, or credible stress needs.
64
+ - **Analytical actions:** Inventory obligations, timing, restrictions, and liquid
65
+ assets; stress simultaneous demands; state protected reserve and supported surplus.
66
+ - **Output:** A reserve schedule with required liquidity, stress uses, funding,
67
+ restrictions, and unresolved surplus.
68
+ - **Limits:** No universal ratio applies and nominal liquidity may disappear;
69
+ unverifiable access makes the amount unavailable, not surplus.
70
+ - **Source basis:**
71
+ - **Berkshire Hathaway 2018 annual letter** — *implements*: preserve calamity
72
+ liquidity before acquisitions.
73
+ - **Berkshire Hathaway 2003 annual letter** — *qualifies*: stable ring fenced utility
74
+ cash flows can support subsidiary debt.
75
+ - **Corroboration:** OM1996; BH2014; FL2025.
76
+
77
+ <a id="c03"></a>
78
+
79
+ ### C03 — Compare the Full Capital-Allocation Menu and Available Channels
80
+
81
+ - **Decision question:** Which route offers the strongest supported owner outcome after
82
+ tax, risk, scale, timing, financing, and friction?
83
+ - **Guidance:** Compare internal investment, acquisitions, securities, debt change,
84
+ repurchase, payout, and inaction on one explicit owner-value basis.
85
+ - **Use when:** More than one discretionary route is available or management omits
86
+ alternatives.
87
+ - **Analytical actions:** Enumerate feasible routes; normalize owner cash, downside,
88
+ duration, tax, scale, control, and reversibility; rank only comparable evidence.
89
+ - **Output:** A capital-route matrix with assumptions, constraints, ranges, downside,
90
+ scale, and unresolved alternatives.
91
+ - **Limits:** No universal hurdle or probability method applies; survival precedes
92
+ ranking and the matrix authorizes no deployment.
93
+ - **Source basis:**
94
+ - **Berkshire Hathaway 2021 annual letter** — *implements*: compare capital allocation
95
+ routes by return and scale.
96
+ - **Berkshire Hathaway 1987 annual letter** — *supports*: select by after tax
97
+ mathematical expectation.
98
+ - **Corroboration:** EWB §IV.D; OM1996; BH2014.
99
+
100
+ <a id="c04"></a>
101
+
102
+ ### C04 — Retain and Reinvest Earnings Only for Productive Deployment
103
+
104
+ - **Decision question:** Is retained capital likely to increase per-share owner value
105
+ more than distribution or another feasible route?
106
+ - **Guidance:** Treat retained earnings as owner capital that must earn its keep through
107
+ prospective incremental earning power and later accountability.
108
+ - **Use when:** Material retention for organic growth, maintenance presented as growth,
109
+ or central redeployment.
110
+ - **Analytical actions:** Separate maintenance from growth; estimate incremental returns
111
+ and capacity; compare later outcomes with the original case and alternatives.
112
+ - **Output:** A retention ledger linking amounts to uses, expected economics, realized
113
+ outcomes, and unresolved attribution.
114
+ - **Limits:** Returns can be delayed and hard to attribute; if maintenance and growth
115
+ cannot be separated, the test is unresolved.
116
+ - **Source basis:**
117
+ - **Berkshire Hathaway 1978 annual letter** — *implements*: condition retention on
118
+ profitable reinvestment.
119
+ - **Berkshire Hathaway 2016 annual letter** — *supports*: retained earnings must
120
+ increase earning power.
121
+ - **Corroboration:** EWB §III.C; OM1996; BH2014; LOW ch.15 (subsidiary retention test).
122
+
123
+ <a id="c05"></a>
124
+
125
+ ### C05 — Return Surplus Capital When No Better Use Exists
126
+
127
+ - **Decision question:** After protected reserves and productive uses, is capital
128
+ genuinely surplus?
129
+ - **Guidance:** Treat payout as the consequence of no better supported deployment, not a
130
+ fixed preference; distinguish distribution from central redeployment.
131
+ - **Use when:** Mature or capital-light operations generate cash beyond maintenance,
132
+ growth, obligations, and resilience needs.
133
+ - **Analytical actions:** Reconcile distributable cash after C02; compare C03
134
+ alternatives; show tax, control, and owner-treatment effects of payout channels.
135
+ - **Output:** A surplus-capital ledger with amounts blocked, deployable, distributable,
136
+ or unresolved.
137
+ - **Limits:** Legal, tax, contractual, and balance-sheet limits may block payout; an
138
+ incomplete reserve or opportunity set means no surplus finding.
139
+ - **Source basis:**
140
+ - **Berkshire Hathaway 1984 annual letter** — *implements*: Berkshire dividend policy
141
+ uses value creation threshold.
142
+ - **Berkshire Hathaway 2007 annual letter** — *qualifies*: redeploy cash from high
143
+ return low reinvestment businesses.
144
+ - **Corroboration:** EWB §III.C; BH2014; LOW ch.15 (distribution threshold case).
145
+
146
+ <a id="c06"></a>
147
+
148
+ ### C06 — Repurchase Only Below Value with Surplus Capacity and Material Effect
149
+
150
+ - **Decision question:** Will repurchase materially improve continuing-owner value
151
+ without weakening resilience or unfairly transferring value?
152
+ - **Guidance:** Require conservative undervaluation, protected liquidity, fair
153
+ disclosure, superior alternatives, and meaningful per-share effect.
154
+ - **Use when:** An issuer proposes, conducts, or defends a material repurchase.
155
+ - **Analytical actions:** Compare price with value; recheck capacity and alternatives;
156
+ quantify shares retired, financing, per-share effect, and transfers.
157
+ - **Output:** A repurchase worksheet with value, capacity, materiality, fairness,
158
+ alternatives, and unresolved assumptions.
159
+ - **Limits:** Value is uncertain and above-value purchases can transfer wealth; the
160
+ worksheet authorizes no repurchase or trade.
161
+ - **Source basis:**
162
+ - **Berkshire Hathaway 1980 annual letter** — *implements*: repurchase below intrinsic
163
+ value.
164
+ - **Berkshire Hathaway 1999 annual letter** — *qualifies*: above value repurchases
165
+ transfer wealth from continuing owners.
166
+ - **Corroboration:** EWB §IV.B; BH2014; BH2022; LOW ch.10 (Washington Post repurchases).
167
+
168
+ <a id="c07"></a>
169
+
170
+ ### C07 — Issue Shares Only Value for Value
171
+
172
+ - **Decision question:** Does issuing equity give owners at least as much durable value
173
+ and resilience as the interest surrendered?
174
+ - **Guidance:** Analyze issuance as a partial sale of owner assets and compare value
175
+ surrendered with assets, claims extinguished, or resilience received.
176
+ - **Use when:** Stock-financed acquisitions, compensation issuance, conversion,
177
+ recapitalization, or balance-sheet repair.
178
+ - **Analytical actions:** Estimate value and ownership surrendered; value consideration
179
+ and resilience received; reconcile to continuing-owner value rather than optics.
180
+ - **Output:** An issuance exchange bridge with ownership transfer, proceeds, financing
181
+ effects, and per-share result.
182
+ - **Limits:** Issuance can rationally improve resilience and both sides are uncertain;
183
+ missing estimates leave the exchange unresolved.
184
+ - **Source basis:**
185
+ - **Berkshire Hathaway 1982 annual letter** — *implements*: share issuance value for
186
+ value rule.
187
+ - **Berkshire Hathaway 1992 annual letter** — *illustrates*: stock financed bank deal
188
+ destroyed value.
189
+ - **Corroboration:** EWB §IV.A; OM1996; LOW ch.12 (stock-deal dilution cases).
190
+
191
+ <a id="c08"></a>
192
+
193
+ ### C08 — Evaluate Acquisitions by Quality, Price, Financing, Alternatives, and Postmortems
194
+
195
+ - **Decision question:** Does the complete exchange improve continuing-owner value under
196
+ defensible stand-alone and downside cases?
197
+ - **Guidance:** Evaluate target economics, management, price, financing, dilution,
198
+ alternatives, and realized outcomes together, not EPS or size.
199
+ - **Use when:** A proposed or completed acquisition, merger, or major asset purchase.
200
+ - **Analytical actions:** Underwrite stand-alone quality and owner cash; build a value
201
+ exchange and financing bridge; preserve assumptions for post-closing comparison.
202
+ - **Output:** An acquisition sheet with stand-alone value, consideration, financing,
203
+ alternatives, downside, per-share effect, and postmortem fields.
204
+ - **Limits:** Good businesses can be overpaid for and synergies may matter; unbounded
205
+ economics or consideration leaves the assessment unresolved.
206
+ - **Source basis:**
207
+ - **Berkshire Hathaway 1985 annual letter** — *implements*: Berkshire whole business
208
+ acquisition criteria.
209
+ - **Berkshire Hathaway 2017 annual letter** — *implements*: evaluate acquisitions on
210
+ all equity basis.
211
+ - **Corroboration:** EWB §IV.D; OM1996; BH2014.
212
+
213
+ <a id="c09"></a>
214
+
215
+ ### C09 — Counter Acquisition-Process Bias
216
+
217
+ - **Decision question:** Has commitment manufactured confidence through selective
218
+ information, incentives, or optimistic assumptions?
219
+ - **Guidance:** Require an informed opposing case challenging seller information,
220
+ forecasts, turnarounds, synergies, adviser incentives, and deal hunger.
221
+ - **Use when:** A material transaction with committed leadership, seller-controlled
222
+ information, or synergy and turnaround dependence.
223
+ - **Analytical actions:** Build the stand-alone downside before synergies; map
224
+ incentives and information; run a premortem and preserve assumptions.
225
+ - **Output:** An independent deal-challenge memo listing contested assumptions,
226
+ adverse-selection risks, opposing evidence, and unresolved conditions.
227
+ - **Limits:** Seller advantage does not imply fraud, deals do not universally fail, and
228
+ broad acquisition priors cannot determine a specific case.
229
+ - **Source basis:**
230
+ - **Berkshire Hathaway 1995 annual letter** — *supports*: most acquisitions damage
231
+ buyers and seller projections mislead.
232
+ - **Berkshire Hathaway 2017 annual letter** — *supports*: deal hunger recruits biased
233
+ forecasts and synergies.
234
+ - **Corroboration:** EWB §IV.A; EWB §IV.D; BH2014; LOW ch.12 (acquisition ego cases).
235
+
236
+ <!-- This document follows common-doc-guidelines.md.
237
+ See github.com/jlevy/practical-prose and review guidelines before editing.
238
+ -->
@@ -0,0 +1,189 @@
1
+ # Risk, Resilience, and Monitoring
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 tracing permanent harm, leverage, contingent claims, inflation, exit
8
+ conditions, or invalidation.
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
+ | [R01](#r01) | What could permanently reduce owner purchasing power, future consumption, or the ability to wait? |
17
+ | [R02](#r02) | Can obligations and operating capacity survive several plausible stresses arriving together? |
18
+ | [R03](#r03) | Could nonlinear claims, model errors, collateral demands, or weakest-link counterparties exceed liabilities or available liquidity? |
19
+ | [R04](#r04) | Does nominal growth become real owner value after pricing lags, replacement capital, working capital, tax, and financing? |
20
+ | [R05](#r05) | How much underlying return is lost to fees, taxes, turnover, advice, and unnecessary activity? |
21
+ | [R06](#r06) | Have economics, thesis evidence, integrity, or opportunity cost changed enough to satisfy a predeclared exit condition? |
22
+ | [R07](#r07) | Which observations would strengthen, weaken, revise, or retire each material assumption? |
23
+
24
+ ## Complete Cards
25
+
26
+ <a id="r01"></a>
27
+
28
+ ### R01 — Define Risk by Permanent Owner Harm or Forced Action
29
+
30
+ - **Decision question:** What could permanently reduce owner purchasing power, future
31
+ consumption, or the ability to wait?
32
+ - **Guidance:** Define risk by permanent owner outcomes and forced-action paths;
33
+ volatility matters when it interacts with liquidity, solvency, mandate, or horizon.
34
+ - **Use when:** Risk analysis dominated by beta, volatility, or generic labels.
35
+ - **Analytical actions:** Define owner, horizon, and harm; trace permanent-loss and
36
+ forced-action mechanisms; separate quotation volatility from impairment.
37
+ - **Output:** An owner-risk taxonomy with harm, mechanism, horizon, trigger, and
38
+ unresolved probability.
39
+ - **Limits:** Volatility matters for constraints and short horizons; this definition
40
+ proves neither concentration nor equity safety.
41
+ - **Source basis:**
42
+ - **Berkshire Hathaway 2011 annual letter** — *defines*: investment risk as purchasing
43
+ power loss probability.
44
+ - **Berkshire Hathaway 1993 annual letter** — *implements*: assess real risk through
45
+ purchasing power and business factors.
46
+ - **Corroboration:** EWB §II.C; OM1996; BH2022.
47
+
48
+ <a id="r02"></a>
49
+
50
+ ### R02 — Stress Leverage and Liquidity Under Correlated Adversity
51
+
52
+ - **Decision question:** Can obligations and operating capacity survive several
53
+ plausible stresses arriving together?
54
+ - **Guidance:** Stress debt, liquidity, refinancing, collateral, and operating needs
55
+ jointly; do not rely on averages or uninterrupted credit access.
56
+ - **Use when:** Material leverage, maturity concentration, cyclical cash flow, liquidity
57
+ dependence, or forced-action exposure.
58
+ - **Analytical actions:** Establish unrestricted liquidity and reserve; combine
59
+ operating, market, collateral, and refinancing stresses; identify first failure.
60
+ - **Output:** A correlated-stress table with sources, uses, reserve breach, refinancing
61
+ dependence, and unresolved inputs.
62
+ - **Limits:** No universal threshold applies and ring-fenced cash flows may support
63
+ different debt only when legal separation is verified.
64
+ - **Source basis:**
65
+ - **Berkshire Hathaway 2018 annual letter** — *implements*: preserve calamity
66
+ liquidity before acquisitions.
67
+ - **Berkshire Hathaway 2010 annual letter** — *supports*: leverage can destroy
68
+ survival when refinancing disappears.
69
+ - **Corroboration:** BPL1967; OM1996; BH2014; BH2023.
70
+
71
+ <a id="r03"></a>
72
+
73
+ ### R03 — Stress Contingent Obligations, Derivatives, Models, and Counterparties
74
+
75
+ - **Decision question:** Could nonlinear claims, model errors, collateral demands, or
76
+ weakest-link counterparties exceed liabilities or available liquidity?
77
+ - **Guidance:** Reconstruct the obligation and counterparty chain, challenge model
78
+ population and incentives, and stress amount, timing, correlation, collateral,
79
+ refinancing, and settlement together.
80
+ - **Use when:** Derivatives, pensions, reserves, guarantees, structured claims, or
81
+ model-dependent liabilities.
82
+ - **Analytical actions:** Build the obligation and collateral chain; challenge
83
+ structural breaks; stress timing, correlation, liquidity, and counterparties.
84
+ - **Output:** A contingent-obligation ledger and tail map with ranges, dependencies, and
85
+ unresolved exposures.
86
+ - **Limits:** Product expertise is often necessary; do not estimate absent exposure
87
+ merely to complete the analysis.
88
+ - **Source basis:**
89
+ - **Berkshire Hathaway 2003 annual letter** — *supports*: derivatives company
90
+ disclosures cannot reveal the full risk.
91
+ - **Berkshire Hathaway 2008 annual letter** — *implements*: test history based models
92
+ for changes in the underlying universe.
93
+ - **Corroboration:** EWB §II.G; BH2002.
94
+
95
+ <a id="r04"></a>
96
+
97
+ ### R04 — Test Inflation Exposure Through Pricing Power and Capital Needs
98
+
99
+ - **Decision question:** Does nominal growth become real owner value after pricing lags,
100
+ replacement capital, working capital, tax, and financing?
101
+ - **Guidance:** Trace inflation through revenue, costs, price, volume, required capital,
102
+ financing, and owner cash rather than labeling a hedge.
103
+ - **Use when:** Long-duration forecasts, inflation-sensitive inputs, fixed-price claims,
104
+ capital intensity, or an asserted inflation hedge.
105
+ - **Analytical actions:** Map price-cost-volume timing; estimate replacement and working
106
+ capital; compare nominal with real owner cash.
107
+ - **Output:** An inflation-transmission map and real-owner-cash sensitivity with
108
+ unresolved variables.
109
+ - **Limits:** Pricing can reduce volume and productive assets can require heavy capital;
110
+ asset labels do not resolve the result.
111
+ - **Source basis:**
112
+ - **Berkshire Hathaway 2011 annual letter** — *defines*: investment risk as purchasing
113
+ power loss probability.
114
+ - **Berkshire Hathaway 2011 annual letter** — *qualifies*: buy currency securities
115
+ only for unusual mispricing or rate opportunities.
116
+ - **Corroboration:** EWB §V.C; BH1981.
117
+
118
+ <a id="r05"></a>
119
+
120
+ ### R05 — Preserve Compounding by Minimizing Avoidable Friction
121
+
122
+ - **Decision question:** How much underlying return is lost to fees, taxes, turnover,
123
+ advice, and unnecessary activity?
124
+ - **Guidance:** Measure avoidable friction before crediting active intervention while
125
+ keeping survival and reinvestment quality as prior conditions.
126
+ - **Use when:** Strategy comparison, manager evaluation, turnover, taxes, or claims that
127
+ gross performance equals owner return.
128
+ - **Analytical actions:** Reconcile gross to net; compare with a lower-friction
129
+ alternative; compound measured drag over the horizon.
130
+ - **Output:** A friction bridge showing costs and cumulative owner impact.
131
+ - **Limits:** Low cost does not make a weak strategy sound and access, mandate, tax, and
132
+ benchmarks differ.
133
+ - **Source basis:**
134
+ - **Berkshire Hathaway 1983 annual letter** — *supports*: market turnover imposes
135
+ owner friction costs.
136
+ - **Berkshire Hathaway 2013 annual letter** — *supports*: frequent trading and advice
137
+ costs reduce aggregate investor returns.
138
+ - **Corroboration:** EWB §III.A; EWB §III.D; BH2014.
139
+
140
+ <a id="r06"></a>
141
+
142
+ ### R06 — Test Whether an Exit Condition Has Been Met
143
+
144
+ - **Decision question:** Have economics, thesis evidence, integrity, or opportunity cost
145
+ changed enough to satisfy a predeclared exit condition?
146
+ - **Guidance:** Compare current evidence with the original thesis and conditions;
147
+ distinguish deterioration and superior alternatives from price reaction.
148
+ - **Use when:** Hold, sell, or thesis-update review after material evidence or a
149
+ proposed exit.
150
+ - **Analytical actions:** Compare original and current assumptions; test economics,
151
+ integrity, value, tax, and alternatives; classify each condition.
152
+ - **Output:** An exit-condition assessment with evidence and unresolved questions, but
153
+ no trade instruction.
154
+ - **Limits:** Long holding and sale for higher-priority uses are in tension; no
155
+ condition automatically authorizes a trade.
156
+ - **Source basis:**
157
+ - **Warren Buffett’s 2015 50th-anniversary essay** — *qualifies*: consider inaction
158
+ before selling a prosperous business.
159
+ - **Berkshire Hathaway 2009 annual letter** — *illustrates*: security sales funded
160
+ higher priority cash deployment.
161
+ - **Corroboration:** EWB §IV.E; BPL1967; BH2014 (Tesco exit-delay case).
162
+
163
+ <a id="r07"></a>
164
+
165
+ ### R07 — Monitor Assumptions, Change Indicators, and Invalidation Conditions
166
+
167
+ - **Decision question:** Which observations would strengthen, weaken, revise, or retire
168
+ each material assumption?
169
+ - **Guidance:** Maintain a compact assumption register with evidence-linked indicators
170
+ and invalidation conditions; update from decision-relevant evidence rather than
171
+ undirected news or quotes.
172
+ - **Use when:** Ongoing monitoring, periodic thesis review, or material new operating,
173
+ governance, financing, or industry evidence.
174
+ - **Analytical actions:** Register assumptions, indicators, and cadence; classify new
175
+ evidence; mark assumptions strengthened, weakened, revised, retired, or unresolved.
176
+ - **Output:** A thesis-monitoring register with dated evidence, status changes, and
177
+ blocked conclusions.
178
+ - **Limits:** Indicators can be noisy or lagging and no update automatically produces a
179
+ buy, sell, or hold action.
180
+ - **Source basis:**
181
+ - **Berkshire Hathaway 2013 annual letter** — *implements*: ignore daily prices and
182
+ monitor productive output.
183
+ - **Berkshire Hathaway 1996 annual letter** — *qualifies*: do not sell fine businesses
184
+ on scary news alone.
185
+ - **Corroboration:** EWB §II.E; BPL1967; BH2014.
186
+
187
+ <!-- This document follows common-doc-guidelines.md.
188
+ See github.com/jlevy/practical-prose and review guidelines before editing.
189
+ -->