Rules Hub
Coding Rules Library
← Back to all rules
Rule priority, scope & exceptions
Use this to align rules with the senior-level structure (P0/P1/P2, scope, exceptions/tradeoffs).
fullstack ruleP2universalStack: universal
readabilitycommentsmaintainability
Document non-obvious calculations and offsets with a short comment
Add a brief comment explaining what a magic calculation or +1 offset represents so reviewers can follow it.
PR: vinify-frontend · org-mining-deep-2026-06Created: Jun 17, 2026
Bad example
Old codetypescript
| 1 | const displayNumber = slot + 1; |
Explanation (EN)
Objašnjenje (HR)
Good example
New codetypescript
| 1 | // +1 because the base price occupies slot #1 |
| 2 | const displayNumber = slot + 1; |
Explanation (EN)
Objašnjenje (HR)