Create geopolitical turbulence trapper project skeleton

projects/geopolitical-turbulance-trapper/docs/DERIVATIVES_VERIFICATION_WORKFLOW.md

@@ -0,0 +1,26 @@
+# Derivatives Verification Workflow
+
+Before any derivative is elevated from candidate to recommendation:
+
+1. Verify underlying-symbol mapping.
+2. Verify instrument type (CBBC, warrant, option, LEAP).
+3. Verify call/barrier/strike/expiry/ratio from a trusted source.
+4. Record issuer / venue.
+5. Record bid, ask, spread, volume, turnover, and outstanding when available.
+6. Mark verification status:
+   - `unverified`
+   - `partial`
+   - `verified`
+7. Do not present `unverified` products as high-confidence trade suggestions.
+
+## Extra checks for HK CBBC / warrants
+- KO/call buffer vs current underlying price
+- liquidity deterioration risk near barrier
+- outstanding concentration risk
+- likely spread behavior under fast markets
+
+## Extra checks for US options / LEAPS
+- IV level and term structure
+- theta decay
+- option volume / OI
+- earnings event proximity

projects/geopolitical-turbulance-trapper/docs/PROJECT_BRIEF.md

@@ -0,0 +1,26 @@
+# Project Brief
+
+## Goal
+Track geopolitical, macro, commodity, earnings, and market information across HK / US / AU focus markets and convert them into actionable derivatives trading support.
+
+## MVP
+HK-first:
+- HSI
+- HSTECH
+- Tencent
+- Alibaba
+- Xiaomi
+
+## Key outputs
+- market regime
+- derivative candidates
+- buy zone / danger zone / reduce zone
+- liquidity and execution risk review
+- dashboard alerts
+
+## Hard rules
+- facts before opinions
+- verify product metadata before recommendation
+- support bear as well as bull workflows
+- treat liquidity / outstanding / spread risk as first-class
+- AI explains; AI does not act as the facts source

projects/geopolitical-turbulance-trapper/docs/ROADMAP.md

@@ -0,0 +1,21 @@
+# Roadmap
+
+## Step 1
+- establish schemas
+- define HK-first target universe
+- formalize verification-first derivatives workflow
+
+## Step 2
+- build data-source adapters for price and macro snapshots
+- build derivative metadata ingestion/verification stubs
+
+## Step 3
+- implement regime and risk engine
+- define bear / bull / combo playbooks
+
+## Step 4
+- build dashboard MVP
+- add alerts for entry zone, danger zone, KO risk, and spread widening
+
+## Step 5
+- extend to US targets and options / LEAPS