Coding Standards

Global standards that apply to all projects and languages.

Single Source of Truth

Any value defined in one place and consumed in another should be referenced, not copied. Applies to versions, paths, URLs, schema constants, and configuration.

• If two files would need to be updated in lockstep, the second is a derived artifact — generate it, don't hand-maintain it.
• CI verification of two files agreeing is a smell: the right pattern is run-the-generator + git diff --exit-code, not parse-and-compare.
• Hand-maintained mirrors of canonical sources rot silently. The cost of a small generator is always lower than the cost of recurring drift bugs.

Before You Write