Breadth Chart Analyst

Breadth Chart Analyst

Overview

This skill enables specialized analysis of two complementary market breadth charts that provide strategic (medium to long-term) and tactical (short-term) market perspectives. Analyze breadth chart images to assess market health, identify trading signals based on backtested strategies, and develop positioning recommendations. All thinking and output are conducted exclusively in English.

When to Use

Use this skill when:

• User provides S&P 500 Breadth Index (200-Day MA based) chart images for analysis
• User provides US Stock Market Uptrend Stock Ratio chart images for analysis
• User requests market breadth assessment or market health evaluation
• User asks about medium-term strategic positioning based on breadth indicators
• User needs short-term tactical timing signals for swing trading
• User wants combined strategic and tactical market outlook
• User requests breadth analysis WITHOUT providing chart images (CSV data mode)

Do NOT use this skill when:

• User asks about individual stock analysis (use us-stock-analysis skill instead)
• User needs sector rotation analysis without breadth charts (use sector-analyst skill instead)
• User wants news-based market analysis (use market-news-analyst skill instead)

Prerequisites

• Chart Images Optional: CSV data from public sources is the PRIMARY data source; chart images provide supplementary visual context
• No API Keys Required: CSV data is fetched from public GitHub Pages; no external API subscriptions needed
• Language: All analysis and output conducted in English

Output

This skill generates markdown analysis reports saved to the reports/ directory:

• Chart 1 only: breadth_200ma_analysis_[YYYY-MM-DD].md
• Chart 2 only: uptrend_ratio_analysis_[YYYY-MM-DD].md
• Both charts: breadth_combined_analysis_[YYYY-MM-DD].md

Reports include executive summaries, current readings, signal identification, scenario analysis with probabilities, and actionable positioning recommendations for different trader types.

Core Principles

1. Dual-Timeframe Analysis: Combine strategic (Chart 1: 200MA Breadth) and tactical (Chart 2: Uptrend Ratio) perspectives 2. Backtested Strategy Focus: Apply proven systematic strategies based on historical patterns 3. Objective Signal Identification: Focus on clearly defined thresholds, transitions, and markers 4. English Communication: Conduct all analysis and generate all reports in English 5. Actionable Recommendations: Provide specific positioning guidance for different investor types

Chart Types and Purposes

Chart 1: S&P 500 Breadth Index (200-Day MA Based)

Purpose: Medium to long-term strategic market positioning

Key Elements:

• 8-Day MA (Orange Line): Short-term breadth trend, primary entry signal generator
• 200-Day MA (Green Line): Long-term breadth trend, primary exit signal generator
• Red Dashed Line (73%): Average peak level - market overheating threshold
• Blue Dashed Line (23%): Average 8MA trough level - extreme oversold, excellent buying opportunity
• Triangles:
• Purple ▼ = 8MA troughs (buy signal when reverses)
• Blue ▼ = 200MA troughs (major cycle lows)
• Red ▲ = 200MA peaks (sell signal)
• Pink Background: Downtrend periods

Backtested Strategy:

• BUY: When 8MA reverses from a trough (especially below 23%)
• SELL: When 200MA forms a peak (typically near/above 73%)
• Result: Historically high performance, avoids bear markets

Chart 2: US Stock Market - Uptrend Stock Ratio

Purpose: Short-term tactical timing and swing trading

Key Elements:

• Uptrend Stock Definition: Stocks above 200MA/50MA/20MA with positive 1-month performance
• Green Regions: Market in uptrend phase
• Red Regions: Market in downtrend phase
• ~10% Level (Lower Orange Dashed): Short-term bottom, extreme oversold
• ~40% Level (Upper Orange Dashed): Short-term top, market overheating

Swing Trading Strategy:

• ENTER LONG: When color changes from red to green (especially from <10-15% levels)
• EXIT LONG: When color changes from green to red (especially from >35-40% levels)
• Timeframe: Days to weeks

Analysis Workflow

Step 0: Fetch CSV Data (PRIMARY SOURCE - MANDATORY)

CRITICAL: CSV data is the PRIMARY source for all Breadth values. This step MUST be executed BEFORE any image analysis.

python3 skills/breadth-chart-analyst/scripts/fetch_breadth_csv.py

Why CSV is PRIMARY:

