Designing codebases for AI agents
Clear boundaries, local tests, and discoverable rules reduce the cost of every change.
// blog
Notes from building software and dealing with AI tools.
Clear boundaries, local tests, and discoverable rules reduce the cost of every change.
Long-running agents need explicit boundaries, checkpoints, and proof of completion.
A compact task contract reduces wasted context, output, and review time.
Give agent small jobs. Check every result.
Use a small evaluation loop to decide which tools deserve a place in your work.
Shared repository rules, evaluation tasks, and review policy turn individual prompting into an engineering process.
When code becomes cheaper to produce, specification, review, and debugging become more valuable.
Give coding agents evidence from the repository, not a longer story in chat.
A practical system for planning two workloads without pretending every week has unlimited capacity.