Building Blocks That Fit Together
Modules are promises. Keep them small, honest and easy to replace.

By Codeo
April 11, 2025 · 9 min read · Advanced
A module is a promise about what stays stable and what may change. Design the seam first and the parts will fit.
- Expose the smallest surface that makes the module useful.
- Hide the decision you expect to regret.
- A dependency you can delete in an afternoon is not a dependency.
Filed underCode Craft
More from the workshop
Code CraftSoftware Craftsmanship Isn’t Dead. AI Just Moved the Bottlenecks.
Every few months, someone announces the death of Software Craftsmanship.
August 7, 2026 · 3 min read
Clean CodeWriting Code That Tells a Story
Good code is read more often than it is written. Make it worth reading.
May 10, 2025 · 6 min read
Refactoring
Refactoring Without Changing Behavior
Small improvements, every day. Leave the code better than you found it.
May 6, 2025 · 8 min read