# Solution and learning notes

These writeups capture implementation lessons that are useful outside the original development session.

## Public notes

- [Oracle design](oracle-design.md) — dual-purpose OCaml reference implementation for differential testing and correctness signaling.
- [ITCH replay learnings](itch-replay-learnings.md) — lessons from measuring parsing and order-book update performance on NASDAQ TotalView-ITCH data.
- [Portfolio simulator parity learnings](portfolio-sim-parity-learnings.md) — parity results and known differences against vectorbt for a cross-sectional momentum strategy.

Operational learning notes live in [../operations/](../operations/).

## Private notes intentionally excluded

Some local notes are intentionally not part of the public branch because they are planning scaffolds or require paper-live evidence before they can support public claims.
