Paul Grimshaw
Building codebases that humans and AI can navigate together. Writing on software architecture and engineering for the age of agents.
- 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.