One Instruction File for Every AI Agent
Three AI coding tools, three config files, all slowly disagreeing with each other and with the code. This is how we got down to one source of truth the robots and the humans both read.
Read more ...Three AI coding tools, three config files, all slowly disagreeing with each other and with the code. This is how we got down to one source of truth the robots and the humans both read.
Read more ...A React app crashes. Sentry tells you it crashed. It does not tell you whose crash it is. You can usually work that out. It’s just a step nobody should have to do by hand.
This is the story of how we taught our error boundaries to tag the team that owns the screen, so the report answers that question on its own.
Read more ...The promotion earns you the title. It does not teach you the job.
In March 2026 we ran Tech Lead School, an honest attempt to close the gap between what earns the promotion and what the role actually demands. Here is what worked, what didn’t, and what surprised us.
Read more ...Our hiring process was not broken in an obvious way. It produced reasonable outcomes and we had learned to live with its inefficiencies. But over time the cost of running it became impossible to justify. I could have looked the other way. But I have always believed in leaving the battlefield better than I found it. This is the story of how we identified its shortcomings, redesigned the process around our actual constraints, and handed ownership of it to the entire team.
Read more ...Senior engineering management is mostly subtraction. The brief you don’t over-specify. The standard you don’t leave verbal. The conversation you don’t have because the team is already having it.
But subtraction is not absence. It only works when the infrastructure underneath is honest: a clear end state, written standards, accountability that survives your calendar, and protection from the org above. This is the version of the job I’ve been learning the hard way.
Read more ...A senior engineer stepped into a first-time lead role and discovered that the real shock was not fewer hours of coding. It was realizing that a full day could be spent reviewing, mentoring, estimating, and unblocking, yet still feel invisible because the work had shifted from personal output to other people’s growth.
This piece is about that shift: what I had to trade when speed stopped being my main source of value, and why the manager side of the role turned out to be harder than I expected. It is also about what makes that transition more complicated in an AI-heavy code review culture, where code can look polished long before the underlying fundamentals are solid.
Read more ...