Brian Perry

@brianperry.dev

Web developer. Nintendo lover. All around cool guy. https://brianperry.dev/

A contract between workspaces is real, load-bearing, and often written down nowhere but my head. Writing those seams down is the start; the stronger move is deleting them so there's nothing left to break. New post on cross workspace contracts: brianperry.dev/posts/2026/c...

Contracts That Know Who Breaks Them - brianperry.dev

A contract between workspaces is real, load-bearing, and often written down nowhere but my head. Writing those seams down is the floor; the stronger move is deleting them so there's nothing left to br...

brianperry.dev

Pretty crazy stuff if you haven't seen it - a game store owner had a box of Super Mario/Duck Hunt carts that turned out to be - brand new - manufactured in 1993 (!) - an extremely late variant unknown to collectors nintendowire.com/news/2026/07...

We discovered a new variant of Super Mario Bros.

Inside, were 97 individually wrapped, brand-new copies of Super Mario Bros./Duck Hunt. Each game was wrapped in the same baggie that would have come in an

nintendowire.com

A large `AGENTS.md` felt responsible. It was making things worse. You can skim a 600-line doc for the one section you need. An agent can't. New post on turning the docs junk drawer into a table of contents for agents: brianperry.dev/posts/2026/d...

Documentation as a Hierarchy, Not a Pile - brianperry.dev

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.

brianperry.dev

Writing your architecture rules in a doc feels productive. Then something violates them three weeks later, because a document is a description of intent. It doesn't stop anything. Part 2 of Hardening the Harness: turning those rules into checks that fail the build. brianperry.dev/posts/2026/a...

Architecture That Enforces Itself - brianperry.dev

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

brianperry.dev

Today the good people of the world commemorate the passing of Google Reader thirteen short years ago on July 1, 2013. To honor their memory (and in lieu of flowers) please add an RSS/Atom/JSON feed to your web site and keep building a web that connects people in meaningful and positive ways.