Architectural drift prevention for the AI SDLC

Architecturethat holds.

AI writes the code. Your architecture still decides what ships.

Supported by Google for Startups Microsoft for Startups MIT licensed · open source
Two people arranging a wall of hand-drawn application screens into one system
Architecture is decided by people. Mneme carries that decision to every agent.

The code can work and still violate the system.

ADR-017Approved · Platform team

Keep data access behind the service boundary.

Frontend surfaces may request analytics through the backend service. They must not instantiate data-platform clients directly.

IF path = frontend/**
AND dependency = @google-cloud/bigquery
THEN BLOCK
decision owned · reviewed

Agent proposal

// frontend/checkout.ts import { BigQuery } from '@google-cloud/bigquery'; export async function trackCheckout(event) { const bq = new BigQuery(); return bq.insert(event); }
Task context: add checkout analytics
Changed surface: frontend route

Mneme verdict

BLOCKED

ADR-017 forbids a data-platform client in the frontend checkout service.

Had it shipped Warehouse credentials bundled into the browser, and a customer-data path nobody reviewed.

REMEDIATION
Call the approved backend analytics service instead.

SOURCE
ADR-017 · Data access boundary

Run the demo, or run it on your code.

Path 01 · runnable proof

Try the demo.

Clone the open-source repository and watch an architectural violation get caught before generation — no API key required.

Terminal · demo path
$ git clone https://github.com/MnemeHQ/mneme
$ cd mneme
$ pip install -e .
$ python examples/demo-adr-import.py

WARN  [ADR-005] constraint "no MnemeHQ" -- trigger: mnemehq
      Brand vs Package Namespace Enforcement

Result: WARN
No API keyOpen sourceReproducible
Walk the full demo
Path 02 · existing project

Add Mneme to your repo.

Install the owned package, initialize the decision corpus, add one approved decision, and check the first proposed change.

Terminal · project path
$ pip install mneme-hq
$ mneme init
Created .mneme/project_memory.json

$ mneme check \
  --memory .mneme/project_memory.json \
  --input proposed-change.diff \
  --query "checkout analytics"

FAIL · ADR-017 · exit 2
Result: FAIL
Python 3.10+macOS · Linux · WindowsLocal CLI
Read the quickstart

Architecture is a human decision. Enforcement should preserve that authority.

A Mneme pilot turns one real set of architectural decisions into an enforceable workflow across the agents and repositories your team already uses. Start with one boundary, one repository, and evidence everyone can inspect.

People decide. Mneme makes the decision operational. Evidence proves it held.

Three direct answers.

What is Mneme HQ?

Mneme is open-source architectural drift prevention for the AI SDLC. It turns approved ADRs, engineering standards, project context, and prior decisions into deterministic guide, warn, or block verdicts before incompatible changes land, with every verdict traced to its source.

When does Mneme enforce architectural decisions?

Mneme can apply relevant decisions before an agent writes code, during file changes through supported hooks, and in CI before a change merges. Each guide, warn, or block verdict identifies the governing source and permitted next action.

How is Mneme different from context, auditing, and code review tools?

Context systems help agents understand. Auditing tools show how agents behaved. Code review evaluates completed output. Mneme enforces the approved engineering intent the agent must follow, while linking every verdict to its source.

One decision corpus. Honest support levels.

View the authoritative integration matrix →
Native
Mneme CLI
Claude Code hook
Claude Agent SDK hooks
Google Antigravity adapter
Tested workflow
Cursor rules export
GitHub Actions gate
GitLab CI gate
Paperclip (via Claude Code)
Designed to support
GitHub Copilot · OpenCode
JetBrains · VS Code · Warp
In progress
Codex CLI (validation)
Deep Agents middleware POC
Kiro hook (open PR)

Give every coding agent the decisions your team already made.