Posts

Almost every team working with agents has been through this: you write a spec that looks reasonable, the agent runs, and what comes back is not quite what you asked for. It is not broken code, it is subtly wrong code. …

There is a kind of code that gets sold as “SOLID code” and is, in practice, a maze. One-method classes, interfaces with a single implementation, factories that only forward parameters, layers that exist solely to justify …

There is a pattern that shows up in almost every team that starts working seriously with agents: the prompt keeps growing. It starts with a reasonable AGENTS.md, then the module docs, then three related files, then …

On March 31, 2026, between 00:21 UTC and roughly 03:15 UTC, two versions of axios sat on the npm registry with an extra dependency declared in package.json: plain-crypto-js@4.2.1. That dependency was never imported at …

There is a lot of scaling talk that starts in the wrong place. The system is not really suffering yet, but the architecture has already become a pile of buzzwords: sharding, event-driven, CQRS, multi-region, Kafka …

In the previous articles of this series we covered SDD (Spec-Driven Development) and how to apply quality gates, tests, and templates. Now I’ll show something I haven’t found clearly documented anywhere: the complete …

In the previous article I explained what Spec-Driven Development is and why it makes sense for teams working with agents. Now we get to the part that matters most: how to turn that into day-to-day execution. Once the …

If you’ve ever used AI to write code, you’ve probably been through this: you ask for something, the AI delivers something that looks correct, but when you test it… it’s not quite right. The code compiles, the variable …

HTTP servers play a fundamental role in distributing content and services on the internet. Implementing a simple HTTP server can be an excellent opportunity to understand the basic principles of web communication and …

If you’ve never heard of aliases in linux, the simplest way to explain it is that they are shortcuts to the command line, instead of typing a huge command, or not so big, you type a simple command. An example, instead …