Clean Code

Function Rules

Rule	Guideline
Function length	Prefer under 20 lines. Extract when doing two things.
Naming	Name reveals intent. No abbreviations except universal ones (ctx, err, id).
Abstraction level	One level per function. Don't mix SQL strings with business logic.
Comments	Explain WHY, not WHAT. If code needs WHAT comments, rename or extract.
Error handling	Handle at the appropriate layer. Don't swallow errors silently.
Argument count	0 is ideal; 1 is common; 2 is acceptable; 3+ is suspicious. A boolean flag argument is a hidden second function — split it.
Command-Query Separation	A function either changes state or returns a value — not both.

Installs

Repository

GitHub Stars

First Seen

Jun 10, 2026