The per-module unit-test recipe needs to document Zig option ordering. During #1092 validation, appending -OReleaseSafe or -fsanitize-thread after the final -Mgc declaration left the engine root in Debug without instrumentation. The resulting test passes did not qualify the intended engine mode.
Executed evidence: the unqualified engine artifact had no __tsan_init symbol. Repeating -fsanitize-thread before each module declaration produced a different engine artifact with __tsan_init and __tsan_read8 symbols; the 21-case group then passed without suppressions. Likewise, placing -OReleaseSafe before each declaration passed the same group in ReleaseSafe.
Definition of done:
- Clarify in CLAUDE.md that optimization and sanitizer options apply to the next module declaration, with a concrete correctly ordered engine-root example.
- Explain repeating flags for dependency modules and checking instrumentation before claiming a sanitizer pass.
- Land the operating-manual correction in a small conventional commit.