Coding Rules

Language-Specific References

For language-specific rules, also read:

• TypeScript/React: references/typescript.md

Core Philosophy [MANDATORY]

1. Maintainability over Speed: Prioritize long-term code health
2. Simplicity First: YAGNI principle — simplest solution that meets requirements
3. Design Convergence: Deliver the current required outcome with the least new design surface. Add surface only to satisfy a current requirement, verified constraint, observed problem, or evidence-backed material risk; among sufficient options, choose the lowest-lifecycle-cost option.
4. Explicit over Implicit: Clear intentions through code structure and naming
5. Delete over Comment: Remove unused code instead of commenting it out

ENFORCEMENT: Every code change MUST align with these principles

Design Surface Terms [MANDATORY]