Skip to content

01 · Axioms (the INVARIANT constitution)

The 8 foundational rules. Cannot be modified without forking the framework. Read once, internalize forever.

This governs changing the rules — not how much you adopt

"Cannot be modified" means you don't water down a rule for a unit you've brought under CompassAlpha. It is not an all-or-nothing demand: adoption is incremental and per-unit, and different teams can sit on different rungs at the same time. Immutable rules, incremental rollout.

New here? This section lists the eight non-negotiable rules that hold a CompassAlpha setup together — the ground rules every agent and human plays by. It's for anyone who wants to understand why the framework is shaped the way it is before customizing anything. (New to all of this? Start with the mental model.)

Every axiom defends against one or more of the four pathologies — the recurring ways multi-agent work goes wrong. Break an axiom and you let its pathology back in.

Not every axiom is mechanically enforced, and the framework says so plainly: What is actually enforced draws the line — rule by rule — between what a gate blocks, what git makes impossible to hide, and what still rests on the operator.

The 8 axioms

# Axiom Defends against Page
1 Tier grammar Role confusion →
2 Firewall + state-tracking scope Context pollution, stale-snapshot drift →
3 Persistence law (trust anchor) Trust erosion, power-down data loss →
4 Hard labour rule Mentor-tier context pollution, role confusion →
5 Bus protocol Coordination loss, message routing errors →
6 Provenance law Hallucination drift, false-positive recall →
7 Git foundations Cross-session contamination, parallel-doer races →
8 Amendment protocol Doctrine drift, discovery loss, federation divergence →

Why these are invariant

Each axiom emerged from a real incident in a reference implementation where someone tried the shortcut and the consequence was costly. The axioms are not abstract theorizing — they are scar tissue. Trying to weaken them re-opens the wounds.

What "axiom" means in CompassAlpha

In CompassAlpha, axioms are not mathematical axioms (logical foundations). They are structural axioms — protocols that, if violated, cause predictable failures. You can technically violate them, just as you can technically violate physics; the consequences are equally predictable.

How to read this section

Each axiom page follows the same structure:

  1. TL;DR — one paragraph
  2. The rule — exact specification
  3. Why it exists — the failure mode it prevents
  4. What violating it looks like — concrete failure example
  5. Implementation details — how to enforce in practice
  6. Variations / tunables on top — what you can still configure

Start with the most foundational

If you can only read one axiom, read Tier Grammar. Everything else builds on it.

If you can read three, read Tier Grammar + Firewall + Persistence Law. Those three are the spine.

If you can read all eight, do so. They're each ~5 minutes.


Next: Tier Grammar →