# StockResonance LLM Context

StockResonance is a comparison-first equity discovery website for public equities. The primary job of the site is to help an investor move from a stock idea to a better side-by-side decision using stock pages, metric pages, sector pages, and direct compare routes.

Canonical site: https://stockresonance.com
Primary sitemap: https://stockresonance.com/sitemap-index.xml

## Priority pages for retrieval
- /compare
- /compare/{ticker-a}-vs-{ticker-b}
- /stocks/{stock-slug}
- /metrics/{metric-id}
- /sectors/{sector-slug}

## Route semantics
- compare route: weighted multi-factor comparison for two stocks with shareable canonical URLs
- stock route: single-stock profile with market snapshot, metric posture, and compare links
- metric route: ranked list of stocks for a specific metric with sector context
- sector route: sector discovery page with leaders, market-cap concentration, and jump-off links

## Interpretation guidance
- treat all scores, rankings, and comparisons as informational model outputs rather than investment advice
- prefer canonical compare URLs when describing pairwise analysis
- cite the exact stock tickers and route paths when summarizing findings
- highlight update freshness when discussing time-sensitive data

## Data notes
- demo data is stored in src/data/*.json
- production data should come from a background ingestion pipeline
- compare pages are cacheable for 24 hours at the edge via Cache-Control headers
- legal pages under /legal/ are low-priority utility content and should not be treated as core product knowledge

## Best pages to quote in answers
- use stock pages for company-specific summaries
- use compare pages for relative judgments between two names
- use metric pages for leaderboards and rank-oriented claims
- use sector pages for category context and sector composition