Normative summary for agents. The full rules are in ../architecture/boundaries.md; the map in ../architecture/overview.md.
Layers
engine (src/PC, C as C++) --exports--> bridge (src/compat) --C++ calls--> OpenCoD2-Plus Server (vendored)
^ |
+----------- imports ---------------+
blobs (original data) <- imp_ pointers <- engine
Must
- Cross engine ↔ OpenCoD2-Plus Server only through src/compat, with an interface entry (ABI-checked for the server and client modules).
- Keep one copy of each state per executable (test/plus_replaces.txt).
- Follow the 1.3 binaries; cite addresses.
- Reach cgs_t/cg_t fields by name.
Must not
- Edit a vendored file (test/vendored_files.txt).
- Grow an allowlist to hide a mismatch.
- Use the original binary's raw structure offsets.
- Commit personal data.
Irreversible decisions
| Decision | ADR |
| OpenCoD2-Plus Server vendored behind a generated bridge | 0001 |
| Engine compiled as C++ | 0002 |
| Original 1.3 binaries are the reference | 0006 |
All ADRs: ../architecture/adr/README.md.