exposure-coach

1# Exposure Coach
2 
3## Overview
4 
5Exposure Coach synthesizes outputs from market-breadth-analyzer, uptrend-analyzer, macro-regime-detector, market-top-detector, ftd-detector, theme-detector, sector-analyst, and institutional-flow-tracker into a unified control-plane decision. The skill answers the solo trader's core question: "How much capital should I commit to equities right now?" before any individual stock analysis begins.
6 
7## When to Use
8 
9- Before initiating any new stock positions to determine appropriate capital commitment
10- At the start of each trading week to calibrate portfolio exposure
11- When multiple market signals conflict and a unified posture is needed
12- After significant macro or market events to reassess exposure ceiling
13- When transitioning between market regimes (broadening, concentration, contraction)
14 
15## Prerequisites
16 
17- Python 3.9+
18- FMP API key (set `FMP_API_KEY` environment variable) for institutional-flow-tracker data
19- Input JSON files from upstream skills (see Workflow Step 1)
20- Standard library + `argparse`, `json`, `datetime`
21 
22## Workflow
23 
24### Step 1: Gather Upstream Skill Outputs
25 
26Collect the most recent JSON outputs from integrated skills. Each file provides a specific signal dimension:
27 
28| Skill | Output File Pattern | Signal Provided |
29|-------|---------------------|-----------------|
30| market-breadth-analyzer | `breadth_*.json` | Advance/decline ratios, new highs/lows |
31| uptrend-analyzer | `uptrend_*.json` | Uptrend participation percentage |
32…