@v587d/capital-generation 2.7.11 → 2.8.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 (208) hide show
  1. package/CHANGELOG.md +76 -3
  2. package/README.md +4 -2
  3. package/chart-ui/package.json +1 -1
  4. package/config/package.json +1 -1
  5. package/lib/agents/bash-guard.d.ts +22 -17
  6. package/lib/agents/bash-guard.js +32 -28
  7. package/lib/agents/root-tool-policy.d.ts +29 -3
  8. package/lib/agents/root-tool-policy.js +100 -14
  9. package/lib/index.js +14 -8
  10. package/lib/web-retriever/local-fetch.d.ts +1 -1
  11. package/lib/web-retriever/local-fetch.js +1 -1
  12. package/lib/web-retriever/wind-client.d.ts +1 -1
  13. package/lib/web-retriever/wind-client.js +1 -1
  14. package/package.json +1 -1
  15. package/preset/capital-generation/README.md +22 -15
  16. package/preset/capital-generation/agent.patch.yml +20 -4
  17. package/preset/capital-generation/skills/capital-data-profile/SKILL.md +177 -0
  18. package/preset/capital-generation/skills/capital-data-protocol/SKILL.md +11 -269
  19. package/preset/capital-generation/skills/capital-data-query/SKILL.md +109 -0
  20. package/preset/capital-generation/skills/capital-equity-research/SKILL.md +2 -2
  21. package/preset/capital-generation/skills/capital-orchestration/SKILL.md +3 -2
  22. package/preset/capital-generation/skills/capital-web-evidence/SKILL.md +134 -0
  23. package/preset/capital-generation/skills/capital-web-protocol/SKILL.md +10 -130
  24. package/selected-skills/InvestSkill/UPSTREAM.md +18 -0
  25. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +10 -296
  26. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/10-retrieving-the-filing.md +130 -0
  27. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/11-key-metrics-table.md +129 -0
  28. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/12-language-mode.md +60 -0
  29. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +13 -152
  30. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/references/10-analysis-framework.md +75 -0
  31. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/references/11-output-and-signal.md +51 -0
  32. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/references/12-thesis-invalidation.md +44 -0
  33. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +10 -284
  34. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/10-persona.md +113 -0
  35. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/11-section-c-company-specific.md +108 -0
  36. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/12-section-f-90-day.md +85 -0
  37. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +11 -433
  38. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/10-overview.md +82 -0
  39. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/11-porter-s-five-forces.md +137 -0
  40. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/12-innovation-disruption-assessment.md +112 -0
  41. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/13-input-formats.md +130 -0
  42. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +12 -639
  43. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/10-analysis-framework.md +138 -0
  44. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/11-dividend-history-and-reliability.md +131 -0
  45. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/12-share-buyback-analysis.md +125 -0
  46. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/13-fcf-deployment-scorecard.md +133 -0
  47. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/14-output.md +149 -0
  48. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +10 -411
  49. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/10-analysis-framework.md +194 -0
  50. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/11-data-sources.md +196 -0
  51. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/12-thesis-invalidation.md +43 -0
  52. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +11 -234
  53. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/10-overview.md +86 -0
  54. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/11-phase-4-the-implied.md +60 -0
  55. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/12-output-format.md +83 -0
  56. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/13-standard-signal-output.md +34 -0
  57. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +10 -304
  58. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/10-key-economic-indicators.md +98 -0
  59. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/11-credit-market-indicators.md +114 -0
  60. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/12-recession-probability-scoring.md +114 -0
  61. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +11 -236
  62. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/10-overview.md +83 -0
  63. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/11-phase-5-overlap-with.md +69 -0
  64. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/12-output-format.md +79 -0
  65. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/13-standard-signal-output.md +34 -0
  66. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +11 -243
  67. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/10-overview.md +61 -0
  68. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/11-phase-2-source-hierarchy.md +54 -0
  69. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/12-phase-5-consistency.md +90 -0
  70. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/13-notes.md +68 -0
  71. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +11 -499
  72. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/10-overview.md +143 -0
  73. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/11-phase-3-financial-statement.md +167 -0
  74. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/12-phase-6-management-tone.md +176 -0
  75. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/13-thesis-invalidation.md +43 -0
  76. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +10 -291
  77. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/10-overview.md +117 -0
  78. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/11-step-3-position-locator.md +112 -0
  79. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/12-visualization-support.md +84 -0
  80. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +10 -457
  81. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/10-analysis-framework.md +185 -0
  82. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/11-pattern-recognition.md +175 -0
  83. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/12-interpretation-guidelines.md +120 -0
  84. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +11 -503
  85. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/10-analysis-framework.md +132 -0
  86. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/11-ownership-concentration-analysis.md +166 -0
  87. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/12-red-flags-warning-signs.md +192 -0
  88. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/13-thesis-invalidation.md +43 -0
  89. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +11 -264
  90. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/10-overview.md +63 -0
  91. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/11-phase-2-explanation-card.md +108 -0
  92. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/12-output-format.md +88 -0
  93. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/13-standard-signal-output.md +34 -0
  94. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +11 -448
  95. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/10-analysis-framework.md +109 -0
  96. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/11-implied-volatility-iv-analysis.md +102 -0
  97. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/12-earnings-play-analysis.md +109 -0
  98. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/13-data-sources.md +159 -0
  99. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +11 -435
  100. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/10-phase-1-portfolio-snapshot.md +124 -0
  101. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/11-phase-6-correlation-diversification.md +124 -0
  102. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/12-phase-9-rebalancing-decision.md +153 -0
  103. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/13-data-verification.md +62 -0
  104. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +11 -372
  105. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/10-overview.md +102 -0
  106. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/11-phase-3-the-trim.md +88 -0
  107. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/12-phase-6-the-thesis.md +105 -0
  108. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/13-input-formats.md +105 -0
  109. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +10 -250
  110. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/10-overview.md +92 -0
  111. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/11-phase-4-correlation-spike.md +116 -0
  112. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/12-notes.md +65 -0
  113. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +11 -381
  114. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/10-sector-overview.md +123 -0
  115. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/11-sector-correlation-matrix.md +90 -0
  116. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/12-peer-benchmarking-within-sector.md +92 -0
  117. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/13-consumer-staples.md +105 -0
  118. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +10 -352
  119. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/10-analysis-framework.md +110 -0
  120. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/11-bearish-thesis-evaluation.md +118 -0
  121. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/12-data-sources.md +148 -0
  122. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +16 -603
  123. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/10-analysis-components.md +122 -0
  124. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/11-dupont-decomposition.md +121 -0
  125. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/12-quality-scoring-framework.md +115 -0
  126. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/13-dcf-framework.md +113 -0
  127. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/14-analyst-consensus-tracking.md +127 -0
  128. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/15-thesis-invalidation.md +43 -0
  129. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +13 -177
  130. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/references/10-scoring-framework.md +85 -0
  131. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/references/11-output-format.md +58 -0
  132. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/references/12-invalidation-and-signal.md +51 -0
  133. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +12 -595
  134. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/10-overview.md +133 -0
  135. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/11-method-2-comparable-company.md +127 -0
  136. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/12-football-field-summary-valuation.md +140 -0
  137. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/13-terminal-value-two-methods.md +121 -0
  138. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/14-when-dcf-is.md +110 -0
  139. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +12 -304
  140. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/10-overview.md +73 -0
  141. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/11-phase-3-dividends-qualified.md +67 -0
  142. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/12-framework-non-us-module.md +61 -0
  143. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/13-scoring-tax-efficiency-score.md +83 -0
  144. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/14-thesis-invalidation.md +55 -0
  145. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +16 -612
  146. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/10-chart-pattern-analysis.md +172 -0
  147. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/11-chart-visualization-support.md +181 -0
  148. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/12-multi-timeframe-analysis-mtf.md +95 -0
  149. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/13-advanced-indicators-ichimoku-cloud.md +61 -0
  150. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/14-options-flow-integration.md +95 -0
  151. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/15-thesis-invalidation.md +45 -0
  152. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +10 -274
  153. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/10-overview.md +94 -0
  154. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/11-phase-5-the-pre.md +113 -0
  155. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/12-example.md +90 -0
  156. package/selected-skills/claude-for-financial-services-cn/UPSTREAM.md +1 -0
  157. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/SKILL.md +18 -184
  158. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/references/10-catalyst-types.md +64 -0
  159. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/references/11-workflow-and-calendar.md +131 -0
  160. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/SKILL.md +16 -195
  161. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/references/10-workflow.md +201 -0
  162. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/SKILL.md +17 -156
  163. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/references/10-workflow.md +161 -0
  164. package/selected-skills/investment-skills/UPSTREAM.md +1 -0
  165. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +31 -122
  166. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{01-decision-posture.md → 01-decision-posture-D01-D04.md} +0 -119
  167. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/01-decision-posture-D05-D09.md +123 -0
  168. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/02-business-economics-B01-B03.md +94 -0
  169. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{02-business-economics.md → 02-business-economics-B04-B07.md} +3 -93
  170. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{03-management-governance.md → 03-management-governance-M01-M04.md} +0 -93
  171. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/03-management-governance-M05-M08.md +97 -0
  172. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/04-financial-reality-F01-F03.md +95 -0
  173. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{04-financial-reality.md → 04-financial-reality-F04-F07.md} +3 -94
  174. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{05-valuation.md → 05-valuation-V01-V03.md} +0 -72
  175. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/05-valuation-V04-V06.md +76 -0
  176. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{06-capital-allocation.md → 06-capital-allocation-C01-C04.md} +0 -115
  177. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/06-capital-allocation-C05-C09.md +119 -0
  178. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/{07-risk-monitoring.md → 07-risk-monitoring-R01-R03.md} +0 -94
  179. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/07-risk-monitoring-R04-R07.md +98 -0
  180. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/08-specialized-overlays-S01-S03.md +99 -0
  181. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/08-specialized-overlays-S04-S06.md +72 -0
  182. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/08-specialized-overlays-S07-S09.md +74 -0
  183. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/08-specialized-overlays-S10-S12.md +76 -0
  184. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/09-workflows.md +96 -0
  185. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/10-method.md +12 -0
  186. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/11-deterministic-router.md +11 -0
  187. package/selected-skills/peter-lynch-skill/UPSTREAM.md +1 -0
  188. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +12 -86
  189. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/10-workflow.md +94 -0
  190. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology-1.md +220 -0
  191. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology-2.md +146 -0
  192. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology-3.md +114 -0
  193. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology-4.md +113 -0
  194. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/methodology.md +8 -521
  195. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research-1.md +119 -0
  196. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research-2.md +82 -0
  197. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research-3.md +158 -0
  198. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research-4.md +123 -0
  199. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/deep/web-research.md +8 -454
  200. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/methodology-1.md +155 -0
  201. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/methodology-2.md +43 -0
  202. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/methodology.md +6 -180
  203. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research-1.md +114 -0
  204. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research-2.md +180 -0
  205. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research-3.md +92 -0
  206. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/references/quick/web-research.md +7 -359
  207. package/watchlist/package.json +1 -1
  208. package/selected-skills/investment-skills/skills/buffett-investment-framework/references/08-specialized-overlays.md +0 -309
