Convention file every new Claude session reads first when opening this
repo. Encodes the invariants that aren't visible from any single file:
- Five trading-layer non-negotiable rules (sys2 manage-only, released_at,
eff_* freezing, HL effective leverage, per-wallet locks).
- Module map with the input/output function of every service file.
- System 1 vs System 2 comparison table — the single most important
distinction in this codebase.
- /adopt flow walkthrough, including the race-protection points fixed in
7599d49.
- 8-point code-review checklist to run against any trading change.
- ADR for why sys2 became manage-only (v2.0).
- "Looks like a bug but isn't" + "Known issues not yet fixed" sections to
save the next AI agent from chasing ghosts or shipping regressions.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
k