Breakout Trade Planner takes the JSON output of the VCP screener skill and applies a Minervini-style gate to every candidate. Candidates that pass get a trade plan with signal and worst-case entry prices, a stop below the last contraction low, a target in R-multiples and a position size based on worst-case risk.
The script checks account-level limits (single position size, sector exposure and total open risk) and writes a JSON file and a Markdown report. It runs offline on local files and does not place orders. The output is a planning aid and not investment advice.
What You Get
- A JSON plan and a Markdown report named with the decision timestamp
- Per candidate: signal entry, worst-case entry, stop, risk per share, target price and share count
- Two order templates per actionable plan: a stop-limit bracket to pre-place and a limit bracket for use after confirmation
- A summary of total risk, total position value and counts for each group
Common Use Cases
- Turning a day’s VCP screener results into sized plans
- Checking how much total open risk a set of candidates would add to a portfolio
- Seeing why a candidate was rejected, deferred or constrained
- Replaying a plan for a past date with the as-of option
What Makes It Unique
Sizing uses the worst-case entry price (pivot plus a chase allowance), so the stated risk per trade is the largest the plan allows. Candidates must pass a fixed gate: a valid VCP, a good, strong or textbook rating band and worst-case risk of no more than 8 percent. Breakout-state candidates also need breakout volume and a price within the chase limit. Plan validity follows the real exchange calendar, so a plan made after the close or on a holiday points to the next trading session.
Under The Hood
The agent runs a local Python script that reads the screener JSON, an optional exposure JSON and the command line settings, then writes a JSON file and a Markdown file into an output folder (reports/ by default), so it creates files on disk. It makes no network calls and needs no API keys; it needs the pandas-market-calendars package for the exchange calendar. The order templates are data in the report and are never sent to a broker.