hexum_check

Last updated 12 September 2026

When to call

Before claiming the turn is done.

Arguments

Pass the same files you care about, or workspace when the agent is reading from disk.

What comes back

healthy, drift_detected, or ARCHITECTURE_CONFIG_MISSING, plus violations.

Example

{
  "status": "drift_detected",
  "violations_count": 1,
  "violations": [{
    "rule": "no_ui_to_data",
    "file": "src/ui/App.tsx",
    "hint": "Call services instead."
  }]
}

What the agent does next

On drift, follow hint and check again. Do not ship a red check.

All five tools: Hexum MCP tools. Contract file: architecture.hexum.

FAQ

What is hexum_check?

Maps files to layers in architecture.hexum and reports forbidden imports. Example FAIL: ui → data, rule no_ui_to_data, hint: call services instead.

When should the agent call hexum_check?

Before claiming the turn is done.

Does Hexum replace Cursor or Claude Code?

No. You keep Cursor, Claude Code, Antigravity, Codex, or Grok. Hexum is not an editor and not a model. You paste a key into the agent you already use.

Does the architecture check use an AI?

No. It reads a rules file in your repo and reports forbidden imports. It does not call a model, so it does not guess.

Does Hexum store my repo?

No. We do not keep the code your agent sends. We do not train on it. Policy: /zdr.