[XavierBeheydt]

Summary

A name tells its kind and its scope, so a diff reads right without an IDE (a review on GitHub or on a phone):

• kind prefixes: E enum, I interface, T type template parameter, k constant, b boolean;
• scope prefixes: m_ private/protected member, s_ static member, g_ global;
• PascalCase types, camelCase functions and values, AETHER_ macros, lower_case namespaces.

Files:

• docs/naming.md (new): the table and how to read it, one page for contributors and for engine users reading the API.
• .agents/instructions/style/cpp.md: points to it instead of its old two-rule line.
• .clang-tidy: readability-identifier-naming enforces every rule except the boolean b prefix (clang-tidy cannot select by type), which is left to review. The lowercase fixed-size aliases (i32, u8, f32, usize) and a lone T template parameter are allowed.

Verification

• clang-tidy reports nothing on the code already on dev (version.cpp, the core tests, types.hpp through them).
• On a throwaway file with good and bad names, it flags all 15 bad ones (abstract class without I, enum without E, file_, counter static member, globalCount, maxLights, BAD_MACRO, wrong-case functions, parameters, locals, namespace, template parameter...) and none of the good ones (EGood, ISinkOk, TValue, m_fileOk, m_bDirty, g_countOk, kMaxLightsOk).

Follow-ups

• feat(core): std::expected error handling #25 and feat(core): synchronous async-ready logger #27 are renamed to match (EErrorCode, ESeverity, ISink, m_file, TArgs...).
• docs/development.md (docs: avoid exceptions in engine code, and why #28) will link to docs/naming.md.
• CI runs clang-format, not clang-tidy, so the convention is checked locally only until a clang-tidy job exists.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JfRmXnowFEecvNmG9b9szy