risk-model

name	risk-model
description	Gate a proposed trade signal through hard risk limits and compute the position size those limits allow. Verdicts only ever say no or smaller — never more. Advisory only: it reports a size and never places, modifies, or manages orders.

Risk model: the gate

This skill does not find trades. It takes a signal some other skill proposed (for example an open-range-breakout evaluator), a snapshot of the account, and the user's hard limits, and returns a verdict: allowed, reduced, or blocked, with the lot size the limits permit and machine-readable reasons.

Use the bundled CLI as the source of truth. Never compute a position size in prose, and never present a size the CLI did not output.

Run it

1. Read references/input-format.md for the snapshot JSON shape.
2. Read references/account-snapshot.md for how to gather the snapshot fields with read-only broker tools.
3. Write one input JSON with an explicit as_of, then:

risk-assess --config risk.yaml --input snapshot.json --pretty

Interpret verdicts

• allowed — the signal fits every limit; size_lots is the largest size that keeps risk at or below risk_per_trade_pct, rounded down to the broker's lot step.
• reduced — a cap intervened (daily_budget_capped, max_lot_capped); the size is smaller than the per-trade risk would otherwise allow. Report the reason with it.
• blocked — a hard rule failed (daily_loss_limit_reached, max_trades_per_day_reached, max_concurrent_positions_reached, risk_budget_below_minimum_lot, missing_symbol_specs). Do not present the setup as tradeable; state the block and its reasons instead.

The reported risk.pct is the actual risk at the rounded size, which is always at or below the configured percentage. Always relay the budget block so the user can see how much daily risk budget remains.

Rules for the agent

• Never re-run with edited equity, P&L, or stop values to turn a blocked into an allowed. If the snapshot is wrong, re-gather it from the broker tools.
• Assess against a fresh snapshot every time. Taking a trade changes the account state, so yesterday's verdict — or five minutes ago's — is not today's.
• A blocked verdict is the answer, not an obstacle. There is deliberately no override flag anywhere in this skill.

Boundaries

• Advisory only. This skill computes and reports a size; it never places, modifies, or closes orders, and it never manages an open position.
• It bounds planned loss per trade and per day. It does not create an edge, does not improve expectancy, and does not make a losing strategy profitable.
• Slippage, gaps, and weekend holds can realize more than the planned risk. The gate bounds what you plan, not what the market does.
• News, holidays, spread, and correlation exposure remain separate checks that this evaluator does not perform.