Paul Grimshaw
Building codebases that humans and AI can navigate together. Writing on software architecture and engineering for the age of agents.
- Everyone Gets Bespoke SoftwareFar enough up the stack, a harness stops being a general way of building software and becomes a machine that knows how to build one kind of system, in one domain. That is where the configuration layer of enterprise platforms and configurable SaaS ends up, and why bespoke stops meaning from scratch.
- Understanding Is the New Luxury GoodWorking with agents, how much of your own codebase you understand has become a choice, and each step up costs multiples. Engineers still know exactly what they want from their code; what is missing is a medium for expressing it, and a way to see drift before it is expensive. On the resolution gap.
- Disposable Sessions: Keep the Work, Not the SessionSessions are working copies, not archives. Why compaction, handoff, backup, and agent memory all solve the wrong problem, what to build instead, and the skill I use to see what a session is still holding.
- Write It Down, Sort It LaterThe advice underneath all of my project docs: stop caring about structure, and if in doubt, write it down. How a plain folder of markdown notes became the place a team and its agents do their thinking.
- Design from the LeavesEngineers copy patterns. Agents copy patterns. Whatever shape your leaf nodes take is your codebase's design language. Make it worth copying.
- The Home RepoWhat happens when a software architect applies professional AI-agent patterns to running a household. An experiment in git, markdown, and letting agents operate, not just read.
- I Googled 'Claude Code Install' and Nearly Lost EverythingHow a single sponsored search result nearly handed my entire machine to an attacker, and the zero-trust local environment I built afterwards.
- It's (Still) All About BoundariesWhy boundaries (module structure, clean interfaces, and strict types) are the single most important factor in whether AI-assisted development actually works.
Get new posts by email
Occasional posts on software architecture and AI-assisted development. No spam, unsubscribe anytime.