ADR 003 Colocated Test Naming

Decision

Tests are colocated with the production module, schema, script, or component they verify.

• Python: module.py and module_test.py.
• TypeScript/Astro support: module.ts and module_test.ts.
• Do not add test_*.py, *.test.ts, *.spec.ts, or central __tests__ trees.
• Integration drivers remain beside their owning script or interface. A broad tests/ folder is migration debt, not a permanent exception.

Implementation Evidence

• Backend booking implementation and colocated test
• Latest stage cleanup test uses colocated suffix
• Contract booking types and colocated test
• Frontend Atomic UI and colocated tests
• Known backend integration-test debt

Consequences

Current tracked files use the *_test suffix. Three backend integration tests remain under a central tests/ tree, so full colocation is not yet complete.