• OpenCV image detection is fragile -- chart format changes cause catastrophic failures (Issue #7)
• CSV provides exact numerical values directly from the data source
• Image analysis is SUPPLEMENTARY only (for visual trend context)

Data Sources: 1. Market Breadth: tradermonty.github.io/market-breadth-analysis/market_breadth_data.csv

• Provides: 200-Day MA, 8-Day MA, Trend, Dead Cross status

2. Uptrend Ratio: tradermonty/uptrend-dashboard/data/uptrend_ratio_timeseries.csv

• Provides: Current ratio, 10MA, slope, trend (UP/DOWN), color (GREEN/RED)

3. Sector Summary: tradermonty/uptrend-dashboard/data/sector_summary.csv

• Provides: Per-sector ratio, trend, status (overbought/oversold)

Data Source Priority:

Expected Output:

============================================================
Breadth Data (CSV) - 2026-02-13
============================================================
--- Market Breadth (S&P 500) ---
200-Day MA: 62.26% (healthy (>=60%))
8-Day MA:   67.56% (healthy_bullish (60-73%))
8MA vs 200MA: +5.30pt (8MA ABOVE -- NO dead cross)
Trend: UPTREND
--- Uptrend Ratio (All Markets) ---
Current: 33.03% GREEN (neutral_bullish)
10MA: 32.65%, Slope: +0.0055, Trend: UP
--- Sector Summary ---
...
============================================================

Validation: After running CSV fetch, verify:

• [ ] CSV data retrieved successfully
• [ ] 200-Day MA value recorded
• [ ] 8-Day MA value recorded
• [ ] Dead cross status determined (8MA < 200MA = dead cross)
• [ ] Uptrend Ratio value + color + trend recorded
• [ ] Use these CSV values as the authoritative source for all subsequent analysis

---

Step 1: Receive Chart Images and Prepare Analysis

When the user provides breadth chart images for analysis:

1. Confirm receipt of chart image(s) 2. Identify which chart(s) are provided:

• Chart 1 only (200MA Breadth)
• Chart 2 only (Uptrend Ratio)
• Both charts

3. Note any specific focus areas or questions from the user 4. CRITICAL: Extract right edge of chart images before analysis (Step 1.5)

If NO chart images are provided: Skip Steps 1, 1.5, and image-based analysis. Use CSV data from Step 0 as the sole data source and proceed directly to the analysis and report generation steps.

Language Note: All subsequent thinking, analysis, and output will be in English.

Step 1.5: Two-Stage Chart Analysis (MANDATORY when charts provided)

CRITICAL: Use a two-stage analysis approach to prevent misreading historical data as current values.

Stage 1: Full Chart Analysis (Historical Context)

First, analyze the FULL chart image to understand:

• Overall historical trend and cycles
• Key historical events (troughs, peaks, recoveries)
• Long-term patterns and context

Stage 2: Right Edge Focused Analysis (Current Values)

Then, extract and analyze the rightmost 25% of the chart to accurately determine CURRENT values.

Execute the Python script to extract the right edge:

python3 skills/breadth-chart-analyst/scripts/extract_chart_right_edge.py <image_path> --percent 25

Why Two-Stage Analysis is Mandatory

Common Error This Prevents:

• LLM reads 2025 mid-year dip (8MA ~25-30%) instead of current value (8MA ~60-65%)
• By isolating the right edge, the "current" data is unambiguous

Analysis Protocol

1. Read full chart → Document historical context 2. Run extraction script → Generate right edge image 3. Read right edge image → Document current values with HIGH CONFIDENCE 4. Cross-check: If Stage 1 and Stage 2 values differ significantly, Stage 2 (right edge) takes precedence 5. Report both: Include Stage 1 context AND Stage 2 current values in analysis

Step 2: Load Breadth Chart Methodology

Before beginning analysis, read the comprehensive breadth chart methodology:

Read: references/breadth_chart_methodology.md

This reference contains detailed guidance on:

• Chart 1: 200MA-based breadth index interpretation and strategy
• Chart 2: Uptrend stock ratio interpretation and strategy
• Signal identification and threshold significance
• Strategy rules and risk management
• Combining both charts for optimal decision-making
• Common pitfalls to avoid

Step 3: Examine Sample Charts (First Time or for Reference)

To understand the chart format and visual elements, review the sample charts included in this skill:

View: assets/SP500_Breadth_Index_200MA_8MA.jpeg
View: assets/US_Stock_Market_Uptrend_Ratio.jpeg

These samples demonstrate:

• Visual appearance and structure of each chart type
• How signals and thresholds are displayed
• Color coding and marker systems
• Historical patterns and cycles

Step 4: Analyze Chart 1 (200MA-Based Breadth Index)

If Chart 1 is provided, conduct systematic analysis:

4.1 Extract Current Readings

From the chart image, identify:

• Current 8MA level (orange line): Specific percentage
• Current 200MA level (green line): Specific percentage
• 8MA slope: Rising, falling, or flat
• 200MA slope: Rising, falling, or flat
• Distance from 73% threshold: How close to overheating
• Distance from 23% threshold: How close to extreme oversold
• Most recent date visible on the chart

4.1.5 CRITICAL: Latest Data Point Detailed Trend Analysis

This step is MANDATORY to avoid misreading recent trend changes.

CRITICAL WARNING: Charts can be deceptive. The MAJORITY of analysis errors occur because the analyst: 1. Confuses the 8MA (orange) with the 200MA (green) 2. Reads historical trends instead of the CURRENT rightmost data points 3. Misidentifies which line is rising vs falling

BEFORE analyzing trend direction, FIRST confirm line colors:

• ✓ 8MA = ORANGE line (fast-moving, more volatile)
• ✓ 200MA = GREEN line (slow-moving, smoother)
• If unsure which is which, STOP and re-examine the chart legend/colors

Focus intensively on the rightmost 3-5 data points of the chart (most recent weeks):

For 8MA (Orange Line) - Analyze the very latest trajectory: 1. Identify the absolute latest position: Where is the 8MA at the rightmost edge of the chart? 2. Trace back 3-5 data points (approximately 3-5 weeks):

• What was the 8MA level 1 week ago?
• What was the 8MA level 2 weeks ago?
• What was the 8MA level 3 weeks ago?

3. Calculate the directional change:

• Is the latest value HIGHER or LOWER than 1 week ago?
• Is the latest value HIGHER or LOWER than 2 weeks ago?
• What is the trend: consistently rising, consistently falling, or mixed?

4. Determine the CURRENT slope (not historical slope):

• Rising: Latest data point is higher than previous 2-3 points AND shows upward curvature
• Falling: Latest data point is lower than previous 2-3 points AND shows downward curvature
• Flat: Latest data point is approximately equal to previous points (within 2-3%)

Critical Questions to Answer:

• [ ] Is the 8MA currently moving UP or DOWN at the rightmost edge?
• [ ] If there was a recent trough, has the 8MA sustained the upward move, or has it rolled over?
• [ ] Count consecutive periods of increase: How many consecutive periods has 8MA risen? (Need 2-3 for confirmation)
• [ ] Count consecutive periods of decrease: How many consecutive periods has 8MA fallen? (Indicates failed reversal if declining after trough)

For 200MA (Green Line) - Analyze the very latest trajectory: 1. Identify the absolute latest position: Where is the 200MA at the rightmost edge? 2. Trace back 4-6 weeks:

• What was the 200MA level 2 weeks ago?
• What was the 200MA level 4 weeks ago?

3. Determine the CURRENT slope:

• Is it rising, falling, or flat in the most recent period?

Failed Reversal Detection (CRITICAL): If an 8MA trough (purple ▼) was recently identified:

• [ ] Did the 8MA rise for only 1-2 periods and then turn back down?
• [ ] Did the 8MA fail to reach 60% before turning down?
• [ ] Is the 8MA currently declining again after the bounce?
• If YES to any: This is a FAILED REVERSAL - DO NOT ENTER, signal is INVALID

Example Analysis Format:

Latest 8MA Data Points (rightmost to left):
- Current (Week 0): 48%
- 1 week ago: 52%
- 2 weeks ago: 55%
- 3 weeks ago: 50%

Analysis: 8MA is FALLING. It rose from 50% to 55% (weeks 3-2), but has since declined to 48%.
This shows a failed reversal pattern - bounce was temporary, downtrend has resumed.
SLOPE: Falling (not rising!)

MANDATORY CROSS-CHECK (to catch misreadings): After determining the trend, ask yourself:

• [ ] "If I claimed 8MA is RISING, but it's actually been FALLING for weeks, what would that look like?"
• Answer: The rightmost data points would be LOWER than previous points (confirming FALLING)
• [ ] "Does my analysis match the visual slope of the orange line at the rightmost edge?"
• If orange line visually slopes DOWN at the right edge → It's FALLING
• If orange line visually slopes UP at the right edge → It's RISING
• [ ] "Is there any pink background shading (downtrend) near the rightmost edge?"
• If YES → This confirms downtrend conditions, 8MA is likely FALLING
• [ ] "Are the 8MA and 200MA converging (getting closer) or diverging?"
• Converging from below → Potential death cross forming → BEARISH
• Converging from above → Potential golden cross forming → BULLISH

4.2 Identify Signal Markers

Look for and document:

• Most recent 8MA trough (purple ▼): Date and level
• Most recent 200MA trough (blue ▼): Date and level (if visible in timeframe)
• Most recent 200MA peak (red ▲): Date and level
• Days/weeks since most recent signals
• Any pink background shading (downtrend periods)

4.3 Assess Market Regime

Based on readings and patterns, classify the current market as:

• Healthy Bull Market
• Overheated Bull Market
• Market Top/Distribution Phase
• Bear Market/Correction
• Capitulation/Extreme Oversold
• Early Recovery

Support the classification with specific evidence from the chart.

4.4 Determine Strategy Position

Apply the backtested strategy rules with STRICT confirmation requirements:

Check for BUY signal (ALL criteria must be met): 1. ✓ Trough Formation: Has 8MA formed a clear trough (purple ▼)? 2. ✓ Reversal Initiated: Has 8MA begun to move upward from the trough? 3. ✓ Confirmation Achieved: Has 8MA risen for 2-3 CONSECUTIVE periods after the trough? 4. ✓ No Recent Reversal: Based on Step 4.1.5 analysis, is 8MA CURRENTLY rising (not falling)? 5. ✓ Sustained Move: Has 8MA maintained the upward trajectory without rolling over? 6. ⭐ Optional but Strong: Is 8MA below or near 23% (extreme oversold) at trough?

BUY Signal Status:

• CONFIRMED: All 5 required criteria met → ENTER LONG
• DEVELOPING: Trough formed, but < 2-3 consecutive increases → WAIT, MONITOR
• FAILED: Trough formed, but 8MA has rolled over and is declining → DO NOT ENTER, WAIT FOR NEXT TROUGH
• NO SIGNAL: No trough formed → WAIT

Check for SELL signal:

• Has 200MA formed a peak (red ▲)?
• Is 200MA near or above 73%?
• Is this an active sell signal requiring position exit?

Current position determination:

• Long: BUY signal confirmed, position entered and held
• Preparing to Enter: BUY signal developing (trough formed, watching for confirmation)
• WAIT / Flat: No valid signal OR failed reversal detected
• Preparing to Exit: SELL signal developing (200MA approaching peak)

4.5 Develop Scenarios

Create 2-3 scenarios with probability estimates:

• Base case scenario (highest probability)
• Alternative scenario(s)
• Each scenario includes: description, supporting factors, strategy implications, key levels

Step 5: Analyze Chart 2 (Uptrend Stock Ratio)

If Chart 2 is provided, conduct systematic analysis:

5.0 ~~MANDATORY~~ DEPRECATED: Uptrend Ratio Detection Script (Superseded by Step 0 CSV Fetch)

NOTE (Issue #7): This OpenCV detection step is DEPRECATED. Use CSV data from Step 0 as the PRIMARY source. The OpenCV script may be run for supplementary validation only, but CSV values take precedence in all cases.

python3 skills/breadth-chart-analyst/scripts/detect_uptrend_ratio.py <image_path> [--debug]

5.1 Extract Current Readings

From the chart image, identify:

• Current uptrend stock ratio: Specific percentage
• Current color: Green (uptrend) or Red (downtrend)
• Ratio slope: Rising, falling, or flat
• Distance from 10% threshold: How close to extreme oversold
• Distance from 40% threshold: How close to overbought
• Most recent date visible on the chart

5.2 Identify Trend Transitions

Look for and document:

• Most recent red-to-green transition: Date and ratio level at transition
• Most recent green-to-red transition: Date and ratio level at transition
• Duration of current color phase: How long in current trend
• Days/weeks since most recent transition

5.3 Assess Market Condition

Based on current ratio and color, classify as:

• Extreme Oversold (<10%)
• Moderate Bearish (10-20%, red)
• Neutral/Transitional (20-30%)
• Moderate Bullish (30-37%, green)
• Extreme Overbought (>37-40%)

Support the classification with specific evidence from the chart.

5.4 Determine Trading Position

Apply the swing trading strategy rules:

Check for ENTER LONG signal:

• Has color changed from red to green?
• Was the transition from an oversold level (<15%)?
• Is the transition confirmed (2-3 days of green)?

Check for EXIT LONG signal:

• Has color changed from green to red?
• Was the transition from an overbought level (>35%)?
• Is momentum weakening?

Current position: Long, Flat, Preparing to Enter, or Preparing to Exit

5.5 Develop Scenarios

Create 2-3 scenarios with probability estimates:

• Base case scenario (highest probability)
• Alternative scenario(s)
• Each scenario includes: description, supporting factors, trading implications, key levels

Step 6: Combined Analysis (When Both Charts Provided)

If both charts are provided, integrate the strategic and tactical perspectives:

6.1 Alignment Assessment

Create a positioning matrix:

• Chart 1 (Strategic): Bullish / Bearish / Neutral + signal status
• Chart 2 (Tactical): Bullish / Bearish / Neutral + signal status
• Combined Implication: How do they align or conflict?

6.2 Scenario Classification

Determine which of the four scenarios applies:

Scenario 1: Both Bullish

• Chart 1: 8MA rising, 200MA not yet peaked
• Chart 2: Green (uptrend), ratio rising from oversold
• Implication: Maximum bullish stance, aggressive positioning

Scenario 2: Strategic Bullish, Tactical Bearish

• Chart 1: 8MA rising, 200MA not yet peaked
• Chart 2: Red (downtrend), ratio falling or elevated
• Implication: Hold core long positions, wait for tactical entry

Scenario 3: Strategic Bearish, Tactical Bullish

• Chart 1: 200MA peaked or declining
• Chart 2: Green (uptrend), ratio rising
• Implication: Short-term tactical trades only, tight stops

Scenario 4: Both Bearish

• Chart 1: Both MAs declining
• Chart 2: Red (downtrend), ratio falling
• Implication: Defensive positioning, cash or shorts

6.3 Unified Recommendation

Provide integrated positioning guidance for:

• Long-term investors (based primarily on Chart 1)
• Swing traders (based primarily on Chart 2)
• Active tactical traders (based on combination)

Address any conflicts between charts and explain resolution.

Step 7: Generate Analysis Report in English

Create a comprehensive markdown report using the template structure:

Read and use as template: assets/breadth_analysis_template.md

IMPORTANT: All analysis and output must be in English.

The report structure varies based on which chart(s) are analyzed:

If Chart 1 only:

• Executive Summary
• Chart 1 full analysis sections
• Summary and Conclusion
• Omit Chart 2 and Combined Analysis sections

If Chart 2 only:

• Executive Summary
• Chart 2 full analysis sections
• Summary and Conclusion
• Omit Chart 1 and Combined Analysis sections

If Both Charts:

• Executive Summary
• Chart 1 full analysis sections
• Chart 2 full analysis sections
• Combined Analysis section (mandatory)
• Summary and Conclusion

File Naming Convention: Save each analysis as:

• Chart 1 only: breadth_200ma_analysis_[YYYY-MM-DD].md
• Chart 2 only: uptrend_ratio_analysis_[YYYY-MM-DD].md
• Both charts: breadth_combined_analysis_[YYYY-MM-DD].md

Step 8: Quality Assurance

Before finalizing the report, verify:

1. ✓ Language: All content is in English (thinking and output) 2. ✓ Line Color Verification: Explicitly confirmed 8MA = ORANGE, 200MA = GREEN before trend analysis 3. ✓ Latest Data Trend Analysis: Step 4.1.5 was thoroughly completed - the most recent 3-5 data points were analyzed to determine CURRENT trend direction 4. ✓ Trend Direction Accuracy: The stated 8MA slope (Rising/Falling/Flat) accurately reflects the RIGHTMOST data points, not historical movement 5. ✓ Cross-Check Completed: MANDATORY CROSS-CHECK questions were answered to confirm trend direction matches visual slope 6. ✓ Death/Golden Cross Check: If 8MA and 200MA are converging, explicitly identified whether death cross or golden cross is forming 7. ✓ Failed Reversal Check: If a trough was identified, explicitly verified whether the reversal sustained or failed by analyzing latest trajectory 8. ✓ Specific Values: All readings include specific percentages/levels, not vague descriptions 9. ✓ Signal Status: Clear identification of active signals (CONFIRMED BUY / DEVELOPING / FAILED / SELL / WAIT) 10. ✓ Strategy Alignment: Recommendations align with backtested strategies and confirmation requirements 11. ✓ Probabilities: Scenario probabilities sum to 100% 12. ✓ Actionable: Clear positioning recommendations for different trader types 13. ✓ Context: Historical comparison and reference to similar past situations 14. ✓ Risk Management: Invalidation levels and risk factors clearly stated

FINAL SANITY CHECK:

• [ ] If report claims "BUY signal" or "8MA rising", confirm this doesn't contradict user's chart showing death cross or downtrend
• [ ] If report claims "bullish", confirm there's no pink background shading or death cross visible
• [ ] If unsure about ANY trend direction, explicitly state uncertainty rather than guessing

Quality Standards

Objectivity Requirements

• Base all analysis strictly on observable chart data
• Do not incorporate external information (news, fundamentals) unless specifically relevant
• Use precise technical terminology consistently
• Distinguish clearly between factual observations and probabilistic forecasts
• Acknowledge uncertainty when signals are ambiguous

Completeness Requirements

• Address all relevant sections of the analysis template
• Provide specific numerical values for all key metrics
• Justify probability estimates with technical factors
• Include invalidation levels for each scenario
• Compare current readings to historical patterns visible on the charts

Clarity Requirements

• Write in professional, analytical English
• Use clear section headings and structure
• Present information in tables where appropriate
• Make recommendations specific and actionable
• Avoid jargon without explanation

Strategy Adherence Requirements

• Apply backtested strategy rules correctly
• Distinguish between strategic (Chart 1) and tactical (Chart 2) signals
• Provide clear position status (Long/Flat/Entering/Exiting)
• Include specific entry/exit levels when applicable
• Address risk management (stop losses, position sizing)

Common Analysis Errors and How to Avoid Them

Error 1: Confusing 8MA with 200MA

Symptom: Report claims 8MA is rising when it's actually the 200MA that's rising

Prevention:

• ALWAYS verify: 8MA = ORANGE, 200MA = GREEN
• Check line volatility: 8MA moves faster with more volatility
• If unsure, state: "Based on line color, I identify the [orange/green] line as [8MA/200MA]"

Error 2: Reading Historical Trends Instead of Current Direction

Symptom: Report describes what happened 1-2 months ago, not what's happening NOW

Prevention:

• Focus ONLY on rightmost 3-5 data points
• Explicitly write: "At the CURRENT rightmost edge, 8MA is at X% and is [rising/falling]"
• Ignore what happened in September if we're analyzing November

Error 3: Missing Death Cross or Golden Cross Formation

Symptom: Report is bullish when 8MA and 200MA are about to death cross (bearish)

Prevention:

• ALWAYS check: "Are 8MA and 200MA getting closer (converging) or further apart (diverging)?"
• If converging with 8MA above 200MA → Potential death cross → BEARISH
• If converging with 8MA below 200MA → Potential golden cross → BULLISH
• Explicitly state: "8MA is currently [above/below] 200MA, and they are [converging/diverging]"

Error 4: Ignoring Pink Background Shading

Symptom: Report claims bullish setup when chart shows pink downtrend background

Prevention:

• Check for pink shading at the rightmost edge
• Pink background = Downtrend period = Bearish conditions
• If pink shading present, report MUST acknowledge bearish conditions

Error 5: Claiming Reversal Too Early

Symptom: Report says "BUY signal confirmed" after only 1 week of increase

Prevention:

• Require 2-3 CONSECUTIVE weeks of 8MA increase for confirmation
• If only 1 week: Signal is "DEVELOPING", not "CONFIRMED"
• If 8MA rises then falls again: Signal is "FAILED", not valid

Example Usage Scenarios

Example 1: CSV-Only Analysis (No Charts)

User: "breadth分析して" (Analyze breadth)
[No chart images provided]

Breadth Analyst:
1. Executes fetch_breadth_csv.py to get latest CSV data
2. Reads breadth_chart_methodology.md
3. Analyzes CSV data:
   - 200MA: 62.26% (healthy)
   - 8MA: 67.56% (healthy_bullish)
   - 8MA vs 200MA: +5.30pt (NO dead cross)
   - Uptrend Ratio: 33.03% GREEN (neutral_bullish)
   - Sector summary with overbought/oversold sectors
4. Assesses market regime based on CSV values
5. Generates report: breadth_combined_analysis_2026-03-16.md

Example 2: Strategic Breadth Analysis (Chart 1 Only)

User: "Please analyze this S&P 500 breadth chart and tell me where we are in the market cycle."
[Provides Chart 1 image: 200MA Breadth Index]

Breadth Analyst (thinking in English):
1. Executes CSV fetch for authoritative numerical values
2. Confirms receipt of Chart 1 (200MA-based breadth index)
3. Reads breadth_chart_methodology.md for Chart 1 guidance
4. Two-stage analysis: full chart → right edge extraction
5. Cross-checks CSV values with chart readings
6. Generates comprehensive report in English

Example 3: Combined Strategic + Tactical Analysis (Both Charts)

User: "Analyze both of these breadth charts and give me your overall market view."
[Provides both Chart 1 and Chart 2 images]

Breadth Analyst (thinking in English):
1. Executes CSV fetch as PRIMARY source
2. Confirms receipt of both charts
3. Reads full breadth_chart_methodology.md
4. Two-stage analysis for each chart
5. Cross-checks all values against CSV data
6. Combined assessment and unified recommendation
7. Generates comprehensive combined report

Resources

This skill includes the following bundled resources:

references/breadth_chart_methodology.md

Comprehensive methodology covering:

• Chart 1 (200MA Breadth): Components, interpretation, market regimes, backtested strategy, analysis checklist
• Chart 2 (Uptrend Ratio): Components, interpretation, market conditions, swing trading strategy, analysis checklist
• Combined Analysis: Alignment scenarios, integrated decision-making
• Common Pitfalls: Mistakes to avoid for each chart type

Usage: Read this file before conducting any breadth chart analysis to ensure systematic, accurate interpretation.

assets/breadth_analysis_template.md

Structured template for breadth analysis reports in English.

Usage: Use this template structure for every analysis report.

assets/SP500_Breadth_Index_200MA_8MA.jpeg

Sample Chart 1 image for format reference.

assets/US_Stock_Market_Uptrend_Ratio.jpeg

Sample Chart 2 image for format reference.

scripts/fetch_breadth_csv.py

PRIMARY data source. Fetches market breadth, uptrend ratio, and sector summary data from public CSV sources. Uses only stdlib (urllib + csv) -- no external dependencies.

python3 skills/breadth-chart-analyst/scripts/fetch_breadth_csv.py        # Human-readable
python3 skills/breadth-chart-analyst/scripts/fetch_breadth_csv.py --json  # JSON output

scripts/extract_chart_right_edge.py

Extracts the rightmost portion of chart images to help focus on latest data points. Requires PIL/Pillow.

python3 skills/breadth-chart-analyst/scripts/extract_chart_right_edge.py <image_path> --percent 25

scripts/detect_uptrend_ratio.py (DEPRECATED)

OpenCV-based uptrend ratio detection. Superseded by CSV fetch. Requires opencv-python + numpy.

scripts/detect_breadth_values.py (DEPRECATED)

OpenCV-based breadth value detection. Superseded by CSV fetch. Requires opencv-python + numpy.

Special Notes

Language Requirement

CRITICAL: All analysis, thinking, and output MUST be in English. This includes:

• Internal analysis and reasoning
• Report generation
• Tables and data presentation
• Scenario descriptions
• Recommendations

Do not translate or use any other language. The user expects English output exclusively.

Strategy Focus

This skill emphasizes backtested, systematic strategies rather than discretionary interpretation. Always:

• Apply the strategy rules as documented
• Reference historical performance patterns
• Provide specific entry/exit criteria
• Include risk management guidance

Practical Application

The goal is actionable intelligence. Every analysis should answer:

• Strategic: Should I be long, flat, or short the market over the medium term?
• Tactical: Should I enter or exit positions in the short term?
• Timing: When should I act, and at what levels?
• Risk: What would invalidate this view, and where should stops be?

Market Breadth Analysis Report

Analysis Date: [YYYY-MM-DD] Analyst: Claude Breadth Chart Specialist Charts Analyzed: [Chart 1 only / Chart 2 only / Both Charts]

---

Executive Summary

[Brief 2-4 sentence overview of the key findings from the breadth analysis]

Strategic Outlook: [Bullish / Bearish / Neutral] Tactical Outlook: [Bullish / Bearish / Neutral] Overall Recommendation: [Aggressive Long / Moderate Long / Neutral / Defensive / Short]

---

Chart 1: S&P 500 Breadth Index (200-Day MA Based)

Current Readings

Date of Latest Data: [Latest date visible on chart]

Key Metrics

Trend Direction

• 8MA Slope: [Rising / Falling / Flat] - [Brief description of trajectory]
• 200MA Slope: [Rising / Falling / Flat] - [Brief description of trajectory]
• Trend Alignment: [Both Rising / Both Falling / Diverging / Mixed]

Latest Data Point Trend Analysis (CRITICAL)

Focus: Rightmost 3-5 Data Points

8MA Recent Trajectory (Week-by-Week from trough/recent period to present):

• Current Level (Week 0): [XX%]
• 1 Week Ago (Week -1): [XX%] - Change: [+/-XX%]
• 2 Weeks Ago (Week -2): [XX%] - Change: [+/-XX%]
• 3 Weeks Ago (Week -3): [XX%] - Change: [+/-XX%]

Consecutive Period Analysis:

• Consecutive Increases: [X periods]
• Consecutive Decreases: [X periods]
• Current Momentum: [Accelerating Up / Steady Up / Decelerating / Turning Down / Falling]

CURRENT Slope Determination (based on latest edge):

• [ ] Rising: Latest value higher than previous 2-3 points with upward curvature
• [ ] Falling: Latest value lower than previous 2-3 points with downward curvature
• [ ] Flat: Latest value approximately equal to previous points (±2-3%)

Failed Reversal Check (if trough recently formed):

• [ ] Has 8MA rolled over after initial bounce?
• [ ] Has 8MA declined for 1-2+ consecutive periods after rising?
• [ ] Has 8MA failed to reach 55-60% before turning down?

Conclusion: The 8MA is [CURRENTLY RISING / CURRENTLY FALLING / FLAT] based on the rightmost data points.

Signal Status

Recent Signal Markers

8MA Troughs (Purple ▼):

• Most Recent: [Date] at [XX%]
• Status: [X days/weeks since trough]
• Reversal Confirmed: [Yes / No / Developing]

200MA Troughs (Blue ▼):

• Most Recent: [Date] at [XX%]
• Significance: [Major cycle low / Historical context]

200MA Peaks (Red ▲):

• Most Recent: [Date] at [XX%]
• Status: [X days/weeks since peak]
• Implications: [Exit signal active / Historical peak]

Active Signals

Current Strategy Signal: [CONFIRMED BUY / DEVELOPING BUY / FAILED REVERSAL / SELL / HOLD / WAIT]

Signal Classification:

• CONFIRMED BUY: Trough formed + 2-3 consecutive increases + CURRENTLY rising → ENTER LONG
• DEVELOPING BUY: Trough formed + < 2 consecutive increases → WAIT, MONITOR
• FAILED REVERSAL: Trough formed + initially rose + now declining → DO NOT ENTER
• SELL: 200MA peak formed → EXIT LONG
• HOLD: Already long, no exit signal → MAINTAIN POSITION
• WAIT: No trough, or waiting for new trough after failed reversal → STAY FLAT

[Detailed explanation of why this signal status is assigned, including specific reference to Latest Data Point Trend Analysis findings]

Market Regime Assessment

Current Regime: [Healthy Bull Market / Overheated Bull Market / Market Top/Distribution / Bear Market/Correction / Capitulation/Extreme Oversold / Early Recovery]

Regime Characteristics

[Detailed description of the current market regime, including:]

• Key observations supporting this classification
• How current readings align with historical patterns
• Typical duration and behavior in this regime

Supporting Evidence

1. [First piece of evidence] 2. [Second piece of evidence] 3. [Third piece of evidence]

Historical Context

Comparison to Previous Cycles

[Analysis comparing current readings to previous similar situations shown on the chart]

Similar Historical Periods:

• [Date Range 1]: [Brief description and outcome]
• [Date Range 2]: [Brief description and outcome]
• [Date Range 3]: [Brief description and outcome]

Distance from Extremes

• Time Since Last 8MA Trough: [X weeks/months]
• Time Since Last 200MA Peak: [X weeks/months]
• Current Reading vs Historical Average: [Above/Below by XX%]

Strategy Implications

Backtested Strategy Positioning

Current Position: [Long / Flat / Preparing to Enter / Preparing to Exit]

Entry Analysis

Entry Signal Status: [Active / Not Active / Pending]

[If active or pending:]

• Entry Trigger: [Description of what triggered or would trigger entry]
• Confirmation Criteria: [What needs to happen for confirmation]
• Optimal Entry Zone: [Price/breadth level range]
• Entry Timing: [Immediate / Wait for X / Already entered]

[If not active:]

• What Would Trigger Entry: [Specific conditions needed]
• Estimated Distance to Entry: [How far from entry conditions]

Exit Analysis

Exit Signal Status: [Active / Not Active / Monitoring]

[If active or monitoring:]

• Exit Trigger: [Description of what triggered or would trigger exit]
• Key Level to Watch: [Specific breadth level or 200MA behavior]
• Exit Timing: [Immediate / Prepare to exit / Not yet]

[If not active:]

• What Would Trigger Exit: [Specific conditions needed]
• Estimated Distance to Exit: [How far from exit conditions]

Risk Management

Current Risk Level: [Low / Moderate / High / Extreme]

Risk Factors:

• [Risk factor 1]
• [Risk factor 2]
• [Risk factor 3]

Invalidation Levels:

• Bullish Case Invalidation: [Specific level or condition]
• Bearish Case Invalidation: [Specific level or condition]

Key Levels to Monitor

Critical Thresholds

1. [Level 1]: [Description and significance] 2. [Level 2]: [Description and significance] 3. [Level 3]: [Description and significance]

Upcoming Milestones

• Near-term (Next 1-2 weeks): [What to watch for]
• Medium-term (Next 1-2 months): [What to watch for]
• Long-term (Next 3-6 months): [What to watch for]

Scenario Analysis

Base Case Scenario: [Title] - [XX]% Probability

Description: [What this scenario entails]

Supporting Factors:

• [Factor 1]
• [Factor 2]
• [Factor 3]

Implications:

• Strategy Position: [Long/Flat/Short]
• Expected Duration: [Timeframe]
• Key Levels: [Targets or invalidation levels]

---

Alternative Scenario: [Title] - [XX]% Probability

Description: [What this scenario entails]

Supporting Factors:

• [Factor 1]
• [Factor 2]

Implications:

• Strategy Position: [Long/Flat/Short]
• Expected Duration: [Timeframe]
• Key Levels: [Targets or invalidation levels]

---

Chart 2: US Stock Market - Uptrend Stock Ratio

Current Readings

Date of Latest Data: [Latest date visible on chart]

Key Metrics

Trend Direction

• Ratio Slope: [Rising / Falling / Flat] - [Brief description of trajectory]
• Trend Duration: [X days/weeks] in current [Green/Red] phase
• Momentum: [Accelerating / Decelerating / Steady]

Signal Status

Recent Trend Transitions

Most Recent Red-to-Green Transition (Downtrend to Uptrend):

• Date: [Date]
• Ratio at Transition: [XX%]
• Days Since Transition: [X days]
• Performance Since: [Result if applicable]

Most Recent Green-to-Red Transition (Uptrend to Downtrend):

• Date: [Date]
• Ratio at Transition: [XX%]
• Days Since Transition: [X days]
• Performance Since: [Result if applicable]

Active Signals

Current Trading Signal: [ENTER LONG / EXIT LONG / HOLD LONG / STAY FLAT / PREPARE TO ENTER]

[Detailed explanation of why this signal is active]

Market Condition Assessment

Current Condition: [Extreme Oversold / Moderate Bearish / Neutral/Transitional / Moderate Bullish / Extreme Overbought]

Condition Characteristics

[Detailed description of the current market condition, including:]

• Participation breadth analysis
• Short-term momentum assessment
• Risk/reward considerations at current levels

Supporting Evidence

1. [First piece of evidence] 2. [Second piece of evidence] 3. [Third piece of evidence]

Historical Context

Comparison to Recent Extremes

Recent Oversold Extremes (<15%):

• [Date]: [Ratio %] - [Outcome]
• [Date]: [Ratio %] - [Outcome]

Recent Overbought Extremes (>35%):

• [Date]: [Ratio %] - [Outcome]
• [Date]: [Ratio %] - [Outcome]

Typical Behavior at Current Level

[Analysis of how the market typically behaves when the ratio is at the current level]

Trading Strategy Implications

Swing Trading Strategy Positioning

Current Position: [Long / Flat / Preparing to Enter / Preparing to Exit]

Entry Analysis

Entry Signal Status: [Active / Not Active / Pending Confirmation]

[If active or pending:]

• Entry Trigger: [Red-to-green transition / Oversold reversal / etc.]
• Confirmation Status: [Confirmed / Needs X more days / Partial confirmation]
• Optimal Entry Level: [Current / Wait for ratio to reach X%]
• Entry Timing: [Immediate / Next X days / Already entered]
• Risk/Reward: [Assessment of risk/reward at current or pending entry]

[If not active:]

• What Would Trigger Entry: [Specific color change or level needed]
• Current Phase: [Waiting for oversold / Mid-trend / Overbought]

Exit Analysis

Exit Signal Status: [Active / Not Active / Monitoring / Tighten Stops]

[If active or monitoring:]

• Exit Trigger: [Green-to-red transition / Overbought level / etc.]
• Exit Timing: [Immediate / When ratio reaches X% / When color changes]
• Profit Status: [Up X% from entry / Down / Flat]

[If not active:]

• What Would Trigger Exit: [Specific color change or level needed]
• Current Phase: [Early in trend / Mid-trend / Late in trend]

Position Sizing Recommendations

Suggested Position Size: [Full / 75% / 50% / 25% / Minimal / Zero]

Rationale: [Explanation based on current ratio level, trend status, and risk/reward]

Risk Management

Current Risk Level: [Low / Moderate / High / Extreme]

Risk Factors:

• [Risk factor 1]
• [Risk factor 2]
• [Risk factor 3]

Stop Loss Level: [Specific ratio level or condition]

Profit Target: [Specific ratio level or condition]

Key Levels to Monitor

Critical Thresholds

1. 10% Level (Oversold Bottom): [Distance from current, significance] 2. 40% Level (Overbought Top): [Distance from current, significance] 3. [Other Key Level]: [Description and significance]

Timing Considerations

• Short-term (Next few days): [What to watch for]
• Swing Trade Horizon (Next 1-3 weeks): [Expected development]

Scenario Analysis

Scenario 1: [Title] - [XX]% Probability

Description: [What this scenario entails]

Supporting Factors:

• [Factor 1]
• [Factor 2]

Implications:

• Trading Action: [Enter/Hold/Exit]
• Expected Ratio Movement: [Direction and potential range]
• Timeframe: [Days to weeks]

---

Scenario 2: [Title] - [XX]% Probability

Description: [What this scenario entails]

Supporting Factors:

• [Factor 1]
• [Factor 2]

Implications:

• Trading Action: [Enter/Hold/Exit]
• Expected Ratio Movement: [Direction and potential range]
• Timeframe: [Days to weeks]

---

Combined Analysis: Strategic & Tactical Integration

[This section is included when both charts are analyzed together]

Alignment Assessment

Current Positioning Matrix

Scenario Classification

Current Scenario: [Scenario 1 / Scenario 2 / Scenario 3 / Scenario 4]

Scenario 1: Both Bullish

• Chart 1: [Status]
• Chart 2: [Status]
• Combined Implication: [Maximum bullish / Strategic opportunity]

Scenario 2: Strategic Bullish, Tactical Bearish

• Chart 1: [Status]
• Chart 2: [Status]
• Combined Implication: [Hold core, wait for tactical entry]

Scenario 3: Strategic Bearish, Tactical Bullish

• Chart 1: [Status]
• Chart 2: [Status]
• Combined Implication: [Short-term trade only, tight stops]

Scenario 4: Both Bearish

• Chart 1: [Status]
• Chart 2: [Status]
• Combined Implication: [Defensive positioning]

Unified Recommendation

Overall Market Assessment

Strategic Stance (3-12+ months): [Bullish / Bearish / Neutral]

Tactical Stance (Days to weeks): [Bullish / Bearish / Neutral]

Conviction Level: [High / Medium / Low]

Recommended Actions

For Long-Term Investors: 1. [Action 1 based on Chart 1] 2. [Action 2 based on Chart 1] 3. [Action 3 - position sizing]

For Swing Traders: 1. [Action 1 based on Chart 2] 2. [Action 2 based on Chart 2] 3. [Action 3 - timing and entry/exit levels]

For Active Tactical Traders: 1. [Action 1 combining both charts] 2. [Action 2 - nimble positioning] 3. [Action 3 - risk management]

Optimal Strategy

Current Market Environment Best Suited For: [Strategic positioning / Tactical trading / Both / Neither - stay flat]

[Detailed explanation of why this is the optimal approach given the current breadth readings]

Risk and Opportunity Matrix

Primary Opportunities

1. [Opportunity 1]: [Description and how to capitalize] 2. [Opportunity 2]: [Description and how to capitalize]

Primary Risks

1. [Risk 1]: [Description and how to mitigate] 2. [Risk 2]: [Description and how to mitigate]

Conflicts and Considerations

Chart Divergences

[If there are conflicts between Chart 1 and Chart 2 signals:]

Divergence Identified: [Description of the conflict]

Resolution: [How to interpret and act on the divergence]

Precedence: [Which chart takes priority in this situation and why]

---

Summary and Conclusion

Key Takeaways

1. [Most Important Finding]: [Brief explanation] 2. [Second Most Important Finding]: [Brief explanation] 3. [Third Most Important Finding]: [Brief explanation]

Action Items

Immediate Actions (Now):

• [ ] [Action item 1]
• [ ] [Action item 2]

Pending Actions (Contingent on market movement):

• [ ] If [condition], then [action]
• [ ] If [condition], then [action]

Monitoring Plan

Daily Monitoring Required: [Yes / No]

Key Updates to Watch For: 1. [Update 1 - e.g., new 8MA trough formation] 2. [Update 2 - e.g., color transition in Chart 2] 3. [Update 3 - e.g., breach of key threshold]

Next Analysis Recommended: [Timeframe - daily / every 3 days / weekly]

Confidence and Limitations

Analysis Confidence Level: [High / Medium / Low]

Reasoning for Confidence Level: [Explanation]

Limitations and Caveats:

• [Limitation 1 - e.g., signals work best in trending markets]
• [Limitation 2 - e.g., external shocks can override technical signals]
• [Limitation 3 - e.g., breadth lags price in fast-moving conditions]

---

Disclaimer

This analysis is based purely on market breadth technical indicators and does not consider fundamental factors, macroeconomic data, geopolitical events, or other external factors that may influence market behavior. The strategies referenced are based on historical backtesting and may not perform identically in future market conditions. This analysis represents a probabilistic assessment of potential scenarios and is not a guarantee of future performance or a recommendation to buy or sell securities.

All probabilities are estimates based on technical factors and historical patterns, and are subject to change as new data emerges.

---

End of Breadth Analysis Report

---

Appendix: Chart Images

[If chart images are to be included in the report]

Chart 1: S&P 500 Breadth Index

[Chart image or reference]

Chart 2: Uptrend Stock Ratio

[Chart image or reference]

Breadth Chart Analysis Methodology

This reference provides comprehensive methodology for analyzing two types of market breadth charts that provide complementary views of market health and trend status.

Overview

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:

1. 200MA-Based Breadth Index: Medium to long-term trend assessment tool 2. Uptrend Stock Ratio: Short-term trend and momentum indicator

These two charts work together to provide both strategic (medium/long-term) and tactical (short-term) market perspectives.

---

Chart 1: S&P 500 Breadth Index (200-Day MA Based)

Purpose and Use Case

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.

Chart Components

Primary Lines

8-Day Moving Average (8MA) - Orange Line

• Short-term smoothing of the breadth index
• More responsive to rapid market changes
• Key for identifying reversal points
• Used as the primary signal generator for entries

200-Day Moving Average (200MA) - Green Line

• Long-term trend of market breadth
• Slower to respond, filters out noise
• Represents the underlying structural health of the market
• Used as the primary signal generator for exits

Reference Levels

Red Dashed Line (0.73 / 73%)

• Average Peak Level: Historical average of 200MA tops
• Significance: When the breadth index exceeds this level, the market is in an overheated state
• Interpretation:
• Above 73%: Market is extremely bullish but approaching exhaustion
• Significantly above 73%: Elevated risk of correction or consolidation
• Rarely sustainable for extended periods

Blue Dashed Line (0.23 / 23%)

• Average 8MA Trough Level: Historical average of 8MA bottoms
• Significance: When the 8MA falls below this level, the market is in extreme oversold territory
• Interpretation:
• Below 23%: Severe market stress, capitulation-level selling
• High probability of reversal and recovery
• Historically represents excellent buying opportunities
• Extreme fear and pessimism typically present

Signal Markers (Triangles)

Purple/Magenta Downward Triangles (▼)

• 8MA Troughs: Mark the bottoms of the 8-day moving average
• Significance: Potential reversal points, especially when near or below the 23% threshold
• Use: Primary buy signal when 8MA begins to turn up from a trough

Blue Downward Triangles (▼)

• 200MA Troughs: Mark the bottoms of the 200-day moving average
• Significance: Major market cycle lows, extremely rare
• Use: Indicates the beginning of a new long-term bull market

Red Upward Triangles (▲)

• 200MA Peaks: Mark the tops of the 200-day moving average
• Significance: Major market cycle highs indicating trend exhaustion
• Use: Primary sell signal for the tested strategy

Background Shading

Pink Background Regions

• Downtrend Periods: Time periods when the market is in a confirmed downtrend
• Significance: Higher risk environment, defensive positioning warranted
• Use: Visual aid to identify unfavorable market conditions

Interpretation Framework

Market Regimes

Healthy Bull Market

• 8MA and 200MA both rising
• Breadth index between 40% and 73%
• Regular pullbacks to 50-60% range that hold above 8MA
• Wide participation across stocks

Overheated Bull Market

• Breadth index persistently above 73%
• 8MA and 200MA both very elevated
• High risk of near-term correction
• Market vulnerable to negative catalysts

Market Top/Distribution Phase

• 200MA forming a peak (red ▲)
• 8MA begins to roll over even if 200MA hasn't peaked yet
• Breadth index declining from elevated levels
• Signal to exit long positions

Bear Market/Correction

• Both 8MA and 200MA declining
• Pink background shading present
• Breadth index below 50%
• High volatility typical

Capitulation/Extreme Oversold

• 8MA below 23% (blue dashed line)
• 8MA forming a trough (purple ▼)
• Maximum pessimism and fear
• Historically excellent buying opportunities

Early Recovery

• 8MA turning up from a trough
• 200MA may still be declining (lagging)
• Breadth index beginning to rise from extreme lows
• Initial phase of new uptrend

Backtested Strategy

Based on historical analysis, the following strategy has demonstrated strong performance:

Entry Rules

BUY Signal: 8MA Trough Reversal

• Wait for 8MA to form a clear bottom (purple ▼)
• Especially strong when 8MA trough is below 23% (extreme oversold)
• Enter long position in S&P 500 index when 8MA begins to turn upward
• Confirmation: 8MA crosses above previous recent high or shows 2-3 consecutive days of increase

Detailed Reversal Confirmation Criteria

CRITICAL: Do not enter prematurely. A trough formation alone is NOT sufficient for entry. The reversal must be CONFIRMED.

Required Steps for Confirmation:

1. Trough Identification (Step 1):

• 8MA forms a clear bottom marked by purple ▼ triangle
• Trough level should ideally be below 40%, preferably below 30%
• Extreme troughs below 23% provide highest probability setups

2. Initial Reversal (Step 2):

• 8MA begins to move upward from the trough
• First 1-2 periods of increase observed
• WARNING: This is NOT yet a confirmed signal - DO NOT ENTER

3. Confirmation Period (Step 3 - MANDATORY):

• 8MA continues to rise for 2-3 CONSECUTIVE periods after the trough
• Each period should show clear upward progress (at least 2-5% increase)
• No significant pullbacks or reversals during confirmation period

4. Latest Data Verification (Step 4 - CRITICAL):

• Analyze the RIGHTMOST 3-5 data points on the chart
• Verify that the 8MA is CURRENTLY rising (at the latest edge of the chart)
• Confirm no rollover or downward turn has occurred recently
• This step prevents entry on failed reversals

5. Resistance Breakout (Step 5 - Optional but Ideal):

• 8MA crosses above 55-60% level
• This confirms strong breadth improvement
• Provides higher confidence in sustainability

Confirmation Status Classification:

• CONFIRMED (Green Light): Steps 1-4 complete, 8MA rising for 2-3+ consecutive periods and CURRENTLY rising → ENTER
• DEVELOPING (Yellow Light): Steps 1-2 complete, but < 2 consecutive increases → WAIT, MONITOR CLOSELY
• FAILED (Red Light): Steps 1-2 occurred, but 8MA has rolled over and is declining → DO NOT ENTER, signal invalidated
• NO SIGNAL (Red Light): No trough formed → WAIT

Time-Based Confirmation:

• Typical confirmation period: 2-4 weeks after trough
• If confirmation takes > 6 weeks, signal strength decreases
• If 8MA fails to reach 55% within 6 weeks of trough, reassess validity

Failed Reversal Patterns (WARNING SIGNS)

What is a Failed Reversal?

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.

Identifying Failed Reversals:

1. Weak Bounce Pattern:

• 8MA rises for only 1-2 periods after trough
• 8MA fails to reach 50-55% level
• 8MA then turns downward again
• Result: False signal, do NOT enter

2. Premature Rollover:

• 8MA rises to 50-60% range
• 8MA fails to sustain the rise, begins declining
• 8MA shows consistent downward trajectory at latest data points
• Result: Reversal failed, exit if already entered or do not enter

3. Double Bottom Formation:

• First trough forms, 8MA rises briefly
• 8MA declines to form second, lower trough
• Result: First trough was not the final bottom, wait for second trough to confirm

Failed Reversal Action Protocol:

• Immediately classify signal as INVALID
• Do NOT enter position
• Wait for 8MA to form a NEW, LOWER trough (often below 23%)
• Reset analysis and wait for fresh confirmation from the new trough

Historical Failed Reversal Examples (refer to chart):

• Failed reversals are less common but occur during severe corrections
• They typically precede deeper declines to extreme oversold (<23%)
• After failed reversal, the eventual confirmed reversal from lower levels often provides excellent entries

Latest Data Point Analysis Protocol

Why Latest Data Points Matter Most:

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.

Protocol:

1. Always Start with the Rightmost Data Point:

• This is the absolute latest reading
• This determines the CURRENT slope of the 8MA

2. Trace Backward 3-5 Data Points:

• Compare current level to 1 week ago
• Compare current level to 2 weeks ago
• Compare current level to 3 weeks ago
• Determine if the trend is: Rising, Falling, or Flat

3. Calculate Consecutive Periods:

• Count how many consecutive periods 8MA has risen
• Count how many consecutive periods 8MA has fallen
• Confirmation requires 2-3 consecutive UP periods
• 1-2 consecutive DOWN periods after a trough = failed reversal warning

4. Visual Slope Assessment:

• Visually trace the 8MA line at the rightmost edge
• Is the line sloping UP, DOWN, or FLAT?
• Do NOT rely on earlier parts of the chart - focus on the edge

Example Analysis:

Scenario: 8MA formed trough at 30% three weeks ago

Week-by-Week Analysis (from trough to present):
- Week 1 after trough: 30% → 40% (UP 10%)
- Week 2 after trough: 40% → 52% (UP 12%)
- Week 3 after trough: 52% → 48% (DOWN 4%)

Current Slope: FALLING
Consecutive Increases: 0 (last period was DOWN)
Status: FAILED REVERSAL - 8MA rolled over after initial bounce

Action: DO NOT ENTER. Signal is invalid. Wait for new trough formation.

Scenario: 8MA formed trough at 25% four weeks ago

Week-by-Week Analysis (from trough to present):
- Week 1 after trough: 25% → 35% (UP 10%)
- Week 2 after trough: 35% → 45% (UP 10%)
- Week 3 after trough: 45% → 55% (UP 10%)
- Week 4 after trough: 55% → 60% (UP 5%)

Current Slope: RISING
Consecutive Increases: 4 (all periods UP)
Status: CONFIRMED - Strong sustained reversal

Action: ENTER LONG. Signal is confirmed and robust.

Exit Rules

SELL Signal: 200MA Peak Detection

• Exit long position when 200MA forms a peak (red ▲)
• 200MA peaks typically occur when breadth index is near or above 73%
• Do not wait for 200MA to turn down; exit at or near the peak
• This signals the end of the bull market phase

Risk Management

• Stop Loss: Consider exiting if 8MA breaks decisively below its most recent trough
• Partial Profits: Consider taking partial profits when breadth index exceeds 73% (overheated)
• Re-entry: Do not re-enter during the same cycle unless a new 8MA trough forms

Strategy Performance Characteristics

• Win Rate: Historically high due to buying extreme oversold and selling into strength
• Hold Period: Typically several months to over a year
• Drawdown Management: Strategy avoids holding through major bear markets
• False Signals: Rare due to the significant smoothing of the indicators

Analysis Checklist

When analyzing this chart, systematically evaluate:

1. ✓ Current 8MA Level: Where is the 8MA relative to historical troughs and the 23% threshold? 2. ✓ Current 200MA Level: Where is the 200MA relative to historical peaks and the 73% threshold? 3. ✓ 8MA Slope: Is the 8MA rising, falling, or flat? 4. ✓ 200MA Slope: Is the 200MA rising, falling, or flat? 5. ✓ Recent Signal Markers: Any recent triangles indicating troughs or peaks? 6. ✓ Market Regime: Which regime best describes the current state? 7. ✓ Strategy Position: Based on the backtested strategy, should one be long, flat, or preparing to enter/exit? 8. ✓ Distance from Thresholds: How close is the breadth index to key levels (23%, 73%)?

---

Chart 2: US Stock Market - Uptrend Stock Ratio

Purpose and Use Case

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.

Definition of "Uptrend Stock"

A stock is classified as being in an uptrend when it meets ALL of the following criteria:

1. Price above 200-day MA: Stock is in a long-term uptrend 2. Price above 50-day MA: Stock is in an intermediate-term uptrend 3. Price above 20-day MA: Stock is in a short-term uptrend 4. Positive 1-month performance: Stock has gained value over the past month

This multi-factor definition ensures that only stocks with confirmed momentum across multiple timeframes are counted as "uptrend stocks."

Chart Components

Primary Visualization

Color-Coded Trend Identification

Green Regions

• Represent periods when the market is in an uptrend
• Uptrend stock ratio is generally rising
• Positive market momentum
• Favorable environment for long positions

Red Regions

• Represent periods when the market is in a downtrend
• Uptrend stock ratio is generally falling
• Negative market momentum
• Unfavorable for long positions, defensive posture appropriate

Color Transitions

• Red-to-Green Transition: Downtrend ending, uptrend beginning (BUY signal)
• Green-to-Red Transition: Uptrend ending, downtrend beginning (SELL signal)

Reference Levels

Lower Orange Dashed Line (~10%)

• Short-Term Market Bottom: When the uptrend ratio falls to approximately 10%
• Significance: Extreme oversold condition
• Interpretation:
• Below 10%: Maximum bearish sentiment, capitulation phase
• High probability of near-term reversal
• Short-term bottom often forms at this level
• Excellent risk/reward for initiating long positions

Upper Orange Dashed Line (~37-40%)

• Short-Term Market Top: When the uptrend ratio approaches approximately 40%
• Significance: Overbought condition, market overheating
• Interpretation:
• Near 40%: Market is short-term overbought
• High probability of pullback or consolidation
• Reversal often begins at this level
• Consider taking profits or tightening stops on long positions

Interpretation Framework

Market Conditions

Extreme Oversold (Ratio < 10%)

• Very few stocks participating in uptrend
• Market-wide selling pressure
• High fear and pessimism
• Contrarian buying opportunity
• Often coincides with VIX spikes
• Watch for red-to-green transition

Moderate Bearish (Ratio 10-20%)

• Below-average market participation
• Downtrend still in effect (red)
• Selective stock strength only
• Wait for confirmation before entering

Neutral/Transitional (Ratio 20-30%)

• Average market participation
• Can be either early uptrend or late downtrend
• Color (green vs red) is critical for context
• Watch for trend changes

Moderate Bullish (Ratio 30-37%)

• Healthy uptrend participation
• Green color dominant
• Sustainable momentum
• Favorable for long positions

Extreme Overbought (Ratio > 37-40%)

• Very high participation in uptrend
• Market short-term overheated
• Vulnerable to pullback
• Watch for green-to-red transition
• Consider profit-taking

Trend Transitions

Red-to-Green (Downtrend to Uptrend)

• Entry Signal: Marks the beginning of a new uptrend phase
• Characteristics:
• Uptrend ratio bottoms and begins to rise
• Often occurs from extreme oversold levels (<10-15%)
• Increasing number of stocks breaking above MAs
• Momentum shifting from bearish to bullish
• Action: Initiate long positions in index or strong individual stocks

Green-to-Red (Uptrend to Downtrend)

• Exit Signal: Marks the end of an uptrend phase
• Characteristics:
• Uptrend ratio peaks and begins to fall
• Often occurs from overbought levels (>35-40%)
• Stocks breaking below key moving averages
• Momentum shifting from bullish to bearish
• Action: Exit long positions, move to cash or defensive positions

Trading Strategy

Short-Term Swing Trading Strategy

Entry Rules

1. Wait for Oversold Condition:

• Uptrend ratio declines to 10-15% range
• Market in red (downtrend) phase

2. Identify Trend Reversal:

• Color changes from red to green
• Uptrend ratio begins to rise from lows
• Confirmation: 2-3 consecutive increases in the ratio

3. Enter Long Position:

• Buy S&P 500 index (SPY, ES futures) or basket of leading stocks
• Position size based on risk tolerance

Exit Rules

1. Watch for Overbought Condition:

• Uptrend ratio approaches 37-40% level
• Market has been green for extended period

2. Identify Trend Exhaustion:

• Color changes from green to red
• Uptrend ratio begins to fall from highs
• Momentum waning

3. Exit Long Position:

• Sell index position
• Move to cash or defensive assets

Risk Management

• Stop Loss: Exit if uptrend ratio breaks below recent lows while still in supposed uptrend
• Partial Exits: Consider scaling out as ratio approaches 35-37%
• Position Sizing: Larger positions when entering from extreme oversold (<10%), smaller when entering from moderate levels
• False Signals: Quick reversals (red-green-red or green-red-green within days) may be false; wait for confirmation

Strategy Performance Characteristics

• Timeframe: Days to weeks (swing trading)
• Win Rate: Moderate to high, depending on confirmation criteria
• Hold Period: Typically 1-4 weeks
• Best Performance: When entries align with extreme oversold conditions (<10%)
• Risk: Whipsaws during choppy, trendless markets

Combining Both Charts

For optimal decision-making, use both breadth charts together:

Strategic Positioning (Chart 1: 200MA Breadth)

• Determines overall market regime (bull, bear, neutral)
• Guides strategic asset allocation
• Identifies major entry/exit points for core positions
• Longer holding periods (months to year+)

Tactical Positioning (Chart 2: Uptrend Ratio)

• Determines short-term momentum and timing
• Guides tactical trades and position sizing
• Identifies short-term entry/exit points for swing trades
• Shorter holding periods (days to weeks)

Alignment Scenarios

Scenario 1: Both Bullish

• Chart 1: 8MA rising, 200MA rising or flat, breadth < 73%
• Chart 2: Green (uptrend), ratio rising from oversold
• Action: Maximum bullish stance, aggressive long positioning

Scenario 2: Strategic Bullish, Tactical Bearish

• Chart 1: 8MA rising, 200MA not yet peaked
• Chart 2: Red (downtrend), ratio elevated or falling
• Action: Hold core long positions, avoid new tactical longs, wait for oversold

Scenario 3: Strategic Bearish, Tactical Bullish

• Chart 1: 200MA peaked or declining
• Chart 2: Green (uptrend), ratio rising from extreme oversold
• Action: Short-term tactical longs only, tight stops, prepare for strategic exit

Scenario 4: Both Bearish

• Chart 1: Both MAs declining, pink background
• Chart 2: Red (downtrend), ratio falling
• Action: Defensive positioning, cash or short positions, wait for 8MA trough

Analysis Checklist for Chart 2

When analyzing the uptrend stock ratio chart, systematically evaluate:

1. ✓ Current Ratio Level: What is the current uptrend stock percentage? 2. ✓ Current Color: Is the market in green (uptrend) or red (downtrend)? 3. ✓ Proximity to Thresholds: How close is the ratio to 10% (bottom) or 40% (top)? 4. ✓ Trend Direction: Is the ratio rising, falling, or flat? 5. ✓ Recent Transitions: Any recent color changes from red-to-green or green-to-red? 6. ✓ Duration of Current Trend: How long has the current color phase lasted? 7. ✓ Strategy Position: Based on the swing trading strategy, should one be long, flat, or preparing to enter/exit? 8. ✓ Historical Context: How does the current reading compare to recent extremes?

---

Output Requirements

Language and Style

• Analysis Language: Conduct all thinking and analysis in English
• Output Format: Generate all reports in English using markdown format
• Tone: Professional, objective, analytical
• Terminology: Use precise technical terms consistently

Analysis Structure

Each breadth chart analysis report should include:

1. Current Readings: Specific values for all key metrics 2. Signal Status: Clear identification of any active signals (troughs, peaks, transitions) 3. Market Regime Assessment: Classification of the current market environment 4. Strategy Implications: Specific positioning recommendations based on the backtested strategies 5. Key Levels to Watch: Upcoming thresholds or levels that would change the analysis 6. Risk Considerations: Potential invalidation scenarios or alternative interpretations 7. Combined Analysis (when both charts analyzed): Integration of strategic and tactical perspectives

Objectivity Standards

• Base all analysis strictly on observable chart data
• Avoid incorporating external information (news, fundamentals) unless specifically relevant to breadth interpretation
• Clearly distinguish between factual observations and probabilistic forecasts
• Acknowledge uncertainty when signals are ambiguous
• Present both bullish and bearish scenarios when appropriate

---

Common Pitfalls to Avoid

Chart 1 (200MA Breadth) Pitfalls

• 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.

• 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.

• 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.

• 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.

• Ignoring Thresholds: Not recognizing significance of 23% and 73% levels. These thresholds provide critical context for entry and exit timing.

• Overtrading: Trying to trade every wiggle in the 8MA instead of waiting for clear, confirmed trough reversals. Patience is essential for this strategy.

Chart 2 (Uptrend Ratio) Pitfalls

• Chasing: Entering after the ratio has already risen substantially from oversold
• Ignoring Color: Focusing only on the ratio level without considering trend direction (color)
• False Breakouts: Not waiting for confirmation of color transitions
• Missing Extremes: Not recognizing when the ratio reaches <10% or >40%

General Pitfalls

• Analyzing in Isolation: Using only one chart without considering the other
• Over-Complicating: Adding too many additional indicators that cloud the core signals
• Recency Bias: Giving too much weight to the most recent move
• Ignoring Historical Context: Not comparing current readings to historical patterns shown on the charts