quantwise 1.2.0 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/.claude/skills/README.md +80 -0
  2. package/.claude/skills/backtest-expert/SKILL.md +206 -0
  3. package/.claude/skills/backtest-expert/references/failed_tests.md +236 -0
  4. package/.claude/skills/backtest-expert/references/methodology.md +227 -0
  5. package/.claude/skills/breadth-chart-analyst/SKILL.md +583 -0
  6. package/.claude/skills/breadth-chart-analyst/assets/SP500_Breadth_Index_200MA_8MA.jpeg +0 -0
  7. package/.claude/skills/breadth-chart-analyst/assets/US_Stock_Market_Uptrend_Ratio.jpeg +0 -0
  8. package/.claude/skills/breadth-chart-analyst/assets/breadth_analysis_template.md +558 -0
  9. package/.claude/skills/breadth-chart-analyst/references/breadth_chart_methodology.md +590 -0
  10. package/.claude/skills/canslim-screener/SKILL.md +599 -0
  11. package/.claude/skills/canslim-screener/references/canslim_methodology.md +606 -0
  12. package/.claude/skills/canslim-screener/references/fmp_api_endpoints.md +707 -0
  13. package/.claude/skills/canslim-screener/references/interpretation_guide.md +516 -0
  14. package/.claude/skills/canslim-screener/references/scoring_system.md +597 -0
  15. package/.claude/skills/canslim-screener/scripts/calculators/earnings_calculator.py +343 -0
  16. package/.claude/skills/canslim-screener/scripts/calculators/growth_calculator.py +334 -0
  17. package/.claude/skills/canslim-screener/scripts/calculators/institutional_calculator.py +347 -0
  18. package/.claude/skills/canslim-screener/scripts/calculators/leadership_calculator.py +380 -0
  19. package/.claude/skills/canslim-screener/scripts/calculators/market_calculator.py +244 -0
  20. package/.claude/skills/canslim-screener/scripts/calculators/new_highs_calculator.py +194 -0
  21. package/.claude/skills/canslim-screener/scripts/calculators/supply_demand_calculator.py +221 -0
  22. package/.claude/skills/canslim-screener/scripts/finviz_stock_client.py +227 -0
  23. package/.claude/skills/canslim-screener/scripts/fmp_client.py +393 -0
  24. package/.claude/skills/canslim-screener/scripts/report_generator.py +405 -0
  25. package/.claude/skills/canslim-screener/scripts/scorer.py +625 -0
  26. package/.claude/skills/canslim-screener/scripts/screen_canslim.py +361 -0
  27. package/.claude/skills/canslim-screener/scripts/test_institutional_endpoint.py +109 -0
  28. package/.claude/skills/chart/SKILL.md +20 -0
  29. package/.claude/skills/dividend-growth-pullback-screener/SKILL.md +322 -0
  30. package/.claude/skills/dividend-growth-pullback-screener/references/dividend_growth_compounding.md +400 -0
  31. package/.claude/skills/dividend-growth-pullback-screener/references/fmp_api_guide.md +642 -0
  32. package/.claude/skills/dividend-growth-pullback-screener/references/rsi_oversold_strategy.md +333 -0
  33. package/.claude/skills/dividend-growth-pullback-screener/scripts/screen_dividend_growth_rsi.py +1155 -0
  34. package/.claude/skills/earnings-calendar/SKILL.md +721 -0
  35. package/.claude/skills/earnings-calendar/assets/earnings_report_template.md +102 -0
  36. package/.claude/skills/earnings-calendar/references/fmp_api_guide.md +590 -0
  37. package/.claude/skills/earnings-calendar/scripts/fetch_earnings_fmp.py +443 -0
  38. package/.claude/skills/earnings-calendar/scripts/generate_report.py +366 -0
  39. package/.claude/skills/economic-calendar-fetcher/SKILL.md +365 -0
  40. package/.claude/skills/economic-calendar-fetcher/references/fmp_api_documentation.md +345 -0
  41. package/.claude/skills/economic-calendar-fetcher/scripts/get_economic_calendar.py +267 -0
  42. package/.claude/skills/ftd-detector/SKILL.md +147 -0
  43. package/.claude/skills/ftd-detector/references/ftd_methodology.md +188 -0
  44. package/.claude/skills/ftd-detector/references/post_ftd_guide.md +185 -0
  45. package/.claude/skills/ftd-detector/scripts/fmp_client.py +158 -0
  46. package/.claude/skills/ftd-detector/scripts/ftd_detector.py +280 -0
  47. package/.claude/skills/ftd-detector/scripts/post_ftd_monitor.py +404 -0
  48. package/.claude/skills/ftd-detector/scripts/rally_tracker.py +508 -0
  49. package/.claude/skills/ftd-detector/scripts/report_generator.py +341 -0
  50. package/.claude/skills/ftd-detector/scripts/tests/conftest.py +9 -0
  51. package/.claude/skills/ftd-detector/scripts/tests/helpers.py +107 -0
  52. package/.claude/skills/ftd-detector/scripts/tests/test_post_ftd_monitor.py +311 -0
  53. package/.claude/skills/ftd-detector/scripts/tests/test_rally_tracker.py +302 -0
  54. package/.claude/skills/institutional-flow-tracker/README.md +362 -0
  55. package/.claude/skills/institutional-flow-tracker/SKILL.md +357 -0
  56. package/.claude/skills/institutional-flow-tracker/references/13f_filings_guide.md +383 -0
  57. package/.claude/skills/institutional-flow-tracker/references/institutional_investor_types.md +580 -0
  58. package/.claude/skills/institutional-flow-tracker/references/interpretation_framework.md +573 -0
  59. package/.claude/skills/institutional-flow-tracker/scripts/analyze_single_stock.py +457 -0
  60. package/.claude/skills/institutional-flow-tracker/scripts/track_institution_portfolio.py +108 -0
  61. package/.claude/skills/institutional-flow-tracker/scripts/track_institutional_flow.py +450 -0
  62. package/.claude/skills/macro-regime-detector/SKILL.md +86 -0
  63. package/.claude/skills/macro-regime-detector/references/historical_regimes.md +124 -0
  64. package/.claude/skills/macro-regime-detector/references/indicator_interpretation_guide.md +144 -0
  65. package/.claude/skills/macro-regime-detector/references/regime_detection_methodology.md +138 -0
  66. package/.claude/skills/macro-regime-detector/scripts/calculators/__init__.py +1 -0
  67. package/.claude/skills/macro-regime-detector/scripts/calculators/concentration_calculator.py +165 -0
  68. package/.claude/skills/macro-regime-detector/scripts/calculators/credit_conditions_calculator.py +124 -0
  69. package/.claude/skills/macro-regime-detector/scripts/calculators/equity_bond_calculator.py +198 -0
  70. package/.claude/skills/macro-regime-detector/scripts/calculators/sector_rotation_calculator.py +123 -0
  71. package/.claude/skills/macro-regime-detector/scripts/calculators/size_factor_calculator.py +131 -0
  72. package/.claude/skills/macro-regime-detector/scripts/calculators/utils.py +347 -0
  73. package/.claude/skills/macro-regime-detector/scripts/calculators/yield_curve_calculator.py +279 -0
  74. package/.claude/skills/macro-regime-detector/scripts/fmp_client.py +134 -0
  75. package/.claude/skills/macro-regime-detector/scripts/macro_regime_detector.py +278 -0
  76. package/.claude/skills/macro-regime-detector/scripts/report_generator.py +327 -0
  77. package/.claude/skills/macro-regime-detector/scripts/scorer.py +574 -0
  78. package/.claude/skills/macro-regime-detector/scripts/tests/conftest.py +9 -0
  79. package/.claude/skills/macro-regime-detector/scripts/tests/test_concentration.py +78 -0
  80. package/.claude/skills/macro-regime-detector/scripts/tests/test_credit_conditions.py +59 -0
  81. package/.claude/skills/macro-regime-detector/scripts/tests/test_equity_bond.py +74 -0
  82. package/.claude/skills/macro-regime-detector/scripts/tests/test_helpers.py +90 -0
  83. package/.claude/skills/macro-regime-detector/scripts/tests/test_scorer.py +439 -0
  84. package/.claude/skills/macro-regime-detector/scripts/tests/test_sector_rotation.py +78 -0
  85. package/.claude/skills/macro-regime-detector/scripts/tests/test_size_factor.py +59 -0
  86. package/.claude/skills/macro-regime-detector/scripts/tests/test_utils.py +126 -0
  87. package/.claude/skills/macro-regime-detector/scripts/tests/test_yield_curve.py +64 -0
  88. package/.claude/skills/market-breadth-analyzer/SKILL.md +121 -0
  89. package/.claude/skills/market-breadth-analyzer/references/breadth_analysis_methodology.md +168 -0
  90. package/.claude/skills/market-breadth-analyzer/scripts/calculators/__init__.py +1 -0
  91. package/.claude/skills/market-breadth-analyzer/scripts/calculators/bearish_signal_calculator.py +150 -0
  92. package/.claude/skills/market-breadth-analyzer/scripts/calculators/cycle_calculator.py +168 -0
  93. package/.claude/skills/market-breadth-analyzer/scripts/calculators/divergence_calculator.py +119 -0
  94. package/.claude/skills/market-breadth-analyzer/scripts/calculators/historical_context_calculator.py +120 -0
  95. package/.claude/skills/market-breadth-analyzer/scripts/calculators/ma_crossover_calculator.py +115 -0
  96. package/.claude/skills/market-breadth-analyzer/scripts/calculators/trend_level_calculator.py +103 -0
  97. package/.claude/skills/market-breadth-analyzer/scripts/csv_client.py +225 -0
  98. package/.claude/skills/market-breadth-analyzer/scripts/market_breadth_analyzer.py +307 -0
  99. package/.claude/skills/market-breadth-analyzer/scripts/report_generator.py +330 -0
  100. package/.claude/skills/market-breadth-analyzer/scripts/scorer.py +271 -0
  101. package/.claude/skills/market-environment-analysis/SKILL.md +139 -0
  102. package/.claude/skills/market-environment-analysis/references/analysis_patterns.md +124 -0
  103. package/.claude/skills/market-environment-analysis/references/indicators.md +99 -0
  104. package/.claude/skills/market-environment-analysis/scripts/market_utils.py +127 -0
  105. package/.claude/skills/market-news-analyst/SKILL.md +714 -0
  106. package/.claude/skills/market-news-analyst/references/corporate_news_impact.md +446 -0
  107. package/.claude/skills/market-news-analyst/references/geopolitical_commodity_correlations.md +499 -0
  108. package/.claude/skills/market-news-analyst/references/market_event_patterns.md +393 -0
  109. package/.claude/skills/market-news-analyst/references/trusted_news_sources.md +510 -0
  110. package/.claude/skills/market-top-detector/SKILL.md +159 -0
  111. package/.claude/skills/market-top-detector/references/distribution_day_guide.md +100 -0
  112. package/.claude/skills/market-top-detector/references/historical_tops.md +142 -0
  113. package/.claude/skills/market-top-detector/references/market_top_methodology.md +167 -0
  114. package/.claude/skills/market-top-detector/scripts/calculators/__init__.py +17 -0
  115. package/.claude/skills/market-top-detector/scripts/calculators/breadth_calculator.py +116 -0
  116. package/.claude/skills/market-top-detector/scripts/calculators/defensive_rotation_calculator.py +127 -0
  117. package/.claude/skills/market-top-detector/scripts/calculators/distribution_day_calculator.py +161 -0
  118. package/.claude/skills/market-top-detector/scripts/calculators/index_technical_calculator.py +254 -0
  119. package/.claude/skills/market-top-detector/scripts/calculators/leading_stock_calculator.py +198 -0
  120. package/.claude/skills/market-top-detector/scripts/calculators/sentiment_calculator.py +213 -0
  121. package/.claude/skills/market-top-detector/scripts/fmp_client.py +158 -0
  122. package/.claude/skills/market-top-detector/scripts/market_top_detector.py +349 -0
  123. package/.claude/skills/market-top-detector/scripts/report_generator.py +314 -0
  124. package/.claude/skills/market-top-detector/scripts/scorer.py +473 -0
  125. package/.claude/skills/market-top-detector/scripts/tests/conftest.py +9 -0
  126. package/.claude/skills/market-top-detector/scripts/tests/helpers.py +49 -0
  127. package/.claude/skills/market-top-detector/scripts/tests/test_breadth.py +62 -0
  128. package/.claude/skills/market-top-detector/scripts/tests/test_defensive_rotation.py +56 -0
  129. package/.claude/skills/market-top-detector/scripts/tests/test_distribution_day.py +92 -0
  130. package/.claude/skills/market-top-detector/scripts/tests/test_index_technical.py +73 -0
  131. package/.claude/skills/market-top-detector/scripts/tests/test_leading_stock.py +57 -0
  132. package/.claude/skills/market-top-detector/scripts/tests/test_scorer.py +180 -0
  133. package/.claude/skills/market-top-detector/scripts/tests/test_sentiment.py +64 -0
  134. package/.claude/skills/options-strategy-advisor/README.md +469 -0
  135. package/.claude/skills/options-strategy-advisor/SKILL.md +959 -0
  136. package/.claude/skills/options-strategy-advisor/scripts/black_scholes.py +495 -0
  137. package/.claude/skills/pair-trade-screener/README.md +389 -0
  138. package/.claude/skills/pair-trade-screener/SKILL.md +622 -0
  139. package/.claude/skills/pair-trade-screener/references/cointegration_guide.md +745 -0
  140. package/.claude/skills/pair-trade-screener/references/methodology.md +853 -0
  141. package/.claude/skills/pair-trade-screener/scripts/analyze_spread.py +394 -0
  142. package/.claude/skills/pair-trade-screener/scripts/find_pairs.py +535 -0
  143. package/.claude/skills/portfolio-manager/README.md +394 -0
  144. package/.claude/skills/portfolio-manager/SKILL.md +750 -0
  145. package/.claude/skills/portfolio-manager/references/alpaca-mcp-setup.md +367 -0
  146. package/.claude/skills/portfolio-manager/references/asset-allocation.md +502 -0
  147. package/.claude/skills/portfolio-manager/references/diversification-principles.md +553 -0
  148. package/.claude/skills/portfolio-manager/references/portfolio-risk-metrics.md +603 -0
  149. package/.claude/skills/portfolio-manager/references/position-evaluation.md +477 -0
  150. package/.claude/skills/portfolio-manager/references/rebalancing-strategies.md +715 -0
  151. package/.claude/skills/portfolio-manager/references/risk-profile-questionnaire.md +608 -0
  152. package/.claude/skills/portfolio-manager/references/target-allocations.md +558 -0
  153. package/.claude/skills/portfolio-manager/scripts/test_alpaca_connection.py +286 -0
  154. package/.claude/skills/scenario-analyzer/SKILL.md +317 -0
  155. package/.claude/skills/scenario-analyzer/references/headline_event_patterns.md +264 -0
  156. package/.claude/skills/scenario-analyzer/references/scenario_playbooks.md +320 -0
  157. package/.claude/skills/scenario-analyzer/references/sector_sensitivity_matrix.md +217 -0
  158. package/.claude/skills/sector-analyst/SKILL.md +206 -0
  159. package/.claude/skills/sector-analyst/assets/industory_performance_1.jpeg +0 -0
  160. package/.claude/skills/sector-analyst/assets/industory_performance_2.jpeg +0 -0
  161. package/.claude/skills/sector-analyst/assets/sector_performance.jpeg +0 -0
  162. package/.claude/skills/sector-analyst/references/sector_rotation.md +170 -0
  163. package/.claude/skills/stanley-druckenmiller-investment/SKILL.md +84 -0
  164. package/.claude/skills/stanley-druckenmiller-investment/references/case-studies.md +148 -0
  165. package/.claude/skills/stanley-druckenmiller-investment/references/investment-philosophy.md +80 -0
  166. package/.claude/skills/stanley-druckenmiller-investment/references/market-analysis-guide.md +146 -0
  167. package/.claude/skills/stock/NOTION_SETUP.md +33 -0
  168. package/.claude/skills/stock/SKILL.md +38 -0
  169. package/.claude/skills/technical-analyst/SKILL.md +238 -0
  170. package/.claude/skills/technical-analyst/assets/analysis_template.md +183 -0
  171. package/.claude/skills/technical-analyst/references/technical_analysis_framework.md +282 -0
  172. package/.claude/skills/theme-detector/SKILL.md +320 -0
  173. package/.claude/skills/theme-detector/assets/report_template.md +155 -0
  174. package/.claude/skills/theme-detector/references/cross_sector_themes.md +252 -0
  175. package/.claude/skills/theme-detector/references/finviz_industry_codes.md +403 -0
  176. package/.claude/skills/theme-detector/references/thematic_etf_catalog.md +333 -0
  177. package/.claude/skills/theme-detector/references/theme_detection_methodology.md +430 -0
  178. package/.claude/skills/theme-detector/scripts/calculators/__init__.py +1 -0
  179. package/.claude/skills/theme-detector/scripts/calculators/heat_calculator.py +123 -0
  180. package/.claude/skills/theme-detector/scripts/calculators/industry_ranker.py +98 -0
  181. package/.claude/skills/theme-detector/scripts/calculators/lifecycle_calculator.py +172 -0
  182. package/.claude/skills/theme-detector/scripts/calculators/theme_classifier.py +195 -0
  183. package/.claude/skills/theme-detector/scripts/calculators/theme_discoverer.py +280 -0
  184. package/.claude/skills/theme-detector/scripts/config_loader.py +142 -0
  185. package/.claude/skills/theme-detector/scripts/default_theme_config.py +254 -0
  186. package/.claude/skills/theme-detector/scripts/etf_scanner.py +609 -0
  187. package/.claude/skills/theme-detector/scripts/finviz_performance_client.py +131 -0
  188. package/.claude/skills/theme-detector/scripts/report_generator.py +490 -0
  189. package/.claude/skills/theme-detector/scripts/representative_stock_selector.py +673 -0
  190. package/.claude/skills/theme-detector/scripts/scorer.py +87 -0
  191. package/.claude/skills/theme-detector/scripts/tests/README.md +21 -0
  192. package/.claude/skills/theme-detector/scripts/tests/conftest.py +9 -0
  193. package/.claude/skills/theme-detector/scripts/tests/test_config_loader.py +239 -0
  194. package/.claude/skills/theme-detector/scripts/tests/test_etf_scanner.py +810 -0
  195. package/.claude/skills/theme-detector/scripts/tests/test_heat_calculator.py +245 -0
  196. package/.claude/skills/theme-detector/scripts/tests/test_industry_ranker.py +256 -0
  197. package/.claude/skills/theme-detector/scripts/tests/test_lifecycle_calculator.py +301 -0
  198. package/.claude/skills/theme-detector/scripts/tests/test_report_generator.py +624 -0
  199. package/.claude/skills/theme-detector/scripts/tests/test_representative_stock_selector.py +898 -0
  200. package/.claude/skills/theme-detector/scripts/tests/test_scorer.py +185 -0
  201. package/.claude/skills/theme-detector/scripts/tests/test_theme_classifier.py +534 -0
  202. package/.claude/skills/theme-detector/scripts/tests/test_theme_detector_e2e.py +467 -0
  203. package/.claude/skills/theme-detector/scripts/tests/test_theme_discoverer.py +458 -0
  204. package/.claude/skills/theme-detector/scripts/tests/test_uptrend_client.py +76 -0
  205. package/.claude/skills/theme-detector/scripts/theme_detector.py +815 -0
  206. package/.claude/skills/theme-detector/scripts/themes.yaml +168 -0
  207. package/.claude/skills/theme-detector/scripts/uptrend_client.py +241 -0
  208. package/.claude/skills/uptrend-analyzer/SKILL.md +108 -0
  209. package/.claude/skills/uptrend-analyzer/references/uptrend_methodology.md +215 -0
  210. package/.claude/skills/uptrend-analyzer/scripts/calculators/__init__.py +1 -0
  211. package/.claude/skills/uptrend-analyzer/scripts/calculators/historical_context_calculator.py +122 -0
  212. package/.claude/skills/uptrend-analyzer/scripts/calculators/market_breadth_calculator.py +145 -0
  213. package/.claude/skills/uptrend-analyzer/scripts/calculators/momentum_calculator.py +183 -0
  214. package/.claude/skills/uptrend-analyzer/scripts/calculators/sector_participation_calculator.py +204 -0
  215. package/.claude/skills/uptrend-analyzer/scripts/calculators/sector_rotation_calculator.py +218 -0
  216. package/.claude/skills/uptrend-analyzer/scripts/data_fetcher.py +236 -0
  217. package/.claude/skills/uptrend-analyzer/scripts/report_generator.py +329 -0
  218. package/.claude/skills/uptrend-analyzer/scripts/scorer.py +276 -0
  219. package/.claude/skills/uptrend-analyzer/scripts/uptrend_analyzer.py +219 -0
  220. package/.claude/skills/us-market-bubble-detector/CHANGELOG.md +118 -0
  221. package/.claude/skills/us-market-bubble-detector/SKILL.md +545 -0
  222. package/.claude/skills/us-market-bubble-detector/references/bubble_framework.md +335 -0
  223. package/.claude/skills/us-market-bubble-detector/references/historical_cases.md +327 -0
  224. package/.claude/skills/us-market-bubble-detector/references/implementation_guide.md +473 -0
  225. package/.claude/skills/us-market-bubble-detector/references/quick_reference.md +354 -0
  226. package/.claude/skills/us-market-bubble-detector/references/quick_reference_en.md +342 -0
  227. package/.claude/skills/us-market-bubble-detector/scripts/bubble_scorer.py +309 -0
  228. package/.claude/skills/us-stock-analysis/SKILL.md +294 -0
  229. package/.claude/skills/us-stock-analysis/references/financial-metrics.md +172 -0
  230. package/.claude/skills/us-stock-analysis/references/fundamental-analysis.md +129 -0
  231. package/.claude/skills/us-stock-analysis/references/report-template.md +207 -0
  232. package/.claude/skills/us-stock-analysis/references/technical-analysis.md +93 -0
  233. package/.claude/skills/value-dividend-screener/SKILL.md +562 -0
  234. package/.claude/skills/value-dividend-screener/references/fmp_api_guide.md +348 -0
  235. package/.claude/skills/value-dividend-screener/references/screening_methodology.md +315 -0
  236. package/.claude/skills/value-dividend-screener/scripts/screen_dividend_stocks.py +1138 -0
  237. package/.claude/skills/vcp-screener/SKILL.md +79 -0
  238. package/.claude/skills/vcp-screener/references/fmp_api_endpoints.md +45 -0
  239. package/.claude/skills/vcp-screener/references/scoring_system.md +154 -0
  240. package/.claude/skills/vcp-screener/references/vcp_methodology.md +124 -0
  241. package/.claude/skills/vcp-screener/scripts/calculators/__init__.py +1 -0
  242. package/.claude/skills/vcp-screener/scripts/calculators/pivot_proximity_calculator.py +139 -0
  243. package/.claude/skills/vcp-screener/scripts/calculators/relative_strength_calculator.py +161 -0
  244. package/.claude/skills/vcp-screener/scripts/calculators/trend_template_calculator.py +228 -0
  245. package/.claude/skills/vcp-screener/scripts/calculators/vcp_pattern_calculator.py +322 -0
  246. package/.claude/skills/vcp-screener/scripts/calculators/volume_pattern_calculator.py +121 -0
  247. package/.claude/skills/vcp-screener/scripts/fmp_client.py +162 -0
  248. package/.claude/skills/vcp-screener/scripts/report_generator.py +317 -0
  249. package/.claude/skills/vcp-screener/scripts/scorer.py +155 -0
  250. package/.claude/skills/vcp-screener/scripts/screen_vcp.py +536 -0
  251. package/.claude/skills/vcp-screener/scripts/tests/__init__.py +0 -0
  252. package/.claude/skills/vcp-screener/scripts/tests/conftest.py +9 -0
  253. package/.claude/skills/vcp-screener/scripts/tests/test_vcp_screener.py +834 -0
  254. package/.claude/skills/weekly-trade-strategy/.claude/agents/druckenmiller-strategy-planner.md +300 -0
  255. package/.claude/skills/weekly-trade-strategy/.claude/agents/market-news-analyzer.md +239 -0
  256. package/.claude/skills/weekly-trade-strategy/.claude/agents/technical-market-analyst.md +187 -0
  257. package/.claude/skills/weekly-trade-strategy/.claude/agents/us-market-analyst.md +218 -0
  258. package/.claude/skills/weekly-trade-strategy/.claude/agents/weekly-trade-blog-writer.md +318 -0
  259. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/SKILL.md +662 -0
  260. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/assets/SP500_Breadth_Index_200MA_8MA.jpeg +0 -0
  261. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/assets/US_Stock_Market_Uptrend_Ratio.jpeg +0 -0
  262. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/assets/breadth_analysis_template.md +558 -0
  263. package/.claude/skills/weekly-trade-strategy/.claude/skills/breadth-chart-analyst/references/breadth_chart_methodology.md +590 -0
  264. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/SKILL.md +721 -0
  265. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/assets/earnings_report_template.md +102 -0
  266. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/earnings_calendar_2025-11-02.md +447 -0
  267. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/references/fmp_api_guide.md +590 -0
  268. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/scripts/fetch_earnings_fmp.py +443 -0
  269. package/.claude/skills/weekly-trade-strategy/.claude/skills/earnings-calendar/scripts/generate_report.py +366 -0
  270. package/.claude/skills/weekly-trade-strategy/.claude/skills/economic-calendar-fetcher/SKILL.md +365 -0
  271. package/.claude/skills/weekly-trade-strategy/.claude/skills/economic-calendar-fetcher/references/fmp_api_documentation.md +345 -0
  272. package/.claude/skills/weekly-trade-strategy/.claude/skills/economic-calendar-fetcher/scripts/get_economic_calendar.py +267 -0
  273. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/SKILL.md +139 -0
  274. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/references/analysis_patterns.md +124 -0
  275. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/references/indicators.md +99 -0
  276. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-environment-analysis/scripts/market_utils.py +127 -0
  277. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/SKILL.md +714 -0
  278. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/corporate_news_impact.md +446 -0
  279. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/geopolitical_commodity_correlations.md +499 -0
  280. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/market_event_patterns.md +393 -0
  281. package/.claude/skills/weekly-trade-strategy/.claude/skills/market-news-analyst/references/trusted_news_sources.md +510 -0
  282. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/SKILL.md +206 -0
  283. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/assets/industory_performance_1.jpeg +0 -0
  284. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/assets/industory_performance_2.jpeg +0 -0
  285. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/assets/sector_performance.jpeg +0 -0
  286. package/.claude/skills/weekly-trade-strategy/.claude/skills/sector-analyst/references/sector_rotation.md +170 -0
  287. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/SKILL.md +84 -0
  288. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/references/case-studies.md +148 -0
  289. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/references/investment-philosophy.md +80 -0
  290. package/.claude/skills/weekly-trade-strategy/.claude/skills/stanley-druckenmiller-investment/references/market-analysis-guide.md +146 -0
  291. package/.claude/skills/weekly-trade-strategy/.claude/skills/technical-analyst/SKILL.md +238 -0
  292. package/.claude/skills/weekly-trade-strategy/.claude/skills/technical-analyst/assets/analysis_template.md +183 -0
  293. package/.claude/skills/weekly-trade-strategy/.claude/skills/technical-analyst/references/technical_analysis_framework.md +282 -0
  294. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/CHANGELOG.md +118 -0
  295. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/SKILL.md +545 -0
  296. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/bubble_framework.md +335 -0
  297. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/historical_cases.md +327 -0
  298. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/implementation_guide.md +473 -0
  299. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/quick_reference.md +354 -0
  300. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/references/quick_reference_en.md +342 -0
  301. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-market-bubble-detector/scripts/bubble_scorer.py +309 -0
  302. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/SKILL.md +294 -0
  303. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/financial-metrics.md +172 -0
  304. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/fundamental-analysis.md +129 -0
  305. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/report-template.md +207 -0
  306. package/.claude/skills/weekly-trade-strategy/.claude/skills/us-stock-analysis/references/technical-analysis.md +93 -0
  307. package/.claude/skills/weekly-trade-strategy/CLAUDE.md +454 -0
  308. package/.claude/skills/weekly-trade-strategy/README.md +287 -0
  309. package/.claude/skills/weekly-trade-strategy/blogs/.gitkeep +0 -0
  310. package/.claude/skills/weekly-trade-strategy/charts/.gitkeep +0 -0
  311. package/.claude/skills/weekly-trade-strategy/earnings_data.json +10054 -0
  312. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/SKILL.md +662 -0
  313. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/assets/SP500_Breadth_Index_200MA_8MA.jpeg +0 -0
  314. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/assets/US_Stock_Market_Uptrend_Ratio.jpeg +0 -0
  315. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/assets/breadth_analysis_template.md +558 -0
  316. package/.claude/skills/weekly-trade-strategy/skills/breadth-chart-analyst/references/breadth_chart_methodology.md +590 -0
  317. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/SKILL.md +721 -0
  318. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/assets/earnings_report_template.md +102 -0
  319. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/earnings_calendar_2025-11-02.md +447 -0
  320. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/references/fmp_api_guide.md +590 -0
  321. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/scripts/fetch_earnings_fmp.py +443 -0
  322. package/.claude/skills/weekly-trade-strategy/skills/earnings-calendar/scripts/generate_report.py +366 -0
  323. package/.claude/skills/weekly-trade-strategy/skills/economic-calendar-fetcher/SKILL.md +365 -0
  324. package/.claude/skills/weekly-trade-strategy/skills/economic-calendar-fetcher/references/fmp_api_documentation.md +345 -0
  325. package/.claude/skills/weekly-trade-strategy/skills/economic-calendar-fetcher/scripts/get_economic_calendar.py +267 -0
  326. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/SKILL.md +139 -0
  327. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/references/analysis_patterns.md +124 -0
  328. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/references/indicators.md +99 -0
  329. package/.claude/skills/weekly-trade-strategy/skills/market-environment-analysis/scripts/market_utils.py +127 -0
  330. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/SKILL.md +714 -0
  331. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/corporate_news_impact.md +446 -0
  332. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/geopolitical_commodity_correlations.md +499 -0
  333. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/market_event_patterns.md +393 -0
  334. package/.claude/skills/weekly-trade-strategy/skills/market-news-analyst/references/trusted_news_sources.md +510 -0
  335. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/SKILL.md +206 -0
  336. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/assets/industory_performance_1.jpeg +0 -0
  337. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/assets/industory_performance_2.jpeg +0 -0
  338. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/assets/sector_performance.jpeg +0 -0
  339. package/.claude/skills/weekly-trade-strategy/skills/sector-analyst/references/sector_rotation.md +170 -0
  340. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/SKILL.md +84 -0
  341. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/references/case-studies.md +148 -0
  342. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/references/investment-philosophy.md +80 -0
  343. package/.claude/skills/weekly-trade-strategy/skills/stanley-druckenmiller-investment/references/market-analysis-guide.md +146 -0
  344. package/.claude/skills/weekly-trade-strategy/skills/technical-analyst/SKILL.md +238 -0
  345. package/.claude/skills/weekly-trade-strategy/skills/technical-analyst/assets/analysis_template.md +183 -0
  346. package/.claude/skills/weekly-trade-strategy/skills/technical-analyst/references/technical_analysis_framework.md +282 -0
  347. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/CHANGELOG.md +118 -0
  348. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/SKILL.md +545 -0
  349. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/bubble_framework.md +335 -0
  350. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/historical_cases.md +327 -0
  351. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/implementation_guide.md +473 -0
  352. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/quick_reference.md +354 -0
  353. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/references/quick_reference_en.md +342 -0
  354. package/.claude/skills/weekly-trade-strategy/skills/us-market-bubble-detector/scripts/bubble_scorer.py +309 -0
  355. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/SKILL.md +294 -0
  356. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/financial-metrics.md +172 -0
  357. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/fundamental-analysis.md +129 -0
  358. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/report-template.md +207 -0
  359. package/.claude/skills/weekly-trade-strategy/skills/us-stock-analysis/references/technical-analysis.md +93 -0
  360. package/.mcp.json +3 -0
  361. package/cli.mjs +16 -16
  362. package/package.json +4 -2
