docs/hotspot/rules.md

# Hotspot Rules Layer

## Purpose

Rules define testable feature hypotheses. They are not permanent production
weights and they are not trading advice.

## Canonical Rule File

- `docs/ta_reference/institutional_hotspot_rules.md`

## Rule Families

### Institutional Flow Memory

- `flow_120d_accumulation`
- `flow_20d_acceleration`
- `foreign_20ma_support`
- `trust_10ma_support`
- `dealer_confirmation`

### Risk And Divergence

- `trust_10ma_break`
- `foreign_20ma_break`
- `flow_divergence_risk`
- `flow_distribution_risk`

### Price And Volume Context

- 20-day and 60-day momentum
- 5/20 volume surge
- average traded value
- MA20 and MA60 distance
- volatility penalty

## Implementation Rule

Every new rule should be implemented as an auditable metric or reason in the
hotspot payload first.  Only after no-lookahead validation passes should it be
allowed to affect production recommendation weighting.

## Current Code Anchors

- `services/hotspot_scanner_service.py`
- `data/institutional_flow_cache.py`
- `scripts/precompute_full_market_hotspots.py`