CORE Documentation

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

🧭 New to CORE? Start with the plain-language overview: 👉 START HERE — What CORE Is and Why It Exists

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 and want more depth after the START HERE page, use:

1. What is CORE?

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

• What is CORE?

2. Architecture Overview

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

• Architecture

3. How Governance Works

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

• Governance Model

4. QuickStart Guides

If you want to run CORE immediately:

• Starter Kits
• Bring Your Own Runtime

---

⚙️ 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:

• CLI Reference
• CLI Command Index
• CLI Workflows

---

🧠 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:

• Autonomous Development Overview

---

📚 Deep Concepts & Internal Knowledge

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

• Philosophy
• Autonomy Ladder
• Context & Comparisons
• Worked Example

For internal mechanics:

• Introspection & Knowledge
• ContextPackage

---

🛠 Developer Resources

For contributors or maintainers of CORE:

• Contributing Guidelines
• Developer Cheat Sheet
• Technical Debt & Structure Notes

Planning documents:

• Complete Implementation Plan
• Restructure Plan
• Release Notes

---

🧵 Autonomy & Governance

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

• Peer Review
• Complexity Filtering
• Pragmatic Test Generation

Constitutional coverage & enforcement:

• Coverage Quick Reference
• Implementation Checklist
• Test Coverage Plan
• Remediation Summary

---

📖 Reference Materials

API and capability listings:

• API Reference
• Capability Reference

---

🗄 Archive

Historical and older planning materials:

• Academic Paper Draft
• Strategic Plan (Legacy)

---

🎯 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.