@v587d/capital-generation 2.7.12 → 2.8.1

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 (157) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/README.md +10 -6
  3. package/THIRD_PARTY_NOTICES.md +6 -1
  4. package/chart-ui/package.json +1 -1
  5. package/config/index.js +1 -0
  6. package/config/package.json +1 -1
  7. package/lib/agents/bash-guard.d.ts +22 -17
  8. package/lib/agents/bash-guard.js +32 -28
  9. package/lib/agents/root-tool-policy.d.ts +29 -3
  10. package/lib/agents/root-tool-policy.js +100 -14
  11. package/lib/data-collector/dataset-tools.js +9 -0
  12. package/lib/data-collector/tools.js +17 -5
  13. package/lib/index.d.ts +4 -0
  14. package/lib/index.js +27 -8
  15. package/lib/sources/ftshare-rest.d.ts +54 -0
  16. package/lib/sources/ftshare-rest.js +2363 -0
  17. package/lib/time/tools.js +24 -0
  18. package/lib/web-retriever/local-fetch.d.ts +1 -1
  19. package/lib/web-retriever/local-fetch.js +1 -1
  20. package/lib/web-retriever/wind-client.d.ts +1 -1
  21. package/lib/web-retriever/wind-client.js +1 -1
  22. package/package.json +1 -1
  23. package/preset/capital-generation/README.md +22 -15
  24. package/preset/capital-generation/agent.patch.yml +14 -1
  25. package/preset/capital-generation/skills/capital-data-protocol/SKILL.md +4 -1
  26. package/selected-skills/InvestSkill/UPSTREAM.md +17 -0
  27. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/SKILL.md +10 -296
  28. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/10-retrieving-the-filing.md +130 -0
  29. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/11-key-metrics-table.md +129 -0
  30. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/10k-digest/references/12-language-mode.md +60 -0
  31. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/bear-case/SKILL.md +5 -3
  32. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/SKILL.md +10 -284
  33. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/10-persona.md +113 -0
  34. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/11-section-c-company-specific.md +108 -0
  35. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/catalyst-calendar/references/12-section-f-90-day.md +85 -0
  36. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/SKILL.md +11 -433
  37. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/10-overview.md +82 -0
  38. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/11-porter-s-five-forces.md +137 -0
  39. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/12-innovation-disruption-assessment.md +112 -0
  40. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/competitor-analysis/references/13-input-formats.md +130 -0
  41. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/SKILL.md +12 -639
  42. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/10-analysis-framework.md +138 -0
  43. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/11-dividend-history-and-reliability.md +131 -0
  44. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/12-share-buyback-analysis.md +125 -0
  45. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/13-fcf-deployment-scorecard.md +133 -0
  46. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/dividend-analysis/references/14-output.md +149 -0
  47. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/SKILL.md +10 -411
  48. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/10-analysis-framework.md +194 -0
  49. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/11-data-sources.md +196 -0
  50. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-call-analysis/references/12-thesis-invalidation.md +43 -0
  51. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/SKILL.md +11 -234
  52. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/10-overview.md +86 -0
  53. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/11-phase-4-the-implied.md +60 -0
  54. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/12-output-format.md +83 -0
  55. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/earnings-preview/references/13-standard-signal-output.md +34 -0
  56. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/SKILL.md +10 -304
  57. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/10-key-economic-indicators.md +98 -0
  58. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/11-credit-market-indicators.md +114 -0
  59. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/economics-analysis/references/12-recession-probability-scoring.md +114 -0
  60. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/SKILL.md +11 -236
  61. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/10-overview.md +83 -0
  62. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/11-phase-5-overlap-with.md +69 -0
  63. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/12-output-format.md +79 -0
  64. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/etf-analysis/references/13-standard-signal-output.md +34 -0
  65. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/SKILL.md +11 -243
  66. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/10-overview.md +61 -0
  67. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/11-phase-2-source-hierarchy.md +54 -0
  68. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/12-phase-5-consistency.md +90 -0
  69. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/fact-check/references/13-notes.md +68 -0
  70. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/SKILL.md +11 -499
  71. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/10-overview.md +143 -0
  72. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/11-phase-3-financial-statement.md +167 -0
  73. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/12-phase-6-management-tone.md +176 -0
  74. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/financial-report-analyst/references/13-thesis-invalidation.md +43 -0
  75. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/SKILL.md +10 -291
  76. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/10-overview.md +117 -0
  77. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/11-step-3-position-locator.md +112 -0
  78. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/industry-map/references/12-visualization-support.md +84 -0
  79. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/SKILL.md +10 -457
  80. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/10-analysis-framework.md +185 -0
  81. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/11-pattern-recognition.md +175 -0
  82. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/insider-trading/references/12-interpretation-guidelines.md +120 -0
  83. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/SKILL.md +11 -503
  84. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/10-analysis-framework.md +132 -0
  85. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/11-ownership-concentration-analysis.md +166 -0
  86. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/12-red-flags-warning-signs.md +192 -0
  87. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/institutional-ownership/references/13-thesis-invalidation.md +43 -0
  88. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/SKILL.md +11 -264
  89. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/10-overview.md +63 -0
  90. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/11-phase-2-explanation-card.md +108 -0
  91. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/12-output-format.md +88 -0
  92. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/learning-coach/references/13-standard-signal-output.md +34 -0
  93. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/SKILL.md +11 -448
  94. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/10-analysis-framework.md +109 -0
  95. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/11-implied-volatility-iv-analysis.md +102 -0
  96. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/12-earnings-play-analysis.md +109 -0
  97. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/options-analysis/references/13-data-sources.md +159 -0
  98. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/SKILL.md +11 -435
  99. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/10-phase-1-portfolio-snapshot.md +124 -0
  100. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/11-phase-6-correlation-diversification.md +124 -0
  101. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/12-phase-9-rebalancing-decision.md +153 -0
  102. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/portfolio-review/references/13-data-verification.md +62 -0
  103. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/SKILL.md +11 -372
  104. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/10-overview.md +102 -0
  105. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/11-phase-3-the-trim.md +88 -0
  106. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/12-phase-6-the-thesis.md +105 -0
  107. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/position-ladder/references/13-input-formats.md +105 -0
  108. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/SKILL.md +10 -250
  109. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/10-overview.md +92 -0
  110. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/11-phase-4-correlation-spike.md +116 -0
  111. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/risk-stress-test/references/12-notes.md +65 -0
  112. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/SKILL.md +11 -381
  113. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/10-sector-overview.md +123 -0
  114. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/11-sector-correlation-matrix.md +90 -0
  115. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/12-peer-benchmarking-within-sector.md +92 -0
  116. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/sector-analysis/references/13-consumer-staples.md +105 -0
  117. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/SKILL.md +10 -352
  118. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/10-analysis-framework.md +110 -0
  119. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/11-bearish-thesis-evaluation.md +118 -0
  120. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/short-interest/references/12-data-sources.md +148 -0
  121. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/SKILL.md +16 -603
  122. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/10-analysis-components.md +122 -0
  123. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/11-dupont-decomposition.md +121 -0
  124. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/12-quality-scoring-framework.md +115 -0
  125. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/13-dcf-framework.md +113 -0
  126. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/14-analyst-consensus-tracking.md +127 -0
  127. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-eval/references/15-thesis-invalidation.md +43 -0
  128. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-screener/SKILL.md +5 -3
  129. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/SKILL.md +12 -595
  130. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/10-overview.md +133 -0
  131. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/11-method-2-comparable-company.md +127 -0
  132. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/12-football-field-summary-valuation.md +140 -0
  133. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/13-terminal-value-two-methods.md +121 -0
  134. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/stock-valuation/references/14-when-dcf-is.md +110 -0
  135. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/SKILL.md +12 -304
  136. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/10-overview.md +73 -0
  137. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/11-phase-3-dividends-qualified.md +67 -0
  138. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/12-framework-non-us-module.md +61 -0
  139. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/13-scoring-tax-efficiency-score.md +83 -0
  140. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/tax-lens/references/14-thesis-invalidation.md +55 -0
  141. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/SKILL.md +16 -612
  142. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/10-chart-pattern-analysis.md +172 -0
  143. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/11-chart-visualization-support.md +181 -0
  144. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/12-multi-timeframe-analysis-mtf.md +95 -0
  145. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/13-advanced-indicators-ichimoku-cloud.md +61 -0
  146. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/14-options-flow-integration.md +95 -0
  147. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/technical-analysis/references/15-thesis-invalidation.md +45 -0
  148. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/SKILL.md +10 -274
  149. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/10-overview.md +94 -0
  150. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/11-phase-5-the-pre.md +113 -0
  151. package/selected-skills/InvestSkill/plugins/us-stock-analysis/skills/thesis-tracker/references/12-example.md +90 -0
  152. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-catalyst-calendar/SKILL.md +5 -3
  153. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-idea-generation/SKILL.md +5 -3
  154. package/selected-skills/claude-for-financial-services-cn/vertical-plugins/china-finance/skills/china-sector-overview/SKILL.md +5 -3
  155. package/selected-skills/investment-skills/skills/buffett-investment-framework/SKILL.md +1 -1
  156. package/selected-skills/peter-lynch-skill/skills/peter-lynch-skill/SKILL.md +5 -3
  157. package/watchlist/package.json +1 -1
