Convex Architecture Documents

CADs are the normative specifications for Convex. Where the code and a CAD disagree, that is a bug in one of them — not a licence to pick either. Before changing behaviour in a specified area, read the governing CAD and say which one you relied on.

Read them at https://docs.convex.world/docs/cad/<slug> — the slug is the CAD directory name without its numeric prefix, e.g. CAD003 is https://docs.convex.world/docs/cad/encoding.

If the design repository is checked out alongside this one, the sources are in design/docs/cad/<nnn>_<slug>/index.md. Do not assume it is present.

Core Protocol