Skip to content
Graham Brooks Graham Brooks Coding Architect
  • Posts
  • Series
  • Tags
  • Projects
  • About

Series

Architecture the agent can check

Compilers, tests and linters only know about the repository an agent is standing in. These posts are about making architecture — layering, dependencies, API contracts — something the edit loop can fail on.

3 parts, oldest first.

Apr 26, 2026

A Rust-Native Architecture Toolchain: forge, puml, and adoc

A Rust-Native Architecture Toolchain: forge, puml, and adoc Replacing the JVM and Ruby pieces of the architecture documentation stack with single static binaries Most of the tools I reach for when …

Aug 8, 2026

Architecture the Agentic Loop Can Actually Check (tropism)

Types made “this value is a string” checkable. Tests made behaviour checkable. Nothing ever made “the API layer must not talk to the data layer” checkable — cheaply, across every language in the …

Aug 24, 2026

Giving the Consumer a Representative in the Working Tree (brake)

An agent decides it is done when the checks it can run come back green. Every one of those checks is a question about the repository it is standing in. The team that generates a client from your …

Subscribe for new posts

Occasional writing on AI and understanding large codebases. No spam — unsubscribe anytime.

© 2026 Graham Brooks. All rights reserved.