// a serious & professional website

Brian Perry.dev

I'm a web developer figuring out what AI agents are actually good for - at Actual AI by day, and in a pile of side projects the rest of the time. I'm a longtime member of the Drupal community and I often present at tech events. I live with a super awesome family in the Chicago suburbs and I'm really into Nintendo.

Brian with a weather station
// brian

Latest

★ Latest

Documentation as a Hierarchy, Not a Pile →

A big instructions file is a bad interface for an agent, because an agent can't skim. How I turned one junk-drawer AGENTS.md into a table of contents with a docs tree underneath.

posts

Architecture That Enforces Itself →

A document is a description of intent. It doesn't stop anything. How to turn architectural rules into checks that fail the build.

posts
All posts

Work & Play

BUILDRecent Projects

  • Actual AI — guardrails for AI-powered software development.
  • More Later — a reading queue that decides with you. Beta opening soon.
  • brianperry.dev — rebuilt more times than is reasonable.

1-UPCurrently Enjoying

  • Widows Bay — quirky horror-comedy series and proof that all of New England is haunted.
  • Mina the Hollower — a take on Game Boy Color era Zelda from the Shovel Knight team.
  • The Obsessives — keep coming back to this indie rock album that randomly came up in my autoplay.