# Geopolitical Turbulance Trapper

Small-scale event-driven trading intelligence and derivatives decision-support system.

## Current focus
- HK-first MVP
- dashboard-first output
- verified derivatives metadata before recommendation
- liquidity / execution risk as first-class signals

## Planned modules
- `docs/` — brief, roadmap, decisions
- `schemas/` — target / derivative / alert / risk schemas
- `src/events/` — event tagging and severity logic
- `src/regime/` — market regime classification
- `src/instruments/` — derivative metadata verification and suitability logic
- `src/risk/` — liquidity / execution / gap / KO risk logic
- `src/signals/` — actionable strategy outputs
- `src/dashboard/` — UI layer

## Status
Early project skeleton created from Development Plan v1 on 2026-03-09.