CLAUDE.md — Code Quality Best Practices
30 universal principles distilled from Kent Beck's Smalltalk Best Practice Patterns, generalized for any codebase.
- Composed Method Divide every function into sub-functions that each perform one identifiable task. Keep all operations in a method at the same level of abstraction. This naturally produces many small methods, each a few lines long.
- Intention-Revealing Names Name methods/functions after what they accomplish, never how they accomplish it. A reader should understand the purpose of a call without reading its body.
- Replace Comments with Clear Code