@@ -0,0 +1,119 @@
1
+ # Capital Allocation · Part 2 of 2 (C05-C09)
2
+
3
+ Cards C05, C06, C07, C08, C09 of this module. Part 1 (`06-capital-allocation-C01-C04.md`) holds the module title and card index.
4
+ Each part is sized to arrive complete in one `read`; open the part you need before concluding a card is absent.
5
+
6
+ ### C05 — Return Surplus Capital When No Better Use Exists
7
+
8
+ - **Decision question:** After protected reserves and productive uses, is capital
9
+ genuinely surplus?
10
+ - **Guidance:** Treat payout as the consequence of no better supported deployment, not a
11
+ fixed preference; distinguish distribution from central redeployment.
12
+ - **Use when:** Mature or capital-light operations generate cash beyond maintenance,
13
+ growth, obligations, and resilience needs.
14
+ - **Analytical actions:** Reconcile distributable cash after C02; compare C03
15
+ alternatives; show tax, control, and owner-treatment effects of payout channels.
16
+ - **Output:** A surplus-capital ledger with amounts blocked, deployable, distributable,
17
+ or unresolved.
18
+ - **Limits:** Legal, tax, contractual, and balance-sheet limits may block payout; an
19
+ incomplete reserve or opportunity set means no surplus finding.
20
+ - **Source basis:**
21
+ - **Berkshire Hathaway 1984 annual letter** — *implements*: Berkshire dividend policy
22
+ uses value creation threshold.
23
+ - **Berkshire Hathaway 2007 annual letter** — *qualifies*: redeploy cash from high
24
+ return low reinvestment businesses.
25
+ - **Corroboration:** EWB §III.C; BH2014; LOW ch.15 (distribution threshold case).
26
+
27
+ <a id="c06"></a>
28
+
29
+ ### C06 — Repurchase Only Below Value with Surplus Capacity and Material Effect
30
+
31
+ - **Decision question:** Will repurchase materially improve continuing-owner value
32
+ without weakening resilience or unfairly transferring value?
33
+ - **Guidance:** Require conservative undervaluation, protected liquidity, fair
34
+ disclosure, superior alternatives, and meaningful per-share effect.
35
+ - **Use when:** An issuer proposes, conducts, or defends a material repurchase.
36
+ - **Analytical actions:** Compare price with value; recheck capacity and alternatives;
37
+ quantify shares retired, financing, per-share effect, and transfers.
38
+ - **Output:** A repurchase worksheet with value, capacity, materiality, fairness,
39
+ alternatives, and unresolved assumptions.
40
+ - **Limits:** Value is uncertain and above-value purchases can transfer wealth; the
41
+ worksheet authorizes no repurchase or trade.
42
+ - **Source basis:**
43
+ - **Berkshire Hathaway 1980 annual letter** — *implements*: repurchase below intrinsic
44
+ value.
45
+ - **Berkshire Hathaway 1999 annual letter** — *qualifies*: above value repurchases
46
+ transfer wealth from continuing owners.
47
+ - **Corroboration:** EWB §IV.B; BH2014; BH2022; LOW ch.10 (Washington Post repurchases).
48
+
49
+ <a id="c07"></a>
50
+
51
+ ### C07 — Issue Shares Only Value for Value
52
+
53
+ - **Decision question:** Does issuing equity give owners at least as much durable value
54
+ and resilience as the interest surrendered?
55
+ - **Guidance:** Analyze issuance as a partial sale of owner assets and compare value
56
+ surrendered with assets, claims extinguished, or resilience received.
57
+ - **Use when:** Stock-financed acquisitions, compensation issuance, conversion,
58
+ recapitalization, or balance-sheet repair.
59
+ - **Analytical actions:** Estimate value and ownership surrendered; value consideration
60
+ and resilience received; reconcile to continuing-owner value rather than optics.
61
+ - **Output:** An issuance exchange bridge with ownership transfer, proceeds, financing
62
+ effects, and per-share result.
63
+ - **Limits:** Issuance can rationally improve resilience and both sides are uncertain;
64
+ missing estimates leave the exchange unresolved.
65
+ - **Source basis:**
66
+ - **Berkshire Hathaway 1982 annual letter** — *implements*: share issuance value for
67
+ value rule.
68
+ - **Berkshire Hathaway 1992 annual letter** — *illustrates*: stock financed bank deal
69
+ destroyed value.
70
+ - **Corroboration:** EWB §IV.A; OM1996; LOW ch.12 (stock-deal dilution cases).
71
+
72
+ <a id="c08"></a>
73
+
74
+ ### C08 — Evaluate Acquisitions by Quality, Price, Financing, Alternatives, and Postmortems
75
+
76
+ - **Decision question:** Does the complete exchange improve continuing-owner value under
77
+ defensible stand-alone and downside cases?
78
+ - **Guidance:** Evaluate target economics, management, price, financing, dilution,
79
+ alternatives, and realized outcomes together, not EPS or size.
80
+ - **Use when:** A proposed or completed acquisition, merger, or major asset purchase.
81
+ - **Analytical actions:** Underwrite stand-alone quality and owner cash; build a value
82
+ exchange and financing bridge; preserve assumptions for post-closing comparison.
83
+ - **Output:** An acquisition sheet with stand-alone value, consideration, financing,
84
+ alternatives, downside, per-share effect, and postmortem fields.
85
+ - **Limits:** Good businesses can be overpaid for and synergies may matter; unbounded
86
+ economics or consideration leaves the assessment unresolved.
87
+ - **Source basis:**
88
+ - **Berkshire Hathaway 1985 annual letter** — *implements*: Berkshire whole business
89
+ acquisition criteria.
90
+ - **Berkshire Hathaway 2017 annual letter** — *implements*: evaluate acquisitions on
91
+ all equity basis.
92
+ - **Corroboration:** EWB §IV.D; OM1996; BH2014.
93
+
94
+ <a id="c09"></a>
95
+
96
+ ### C09 — Counter Acquisition-Process Bias
97
+
98
+ - **Decision question:** Has commitment manufactured confidence through selective
99
+ information, incentives, or optimistic assumptions?
100
+ - **Guidance:** Require an informed opposing case challenging seller information,
101
+ forecasts, turnarounds, synergies, adviser incentives, and deal hunger.
102
+ - **Use when:** A material transaction with committed leadership, seller-controlled
103
+ information, or synergy and turnaround dependence.
104
+ - **Analytical actions:** Build the stand-alone downside before synergies; map
105
+ incentives and information; run a premortem and preserve assumptions.
106
+ - **Output:** An independent deal-challenge memo listing contested assumptions,
107
+ adverse-selection risks, opposing evidence, and unresolved conditions.
108
+ - **Limits:** Seller advantage does not imply fraud, deals do not universally fail, and
109
+ broad acquisition priors cannot determine a specific case.
110
+ - **Source basis:**
111
+ - **Berkshire Hathaway 1995 annual letter** — *supports*: most acquisitions damage
112
+ buyers and seller projections mislead.
113
+ - **Berkshire Hathaway 2017 annual letter** — *supports*: deal hunger recruits biased
114
+ forecasts and synergies.
115
+ - **Corroboration:** EWB §IV.A; EWB §IV.D; BH2014; LOW ch.12 (acquisition ego cases).
116
+
117
+ <!-- This document follows common-doc-guidelines.md.
118
+ See github.com/jlevy/practical-prose and review guidelines before editing.
119
+ -->
@@ -93,97 +93,3 @@ Abbreviated corroboration citations resolve in the [source key](00-source-key.md
93
93
  - **Corroboration:** EWB §II.G; BH2002.
94
94
 
95
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
- -->
@@ -0,0 +1,98 @@
1
+ # Risk, Resilience, and Monitoring · Part 2 of 2 (R04-R07)
2
+
3
+ Cards R04, R05, R06, R07 of this module. Part 1 (`07-risk-monitoring-R01-R03.md`) holds the module title and card index.
4
+ Each part is sized to arrive complete in one `read`; open the part you need before concluding a card is absent.
5
+
6
+ ### R04 — Test Inflation Exposure Through Pricing Power and Capital Needs
7
+
8
+ - **Decision question:** Does nominal growth become real owner value after pricing lags,
9
+ replacement capital, working capital, tax, and financing?
10
+ - **Guidance:** Trace inflation through revenue, costs, price, volume, required capital,
11
+ financing, and owner cash rather than labeling a hedge.
12
+ - **Use when:** Long-duration forecasts, inflation-sensitive inputs, fixed-price claims,
13
+ capital intensity, or an asserted inflation hedge.
14
+ - **Analytical actions:** Map price-cost-volume timing; estimate replacement and working
15
+ capital; compare nominal with real owner cash.
16
+ - **Output:** An inflation-transmission map and real-owner-cash sensitivity with
17
+ unresolved variables.
18
+ - **Limits:** Pricing can reduce volume and productive assets can require heavy capital;
19
+ asset labels do not resolve the result.
20
+ - **Source basis:**
21
+ - **Berkshire Hathaway 2011 annual letter** — *defines*: investment risk as purchasing
22
+ power loss probability.
23
+ - **Berkshire Hathaway 2011 annual letter** — *qualifies*: buy currency securities
24
+ only for unusual mispricing or rate opportunities.
25
+ - **Corroboration:** EWB §V.C; BH1981.
26
+
27
+ <a id="r05"></a>
28
+
29
+ ### R05 — Preserve Compounding by Minimizing Avoidable Friction
30
+
31
+ - **Decision question:** How much underlying return is lost to fees, taxes, turnover,
32
+ advice, and unnecessary activity?
33
+ - **Guidance:** Measure avoidable friction before crediting active intervention while
34
+ keeping survival and reinvestment quality as prior conditions.
35
+ - **Use when:** Strategy comparison, manager evaluation, turnover, taxes, or claims that
36
+ gross performance equals owner return.
37
+ - **Analytical actions:** Reconcile gross to net; compare with a lower-friction
38
+ alternative; compound measured drag over the horizon.
39
+ - **Output:** A friction bridge showing costs and cumulative owner impact.
40
+ - **Limits:** Low cost does not make a weak strategy sound and access, mandate, tax, and
41
+ benchmarks differ.
42
+ - **Source basis:**
43
+ - **Berkshire Hathaway 1983 annual letter** — *supports*: market turnover imposes
44
+ owner friction costs.
45
+ - **Berkshire Hathaway 2013 annual letter** — *supports*: frequent trading and advice
46
+ costs reduce aggregate investor returns.
47
+ - **Corroboration:** EWB §III.A; EWB §III.D; BH2014.
48
+
49
+ <a id="r06"></a>
50
+
51
+ ### R06 — Test Whether an Exit Condition Has Been Met
52
+
53
+ - **Decision question:** Have economics, thesis evidence, integrity, or opportunity cost
54
+ changed enough to satisfy a predeclared exit condition?
55
+ - **Guidance:** Compare current evidence with the original thesis and conditions;
56
+ distinguish deterioration and superior alternatives from price reaction.
57
+ - **Use when:** Hold, sell, or thesis-update review after material evidence or a
58
+ proposed exit.
59
+ - **Analytical actions:** Compare original and current assumptions; test economics,
60
+ integrity, value, tax, and alternatives; classify each condition.
61
+ - **Output:** An exit-condition assessment with evidence and unresolved questions, but
62
+ no trade instruction.
63
+ - **Limits:** Long holding and sale for higher-priority uses are in tension; no
64
+ condition automatically authorizes a trade.
65
+ - **Source basis:**
66
+ - **Warren Buffett’s 2015 50th-anniversary essay** — *qualifies*: consider inaction
67
+ before selling a prosperous business.
68
+ - **Berkshire Hathaway 2009 annual letter** — *illustrates*: security sales funded
69
+ higher priority cash deployment.
70
+ - **Corroboration:** EWB §IV.E; BPL1967; BH2014 (Tesco exit-delay case).
71
+
72
+ <a id="r07"></a>
73
+
74
+ ### R07 — Monitor Assumptions, Change Indicators, and Invalidation Conditions
75
+
76
+ - **Decision question:** Which observations would strengthen, weaken, revise, or retire
77
+ each material assumption?
78
+ - **Guidance:** Maintain a compact assumption register with evidence-linked indicators
79
+ and invalidation conditions; update from decision-relevant evidence rather than
80
+ undirected news or quotes.
81
+ - **Use when:** Ongoing monitoring, periodic thesis review, or material new operating,
82
+ governance, financing, or industry evidence.
83
+ - **Analytical actions:** Register assumptions, indicators, and cadence; classify new
84
+ evidence; mark assumptions strengthened, weakened, revised, retired, or unresolved.
85
+ - **Output:** A thesis-monitoring register with dated evidence, status changes, and
86
+ blocked conclusions.
87
+ - **Limits:** Indicators can be noisy or lagging and no update automatically produces a
88
+ buy, sell, or hold action.
89
+ - **Source basis:**
90
+ - **Berkshire Hathaway 2013 annual letter** — *implements*: ignore daily prices and
91
+ monitor productive output.
92
+ - **Berkshire Hathaway 1996 annual letter** — *qualifies*: do not sell fine businesses
93
+ on scary news alone.
94
+ - **Corroboration:** EWB §II.E; BPL1967; BH2014.
95
+
96
+ <!-- This document follows common-doc-guidelines.md.
97
+ See github.com/jlevy/practical-prose and review guidelines before editing.
98
+ -->
@@ -0,0 +1,99 @@
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>
@@ -0,0 +1,72 @@
1
+ # Specialized Industry and Instrument Overlays · Part 2 of 4 (S04-S06)
2
+
3
+ Cards S04, S05, S06 of this module. Part 1 (`08-specialized-overlays-S01-S03.md`) holds the module title and card index.
4
+ Each part is sized to arrive complete in one `read`; open the part you need before concluding a card is absent.
5
+
6
+ ### S04 — Insurance: Test Aggregate Tail Loss Against Distress Capacity
7
+
8
+ - **Decision question:** Can one event or common cause impair solvency, liquidity,
9
+ claims payment, or post-shock capacity?
10
+ - **Guidance:** Aggregate policies, businesses, investments, counterparties, collateral,
11
+ and funding; work backward from intolerable outcomes.
12
+ - **Use when:** Catastrophe, systemic, liability, cyber, terrorism, or other nonlinear,
13
+ correlated exposure.
14
+ - **Analytical actions:** Enumerate common causes; estimate ranges under model breaks;
15
+ compare loss with regulatory, covenant, claims, and post-shock needs.
16
+ - **Output:** An aggregate-tail ledger with loss ranges, liquidity timing, binding
17
+ capacity, and unresolved correlations.
18
+ - **Limits:** Scenarios are never exhaustive and no universal buffer applies; preserve
19
+ false precision as unresolved.
20
+ - **Source basis:**
21
+ - **Berkshire Hathaway 1996 annual letter** — *implements*: reverse engineer
22
+ aggregated tail risk from intolerable outcomes.
23
+ - **Berkshire Hathaway 2012 annual letter** — *qualifies*: insurance capacity must
24
+ remain proportionate to enterprise resources.
25
+ - **Corroboration:** BH2002; BH2014; LOW ch.23 (super-cat exposure growth).
26
+
27
+ <a id="s05"></a>
28
+
29
+ ### S05 — Insurance: Test Crisis Liquidity and the Risk-Transfer Chain
30
+
31
+ - **Decision question:** Can claims, collateral, refinancing, or counterparties force
32
+ cash shortfalls when the same shock weakens the chain?
33
+ - **Guidance:** Analyze claims liquidity and the complete transfer chain together,
34
+ including ability, duration, collateral, jurisdiction, and weakest link.
35
+ - **Use when:** Losses are ceded, collateralized, long-tailed, externally financed, or
36
+ dependent on multiple transfer parties.
37
+ - **Analytical actions:** Map gross loss, ceded layers, collateral, timing, and parties;
38
+ stress simultaneous claims and failures; identify unrefinanced liquidity.
39
+ - **Output:** A risk-transfer and liquidity map showing gross and net timing,
40
+ dependencies, collateral, and unresolved recoverability.
41
+ - **Limits:** Retention is not automatically safer and legal rights do not ensure prompt
42
+ collection; unverified recoveries stay unavailable.
43
+ - **Source basis:**
44
+ - **Berkshire Hathaway 2001 annual letter** — *implements*: stress test entire
45
+ reinsurance counterparty chain.
46
+ - **Berkshire Hathaway 2004 annual letter** — *supports*: reinsurer solvency is
47
+ material counterparty risk.
48
+ - **Corroboration:** BH2002; BH2014.
49
+
50
+ <a id="s06"></a>
51
+
52
+ ### S06 — Insurance: Require Discipline and Structure for a Moat
53
+
54
+ - **Decision question:** What prevents this apparently commodity-like insurer from
55
+ earning commodity returns?
56
+ - **Guidance:** Look for low cost or niche, distribution, underwriting skill, capital,
57
+ and a culture willing to sacrifice volume; do not infer a moat from growth.
58
+ - **Use when:** An insurer is claimed to have durable competitive advantage.
59
+ - **Analytical actions:** Name and compare the mechanism; test price, retention,
60
+ acquisition cost, losses, distribution, and capital through a cycle; seek persistence.
61
+ - **Output:** An insurance-moat map with competitor evidence, cycle indicators, erosion
62
+ signals, and unresolved causal links.
63
+ - **Limits:** Berkshire and GEICO are favorable cases, not base rates; unobserved causal
64
+ outcomes leave the moat unresolved.
65
+ - **Source basis:**
66
+ - **Berkshire Hathaway 1987 annual letter** — *supports*: commodity insurance rewards
67
+ low cost or niche.
68
+ - **Berkshire Hathaway 1999 annual letter** — *qualifies*: reinsurance advantage
69
+ combines distribution skill culture and capital.
70
+ - **Corroboration:** BH2014; BH2023; LOW ch.10 (GEICO expense-ratio edge).
71
+
72
+ <a id="s07"></a>
@@ -0,0 +1,74 @@
1
+ # Specialized Industry and Instrument Overlays · Part 3 of 4 (S07-S09)
2
+
3
+ Cards S07, S08, S09 of this module. Part 1 (`08-specialized-overlays-S04-S06.md`) holds the module title and card index.
4
+ Each part is sized to arrive complete in one `read`; open the part you need before concluding a card is absent.
5
+
6
+ ### S07 — Banking: Assess Funding, Credit, Leverage, and Culture
7
+
8
+ - **Decision question:** Can modest asset or underwriting errors overwhelm thin equity
9
+ or trigger confidence-sensitive funding loss?
10
+ - **Guidance:** Analyze asset quality, vintages, funding, liquidity, leverage,
11
+ incentives, and bad-news flow as one bank-specific fragility system.
12
+ - **Use when:** Banks, deposit-taking lenders, or businesses dependent on
13
+ confidence-sensitive funding.
14
+ - **Analytical actions:** Segment credit and concentration; stress funding loss, credit,
15
+ and liquidity together; compare incentives and reporting with outcomes.
16
+ - **Output:** A banking resilience matrix covering loss, runoff, liquidity, capital,
17
+ culture indicators, and unresolved disclosures.
18
+ - **Limits:** Regimes and protections differ materially; missing asset or funding detail
19
+ blocks the branch.
20
+ - **Source basis:**
21
+ - **Berkshire Hathaway 2006 annual letter** — *illustrates*: teaser mortgages defer
22
+ and amplify payment stress.
23
+ - **Berkshire Hathaway 2010 annual letter** — *supports*: leverage can destroy
24
+ survival when refinancing disappears.
25
+ - **Corroboration:** EWB §II.G; OM1996; BH2002; LOW ch.19 (deposit-insurance moral
26
+ hazard).
27
+
28
+ <a id="s08"></a>
29
+
30
+ ### S08 — Consumer and Retail: Separate Brand Economics from Fragile Distribution
31
+
32
+ - **Decision question:** Do loyalty, pricing, distribution, inventory, and format cause
33
+ durable returns, or does the brand depend on a weakening channel?
34
+ - **Guidance:** Test customer behavior and price separately from distribution access,
35
+ delivered value, inventory risk, and format durability.
36
+ - **Use when:** Consumer products, retail, restaurants, or similar brand and channel
37
+ dependence.
38
+ - **Analytical actions:** Measure price, volume, retention, mix, and channel economics;
39
+ trace inventory and format risks; identify channel shifts and alternatives.
40
+ - **Output:** A franchise and distribution scorecard with behavior, unit economics,
41
+ dependencies, and erosion indicators.
42
+ - **Limits:** Exceptional management can overcome some weak economics; missing cohort,
43
+ channel, or inventory evidence leaves durability unresolved.
44
+ - **Source basis:**
45
+ - **Berkshire Hathaway 1983 annual letter** — *supports*: consumer franchise and low
46
+ cost position create goodwill.
47
+ - **Berkshire Hathaway 1988 annual letter** — *qualifies*: exceptional management can
48
+ overcome mediocre industry economics.
49
+ - **Corroboration:** EWB §II.E; EWB §V.C; LOW ch.18 (Coca-Cola franchise case).
50
+
51
+ <a id="s09"></a>
52
+
53
+ ### S09 — Infrastructure: Evaluate Regulation, Irreplaceability, and Maintenance Capital
54
+
55
+ - **Decision question:** Do essential demand and network position earn adequate owner
56
+ returns after obligations, regulation, maintenance, and financing stress?
57
+ - **Guidance:** Evaluate regulated return, irreplaceability, service duties, required
58
+ capital, political legitimacy, and stressed financing together.
59
+ - **Use when:** Utilities, railways, pipelines, networks, and regulated or essential
60
+ capital-intensive infrastructure.
61
+ - **Analytical actions:** Reconcile allowed and realized returns; separate maintenance,
62
+ replacement, and expansion; stress lag, affordability, utilization, and debt service.
63
+ - **Output:** An infrastructure bridge covering rate mechanism, capital, returns,
64
+ financing, constraints, and unresolved regulation.
65
+ - **Limits:** Irreplaceability does not guarantee owner returns; missing rate or
66
+ maintenance evidence blocks the judgment.
67
+ - **Source basis:**
68
+ - **Berkshire Hathaway 2015 annual letter** — *implements*: regulated investment
69
+ requires reasonable returns and constituency approval.
70
+ - **Berkshire Hathaway 2003 annual letter** — *qualifies*: stable ring fenced utility
71
+ cash flows can support subsidiary debt.
72
+ - **Corroboration:** OM1996; BH2014.
73
+
74
+ <a id="s10"></a>
@@ -0,0 +1,76 @@
1
+ # Specialized Industry and Instrument Overlays · Part 4 of 4 (S10-S12)
2
+
3
+ Cards S10, S11, S12 of this module. Part 1 (`08-specialized-overlays-S04-S06.md`) holds the module title and card index.
4
+ Each part is sized to arrive complete in one `read`; open the part you need before concluding a card is absent.
5
+
6
+ ### S10 — Technology and Media: Test Whether Disruption Strengthens or Destroys the Moat
7
+
8
+ - **Decision question:** Can important economics be forecast despite obsolescence,
9
+ distribution change, network effects, and shifting attention?
10
+ - **Guidance:** Identify the protection mechanism, then test technical substitution,
11
+ platform control, distribution, behavior, and reinvestment; stop if forecastability
12
+ cannot be bounded.
13
+ - **Use when:** Technology, software, platforms, media, advertising, or rapid technical
14
+ and distribution change.
15
+ - **Analytical actions:** Map mechanism and dependencies; track retention, switching,
16
+ network density, distribution, attention, and innovation spend; define exit
17
+ indicators.
18
+ - **Output:** A disruption and forecastability map with dependencies, erosion
19
+ indicators, and an estimable or outside-boundary result.
20
+ - **Limits:** Leadership, reputation, or network size alone is insufficient; unbounded
21
+ critical economics stop the branch.
22
+ - **Source basis:**
23
+ - **Berkshire Hathaway 1993 annual letter** — *qualifies*: stay with easy to
24
+ understand businesses.
25
+ - **Berkshire Hathaway 2005 annual letter** — *defines*: widening the moat.
26
+ - **Corroboration:** EWB §II.E; BH2014; LOW ch.18 (competence-bounded selection).
27
+
28
+ <a id="s11"></a>
29
+
30
+ ### S11 — Energy and Commodities: Normalize Cycles, Inflation, and Capital Intensity
31
+
32
+ - **Decision question:** Do normalized owner returns arise from durable advantage or
33
+ favorable price, cycle, or underinvestment?
34
+ - **Guidance:** Separate price exposure from controllable advantage and normalize
35
+ volume, price, utilization, depletion, capital, regulation, and financing.
36
+ - **Use when:** Producers, processors, commodity-linked assets, or energy businesses.
37
+ - **Analytical actions:** Build price-volume-cost and cycle bridges; estimate
38
+ maintenance, depletion, and working capital; test cost claims under adverse prices and
39
+ capacity.
40
+ - **Output:** A normalized commodity table with cycle range, capital burden, cost
41
+ position, inflation exposure, and unresolved assumptions.
42
+ - **Limits:** Low-cost producers may be exceptions and price forecasts remain uncertain;
43
+ missing reserves or replacement data blocks owner cash.
44
+ - **Source basis:**
45
+ - **Berkshire Hathaway 1978 annual letter** — *supports*: commodity capital intensity
46
+ depresses returns.
47
+ - **Berkshire Hathaway 1985 annual letter** — *qualifies*: commodity cost saving capex
48
+ becomes industry price reduction.
49
+ - **Corroboration:** EWB §I.C; EWB §V.C; OM1996; BH2014.
50
+
51
+ <a id="s12"></a>
52
+
53
+ ### S12 — Special Instruments: Analyze Event Probability, Duration, Downside, and Optionality
54
+
55
+ - **Decision question:** Are event, duration, cash-flow, downside, and optionality
56
+ mechanics understandable and adequately evidenced?
57
+ - **Guidance:** Route each instrument to atomic contractual cash-flow,
58
+ event-probability, duration, upside, failure-downside, and enforceability analysis;
59
+ frozen evidence supports only announced-event arbitrage.
60
+ - **Use when:** Announced-event arbitrage, workout, preferred, convertible, or unusual
61
+ contractual claim rather than ordinary equity.
62
+ - **Analytical actions:** Identify contract, event, states, and legal dependencies;
63
+ estimate probability, duration, terms, and failure loss; stop unsupported branches.
64
+ - **Output:** A state-contingent worksheet with event states, probability inputs,
65
+ duration, payoff and loss ranges, legal dependencies, and unsupported branches.
66
+ - **Limits:** No universal return, probability, diversification, or legal checklist
67
+ applies; unsupported instruments remain unresolved.
68
+ - **Source basis:**
69
+ - **Berkshire Hathaway 1988 annual letter** — *defines*: risk arbitrage.
70
+ - **Berkshire Hathaway 1988 annual letter** — *implements*: four question arbitrage
71
+ analysis.
72
+ - **Corroboration:** EWB §II.B; BPL1964.
73
+
74
+ <!-- This document follows common-doc-guidelines.md.
75
+ See github.com/jlevy/practical-prose and review guidelines before editing.
76
+ -->