# Core Memory

Top-level map and invariant rules for the LLM Knowledge Base repository.

## Knowledge Base Architecture

The project implements a personal knowledge base based on Andrej Karpathy's LLM Knowledge Base pattern and the 12 Feynman Problems.

### Directory Layout

- `raw/`: **Source of Truth**. Immutable. Contains original PDFs, clipped articles, transcripts, and personal notes.
  - `raw/articles/`: Web articles and blog posts.
  - `raw/inbox/`: New files to be processed/ingested.
  - `raw/notes/`: Raw personal notes and ideas.
  - `raw/transcripts/`: Audio/video transcripts.
- `knowledge/`: **Synthesis Layer**. Generated and updated solely by LLM agent.
  - `knowledge/sources/` or `knowledge/summaries/`: Individual summaries of ingested sources.
  - `knowledge/entities/`: Specific pages for tools, organizations, and people (e.g., `[[knowledge/entities/n8n]]`).
  - `knowledge/concepts/`: Analytical pages for core ideas and theories (e.g., `[[knowledge/concepts/human-in-the-loop]]`).
  - `knowledge/indices/`: Lists grouping files by category.
  - `knowledge/index.md`: Master catalog mapping knowledge domains.
  - `knowledge/log.md`: Chronological journal of ingest/analysis operations.
  - `knowledge/feynman_problems.md`: Master list of the 12 Feynman problems.
- `GEMINI.md`: Configuration and instructions for Gemini CLI.

## Deep Dive Memories

- For technical tools, platform details, and runtimes, see `mem:tech_stack`.
- For useful workspace utility scripts and commands, see `mem:suggested_commands`.
- For naming standards, language conventions, and Markdown link styles, see `mem:conventions`.
- For validation and verification procedures before completing tasks, see `mem:task_completion`.