Your PR Review Is Not an Architecture Review
PR review is a code quality tool. Treating it as architecture enforcement isn't a discipline problem — it's a mismatch between what the tool can see and what enforcement actually requires.
Read postWriting
Technical writing on the things I'm building, breaking, and figuring out.
Things I'm building, breaking, and figuring out. Mostly backend and systems, with some detours into AI and the organizational side of engineering.
Filter by
Bit Rot Is Not a Metaphor
You can write a perfect ADR and in 18 months nobody follows it. The question is not how to document better. It is what you do with the documentation after it is written.
Read postThe Coupling Rate Problem
GitClear's data shows code cloning is up while refactoring is down. That matters because duplicated code creates coupling, and refactoring is the work that forces teams to reconcile it.
Read postImplicit Coupling Is a Maintenance Problem, Not a Generation Problem
I ran three experiments with Claude Code (Opus 4.6) and Codex (GPT-5.4 xhigh) — greenfield creation, extension, and brownfield detection. The conclusion: implicit coupling is a maintenance problem, not a generation problem.
Read post