breakout-trade-planner

1# Breakout Trade Planner
2 
3Generate trade plans from VCP screener output following Mark Minervini's breakout methodology. Calculate position sizes using worst-case entry prices, enforce portfolio risk limits, and output Alpaca API-compatible order templates.
4 
5## When to Use
6 
7- User has VCP screener JSON output and wants trade plans
8- User asks for breakout entry/stop/target calculation
9- User wants Alpaca order templates for VCP breakout candidates
10- User needs position sizing with portfolio heat management
11 
12## Prerequisites
13 
14- VCP screener JSON output with `schema_version: "1.0"`
15- No API keys required (works with local JSON files)
16- No external skill dependencies (position sizing is built-in)
17 
18## Workflow
19 
20### Step 1: Generate Trade Plans
21 
22Run the planner with VCP screener output:
23 
24```bash
25python3 skills/breakout-trade-planner/scripts/plan_breakout_trades.py \
26  --input reports/vcp_screener_YYYY-MM-DD.json \
27  --account-size 100000 \
28  --risk-pct 0.5 \
29  --output-dir reports/
30```
31 
32### Step 2: Review Output
33 
34Read the generated JSON and Markdown reports. Present:
35 
361. **Actionable Orders** — Pre-breakout candidates with order templates
372. **Revalidation** — Breakout-state candidates needing live confirmation
383. **Watchlist** — Developing VCP candidates to monitor
394. **Rejected/Deferred/Constrained** — Candidates filtered by Gate or portfolio limits
40### Step 3: Explain Trade Plans
41 
42For each actionable order, explain:
43- Entry levels (signal vs worst-case) and stop-loss placement
44…