@@ -0,0 +1,590 @@
1
+ # Breadth Chart Analysis Methodology
2
+
3
+ This reference provides comprehensive methodology for analyzing two types of market breadth charts that provide complementary views of market health and trend status.
4
+
5
+ ## Overview
6
+
7
+ Market breadth indicators measure the participation of stocks in market moves, providing insights into the strength and sustainability of trends that price indices alone cannot reveal. This skill focuses on two specific breadth measurements:
8
+
9
+ 1. **200MA-Based Breadth Index**: Medium to long-term trend assessment tool
10
+ 2. **Uptrend Stock Ratio**: Short-term trend and momentum indicator
11
+
12
+ These two charts work together to provide both strategic (medium/long-term) and tactical (short-term) market perspectives.
13
+
14
+ ---
15
+
16
+ ## Chart 1: S&P 500 Breadth Index (200-Day MA Based)
17
+
18
+ ### Purpose and Use Case
19
+
20
+ This chart measures the percentage of S&P 500 stocks trading above their 200-day moving average, providing insight into the medium to long-term health of the market. It serves as a strategic positioning tool for determining major market cycles.
21
+
22
+ ### Chart Components
23
+
24
+ #### Primary Lines
25
+
26
+ **8-Day Moving Average (8MA) - Orange Line**
27
+ - Short-term smoothing of the breadth index
28
+ - More responsive to rapid market changes
29
+ - Key for identifying reversal points
30
+ - Used as the primary signal generator for entries
31
+
32
+ **200-Day Moving Average (200MA) - Green Line**
33
+ - Long-term trend of market breadth
34
+ - Slower to respond, filters out noise
35
+ - Represents the underlying structural health of the market
36
+ - Used as the primary signal generator for exits
37
+
38
+ #### Reference Levels
39
+
40
+ **Red Dashed Line (0.73 / 73%)**
41
+ - **Average Peak Level**: Historical average of 200MA tops
42
+ - **Significance**: When the breadth index exceeds this level, the market is in an overheated state
43
+ - **Interpretation**:
44
+ - Above 73%: Market is extremely bullish but approaching exhaustion
45
+ - Significantly above 73%: Elevated risk of correction or consolidation
46
+ - Rarely sustainable for extended periods
47
+
48
+ **Blue Dashed Line (0.23 / 23%)**
49
+ - **Average 8MA Trough Level**: Historical average of 8MA bottoms
50
+ - **Significance**: When the 8MA falls below this level, the market is in extreme oversold territory
51
+ - **Interpretation**:
52
+ - Below 23%: Severe market stress, capitulation-level selling
53
+ - High probability of reversal and recovery
54
+ - Historically represents excellent buying opportunities
55
+ - Extreme fear and pessimism typically present
56
+
57
+ #### Signal Markers (Triangles)
58
+
59
+ **Purple/Magenta Downward Triangles (▼)**
60
+ - **8MA Troughs**: Mark the bottoms of the 8-day moving average
61
+ - **Significance**: Potential reversal points, especially when near or below the 23% threshold
62
+ - **Use**: Primary buy signal when 8MA begins to turn up from a trough
63
+
64
+ **Blue Downward Triangles (▼)**
65
+ - **200MA Troughs**: Mark the bottoms of the 200-day moving average
66
+ - **Significance**: Major market cycle lows, extremely rare
67
+ - **Use**: Indicates the beginning of a new long-term bull market
68
+
69
+ **Red Upward Triangles (▲)**
70
+ - **200MA Peaks**: Mark the tops of the 200-day moving average
71
+ - **Significance**: Major market cycle highs indicating trend exhaustion
72
+ - **Use**: Primary sell signal for the tested strategy
73
+
74
+ #### Background Shading
75
+
76
+ **Pink Background Regions**
77
+ - **Downtrend Periods**: Time periods when the market is in a confirmed downtrend
78
+ - **Significance**: Higher risk environment, defensive positioning warranted
79
+ - **Use**: Visual aid to identify unfavorable market conditions
80
+
81
+ ### Interpretation Framework
82
+
83
+ #### Market Regimes
84
+
85
+ **Healthy Bull Market**
86
+ - 8MA and 200MA both rising
87
+ - Breadth index between 40% and 73%
88
+ - Regular pullbacks to 50-60% range that hold above 8MA
89
+ - Wide participation across stocks
90
+
91
+ **Overheated Bull Market**
92
+ - Breadth index persistently above 73%
93
+ - 8MA and 200MA both very elevated
94
+ - High risk of near-term correction
95
+ - Market vulnerable to negative catalysts
96
+
97
+ **Market Top/Distribution Phase**
98
+ - 200MA forming a peak (red ▲)
99
+ - 8MA begins to roll over even if 200MA hasn't peaked yet
100
+ - Breadth index declining from elevated levels
101
+ - Signal to exit long positions
102
+
103
+ **Bear Market/Correction**
104
+ - Both 8MA and 200MA declining
105
+ - Pink background shading present
106
+ - Breadth index below 50%
107
+ - High volatility typical
108
+
109
+ **Capitulation/Extreme Oversold**
110
+ - 8MA below 23% (blue dashed line)
111
+ - 8MA forming a trough (purple ▼)
112
+ - Maximum pessimism and fear
113
+ - Historically excellent buying opportunities
114
+
115
+ **Early Recovery**
116
+ - 8MA turning up from a trough
117
+ - 200MA may still be declining (lagging)
118
+ - Breadth index beginning to rise from extreme lows
119
+ - Initial phase of new uptrend
120
+
121
+ ### Backtested Strategy
122
+
123
+ Based on historical analysis, the following strategy has demonstrated strong performance:
124
+
125
+ #### Entry Rules
126
+
127
+ **BUY Signal**: 8MA Trough Reversal
128
+ - Wait for 8MA to form a clear bottom (purple ▼)
129
+ - Especially strong when 8MA trough is below 23% (extreme oversold)
130
+ - Enter long position in S&P 500 index when 8MA begins to turn upward
131
+ - Confirmation: 8MA crosses above previous recent high or shows 2-3 consecutive days of increase
132
+
133
+ #### Detailed Reversal Confirmation Criteria
134
+
135
+ **CRITICAL**: Do not enter prematurely. A trough formation alone is NOT sufficient for entry. The reversal must be CONFIRMED.
136
+
137
+ **Required Steps for Confirmation**:
138
+
139
+ 1. **Trough Identification** (Step 1):
140
+ - 8MA forms a clear bottom marked by purple ▼ triangle
141
+ - Trough level should ideally be below 40%, preferably below 30%
142
+ - Extreme troughs below 23% provide highest probability setups
143
+
144
+ 2. **Initial Reversal** (Step 2):
145
+ - 8MA begins to move upward from the trough
146
+ - First 1-2 periods of increase observed
147
+ - **WARNING**: This is NOT yet a confirmed signal - DO NOT ENTER
148
+
149
+ 3. **Confirmation Period** (Step 3 - MANDATORY):
150
+ - 8MA continues to rise for 2-3 CONSECUTIVE periods after the trough
151
+ - Each period should show clear upward progress (at least 2-5% increase)
152
+ - No significant pullbacks or reversals during confirmation period
153
+
154
+ 4. **Latest Data Verification** (Step 4 - CRITICAL):
155
+ - Analyze the RIGHTMOST 3-5 data points on the chart
156
+ - Verify that the 8MA is CURRENTLY rising (at the latest edge of the chart)
157
+ - Confirm no rollover or downward turn has occurred recently
158
+ - This step prevents entry on failed reversals
159
+
160
+ 5. **Resistance Breakout** (Step 5 - Optional but Ideal):
161
+ - 8MA crosses above 55-60% level
162
+ - This confirms strong breadth improvement
163
+ - Provides higher confidence in sustainability
164
+
165
+ **Confirmation Status Classification**:
166
+
167
+ - **CONFIRMED (Green Light)**: Steps 1-4 complete, 8MA rising for 2-3+ consecutive periods and CURRENTLY rising → ENTER
168
+ - **DEVELOPING (Yellow Light)**: Steps 1-2 complete, but < 2 consecutive increases → WAIT, MONITOR CLOSELY
169
+ - **FAILED (Red Light)**: Steps 1-2 occurred, but 8MA has rolled over and is declining → DO NOT ENTER, signal invalidated
170
+ - **NO SIGNAL (Red Light)**: No trough formed → WAIT
171
+
172
+ **Time-Based Confirmation**:
173
+ - Typical confirmation period: 2-4 weeks after trough
174
+ - If confirmation takes > 6 weeks, signal strength decreases
175
+ - If 8MA fails to reach 55% within 6 weeks of trough, reassess validity
176
+
177
+ #### Failed Reversal Patterns (WARNING SIGNS)
178
+
179
+ **What is a Failed Reversal?**
180
+
181
+ A failed reversal occurs when the 8MA forms a trough and begins to rise, but then rolls over and declines again before reaching sustained momentum. This invalidates the buy signal and often leads to deeper corrections.
182
+
183
+ **Identifying Failed Reversals**:
184
+
185
+ 1. **Weak Bounce Pattern**:
186
+ - 8MA rises for only 1-2 periods after trough
187
+ - 8MA fails to reach 50-55% level
188
+ - 8MA then turns downward again
189
+ - **Result**: False signal, do NOT enter
190
+
191
+ 2. **Premature Rollover**:
192
+ - 8MA rises to 50-60% range
193
+ - 8MA fails to sustain the rise, begins declining
194
+ - 8MA shows consistent downward trajectory at latest data points
195
+ - **Result**: Reversal failed, exit if already entered or do not enter
196
+
197
+ 3. **Double Bottom Formation**:
198
+ - First trough forms, 8MA rises briefly
199
+ - 8MA declines to form second, lower trough
200
+ - **Result**: First trough was not the final bottom, wait for second trough to confirm
201
+
202
+ **Failed Reversal Action Protocol**:
203
+ - Immediately classify signal as INVALID
204
+ - Do NOT enter position
205
+ - Wait for 8MA to form a NEW, LOWER trough (often below 23%)
206
+ - Reset analysis and wait for fresh confirmation from the new trough
207
+
208
+ **Historical Failed Reversal Examples** (refer to chart):
209
+ - Failed reversals are less common but occur during severe corrections
210
+ - They typically precede deeper declines to extreme oversold (<23%)
211
+ - After failed reversal, the eventual confirmed reversal from lower levels often provides excellent entries
212
+
213
+ #### Latest Data Point Analysis Protocol
214
+
215
+ **Why Latest Data Points Matter Most**:
216
+
217
+ The most recent 3-5 data points on the chart (rightmost edge) represent the CURRENT market condition. Historical movement is context, but the latest trajectory determines whether a signal is active, developing, or failed.
218
+
219
+ **Protocol**:
220
+
221
+ 1. **Always Start with the Rightmost Data Point**:
222
+ - This is the absolute latest reading
223
+ - This determines the CURRENT slope of the 8MA
224
+
225
+ 2. **Trace Backward 3-5 Data Points**:
226
+ - Compare current level to 1 week ago
227
+ - Compare current level to 2 weeks ago
228
+ - Compare current level to 3 weeks ago
229
+ - Determine if the trend is: Rising, Falling, or Flat
230
+
231
+ 3. **Calculate Consecutive Periods**:
232
+ - Count how many consecutive periods 8MA has risen
233
+ - Count how many consecutive periods 8MA has fallen
234
+ - **Confirmation requires 2-3 consecutive UP periods**
235
+ - **1-2 consecutive DOWN periods after a trough = failed reversal warning**
236
+
237
+ 4. **Visual Slope Assessment**:
238
+ - Visually trace the 8MA line at the rightmost edge
239
+ - Is the line sloping UP, DOWN, or FLAT?
240
+ - Do NOT rely on earlier parts of the chart - focus on the edge
241
+
242
+ **Example Analysis**:
243
+
244
+ ```
245
+ Scenario: 8MA formed trough at 30% three weeks ago
246
+
247
+ Week-by-Week Analysis (from trough to present):
248
+ - Week 1 after trough: 30% → 40% (UP 10%)
249
+ - Week 2 after trough: 40% → 52% (UP 12%)
250
+ - Week 3 after trough: 52% → 48% (DOWN 4%)
251
+
252
+ Current Slope: FALLING
253
+ Consecutive Increases: 0 (last period was DOWN)
254
+ Status: FAILED REVERSAL - 8MA rolled over after initial bounce
255
+
256
+ Action: DO NOT ENTER. Signal is invalid. Wait for new trough formation.
257
+ ```
258
+
259
+ ```
260
+ Scenario: 8MA formed trough at 25% four weeks ago
261
+
262
+ Week-by-Week Analysis (from trough to present):
263
+ - Week 1 after trough: 25% → 35% (UP 10%)
264
+ - Week 2 after trough: 35% → 45% (UP 10%)
265
+ - Week 3 after trough: 45% → 55% (UP 10%)
266
+ - Week 4 after trough: 55% → 60% (UP 5%)
267
+
268
+ Current Slope: RISING
269
+ Consecutive Increases: 4 (all periods UP)
270
+ Status: CONFIRMED - Strong sustained reversal
271
+
272
+ Action: ENTER LONG. Signal is confirmed and robust.
273
+ ```
274
+
275
+ #### Exit Rules
276
+
277
+ **SELL Signal**: 200MA Peak Detection
278
+ - Exit long position when 200MA forms a peak (red ▲)
279
+ - 200MA peaks typically occur when breadth index is near or above 73%
280
+ - Do not wait for 200MA to turn down; exit at or near the peak
281
+ - This signals the end of the bull market phase
282
+
283
+ #### Risk Management
284
+
285
+ - **Stop Loss**: Consider exiting if 8MA breaks decisively below its most recent trough
286
+ - **Partial Profits**: Consider taking partial profits when breadth index exceeds 73% (overheated)
287
+ - **Re-entry**: Do not re-enter during the same cycle unless a new 8MA trough forms
288
+
289
+ #### Strategy Performance Characteristics
290
+
291
+ - **Win Rate**: Historically high due to buying extreme oversold and selling into strength
292
+ - **Hold Period**: Typically several months to over a year
293
+ - **Drawdown Management**: Strategy avoids holding through major bear markets
294
+ - **False Signals**: Rare due to the significant smoothing of the indicators
295
+
296
+ ### Analysis Checklist
297
+
298
+ When analyzing this chart, systematically evaluate:
299
+
300
+ 1. ✓ **Current 8MA Level**: Where is the 8MA relative to historical troughs and the 23% threshold?
301
+ 2. ✓ **Current 200MA Level**: Where is the 200MA relative to historical peaks and the 73% threshold?
302
+ 3. ✓ **8MA Slope**: Is the 8MA rising, falling, or flat?
303
+ 4. ✓ **200MA Slope**: Is the 200MA rising, falling, or flat?
304
+ 5. ✓ **Recent Signal Markers**: Any recent triangles indicating troughs or peaks?
305
+ 6. ✓ **Market Regime**: Which regime best describes the current state?
306
+ 7. ✓ **Strategy Position**: Based on the backtested strategy, should one be long, flat, or preparing to enter/exit?
307
+ 8. ✓ **Distance from Thresholds**: How close is the breadth index to key levels (23%, 73%)?
308
+
309
+ ---
310
+
311
+ ## Chart 2: US Stock Market - Uptrend Stock Ratio
312
+
313
+ ### Purpose and Use Case
314
+
315
+ This chart measures the percentage of stocks in confirmed uptrends across the US stock market, providing a real-time view of market momentum and participation. It serves as a tactical tool for short-term swing trading and confirming the strength of market moves.
316
+
317
+ ### Definition of "Uptrend Stock"
318
+
319
+ A stock is classified as being in an uptrend when it meets ALL of the following criteria:
320
+
321
+ 1. **Price above 200-day MA**: Stock is in a long-term uptrend
322
+ 2. **Price above 50-day MA**: Stock is in an intermediate-term uptrend
323
+ 3. **Price above 20-day MA**: Stock is in a short-term uptrend
324
+ 4. **Positive 1-month performance**: Stock has gained value over the past month
325
+
326
+ This multi-factor definition ensures that only stocks with confirmed momentum across multiple timeframes are counted as "uptrend stocks."
327
+
328
+ ### Chart Components
329
+
330
+ #### Primary Visualization
331
+
332
+ **Color-Coded Trend Identification**
333
+
334
+ **Green Regions**
335
+ - Represent periods when the market is in an **uptrend**
336
+ - Uptrend stock ratio is generally rising
337
+ - Positive market momentum
338
+ - Favorable environment for long positions
339
+
340
+ **Red Regions**
341
+ - Represent periods when the market is in a **downtrend**
342
+ - Uptrend stock ratio is generally falling
343
+ - Negative market momentum
344
+ - Unfavorable for long positions, defensive posture appropriate
345
+
346
+ **Color Transitions**
347
+ - **Red-to-Green Transition**: Downtrend ending, uptrend beginning (BUY signal)
348
+ - **Green-to-Red Transition**: Uptrend ending, downtrend beginning (SELL signal)
349
+
350
+ #### Reference Levels
351
+
352
+ **Lower Orange Dashed Line (~10%)**
353
+ - **Short-Term Market Bottom**: When the uptrend ratio falls to approximately 10%
354
+ - **Significance**: Extreme oversold condition
355
+ - **Interpretation**:
356
+ - Below 10%: Maximum bearish sentiment, capitulation phase
357
+ - High probability of near-term reversal
358
+ - Short-term bottom often forms at this level
359
+ - Excellent risk/reward for initiating long positions
360
+
361
+ **Upper Orange Dashed Line (~37-40%)**
362
+ - **Short-Term Market Top**: When the uptrend ratio approaches approximately 40%
363
+ - **Significance**: Overbought condition, market overheating
364
+ - **Interpretation**:
365
+ - Near 40%: Market is short-term overbought
366
+ - High probability of pullback or consolidation
367
+ - Reversal often begins at this level
368
+ - Consider taking profits or tightening stops on long positions
369
+
370
+ ### Interpretation Framework
371
+
372
+ #### Market Conditions
373
+
374
+ **Extreme Oversold (Ratio < 10%)**
375
+ - Very few stocks participating in uptrend
376
+ - Market-wide selling pressure
377
+ - High fear and pessimism
378
+ - Contrarian buying opportunity
379
+ - Often coincides with VIX spikes
380
+ - Watch for red-to-green transition
381
+
382
+ **Moderate Bearish (Ratio 10-20%)**
383
+ - Below-average market participation
384
+ - Downtrend still in effect (red)
385
+ - Selective stock strength only
386
+ - Wait for confirmation before entering
387
+
388
+ **Neutral/Transitional (Ratio 20-30%)**
389
+ - Average market participation
390
+ - Can be either early uptrend or late downtrend
391
+ - Color (green vs red) is critical for context
392
+ - Watch for trend changes
393
+
394
+ **Moderate Bullish (Ratio 30-37%)**
395
+ - Healthy uptrend participation
396
+ - Green color dominant
397
+ - Sustainable momentum
398
+ - Favorable for long positions
399
+
400
+ **Extreme Overbought (Ratio > 37-40%)**
401
+ - Very high participation in uptrend
402
+ - Market short-term overheated
403
+ - Vulnerable to pullback
404
+ - Watch for green-to-red transition
405
+ - Consider profit-taking
406
+
407
+ #### Trend Transitions
408
+
409
+ **Red-to-Green (Downtrend to Uptrend)**
410
+ - **Entry Signal**: Marks the beginning of a new uptrend phase
411
+ - **Characteristics**:
412
+ - Uptrend ratio bottoms and begins to rise
413
+ - Often occurs from extreme oversold levels (<10-15%)
414
+ - Increasing number of stocks breaking above MAs
415
+ - Momentum shifting from bearish to bullish
416
+ - **Action**: Initiate long positions in index or strong individual stocks
417
+
418
+ **Green-to-Red (Uptrend to Downtrend)**
419
+ - **Exit Signal**: Marks the end of an uptrend phase
420
+ - **Characteristics**:
421
+ - Uptrend ratio peaks and begins to fall
422
+ - Often occurs from overbought levels (>35-40%)
423
+ - Stocks breaking below key moving averages
424
+ - Momentum shifting from bullish to bearish
425
+ - **Action**: Exit long positions, move to cash or defensive positions
426
+
427
+ ### Trading Strategy
428
+
429
+ #### Short-Term Swing Trading Strategy
430
+
431
+ **Entry Rules**
432
+
433
+ 1. **Wait for Oversold Condition**:
434
+ - Uptrend ratio declines to 10-15% range
435
+ - Market in red (downtrend) phase
436
+
437
+ 2. **Identify Trend Reversal**:
438
+ - Color changes from red to green
439
+ - Uptrend ratio begins to rise from lows
440
+ - Confirmation: 2-3 consecutive increases in the ratio
441
+
442
+ 3. **Enter Long Position**:
443
+ - Buy S&P 500 index (SPY, ES futures) or basket of leading stocks
444
+ - Position size based on risk tolerance
445
+
446
+ **Exit Rules**
447
+
448
+ 1. **Watch for Overbought Condition**:
449
+ - Uptrend ratio approaches 37-40% level
450
+ - Market has been green for extended period
451
+
452
+ 2. **Identify Trend Exhaustion**:
453
+ - Color changes from green to red
454
+ - Uptrend ratio begins to fall from highs
455
+ - Momentum waning
456
+
457
+ 3. **Exit Long Position**:
458
+ - Sell index position
459
+ - Move to cash or defensive assets
460
+
461
+ **Risk Management**
462
+
463
+ - **Stop Loss**: Exit if uptrend ratio breaks below recent lows while still in supposed uptrend
464
+ - **Partial Exits**: Consider scaling out as ratio approaches 35-37%
465
+ - **Position Sizing**: Larger positions when entering from extreme oversold (<10%), smaller when entering from moderate levels
466
+ - **False Signals**: Quick reversals (red-green-red or green-red-green within days) may be false; wait for confirmation
467
+
468
+ #### Strategy Performance Characteristics
469
+
470
+ - **Timeframe**: Days to weeks (swing trading)
471
+ - **Win Rate**: Moderate to high, depending on confirmation criteria
472
+ - **Hold Period**: Typically 1-4 weeks
473
+ - **Best Performance**: When entries align with extreme oversold conditions (<10%)
474
+ - **Risk**: Whipsaws during choppy, trendless markets
475
+
476
+ ### Combining Both Charts
477
+
478
+ For optimal decision-making, use both breadth charts together:
479
+
480
+ #### Strategic Positioning (Chart 1: 200MA Breadth)
481
+
482
+ - Determines overall market regime (bull, bear, neutral)
483
+ - Guides strategic asset allocation
484
+ - Identifies major entry/exit points for core positions
485
+ - Longer holding periods (months to year+)
486
+
487
+ #### Tactical Positioning (Chart 2: Uptrend Ratio)
488
+
489
+ - Determines short-term momentum and timing
490
+ - Guides tactical trades and position sizing
491
+ - Identifies short-term entry/exit points for swing trades
492
+ - Shorter holding periods (days to weeks)
493
+
494
+ #### Alignment Scenarios
495
+
496
+ **Scenario 1: Both Bullish**
497
+ - Chart 1: 8MA rising, 200MA rising or flat, breadth < 73%
498
+ - Chart 2: Green (uptrend), ratio rising from oversold
499
+ - **Action**: Maximum bullish stance, aggressive long positioning
500
+
501
+ **Scenario 2: Strategic Bullish, Tactical Bearish**
502
+ - Chart 1: 8MA rising, 200MA not yet peaked
503
+ - Chart 2: Red (downtrend), ratio elevated or falling
504
+ - **Action**: Hold core long positions, avoid new tactical longs, wait for oversold
505
+
506
+ **Scenario 3: Strategic Bearish, Tactical Bullish**
507
+ - Chart 1: 200MA peaked or declining
508
+ - Chart 2: Green (uptrend), ratio rising from extreme oversold
509
+ - **Action**: Short-term tactical longs only, tight stops, prepare for strategic exit
510
+
511
+ **Scenario 4: Both Bearish**
512
+ - Chart 1: Both MAs declining, pink background
513
+ - Chart 2: Red (downtrend), ratio falling
514
+ - **Action**: Defensive positioning, cash or short positions, wait for 8MA trough
515
+
516
+ ### Analysis Checklist for Chart 2
517
+
518
+ When analyzing the uptrend stock ratio chart, systematically evaluate:
519
+
520
+ 1. ✓ **Current Ratio Level**: What is the current uptrend stock percentage?
521
+ 2. ✓ **Current Color**: Is the market in green (uptrend) or red (downtrend)?
522
+ 3. ✓ **Proximity to Thresholds**: How close is the ratio to 10% (bottom) or 40% (top)?
523
+ 4. ✓ **Trend Direction**: Is the ratio rising, falling, or flat?
524
+ 5. ✓ **Recent Transitions**: Any recent color changes from red-to-green or green-to-red?
525
+ 6. ✓ **Duration of Current Trend**: How long has the current color phase lasted?
526
+ 7. ✓ **Strategy Position**: Based on the swing trading strategy, should one be long, flat, or preparing to enter/exit?
527
+ 8. ✓ **Historical Context**: How does the current reading compare to recent extremes?
528
+
529
+ ---
530
+
531
+ ## Output Requirements
532
+
533
+ ### Language and Style
534
+
535
+ - **Analysis Language**: Conduct all thinking and analysis in English
536
+ - **Output Format**: Generate all reports in English using markdown format
537
+ - **Tone**: Professional, objective, analytical
538
+ - **Terminology**: Use precise technical terms consistently
539
+
540
+ ### Analysis Structure
541
+
542
+ Each breadth chart analysis report should include:
543
+
544
+ 1. **Current Readings**: Specific values for all key metrics
545
+ 2. **Signal Status**: Clear identification of any active signals (troughs, peaks, transitions)
546
+ 3. **Market Regime Assessment**: Classification of the current market environment
547
+ 4. **Strategy Implications**: Specific positioning recommendations based on the backtested strategies
548
+ 5. **Key Levels to Watch**: Upcoming thresholds or levels that would change the analysis
549
+ 6. **Risk Considerations**: Potential invalidation scenarios or alternative interpretations
550
+ 7. **Combined Analysis** (when both charts analyzed): Integration of strategic and tactical perspectives
551
+
552
+ ### Objectivity Standards
553
+
554
+ - Base all analysis strictly on observable chart data
555
+ - Avoid incorporating external information (news, fundamentals) unless specifically relevant to breadth interpretation
556
+ - Clearly distinguish between factual observations and probabilistic forecasts
557
+ - Acknowledge uncertainty when signals are ambiguous
558
+ - Present both bullish and bearish scenarios when appropriate
559
+
560
+ ---
561
+
562
+ ## Common Pitfalls to Avoid
563
+
564
+ ### Chart 1 (200MA Breadth) Pitfalls
565
+
566
+ - **Misreading Recent Trend Direction** (MOST COMMON ERROR): Analyzing historical chart movement instead of focusing on the LATEST 3-5 data points at the rightmost edge. This leads to stating "8MA is rising" when it's actually falling at the current edge, or vice versa. ALWAYS analyze the rightmost data points to determine CURRENT slope.
567
+
568
+ - **Premature Entry**: Buying before clear 8MA reversal is confirmed (2-3 consecutive periods of increase). Entering on just a trough formation without confirmation often results in losses from failed reversals.
569
+
570
+ - **Ignoring Failed Reversals**: Not recognizing when an 8MA has rolled over after an initial bounce from a trough. If the 8MA rises briefly then turns down again, the signal is INVALID.
571
+
572
+ - **Late Exit**: Waiting for 200MA to decline instead of exiting at the peak formation. The peak itself is the sell signal - do not wait for confirmation of decline.
573
+
574
+ - **Ignoring Thresholds**: Not recognizing significance of 23% and 73% levels. These thresholds provide critical context for entry and exit timing.
575
+
576
+ - **Overtrading**: Trying to trade every wiggle in the 8MA instead of waiting for clear, confirmed trough reversals. Patience is essential for this strategy.
577
+
578
+ ### Chart 2 (Uptrend Ratio) Pitfalls
579
+
580
+ - **Chasing**: Entering after the ratio has already risen substantially from oversold
581
+ - **Ignoring Color**: Focusing only on the ratio level without considering trend direction (color)
582
+ - **False Breakouts**: Not waiting for confirmation of color transitions
583
+ - **Missing Extremes**: Not recognizing when the ratio reaches <10% or >40%
584
+
585
+ ### General Pitfalls
586
+
587
+ - **Analyzing in Isolation**: Using only one chart without considering the other
588
+ - **Over-Complicating**: Adding too many additional indicators that cloud the core signals
589
+ - **Recency Bias**: Giving too much weight to the most recent move
590
+ - **Ignoring Historical Context**: Not comparing current readings to historical patterns shown on the charts