Skip to content

CORE Documentation

Welcome to the CORE Documentation Hub — the complete guide to understanding, operating, and extending the Constitutional, Self‑Governing AI Development Framework.

CORE is built on a clear architectural model:

  • Mind — Governance, policies, constitutional rules (src/mind/)
  • Body — Execution engine, CLI, services, actions (src/body/, src/features/, src/services/)
  • Will — Agents, reasoning, LLM orchestration (src/will/)

The purpose of this documentation is to give you a clean, accurate, and up‑to‑date entry point into the system — free from architectural drift, speculative features, or outdated assumptions.

🚀 Getting Started

If you are new to CORE, start with these pages:

1. What is CORE?

A clear explanation of the philosophy and motivation behind the project.

2. Architecture Overview

How CORE is structured internally: Mind–Body–Will, governance model, lifecycle.

3. How Governance Works

Learn how the .intent/ constitution controls everything CORE does.

4. QuickStart Guides

If you want to run CORE immediately:

⚙️ How to Use CORE

CORE exposes a powerful CLI called core-admin, which integrates:

  • Constitutional audits
  • Autonomous development
  • Context building
  • Knowledge syncing
  • Self‑healing and remediation

To explore the CLI:

poetry run core-admin --help
poetry run core-admin inspect command-tree

You will find detailed explanations in:

🧠 Autonomous Development (Shipped Today)

CORE can already:

  • Create governed feature crates
  • Use AI agents to generate code, tests, and documentation
  • Validate all changes locally (Black, Ruff, Pytest)
  • Run full constitutional audits via the Mind
  • Accept or reject crates based on compliance

Learn exactly what works today:

📚 Deep Concepts & Internal Knowledge

If you want to understand CORE beyond its interface, explore:

For internal mechanics:

🛠 Developer Resources

For contributors or maintainers of CORE:

Planning documents:

🧵 Autonomy & Governance

To understand how CORE keeps itself safe, governed, and free from structural drift:

Constitutional coverage & enforcement:

📖 Reference Materials

API and capability listings:

🗄 Archive

Historical and older planning materials:

🎯 About This Documentation

This documentation is structured to:

  • Stay aligned with the actual codebase (no speculative features)
  • Reflect the current state of autonomy (A1 → A2)
  • Support ongoing development of governed AI systems
  • Serve as a clean entry point for new contributors

If you ever find a discrepancy between docs and code, treat it as a bug.

Welcome to CORE — a system designed not just to run code, but to govern its own evolution.