Processes

Ask Claude what you're not tracking

Analytics only shows the events you remembered to add, never the ones you forgot. Let Claude instrument features as it builds them, then run a skill that audits your tracking against your own docs and live data, flagging what's missing, noisy, or quietly broken.

Your company needs more than an LLM subscription

Handing everyone an LLM subscription gives them a model. A shared, self-hosted agent gives them a configured environment with company context, connected tools, and clear boundaries. Why a company should own that layer rather than rent it, and how to start small.

Everyone has a plan until they get punched in the mouth

Coding agents made implementation cheap, but validation never got cheaper. That shift moves the bottleneck from writing code to deciding what is worth building, and the response is more autonomy and faster iteration, not more detailed upfront plans.

Residuality Theory: a different way to think about architecture

Most architecture methods try to predict which failures will hit. Residuality Theory does the opposite: it throws random stressors at a design and keeps whatever survives. The randomness is the point, because resilience that depends on predicting the future is not resilience at all.

Documentation has a new reader and why it should belong inside the codebase

AI is now a reader of your documentation. When context lives outside the repository, gaps appear and assumptions creep in. Moving documentation closer to the code makes the system easier to reason about, for people and for machines.

The peloton problem

Senior engineers carry the front of every decision, every code review, every on-call shift. The peloton runs best when roles rotate. When the star eventually leaves, someone else needs to know what wind feels like.

From syntax tinkering to systems thinking

The bottleneck in software engineering has shifted from typing to understanding. As AI handles implementation, engineers who thrive will be those who recognise patterns, curate guardrails, and connect technical decisions to business outcomes.

Stop letting documentation rot

Five types of documentation, five different AI leverage stories. The question isn’t whether to involve AI in your docs; it’s where each type belongs and how much maintenance you can hand off.

Pairing with a yes-machine

Pairing with an AI feels like pair programming. It isn't. There's one prior in the room, and it's trained to agree. This post makes the case for mob programming and spec-driven development as the structural fix.

Show me the way: engineering demo 101

Engineering demos fail when they present what was built instead of why it matters. A practical guide to leading with business impact, showing the happy path, and translating technical work into terms your audience actually uses.

Five ways to fail

Errors don't just happen; they land somewhere. Validation, generic, idempotent ignore, warning log, or Sentry: each routes failure to a different audience. Get the routing wrong and either engineers go blind to real bugs, or state corrupts silently.

Architecture always leaks

Auditing data-heavy companies reveals the same pattern: asynchronous data processing crammed into the synchronous web stack. The contention shows in performance, delivery, and team dynamics. Isolation fixes all three.

Your codebase is a commons

Your codebase degrades the same way shared resources do: not from malice, but from missing governance. Elinor Ostrom proved the commons can survive. Her principles map to software teams with uncomfortable precision.

We're not a normal company

Every software company claims to be different. The "we don't need X because we have culture" exemption is special pleading. The four phrases that reveal it, and the questions that break them open.

The CTO as prisoner

CTOs who built their company's survival by doing everything can't escape that role by scheduling a holiday. Moving from doing to enabling is a skill and identity shift at once. One thing handed off permanently is where the exit starts.

Subscribe