Jun 9, 2026, 3:22 PM

brain/GEMINI.md

@@ -6,6 +6,14 @@ This document defines the structure, conventions, and workflows for maintaining
 This wiki is an LLM-maintained knowledge base focused on **AI, Databases, Programming, and Knowledge Management**, integrated with **Feynman's 12 Favorite Problems** framework. 
 The LLM writes and maintains all files under `wiki/`. The human curates raw sources and directs queries.
 
+**The Core Idea**: Unlike traditional RAG systems that re-derive answers from scratch on every query, this wiki is a **persistent, compounding artifact**. The LLM incrementally builds a structured, interlinked collection of markdown files. When new sources are added, the LLM integrates the knowledge, updates cross-references, and flags contradictions. You (the human) are in charge of exploration; the LLM does the bookkeeping. *Obsidian is the IDE; the LLM is the programmer; the wiki is the codebase.*
+
+## Architecture
+There are three distinct layers to this setup:
+1. **Raw sources (`raw/`)** — Your curated collection of source documents. These are immutable.
+2. **The wiki (`wiki/`)** — A directory of LLM-generated markdown files (summaries, concepts, etc.). The LLM owns this layer entirely.
+3. **The schema (this `GEMINI.md` file)** — The configuration file that tells the LLM how the wiki is structured and what workflows to follow.
+
 ## Directory Layout
 - `raw/` — Immutable source documents (transcripts, articles, notes). Never modify these.
 - `wiki/` — LLM-generated markdown files.
@@ -90,3 +98,11 @@ When the user says "ingest [source]" or adds a file to `raw/`:
 - Use Obsidian-style links: `[[concepts/concept-name]]`.
 - Confidence levels: **high** (multiple sources), **medium** (single source), **low** (speculative).
 - Polish language for content, English/Technical slugs for filenames.
+
+## Optional Tools & Tips
+- **Obsidian Web Clipper**: Browser extension for converting web articles to markdown to quickly get sources into your `raw/` collection.
+- **Download Images Locally**: Configure Obsidian to download attachments locally (e.g., to `raw/assets/`). This allows the LLM to view and reference images directly without relying on URLs that may break. (LLMs may need to read text first, then process images separately).
+- **Obsidian Graph View**: The best way to see the shape of the wiki, identify hubs, and spot orphan pages.
+- **Dataview Plugin**: Use this Obsidian plugin to generate dynamic tables and lists by querying the YAML frontmatter the LLM adds to pages.
+- **Marp**: Markdown-based slide format. Used in `wiki/presentations/` to generate decks directly from content.
+- **qmd (Search Tool)**: A local search engine for markdown files (hybrid BM25/vector search + LLM re-ranking). Very useful as the wiki grows beyond what `index.md` can efficiently handle. Can be used as a CLI tool or MCP server.