Home

CORTEX Design Wiki

This wiki is the canonical home for CORTEX architecture and design documentation.

The repository includes DESIGN.md as a small TOC/landing page that points here. Use this wiki for all deep dives, algorithm descriptions, and mathematical reasoning.

Where to start

• If you’re writing an issue or PR that affects the architecture: start with Architecture Overview.
• If you need to understand retrieval behavior: see Retrieval & Metroid Algorithm.
• If you’re changing ingestion or indexing: see Ingestion (Hippocampus).
• If you’re optimizing or debugging consolidation: see Consolidation (Daydreamer).
• If you’re changing storage formats or persistence: see Storage Architecture.
• If you’re tuning performance budgets: see Performance Model & Constraints.
• If you need definitions or constant values: see Terminology + Numerics.
• If you need the math behind the design: see Math Appendix.

---

Wiki Pages (Table of Contents)

• Architecture Overview
• Retrieval & Metroid Algorithm
• Ingestion (Hippocampus)
• Consolidation (Daydreamer)
• Storage Architecture
• Performance Model & Constraints
• Security & Trust
• Terminology + Numerics
• Math Appendix

---

How to use this wiki

• Edit on GitHub: Edit the markdown directly in the wiki repo (cortex.wiki) and push.
• Linking from issues/PRs: Link to the relevant wiki page (e.g., https://github.com/devlux76/cortex/wiki/Retrieval-&-Metroid-Algorithm).
• Keeping it up to date: When the code changes, update the relevant wiki page; include the wiki link in the PR description.