This Pattern Is Horrifyingly Overengineered | Issue #89


I almost didn’t publish this week’s video.

It’s about the Specification design pattern, and if I’m honest, the final version of the code scared me a little. It’s complex, abstract, and in many cases… absolutely overengineered.

But there’s a reason I still decided to share it.

In the video, I explore how the Specification pattern tackles a very real problem: business rules duplicated across different parts of a system, slowly drifting apart and becoming harder to change safely.

Is this something you should use every day? Definitely not. But as a design exercise, it’s incredibly rich.

Have a great weekend,

Arjan


Do you enjoy my content on YouTube and would you like to dive in deeper?

🚀 Check out my online courses

My courses have helped thousands of developers take the next step in their careers. Check out these courses to help grow your skills and become a senior developer:

👕 Clean code and clean clothes

The ArjanCodes merch store features T-shirts, hoodies, hats, and more for the clean-code-obsessed. Careful though: you'll look dangerously professional while reviewing PRs.

👉 Check out the store here and grab something before your stand-up call starts.

Unsubscribe | Sent by ArjanCodes

Wolvenplein 25, Utrecht, UT 3512 CK

The Friday Loop

Every Friday, you'll get a recap of the most important and exciting Python and coding news. The Friday Loop also keeps everyone posted on new ArjanCodes courses and any limited offers coming up.

Read more from The Friday Loop

Most Python developers know dataclasses. Or at least… they think they do 🙂. You add @dataclass, define a few fields, and enjoy writing less boilerplate. But dataclasses hide a lot more power than most people realize and some of that power can quietly bite you if you don’t understand what’s really going on. In this week’s video, I walk through 7 lesser-known dataclass features that make your code safer, clearer, and easier to maintain. I start with common pitfalls like mutable defaults, then...

AI can write code now. But you already knew that :). If you’ve tried using AI seriously, you’ve probably noticed something: the code works (kind of) and then slowly turns into a mess. In this week’s video, I show why prompting alone isn’t enough and why software design is becoming more important, not less, in an AI-driven world. I walk through a real interaction with an AI coding assistant and show how thinking in terms of responsibilities, structure, and system boundaries completely changes...

In a recent video on refactoring complicated business logic, I managed to introduce several subtle errors. Many of you immediately spotted them in the comments. That’s exactly what my first video in 2026 is about. I walk through the mistakes I made, explain why they happened, and show how easy it is to accidentally change behavior when you refactor code. Even with tests in place and decent coverage, assumptions can sneak in, business rules can shift, and logic can quietly break without anyone...