# ringagent docs

Short design notes that sit on top of [PLAN.md](../PLAN.md) (the full
architecture + threat model). Read PLAN.md first; these are focused follow-ups.

- [cad-foundation.md](cad-foundation.md) — why we stay on the OpenCASCADE
  (CadQuery) kernel, what we borrow from build123d, and what the real upgrade is
  (an agent feedback loop, not a kernel swap).
- [diagnostics-spec.md](diagnostics-spec.md) — the `diagnostics.json` report the
  gate emits, partially adopted from build123d / cad-khana's diagnostics-first
  loop and mapped onto our existing `ringkit/gate.py` + `ringkit/casting.py`.