Retiring the Brain: 8,000 lines deleted, the workflow stays

Two weeks ago I published a spotlight on the Brain — the live status board my AI agents and I used to run this monorepo. Then I asked whether I still needed it. Last night the agents deleted it: three PRs, −8,014 lines, shipped in one evening.

The Brain was a markdown protocol with a dashboard on top. Every project carried a BRAIN.md — what is this, what's in focus, what changed lately — and a private viewer rendered them all as cards with live GitHub issues mixed in. It trained the routine I still use: identity cards per project, a hard three-line cap on current focus, a dated close-out line after every session, and issue-first work in isolated git worktrees.

Audit

I asked Claude "should I retire this?" It ran a seven-agent audit of the repo and came back with numbers I couldn't unsee:

• 59% of all commits in the last 90 days touched a BRAIN.md file.
• Of those, 58% were pure dated log appends — no knowledge, just compliance.
• Every one of those appends triggered a full production deploy.
• I'd opened the dashboard on four days in ten weeks.
• Roughly 7,800 lines of infrastructure were maintaining 627 lines of content.

I got a second opinion from Grok, which argued for keeping the card files and the habits while retiring the app. That was the right call. GitHub Issues already owned the work (#1204). Per-project card files stay for agents and humans arriving at the code. Everything else goes.

PRs

Three agents in parallel worktrees:

• #1307 — card-only pushes stopped triggering deploys, labels became automation-applied (humans never curate them), issue templates went in, and the one external consumer of a Brain endpoint got re-plumbed first.
• #1308 — every irreplaceable fact buried in a BRAIN.md (deploy invariants, "this data is gone forever" warnings, do-not-reopen decisions) moved into READMEs and a decisions log; a one-page spec and a ~100-line lint replaced the old stack.
• #1313 — the demolition itself: −8,014 lines.

What stayed

The card files (now just "project cards", same filename). The three-line focus cap. The close-out line — written only when something actually shipped. The git union-merge trick that lets parallel agents append to the same file without conflicts. The little lint that keeps all of it honest.

Work lives in GitHub Issues now. The cards stay behind for whoever shows up at the code next.