Governing Multi-Step AI Development Workflows with Mneme HQ

import json, subprocess
MEMORY = ".mneme/project_memory.json"

def mneme(*args):
    return subprocess.run(["mneme", *args, "--memory", MEMORY],
                          capture_output=True, text=True)

# Before invoking the planner: pass it the decisions that match the task
context = mneme("test_query", "--query", task).stdout
plan = planner_agent.run(task, context=context)

def check(path, draft):
    return mneme("check", "--input", draft, "--target-path", path,
                 "--query", f"edit to {path}", "--json")

# Before invoking the reviewer: check every file the coder wrote
files = coder_agent.run(plan)    # {repo path: draft file on disk}
for path, draft in files.items():
    result = check(path, draft)
    if result.returncode != 0:    # strict: 1 = WARN, 2 = FAIL or INCOMPLETE
        verdict = json.loads(result.stdout)
        draft = coder_agent.fix(path, violations=verdict.get("violations", []))
        files[path] = draft
        if check(path, draft).returncode != 0:    # re-check the fix
            raise SystemExit(f"{path} still fails; reviewer not invoked")

reviewer_agent.run(files)

$ mneme check --memory .mneme/project_memory.json \
    --input out/search.py --target-path app/handlers/search.py \
    --query "edit to app/handlers/search.py"

FAIL  [ADR-004] FORBID_LITERAL "from app.db.client import" -- trigger: from app.db.client import
      Handlers reach the database through the repository layer
      path: app/handlers/search.py via app/handlers/**
PATH  APPLIED  [ADR-004] app/handlers/search.py via app/handlers/** -- an include selector matched
Result: FAIL

$ echo $?
2
# The orchestrator sees exit code 2, skips the reviewer and returns the file to the coder.