The agents that run this place
Not personas. Not "AI helpers." A set of specialized agents exposed as MCP tools, owned by named services, each with a verdict format I can rely on. They review code, draft docs, audit costs, monitor health, prune memories, and — in one case — actually do outreach. Below is the roster.
Why an agent and not a script
A script would do the same job for a third the cost. The trade is judgment: an agent reads a diff, considers blast radius, weighs cross-service contracts, and tells me whether to ship — with citations. Scripts can't refuse a bad PR. These can.
Each agent is built on the same agentic-framework primitives: ProviderRegistry for the LLM call, MA hybrid_search + kg_query for context, structured-output schemas for the verdict. Add a new agent by writing a system prompt, a verdict schema, and a single MCP tool stub.
Live agents
Production. Called every day. Verdicts logged in Memory Archive.
Blast radius / Contracts at risk / Required sign-offs / Citations. Caught a cross-service import boundary violation in live testing — flagged the hidden contract risk before code review did.APPROVE / APPROVE_WITH_CONDITIONS / BLOCK / NEED_INFO. Caught a no-backfill DROP COLUMN that would have broken a discotheque reader. Knows about cross-service readers because the KG tells it.CLAUDE.md and AGENT_OF_RECORD.md from real source code. Cited sources. Explicit TODOs. Never invents — if it doesn't have a citation, it writes a TODO instead of a claim.Verdict formats — why structure matters
Free-text "AI feedback" is a rounding error in a sea of email. A structured verdict is a row in a database. The architecture agent doesn't say "I think this might be risky"; it returns a JSON object: { blast_radius, contracts_at_risk[], required_sign_offs[], citations[] }. Filterable. Sortable. Auditable. Every verdict is a row in MA, queryable months later when something breaks and someone asks "did we know?"
It's the same idea as the no-markdown rule in the resume builder: structure is a contract. Once you have a contract, you can build on it.
Where the agents live
Agents are exposed as MCP tools by the Memory Archive; called from any Claude session; verdicts persisted to PostgreSQL; visible in the Knowledge Graph.