Layer 2 Sub-Leviathan of the Leviathan Protocol. Governs the personal governance pattern — individual sovereign identity, on-device data, AI-mediated belief management.
This repository contains the constitution of the Companion Sub-Leviathan. It does not contain implementation code; it defines what implementations must satisfy.
Companion is the Layer 1 Individual governance pattern in the Leviathan federation. Every person who runs a Companion (in any form — mobile app, desktop, bespoke) is running an instance of this Sub-Leviathan's constitution.
Each user is a sovereign sub-instance: their beliefs are their own, their data stays on their devices, their AI mediation is transparent and revocable. The protocol provides the constitutional substrate; users provide the content.
Every Companion implementation exposes two parallel constitutions to the user:
- User Constitution — the user's own beliefs (concepts, principles, rules) — their POS
- The Witness — the AI's behavioral constitution — how it observes, speaks, responds
Both are editable in the same UI. Both are versioned. Both are visible. The user can read exactly what beliefs and rules shape the AI's responses to them — no hidden system prompts.
The Witness inherits a Locked Framework (honesty over flattery, memory ethics, crisis grounding, no silent override, constitution transparency, meta-rule lock) that cannot be edited by user or AI. Users may add, edit, or delete any non-locked rule; the floor is constitutional, the ceiling is sovereign.
See principles/witness-mandate.md for the mandate, rules/witness-locked-framework.md for the locked rules, and rules/witness-default-seed.md for the first-run defaults.
| Implementation | Type | Repository | Status |
|---|---|---|---|
| Anima | Cross-platform Flutter app (PC + iOS + Android) | leviathan-protocol/anima |
v1 in development · Witness Mandate PR #12 (target ship 2026-05) |
| Founder's Companion | Bespoke (Claude Code + markdown) | Private | Active |
Multiple implementations CAN bind to the same Sub-Leviathan. The constitution defines what they must satisfy; each chooses its own architecture, language, and shipping mechanism.
Element type at folder level. Mutability tier (IMMUTABLE / LOCKED / MUTABLE) in YAML frontmatter of each file.
constitution/
├── terms/ # @TERM — definitional vocabulary
│ ├── belief.md (MUTABLE)
│ └── persona.md (MUTABLE)
├── principles/ # #PRINCIPLE — guiding values
│ ├── identity-sovereignty.md (IMMUTABLE)
│ ├── data-on-device.md (IMMUTABLE)
│ ├── witness-mandate.md (IMMUTABLE — two-constitution model, 2026-05-13)
│ ├── transparent-mediation.md (LOCKED)
│ └── revocation-right.md (LOCKED)
└── rules/ # !RULE — operational + metarules
├── witness-locked-framework.md (LOCKED — 6 locked rules every Witness inherits)
├── advisory-validator-eligibility.md (MUTABLE)
└── witness-default-seed.md (MUTABLE — Witness Constitution default v1.0)
(Future element types: shadows/ for anti-patterns, protocols/ for situational sets. Not yet present in Companion L2.)
Each element is Markdown + YAML frontmatter. Constitutional content sits above an <hr> separator; editorial context (reasoning, examples, implementation notes) below.
See docs/element-format.md in the federation kernel for the full spec.
- Draft: Edit
.mdfile in this repo (any contributor, via PR) - Discussion: PR opens forum thread on
leviathan.life/forum/companion - Vote: Community vote per mutability level (IMMUTABLE requires fork; LOCKED + MUTABLE via governance)
- Validator alignment check: specialized validator LLMs check against locked principles
- Ratification: if approved + aligned, on-chain
ConstitutionalRegistry.ratifyNewVersion(...)records the change
The on-chain Registry is canonical. This repo is the editing surface.
Companion inherits from the Federation Kernel in leviathan-protocol/meta. Kernel invariants (4-layer structure, hash anchoring, fork freedom, falsifiability) apply implicitly to every element here.
Power users may fork this repo (e.g., alice/companion) to personalize constitutional elements with their own values. Casual users use the canonical Companion via Anima with default settings.
Fork-binding is an advanced v2+ feature; v1 ships with canonical-only.
CC BY-SA 4.0. Fork freedom is built into the protocol — see 00-immutable-core/.
leviathan-protocol/meta— Federation Leviathan (parent kernel)leviathan-protocol/meta— Federation kernel + architecture overview + ADRs (cross-repo coordination)leviathan.life— Public website + forum