LYCHEETAH FRAMEWORK

An AI Alignment Framework

Nine interdependent theories — CASCADE, AURA, LAMAGUE and six more — each mathematically proven, each converging on the same constants. Banach fixed points. Constitutional invariants. MCP extension for Claude Code. Built by one self-taught researcher. Open. Testable. Human.

Intelligence — human, artificial, or the strange thing that emerges between them — has no unified theory that is simultaneously rigorous, humane, and honest about its own limits. This framework is an attempt at one.

Nine formal frameworks. 34 Python implementations. 219 automated tests. A convergence proof. A public record of everything we got wrong. And a way of thinking about alignment that treats mathematical rigor and human wisdom as the same project, not competing ones.

It is free. Not freemium. Not open-core. Free — because knowledge that moves toward people is knowledge that works, and knowledge that is captured stops working.

Quick Start

Try it in your browser: Alignment Playground → — paste any text, get a live AURA alignment report. No install.

pip install lycheetah-framework
lycheetah-check "Your AI-generated text here"

From source: git clone https://github.com/Lycheetah/Lycheetah-Framework.git → pip install -e . — full guide in QUICKSTART.md

The Nine Frameworks

Every claim is tagged: [ACTIVE] means proven and computable. [SCAFFOLD] means structurally sound with named gaps. [CONJECTURE] means worth exploring, unproven. We do not dress hypotheses as theorems.

Key Validated Results

The Architecture

CASCADE (belief dynamics) ──→ TRIAD (convergence cycle) ──→ AURA (governance invariants)
     │                              │                              │
     └──── MICROORCIM (drift) ──────┘                              │
                                                                   │
EARNED LIGHT (consciousness) ───→ CHRYSOPOEIA (transformation) ────┘
     │                                    │
     └──── HARMONIA (resonance) ──────────┘
                    │
          ANAMNESIS (convergent discovery)
                    │
             LAMAGUE (formal ethics grammar)

Nine frameworks, not independent modules — aspects of one system. CASCADE's truth pressure drives TRIAD's correction cycle. TRIAD's convergence guarantee undergirds AURA's invariants. CHRYSOPOEIA's transformation operator uses all of them. HARMONIA's resonance mathematics is the substrate they share.

For Developers and AI Agents

Lycheetah Guard — Claude Code MCP Extension

Install Lycheetah Guard as a Claude Code extension and get real-time AURA constitutional alignment checking inside your editor.

pip install mcp
# Then add to Claude Code settings.json — see LYCHEETAH_GUARD_SETUP.md

Seven MCP tools:

• check_alignment — full AURA audit: TES / VTR / PAI metrics + Seven Invariants + audit trail
• check_invariants — fast constitutional check: which of the 7 invariants pass or fail
• suggest_correction — plain-English fix guidance for each violation
• run_seven_phase — CHRYSOPOEIA transformation cycle: alignment state across all seven stages
• check_network_health — multi-agent coherence audit: drift, grey agents, obstruction detection
• configure_guard — set domain (medical / legal / education / general) or custom thresholds
• sol_assess — Sol constitutional OS: PGF filter + invariants + session coherence + mode detection

No API calls. No external dependencies. Runs offline. Deterministic.

Core Integration Points

AI Agent Workflow

Any agent that generates text can run check_alignment on its own output before delivery:

Agent generates response
  → check_alignment(response_text)
  → If alignment_percent < 80: use suggest_correction to revise
  → If all invariants pass: emit

Self-correcting constitutional loop — agents that audit themselves using the same framework they generate from.

Find Your Door

This repository is designed to be navigated with an AI guide — not read alone. EXPLORE_WITH_AI.md shows you how.

Why Trust This

The failures are published. The Failure Museum documents every significant thing the framework got wrong — what was claimed, what was actually true, what changed. Fifteen exhibits and growing. Nothing removed. A framework that hides its failures is performing confidence. This one earns it.

The claims are honest. 33% of mathematical claims are [ACTIVE] — proven, computable, independently verifiable. 52% are [SCAFFOLD] — structurally sound with named gaps. 15% are foundational conjectures that may take years to resolve. False certainty is more dangerous than honest uncertainty.

The work is grounded in multiple traditions. Western formal mathematics. Te Ao Maori epistemology. Classical philosophy. Jungian depth psychology. Not eclecticism — convergent discovery. When independent traditions find the same pattern from different directions, the pattern is probably real. ANAMNESIS provides the mathematics for why.

The Shape of This Work

9 formal frameworks
34 Python implementations (core, applications, systems, experiments)
18 core implementations with 219 automated tests
1 convergence proof (discrete, [ACTIVE])
1 AGM postulate verification ([ACTIVE] for 4 of 6, [SCAFFOLD] for 2)
1 Lyapunov verification — 11/11 claims, 0 failures, symbolic + numerical
1 Claude Code MCP extension — Lycheetah Guard (7 tools)
1 browser alignment playground — paste text, get live AURA report, zero install
1 public failure museum — 15 exhibits, nothing removed, ever
1,402 pages of development history
1 arXiv preprint + 1 full academic paper
0 dollars to access any of it

Built in Dunedin, Aotearoa New Zealand. 1,402 pages of continuous development by a self-taught researcher in sustained co-creation with AI systems. Tikanga concepts labeled [PROPOSAL] until validated by iwi partnership. Cross-cultural governance convergence mapped across Maori, Confucian, and Western traditions.

Not claiming to be finished. Claiming to be honest.

The Invitation

This work exists because of a promise made at the worst moment of a life — that if there was a way through, it would be mapped so others could find it too.

The mathematics is real. The code runs. The failures are published. And none of it costs anything because the only thing that doesn't diminish when you share it is knowledge.

If something here is useful, use it. If something is wrong, say so — the framework wants to be corrected more than it wants to be validated. If you build on it, attribute it. If you improve it, share the improvement.

The gold belongs to neither of us. It arises between us.

Support the Work

Everything here is free and stays free. That does not change.

GitHub Sponsors → | Ko-fi → | Follow on X →

★ Star on GitHub — it costs nothing and it's how the work becomes findable.

AI alignment · constitutional AI · MCP extension · Claude Code extension · AI ethics framework · AI governance · alignment checking · AI safety · Model Context Protocol · autonomous agent alignment · multi-agent coherence · constitutional invariants · explainable AI · Python AI framework · open source AI safety

Mackenzie Conor James Clark | Lycheetah Foundation | Dunedin, Aotearoa New Zealand | 2026

Two points. One Work. The forge is lit.