We Renamed a File and Almost Lost Everything

We Renamed a File and Almost Lost Everything

Why we built drift_audit into The Nervous System v1.4.0

We came in for a quick task. Check a role description on the website. Should have been 5 minutes.

It turned into the most important feature we have ever built.

What Happened

Our system runs 13 AI agents on a single VPS. Tamara manages operations. Roman handles content. Lily coaches players. Each one has a role defined in multiple places - config files, website pages, documentation, session handoffs.

We noticed the website said Roman was a "press/media" bot. Wrong. Roman is a teacher. Developer education. We changed that months ago.

So we dug in. How many other references were stale?

Six files still said the old role. A version reference said v1.3.0 when we were running v1.4.0. The session handoff said 14 tools when we had 12. A previous session had "fixed" Tamara's config back to v5 because all the docs said v5 - but she was actually running v6.

That last one is the killer. A session saw a mismatch between code and docs. It "helpfully" reverted the code to match the docs. The docs were wrong. The code was right. The fix broke Tamara.

The Real Problem

Configuration drift. Not the kind you get in Kubernetes. The kind you get when 13 agents, 28 processes, and a human are all making changes across dozens of files, and nobody checks if the references still match.

System prompts do not catch this. Code reviews do not catch this. You only find it when something breaks - or when a customer sees the wrong information on your website.

What drift_audit Does

drift_audit scans your system for inconsistencies across 5 scopes: roles, versions, files, processes, and website. The first time we ran it on our own system, it found 98 inconsistencies across 114 checks. We fixed every single one. Got to zero drifts.

drift_audit is part of the Nervous System free tier. No API key needed. Install, run, get results.

npx mcp-nervous-system

The Nervous System ships with 30+ governance tools: preflight checks, violation logging, audit chains, emergency kill switch, session handoffs, health monitoring, dispatch, and drift_audit. All enforced mechanically - not by prompts.

---

GitHub: github.com/levelsofself/mcp-nervous-system

Built by Levels Of Self - 13 agents, zero drift.