@@ -0,0 +1,123 @@
1
+ # Sector Overview
2
+
3
+ Part 1 of 4 for `sector-analysis` — Sector Overview; Analysis Framework; Sector Rotation Strategy; Top Holdings Analysis; Sector Valuation Comparison Table; Sector Seasonality Calendar
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Sector Overview
7
+
8
+ Analyze the 11 S&P 500 sectors:
9
+ 1. Information Technology
10
+ 2. Healthcare
11
+ 3. Financials
12
+ 4. Consumer Discretionary
13
+ 5. Communication Services
14
+ 6. Industrials
15
+ 7. Consumer Staples
16
+ 8. Energy
17
+ 9. Utilities
18
+ 10. Real Estate
19
+ 11. Materials
20
+
21
+ ## Analysis Framework
22
+
23
+ 1. **Sector Performance**
24
+ - Relative performance vs. S&P 500
25
+ - Historical performance trends
26
+ - Momentum and trend strength
27
+ - Volatility analysis
28
+
29
+ 2. **Economic Cycle Positioning**
30
+ - Early cycle: Financials, Technology, Industrials
31
+ - Mid cycle: Industrials, Materials, Energy
32
+ - Late cycle: Energy, Consumer Staples, Healthcare
33
+ - Recession: Utilities, Consumer Staples, Healthcare
34
+
35
+ 3. **Fundamental Metrics**
36
+ - Sector valuation (P/E, P/B vs. historical)
37
+ - Earnings growth forecasts
38
+ - Profit margin trends
39
+ - Revenue growth outlook
40
+
41
+ 4. **Macro Drivers**
42
+ - Interest rate sensitivity
43
+ - Commodity price exposure
44
+ - Economic growth correlation
45
+ - Currency impact
46
+ - Regulatory environment
47
+
48
+ 5. **Technical Picture**
49
+ - Sector ETF chart patterns
50
+ - Relative strength analysis
51
+ - Support/resistance levels
52
+ - Volume trends
53
+
54
+ ## Sector Rotation Strategy
55
+
56
+ - Identify current economic cycle phase
57
+ - Determine leading and lagging sectors
58
+ - Assess rotation timing signals
59
+ - Evaluate defensive vs. cyclical positioning
60
+ - Consider factor tilts (value, growth, quality)
61
+
62
+ ## Top Holdings Analysis
63
+
64
+ - Identify sector leaders and laggards
65
+ - Analyze top 5-10 stocks per sector
66
+ - Evaluate sector concentration risks
67
+ - Find emerging opportunities
68
+
69
+ ---
70
+
71
+ ## Sector Valuation Comparison Table
72
+
73
+ Use these ranges as historical context benchmarks. Always verify current figures against live data sources. Ranges reflect long-run averages across full market cycles; individual readings may deviate significantly in extremes.
74
+
75
+ | Sector | Typical P/E Range | Typical P/S Range | EV/EBITDA Range | Dividend Yield Range | Historical EPS Growth (10Y CAGR) |
76
+ |---|---|---|---|---|---|
77
+ | Information Technology | 22–40x | 4–10x | 15–30x | 0.5–1.5% | 12–18% |
78
+ | Healthcare | 16–28x | 1.5–4x | 12–20x | 1.5–2.5% | 8–12% |
79
+ | Financials | 10–16x | 2–4x (Price/Book 1–2x) | 8–14x | 2.0–3.5% | 7–11% |
80
+ | Consumer Discretionary | 18–35x | 0.8–2.5x | 10–20x | 0.5–1.5% | 10–15% |
81
+ | Communication Services | 15–28x | 2–5x | 10–18x | 0.5–2.0% | 6–12% |
82
+ | Industrials | 16–25x | 1–2.5x | 10–16x | 1.5–2.5% | 7–11% |
83
+ | Consumer Staples | 18–26x | 0.8–2x | 12–17x | 2.5–4.0% | 5–8% |
84
+ | Energy | 8–18x (volatile) | 0.5–1.5x | 5–12x | 3.0–5.5% | 3–8% (commodity-driven) |
85
+ | Utilities | 14–22x | 1.5–3x | 10–15x | 3.0–5.0% | 3–6% |
86
+ | Real Estate (REITs) | 30–60x (use P/FFO: 14–22x) | 5–12x | 15–25x | 3.5–6.0% | 4–8% |
87
+ | Materials | 12–22x | 0.8–2x | 8–14x | 2.0–3.5% | 5–10% |
88
+
89
+ **Notes:**
90
+ - P/E for Energy and Financials is highly cyclical — use normalized or through-cycle P/E.
91
+ - REITs are best valued on Price/FFO (Funds From Operations) or EV/EBITDA, not standard P/E.
92
+ - Dividend yield ranges shift with interest rate regimes; compare to prevailing 10Y Treasury for context.
93
+ - P/S is most useful for early-stage growth sectors (Tech, Comm Services) where margins are expanding.
94
+
95
+ ---
96
+
97
+ ## Sector Seasonality Calendar
98
+
99
+ Historical seasonal patterns based on decades of S&P 500 sector returns. These are tendencies, not guarantees — confirm with current macro backdrop and momentum before acting.
100
+
101
+ | Month | Historically Strong Sectors | Historically Weak Sectors | Key Seasonal Driver |
102
+ |---|---|---|---|
103
+ | January | Financials, Small Caps, Industrials | Utilities, Consumer Staples | "January Effect," new year portfolio repositioning |
104
+ | February | Healthcare, Technology | Energy, Materials | Earnings season (Q4 reports), defensive rotation |
105
+ | March | Energy, Industrials, Materials | Real Estate, Utilities | Spring economic activity pickup, rate expectations reset |
106
+ | April | Consumer Discretionary, Technology | Energy | Strong earnings season (Q1), consumer spending uplift |
107
+ | May | Consumer Staples, Healthcare, Utilities | Industrials, Materials | "Sell in May" defensive rotation begins |
108
+ | June | Energy (early summer driving demand) | Consumer Discretionary, Financials | Fed meeting seasonality, summer slowdown |
109
+ | July | Technology, Consumer Discretionary | Energy | Q2 earnings beats, summer consumer activity |
110
+ | August | Consumer Staples, Utilities | Technology, Industrials | Thin liquidity, risk-off tendency, vacation season |
111
+ | September | Energy | Technology, Consumer Discretionary | Historically worst month for equities overall |
112
+ | October | Financials, Industrials, Technology | Real Estate | Q3 earnings season begins, year-end setup |
113
+ | November | Consumer Discretionary, Technology, Industrials | Utilities, Energy | Pre-holiday retail strength, "Santa rally" setup |
114
+ | December | Consumer Discretionary, Consumer Staples | Financials | Holiday spending, tax-loss harvesting, year-end flows |
115
+
116
+ **Cycle-Overlay Seasonality:**
117
+ - Recession entry: Utilities, Consumer Staples, Healthcare outperform regardless of month.
118
+ - Early recovery: Financials, Technology, and Consumer Discretionary lead — often most pronounced in Q1/Q2 post-trough.
119
+ - Commodity supercycles: Energy and Materials seasonal patterns amplify vs. normal years.
120
+
121
+ ---
122
+
123
+
@@ -0,0 +1,90 @@
1
+ # Sector Correlation Matrix
2
+
3
+ Part 2 of 4 for `sector-analysis` — Sector Correlation Matrix; Sector Momentum Scoring
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Sector Correlation Matrix
7
+
8
+ Use this matrix to understand diversification benefits and macro sensitivity when constructing multi-sector portfolios. Correlations are approximate long-run averages; they compress toward 1.0 during market stress.
9
+
10
+ ### Inter-Sector Correlation (approximate, long-run)
11
+
12
+ | | Tech | Health | Fin | Disc | Comm | Ind | Staples | Energy | Util | RE | Mats |
13
+ |---|---|---|---|---|---|---|---|---|---|---|---|
14
+ | **Tech** | — | Low+ | Low+ | Med+ | Med+ | Low+ | Low- | Low- | Low- | Low- | Low- |
15
+ | **Healthcare** | Low+ | — | Low- | Low- | Low+ | Low- | Med+ | Low- | Med+ | Low- | Low- |
16
+ | **Financials** | Low+ | Low- | — | Med+ | Low+ | Med+ | Low- | Low+ | Low- | Med+ | Low+ |
17
+ | **Disc** | Med+ | Low- | Med+ | — | Med+ | Med+ | Low- | Low- | Low- | Low- | Low+ |
18
+ | **Comm Svcs** | Med+ | Low+ | Low+ | Med+ | — | Low+ | Low+ | Low- | Low+ | Low- | Low- |
19
+ | **Industrials** | Low+ | Low- | Med+ | Med+ | Low+ | — | Low- | Med+ | Low- | Low- | Med+ |
20
+ | **Staples** | Low- | Med+ | Low- | Low- | Low+ | Low- | — | Low- | Med+ | Low+ | Low- |
21
+ | **Energy** | Low- | Low- | Low+ | Low- | Low- | Med+ | Low- | — | Low- | Low- | Med+ |
22
+ | **Utilities** | Low- | Med+ | Low- | Low- | Low+ | Low- | Med+ | Low- | — | Med+ | Low- |
23
+ | **Real Estate** | Low- | Low- | Med+ | Low- | Low- | Low- | Low+ | Low- | Med+ | — | Low- |
24
+ | **Materials** | Low- | Low- | Low+ | Low+ | Low- | Med+ | Low- | Med+ | Low- | Low- | — |
25
+
26
+ **Key:** Med+ = moderate positive correlation (0.4–0.7) | Low+ = low positive (0.1–0.4) | Low- = low negative or near-zero (-0.2–0.1)
27
+
28
+ ### Sector Sensitivity to Key Macro Variables
29
+
30
+ | Macro Variable | Strong Positive | Moderate Positive | Neutral | Moderate Negative | Strong Negative |
31
+ |---|---|---|---|---|---|
32
+ | Rising interest rates | Financials | Energy, Materials | Industrials, Tech | Consumer Disc, Comm Svcs | Utilities, Real Estate |
33
+ | Falling interest rates | Utilities, Real Estate | Tech, Healthcare | Staples | Financials | — |
34
+ | Rising oil/energy prices | Energy | Materials, Industrials | Healthcare | Consumer Disc, Staples | Airlines (Disc) |
35
+ | Falling oil prices | Consumer Disc, Airlines | Staples, Tech | Financials | Energy | Materials |
36
+ | USD strengthening | Domestic Staples, Utilities | Financials | Healthcare | Tech (exports), Industrials | Materials, Energy |
37
+ | USD weakening | Tech (multinationals), Materials | Energy, Industrials | Healthcare | Domestic Utilities | — |
38
+ | GDP acceleration | Industrials, Materials, Energy | Tech, Financials, Disc | Comm Svcs | — | Utilities, Staples |
39
+ | Recession / GDP contraction | Utilities, Staples, Healthcare | — | Comm Svcs | Financials, Industrials | Energy, Materials, Disc |
40
+ | Inflation rising | Energy, Materials | Real Estate | Industrials | Tech (multiple compression) | Utilities, Staples |
41
+ | Inflation falling | Utilities, Real Estate, Tech | Healthcare, Disc | Financials | Energy | Materials |
42
+ | Credit spread widening | Utilities, Staples, Healthcare | — | Tech | Financials, Real Estate | Disc, Industrials |
43
+
44
+ ---
45
+
46
+ ## Sector Momentum Scoring
47
+
48
+ Rank all 11 sectors on a 1–11 scale (1 = strongest, 11 = weakest) across four dimensions, then produce a composite rank. Update this scoring monthly or after significant macro events.
49
+
50
+ ### Scoring Dimensions
51
+
52
+ | Dimension | How to Score | Data Source |
53
+ |---|---|---|
54
+ | **3M Price Return** | Rank sectors by 3-month total return vs. each other | Bloomberg, ETF returns (XLK, XLV, etc.) |
55
+ | **Earnings Revision Trend** | % of analysts raising forward EPS estimates (breadth) | FactSet, Bloomberg consensus |
56
+ | **Forward P/E vs. 10Y Historical Average** | Discount = high score; premium = low score | FactSet, LSEG |
57
+ | **Analyst Sentiment** | Net buy ratings minus sell ratings as % of total | Bloomberg, Refinitiv |
58
+
59
+ ### Momentum Scorecard Template
60
+
61
+ ```
62
+ Sector 3M Return EPS Revisions Fwd P/E vs Hist Analyst Sent. Composite Rank
63
+ Information Technology [1-11] [1-11] [1-11] [1-11] [avg rank]
64
+ Healthcare [1-11] [1-11] [1-11] [1-11] [avg rank]
65
+ Financials [1-11] [1-11] [1-11] [1-11] [avg rank]
66
+ Consumer Discretionary [1-11] [1-11] [1-11] [1-11] [avg rank]
67
+ Communication Services [1-11] [1-11] [1-11] [1-11] [avg rank]
68
+ Industrials [1-11] [1-11] [1-11] [1-11] [avg rank]
69
+ Consumer Staples [1-11] [1-11] [1-11] [1-11] [avg rank]
70
+ Energy [1-11] [1-11] [1-11] [1-11] [avg rank]
71
+ Utilities [1-11] [1-11] [1-11] [1-11] [avg rank]
72
+ Real Estate [1-11] [1-11] [1-11] [1-11] [avg rank]
73
+ Materials [1-11] [1-11] [1-11] [1-11] [avg rank]
74
+ ```
75
+
76
+ ### Composite Rank Interpretation
77
+
78
+ | Composite Rank | Action |
79
+ |---|---|
80
+ | 1–3 | Strong overweight — broad-based positive momentum |
81
+ | 4–5 | Moderate overweight — mostly positive signals |
82
+ | 6–7 | Neutral weight — mixed signals |
83
+ | 8–9 | Underweight — mostly negative signals |
84
+ | 10–11 | Avoid / underweight significantly — broad deterioration |
85
+
86
+ **Weighting Suggestion:** Equal-weight all four dimensions as a starting point. Tilt to 40% price return + 30% EPS revisions + 20% valuation + 10% sentiment for a momentum-focused strategy.
87
+
88
+ ---
89
+
90
+
@@ -0,0 +1,92 @@
1
+ # Peer Benchmarking Within Sector
2
+
3
+ Part 3 of 4 for `sector-analysis` — Peer Benchmarking Within Sector; Sector-Specific Risk Factors
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ## Peer Benchmarking Within Sector
7
+
8
+ When analyzing a specific stock, compare it against its sector median to identify relative attractiveness. Use this template for every individual stock recommendation within a sector rotation context.
9
+
10
+ ### Single Stock vs. Sector Median Template
11
+
12
+ ```
13
+ Stock: [TICKER] — [Company Name]
14
+ Sector: [GICS Sector]
15
+ Comparison Date: [Date] | Source: [FactSet / Bloomberg / Company Filings]
16
+
17
+ DIMENSION STOCK VALUE SECTOR MEDIAN PREMIUM / DISCOUNT SCORE (1-5)
18
+ ─────────────────────────────────────────────────────────────────────────────────────────
19
+ VALUATION
20
+ Forward P/E [x.x]x [x.x]x [+/- x%] [1-5]
21
+ EV/EBITDA [x.x]x [x.x]x [+/- x%] [1-5]
22
+ Price/Sales [x.x]x [x.x]x [+/- x%] [1-5]
23
+ Price/Book [x.x]x [x.x]x [+/- x%] [1-5]
24
+ Dividend Yield [x.x]% [x.x]% [+/- x bps] [1-5]
25
+
26
+ GROWTH
27
+ Revenue Growth (TTM) [x.x]% [x.x]% [+/- x%] [1-5]
28
+ EPS Growth (FY est.) [x.x]% [x.x]% [+/- x%] [1-5]
29
+ Revenue Growth (3Y) [x.x]% [x.x]% [+/- x%] [1-5]
30
+
31
+ MARGINS & QUALITY
32
+ Gross Margin [x.x]% [x.x]% [+/- x bps] [1-5]
33
+ EBITDA Margin [x.x]% [x.x]% [+/- x bps] [1-5]
34
+ Net Margin [x.x]% [x.x]% [+/- x bps] [1-5]
35
+ ROIC [x.x]% [x.x]% [+/- x bps] [1-5]
36
+ ROE [x.x]% [x.x]% [+/- x bps] [1-5]
37
+ Debt/EBITDA [x.x]x [x.x]x [+/- x%] [1-5]
38
+ FCF Yield [x.x]% [x.x]% [+/- x bps] [1-5]
39
+ ─────────────────────────────────────────────────────────────────────────────────────────
40
+ COMPOSITE QUALITY SCORE [avg/5]
41
+ ```
42
+
43
+ ### Quality Score Interpretation
44
+
45
+ | Score | Interpretation |
46
+ |---|---|
47
+ | 4.5–5.0 | Sector leader — significant premium justified |
48
+ | 3.5–4.4 | Above-sector-average quality — moderate premium justified |
49
+ | 2.5–3.4 | In-line with sector — valuation should be at-market |
50
+ | 1.5–2.4 | Below-sector quality — discount warranted |
51
+ | 1.0–1.4 | Sector laggard — avoid unless deep value thesis exists |
52
+
53
+ **Scoring Convention:** For valuation metrics, cheaper = higher score (a stock trading at a discount to peers on P/E scores 5, a premium scores 1). For growth, margins, and quality metrics, higher is better.
54
+
55
+ ---
56
+
57
+ ## Sector-Specific Risk Factors
58
+
59
+ Each sector carries idiosyncratic risks beyond broad market beta. Always assess these in the context of the current macro and regulatory environment before establishing a position.
60
+
61
+ ### Information Technology
62
+ - **Regulatory / Antitrust Risk:** Large-cap platforms (search, social, cloud) face ongoing EU Digital Markets Act enforcement, DOJ antitrust cases, and potential structural remedies. Headline risk can compress multiples even without earnings impact.
63
+ - **AI Disruption / Obsolescence Risk:** Generative AI rapidly changes competitive positioning — incumbents may be disrupted faster than traditional product cycles. Evaluate whether a company is a beneficiary or a target.
64
+ - **Semiconductor Supply Chain & Export Controls:** TSMC concentration, US-China export restrictions on advanced chips (EAR controls), and geopolitical risk in Taiwan can cause severe supply shocks.
65
+
66
+ ### Healthcare
67
+ - **FDA Approval Risk / Clinical Trial Binary Events:** Drug pipeline stocks carry binary event risk at Phase 2/3 readouts and FDA PDUFA dates; a single rejection can cause 40–70% drawdowns.
68
+ - **Patent Cliff Risk:** Major pharmaceuticals face loss of exclusivity (LOE) on blockbuster drugs — revenue can fall 80%+ within 2 years of generic entry; assess pipeline coverage vs. patent expiry schedule.
69
+ - **Drug Pricing / CMS Negotiation:** IRA Medicare drug price negotiation and political pressure on list prices compress revenue visibility for large pharma and biotech.
70
+
71
+ ### Financials
72
+ - **Interest Rate Sensitivity (NIM Compression):** Banks' net interest margins expand with rate hikes but compress when rates fall or the yield curve inverts; this is the single largest driver of bank earnings variability.
73
+ - **Credit Cycle Risk:** Loan loss provisions surge in recessions; commercial real estate (CRE) exposure is a persistent concern for regional banks. Monitor non-performing loan (NPL) ratios closely.
74
+ - **Regulatory Capital Requirements (Basel III/IV):** Evolving capital adequacy rules (CET1 requirements, stress test results) constrain buyback capacity and ROE generation for large banks.
75
+
76
+ ### Consumer Discretionary
77
+ - **Consumer Balance Sheet Health:** This sector is most exposed to rising consumer debt, declining savings rates, and credit tightening — especially for big-ticket items (autos, appliances, travel).
78
+ - **Tariff and Import Cost Risk:** Heavy reliance on offshore manufacturing (apparel, electronics, footwear) means tariff escalation directly compresses margins before pricing power can respond.
79
+ - **Secular Shift in Spending (Physical vs. Digital):** Traditional retail faces ongoing structural displacement from e-commerce; under-differentiated brick-and-mortar operators face secular decline.
80
+
81
+ ### Communication Services
82
+ - **Streaming Profitability Inflection Risk:** Media/streaming companies face pressure to convert subscriber growth to sustained free cash flow; content cost inflation and competition from tech giants compress margins.
83
+ - **Advertising Cyclicality:** Digital ad revenue is highly correlated with GDP growth and corporate spending budgets — falls sharply in recessions (Google, Meta ad revenue dropped 15–25% in prior downturns).
84
+ - **Spectrum Allocation and Infrastructure Costs:** Telecom operators face large, lumpy capex cycles tied to 5G and fiber buildouts, with uncertain return timelines and regulatory pricing constraints.
85
+
86
+ ### Industrials
87
+ - **Government Defense/Infrastructure Budget Dependency:** Defense contractors and infrastructure-linked industrials are highly sensitive to Congressional appropriations, sequestration risk, and multi-year contract cancellations.
88
+ - **Supply Chain Disruption and Input Cost Inflation:** Aerospace and industrial machinery have long production cycles — shortages in specialty materials (titanium, rare earth components) or labor can cause years-long delivery delays.
89
+ - **Labor Cost Pressure and Union Risk:** Heavily unionized manufacturing sectors (aerospace, auto, rail) face periodic strike risk and multi-year wage escalation that can compress margins durably.
90
+
91
+
92
+ This section is not finished here: `Sector-Specific Risk Factors` continues in `references/13-consumer-staples.md`.
@@ -0,0 +1,105 @@
1
+ # Sector-Specific Risk Factors(continued)
2
+
3
+ Part 4 of 4 for `sector-analysis` — Sector-Specific Risk Factors; Sector ETF Reference; Output; Standard Signal Output; Thesis Invalidation
4
+ See `SKILL.md` for what to read and when; this part is procedure, not routing.
5
+
6
+ ### Consumer Staples
7
+ - **Private Label / Retailer Margin Squeeze:** In cost-of-living crisis periods, consumers trade down to retailer own-brand products, reducing branded CPG companies' pricing power and volume.
8
+ - **Input Cost Volatility (Commodities, Packaging):** Agricultural commodity inputs (wheat, corn, sugar, palm oil) and energy-intensive packaging are subject to price spikes that compress gross margins with a lag.
9
+ - **Emerging Market Currency and Political Risk:** Many staples companies derive 30–50% of revenue from EM; local currency depreciation and political instability can materially impact reported earnings.
10
+
11
+ ### Energy
12
+ - **Commodity Price Cycle Risk:** Oil and gas earnings are almost entirely driven by the WTI/Brent/Henry Hub price — a 20% oil price decline can eliminate 40–60% of sector earnings in a single quarter.
13
+ - **Energy Transition / Stranded Asset Risk:** Long-duration upstream assets (offshore fields, oil sands) carry the risk of becoming stranded as renewable penetration accelerates and carbon pricing expands.
14
+ - **Geopolitical Supply Disruption:** OPEC+ production decisions, Middle East conflict, Russian supply constraints, and US shale production responses create persistent supply uncertainty that makes earnings forecasting highly uncertain.
15
+
16
+ ### Utilities
17
+ - **Interest Rate / Bond Proxy Risk:** Utilities are priced as bond proxies — rising 10Y Treasury yields directly compress valuations as yield-seeking capital rotates to risk-free alternatives; every 100bps rate rise compresses sector P/E by 1–2 turns historically.
18
+ - **Regulatory Rate Case Risk:** Utility earnings are set by state/federal regulators through rate cases; adverse rulings can cap ROE and delay capital recovery for large infrastructure investments.
19
+ - **Renewable Build-Out Execution Risk:** Ambitious clean energy transition capex (solar, wind, grid modernization) carries construction delay risk, cost overruns, and financing risk in a volatile rate environment.
20
+
21
+ ### Real Estate (REITs)
22
+ - **Interest Rate Sensitivity and Refinancing Risk:** REITs use significant leverage; rising rates increase interest expense and cap rate expansion reduces property valuations. Floating-rate debt exposure is a critical variable.
23
+ - **Property-Type Secular Trends:** Office REITs face structural demand destruction from hybrid work; retail REITs face e-commerce headwinds. Not all REIT sub-sectors face the same structural forces.
24
+ - **Credit Market Access:** REITs must access capital markets regularly to fund growth; credit spread widening and bank lending tightness during stress periods can trap overleveraged operators.
25
+
26
+ ### Materials
27
+ - **Commodity Price Volatility:** Earnings are almost entirely driven by copper, aluminum, gold, steel, or chemical feedstock prices — these are globally set and subject to large cyclical swings.
28
+ - **China Demand Dependency:** China accounts for 50–60% of global demand for base metals; property sector weakness, infrastructure slowdown, or trade tensions in China have outsized effects on global Materials earnings.
29
+ - **Environmental Regulation and Mine Permitting:** Mining and chemical companies face increasingly stringent environmental standards, permitting delays (often 5–10 years for new mines), and carbon pricing that raises operating costs durably.
30
+
31
+ ---
32
+
33
+ ## Sector ETF Reference
34
+
35
+ | Sector | SPDR ETF | Alternative |
36
+ |---|---|---|
37
+ | Information Technology | XLK | VGT, QQQ |
38
+ | Healthcare | XLV | VHT |
39
+ | Financials | XLF | VFH |
40
+ | Consumer Discretionary | XLY | VCR |
41
+ | Communication Services | XLC | VOX |
42
+ | Industrials | XLI | VIS |
43
+ | Consumer Staples | XLP | VDC |
44
+ | Energy | XLE | VDE |
45
+ | Utilities | XLU | VPU |
46
+ | Real Estate | XLRE | VNQ |
47
+ | Materials | XLB | VAW |
48
+
49
+ ## Output
50
+
51
+ Provide sector analysis with:
52
+ - Current sector rankings and momentum
53
+ - Economic cycle assessment
54
+ - Sector rotation recommendations
55
+ - Top stock picks within favored sectors
56
+ - Sectors to underweight/avoid
57
+ - Risk considerations by sector
58
+ - Expected catalysts and timeframes
59
+ - Implementation strategy (ETFs vs. individual stocks)
60
+
61
+ Keep recommendations aligned with macro outlook and risk management principles.
62
+
63
+ ## Standard Signal Output
64
+
65
+ All analysis concludes with this standardized block:
66
+
67
+ ```
68
+ ## Thesis Invalidation
69
+
70
+ After delivering the analysis signal, specify what would reverse it:
71
+
72
+ **If signal is BULLISH — thesis breaks if:**
73
+ - sector underperforms S&P 500 by >10% over 3 months AND rate regime turns unfavorable
74
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
75
+
76
+ **If signal is BEARISH — thesis breaks if:**
77
+ - sector rotates into leadership AND sector P/E discount to S&P closes
78
+ - [One or two more triggers drawn from this analysis's own drivers, each with a threshold]
79
+
80
+ **Re-run this analysis when:**
81
+ - [ ] Next earnings release
82
+ - [ ] Price moves ±15% from current level
83
+ - [ ] 60 days have elapsed
84
+ - [ ] Material news event (acquisition, leadership change, regulatory decision)
85
+
86
+ ╔══════════════════════════════════════════════╗
87
+ ║ INVESTMENT SIGNAL ║
88
+ ╠══════════════════════════════════════════════╣
89
+ ║ Signal: BULLISH / NEUTRAL / BEARISH ║
90
+ ║ Confidence: HIGH / MEDIUM / LOW ║
91
+ ║ Horizon: SHORT / MEDIUM / LONG-TERM ║
92
+ ║ Score: X.X / 10 ║
93
+ ╠══════════════════════════════════════════════╣
94
+ ║ Action: BUY / HOLD / SELL ║
95
+ ║ Conviction: STRONG / MODERATE / WEAK ║
96
+ ╚══════════════════════════════════════════════╝
97
+ ```
98
+
99
+ **Score Guide**: 8.0–10.0 Strongly Bullish | 6.0–7.9 Moderately Bullish | 4.0–5.9 Neutral | 2.0–3.9 Moderately Bearish | 0.0–1.9 Strongly Bearish
100
+ **Confidence**: HIGH (strong data, clear signals) | MEDIUM (mixed signals) | LOW (limited data, conflicting signals)
101
+ **Horizon**: SHORT-TERM (1 week–3 months) | MEDIUM-TERM (3 months–1 year) | LONG-TERM (1+ years)
102
+
103
+ **Disclaimer:** Educational analysis only. Not financial advice.
104
+
105
+