Principles

• •Keep it simple (KISS) — prefer the simplest solution that works
• •Don't repeat yourself (DRY) — extract when you see three duplicates, not before
• •Single Responsibility — each module/function does one thing
• •Use descriptive, intention-revealing names
• •Use kebab-case for files and folders
• •Functions should have clear inputs and outputs with minimal side effects
• •Keep functions right-sized — extract when logic needs a comment to explain
• •Delete dead code — don't comment it out
• •Never swallow errors silently
• •Measure before optimizing — no premature performance work
• •No premature abstraction — wait for three concrete duplicates before extracting

Rules

See rules/ for detailed patterns.