Skip to content

Latest commit

 

History

History
50 lines (36 loc) · 2.68 KB

File metadata and controls

50 lines (36 loc) · 2.68 KB

Docs

docs/ is the active architectural documentation surface for remram-cortex.

The repository has been reset around the layered architecture and the current chosen stack.

Structure

  • overview/: what Cortex is, why it exists, and how the repository is organized
  • authority-map.md: canonical doc split, read order, and legacy handling
  • glossary.md: locked shared terminology
  • concepts/: stable concept definitions that survive implementation changes
  • design/: the active architecture, stack, integration, and deployment docs
  • context-packs/: AI-oriented briefing packs for compact thread start, NotebookLM, and audio debriefs
  • reference/: curated technical notes for the core technologies currently in use

Start Here

AI Handoff Path

For a new AI implementation thread, the recommended read order is:

  1. context-packs/cortex-core/README.md
  2. context-packs/cortex-core/00-repo-orientation.md
  3. context-packs/cortex-core/01-terminology-and-legacy.md
  4. context-packs/cortex-core/02-layers-and-authority.md
  5. context-packs/cortex-core/05-phases-and-delivery.md
  6. ../projects/mvp-1-practical-cortex/README.md
  7. ../projects/mvp-1-practical-cortex/project-plan.md

Use the expanded Layered Cortex Stack pack when you want a longer topic-by-topic briefing or audio-oriented source set.

Canonical Rule

The canonical authority order is:

  1. authority-map.md
  2. glossary.md
  3. design/
  4. supporting summaries in concepts/, product/, projects/, and context-packs/

Historical material removed from the active tree now lives under the top-level archive/.