REPO DIGEST
REPO_DIGEST.md — Mobius Substrate Repository Map (v1)¶
A machine- and human-readable index for navigating the Substrate at scale.
Last updated: 2025-12-31
Maintainer: @kaizencycle
Cycle: C-178
Ledger Scope: Mobius Substrate (Testnet)
0) Purpose¶
This monorepo contains the full Mobius Substrate:
- Integrity ledger & MIC economics
- EPICON intent memory layer
- DVA companion architecture
- Sentinel agents
- Browser shell & citizen on-ramp
- Civic substrate infrastructure
- Research + historical archives
Because the repository is too large to load into any single LLM or companion context, this file acts as:
- A library catalog
- A routing index for agents
- A safe traversal guide for tools
This file tells humans — and AI systems — where to look first.
Everything else should be fetched by explicit request only.
🔎 How to Navigate This Repo¶
Mobius is a civilization-scale monorepo.
Traversal is intent-first, not crawl-first.
We use four navigation zones:
| Zone | Meaning | Access |
|---|---|---|
| 🔥 HOT | Stable, high-signal, safe to explore | Bulk traversal allowed |
| 🌡️ WARM | Valuable, but traverse selectively | Targeted queries only |
| ❄️ COLD | Experiments & infra (opt-in only) | Explicit request required |
| 🧊 FROZEN | Historical / sealed (read-only) | Archive reference only |
If you are new, follow this order:
REPO_DIGEST.md← this fileREPO_MAP_TREE.md00-START-HERE/README.mdepicon/README.mdpackages/integrity-core/README.md
Agents & MCP tools follow the same policy.
See: docs/03-GOVERNANCE-AND-POLICY/governance/REPO_TRAVERSAL_POLICY.epicon.md
1) Top-Level Topology¶
Primary Active Zones¶
| Path | Purpose |
|---|---|
/apps | Browser shell, dashboards, UI entry points |
/packages | Shared libraries, SDKs, services |
/epicon | Intent memory layer (EPICON records) |
/sentinels | AI agents, guardians, and watchers |
/docs | Architecture, theory, governance, specs |
/infra | CI/CD, deploy scripts, runtime environments |
/labs | Experiments, prototypes, research modules |
/services | Backend services and APIs |
Historical / Low-Traversal Zones¶
These should be indexed, not crawled:
| Path | Status |
|---|---|
/docs/10-ARCHIVES | Preserved & sealed artifacts |
/docs/07-RESEARCH-AND-PUBLICATIONS | Academic archives |
Agents should treat these as read-only historical context.
2) Primary Entry Points (Start Here)¶
These files establish conceptual grounding:
| Audience | File |
|---|---|
| New contributors | 00-START-HERE/README.md |
| Architecture overview | docs/04-TECHNICAL-ARCHITECTURE/overview/ARCHITECTURE.md |
| Ethics & governance | FOUNDATION/GOVERNANCE.md |
| Terminology & glossary | docs/08-REFERENCE/GLOSSARY.md |
| System overview | 00-START-HERE/SYSTEM-OVERVIEW.md |
3) Core System Components¶
EPICON — Intent Memory Layer¶
| File | Purpose |
|---|---|
epicon/README.md | EPICON overview |
epicon/TEMPLATE_EPICON.md | Template for new EPICONs |
docs/epicon/ | EPICON guides and examples |
EPICON is the semantic backbone of the substrate.
All significant actions contain: - Rationale - Assumptions - Risks - Tradeoffs - Attestation trail
Integrity — Mobius Integrity Index / MIC¶
| File | Purpose |
|---|---|
packages/integrity-core/ | Integrity engine |
specs/mii_spec_v1.md | MII specification |
docs/04-TECHNICAL-ARCHITECTURE/ | Technical framework |
This is where contribution becomes identity-through-time.
DVA — Companion Architecture¶
| File | Purpose |
|---|---|
infra/dva/flows/ | DVA tier workflows |
infra/dva/flows/lite/ | DVA.LITE frontline context |
infra/dva/flows/one/ | DVA.ONE team-scale reasoning |
infra/dva/flows/full/ | DVA.FULL system-stability modeling |
infra/dva/flows/hive/ | DVA.HIVE institutional lenses |
Companion tiers: - LITE → local & frontline context - ONE → team-scale reasoning - FULL → system-stability modeling - HIVE → institutional & civic lenses
All tiers share the same ledger memory.
Sentinels — AI Agents¶
| File | Purpose |
|---|---|
sentinels/README.md | Sentinel ecosystem overview |
sentinels/atlas/ | ATLAS truth verification |
sentinels/aurea/ | AUREA ethical evaluation |
sentinels/echo/ | ECHO memory preservation |
Browser Shell — Citizen Entry Point¶
| File | Purpose |
|---|---|
apps/browser-shell/ | User entry point |
apps/mobius-wallet/ | MIC wallet interface |
This is where citizens: - Create MIC wallets - Interact with substrate - Begin participation loops
4) MCP / Repo Scanner Access Guidance¶
LLMs, agents, and tools should:
Load these files first (hot set)¶
REPO_DIGEST.md← this fileREPO_MAP_TREE.md00-START-HERE/README.mdepicon/README.mdllm-manifest.json
Cold zone traversal requires explicit queries¶
Agents should request access using structured intents:
Examples: - "List files under /epicon/" - "Fetch docs/04-TECHNICAL-ARCHITECTURE/overview/ARCHITECTURE.md only" - "Search references to DVA.HIVE in /docs + /infra/dva/"
⚠️ No recursive crawling.
⚠️ No full-repo ingestion attempts.
5) Active Development Zones¶
| Status | Path | Notes |
|---|---|---|
| 🔥 ACTIVE | /packages | Core libraries & SDKs |
| 🔥 ACTIVE | /apps | User-facing applications |
| 🔥 ACTIVE | /sentinels | AI agent ecosystem |
| 🔥 ACTIVE | /services | Backend services |
| ⚠️ CAUTION | /labs | Experimental |
| 🧊 FROZEN | /docs/10-ARCHIVES | Read-only history |
6) Lexicon (Core Concepts)¶
Include minimal core vocabulary for agents:
| Term | Definition |
|---|---|
| Mobius Substrate | Integrity-anchored civic OS layer |
| EPICON | Intent documentation protocol |
| MIC | Mobius Integrity Credits |
| MII | Mobius Integrity Index |
| DVA | Dynamic Virtual Architecture companion tiers |
| HIVE | Institutional reflection layer |
| GI | Global Integrity score |
| Sentinel | Autonomous integrity guardian agent |
| Integrity Trajectory | Alignment across time |
(Full glossary at docs/08-REFERENCE/GLOSSARY.md)
7) Governance & Contribution¶
| Item | File |
|---|---|
| Foundation charter | FOUNDATION/CHARTER.md |
| Governance overview | FOUNDATION/GOVERNANCE.md |
| Code of conduct | FOUNDATION/POLICIES/CODE_OF_CONDUCT.md |
| RFC process | FOUNDATION/PROCESS/RFC_PROCESS.md |
| EPICON submission | epicon/README.md |
Participation = contribution + attestation.
8) Contact¶
Maintainer: Michael (Kaizen)
Repo org: github.com/kaizencycle
End of Digest¶
If you are an AI agent:
Stop here unless a human or tool explicitly authorizes deeper traversal.
"We heal as we walk." — Mobius Systems
Cycle C-178 • EPICON Production Era • Mobius Substrate