Code Quality

Must NOT Do

NEVER write comments (lint ignores allowed)
NEVER touch readonly/ui/ manually
NEVER use ! (non-null assertion), any, as any, @ts-ignore, @ts-expect-error
NEVER duplicate types — single source of truth
NEVER disable lint rules globally/per-directory — fix the code
NEVER ignore written source code from linters — only auto-generated code (_generated/, generated/, module_bindings/, readonly/ui/)
NEVER reduce lintmax strictness — if upstream removes rules, find replacements

Every piece of data flows through exactly one definition:

Shared constants → define once, import everywhere. If a value appears in 2+ files, extract it.
When adding new features, check existing utilities FIRST before writing inline logic.

Before writing any new code, verify:

Does this function already exist? Check existing utilities first
Is this constant defined elsewhere? Check shared files
Am I adding a wrapper div? Check if parent gap-*, space-* can handle it
Am I adding inline styles? Only allowed for truly dynamic values. NEVER for colors or static properties.
Am I copy-pasting from another file? Extract to a shared utility/component