title	Bingo View Vault Architecture
type	map
status	active
created	2026-04-26
updated	2026-04-26
tags	second-brain llm-wiki architecture
aliases	知识库目录架构

Bingo View Vault Architecture

This Obsidian vault implements Karpathy's LLM Wiki pattern: raw sources are the immutable evidence layer, wiki/ is the LLM-maintained compiled knowledge layer, and [[AGENTS|AGENTS.md]] is the schema that governs agent behavior.

Directory Tree

Bingo-View/
├── raw/                         <- Immutable source layer
│   ├── assets/                  <- Obsidian attachments, images, PDFs, and media
│   ├── inbox/                   <- Unsorted intake
│   ├── 01-articles/             <- Web clips, articles, essays, technical posts
│   ├── 02-papers/               <- Papers, reports, PDFs, formal documents
│   ├── 03-transcripts/          <- Video, podcast, lecture, interview transcripts
│   ├── 04-meeting-notes/        <- Meeting notes and brainstorming material
│   ├── personal/                <- Personal growth, reflection, life systems
│   ├── research/                <- AI, technology, papers, and deep research
│   ├── reading/                 <- Books, chapters, essays, reading notes
│   ├── projects/                <- Project docs, plans, specs, work material
│   └── 09-archive/              <- Processed disposable intake archive
│
├── wiki/                        <- LLM-maintained compiled knowledge layer
│   ├── index.md                 <- Content catalog; read first for wiki navigation
│   ├── log.md                   <- Append-only operation log
│   ├── overview.md              <- High-level second-brain orientation
│   ├── sources/                 <- Source summaries derived from raw files
│   ├── concepts/                <- Ideas, frameworks, methods, mental models
│   ├── entities/                <- People, organizations, tools, products, books
│   ├── projects/                <- Active or archived project knowledge
│   ├── questions/               <- Durable answers to important questions
│   ├── syntheses/               <- Living analyses, comparisons, evolving theses
│   ├── archives/                <- Point-in-time saved answers
│   ├── maps/                    <- Maps of content and system orientation pages
│   └── templates/               <- Page templates and Karpathy reference templates
│
├── AGENTS.md                    <- Primary schema and operating manual
├── CLAUDE.md                    <- Claude-compatible pointer to AGENTS.md
├── GITHUB_SYNC.md               <- GitHub commit, branch, and push rules
├── README.md                    <- This directory architecture guide
│
├── .agents/skills/              <- Portable project-local Agent Skills
│   ├── ingest/
│   ├── query/
│   ├── lint/
│   ├── karpathy-llm-wiki/
│   ├── obsidian-markdown/
│   ├── obsidian-bases/
│   ├── json-canvas/
│   ├── obsidian-cli/
│   └── defuddle/
│
├── .claude/skills/              <- Claude Code-compatible skill mirror
│   ├── ingest/
│   ├── query/
│   ├── lint/
│   ├── karpathy-llm-wiki/
│   ├── obsidian-markdown/
│   ├── obsidian-bases/
│   ├── json-canvas/
│   ├── obsidian-cli/
│   └── defuddle/
│
└── .obsidian/                   <- Obsidian app configuration

Important Local Decisions

• Attachments live in raw/assets/, not a root-level assets/ directory. This follows Karpathy's original tip to use a fixed raw/assets/ attachment path.
• The source copy of Karpathy's LLM Wiki idea lives at [[raw/research/karpathy-llm-wiki|raw/research/karpathy-llm-wiki.md]], so Obsidian links can point to it.
• raw/09-archive/ is used for processed disposable intake. After successful ingest, sources under raw/inbox/, raw/01-articles/, raw/02-papers/, raw/03-transcripts/, or raw/04-meeting-notes/ are auto-archived to raw/09-archive/YYYY-MM/<original-subfolder>/. Stable evidence under raw/projects/, raw/personal/, raw/research/, raw/reading/, and attachments under raw/assets/ stay in place unless the user explicitly asks.
• [[AGENTS|AGENTS.md]] is the authority. [[CLAUDE|CLAUDE.md]] exists only to help Claude-style agents discover and follow [[AGENTS|AGENTS.md]].
• Project-local skills are vendored into both .agents/skills/ and .claude/skills/ so future agents can reuse the same workflows.

Core Workflow

• Ingest: read raw source, compile durable wiki pages, update [[wiki/index|wiki/index.md]], append to [[wiki/log|wiki/log.md]].
• Query: read [[wiki/index|wiki/index.md]] first, read relevant wiki pages, answer with citations, optionally save durable answers.
• Lint: check index consistency, links, orphan pages, contradictions, stale claims, and missing cross-references.

Start Here

• [[AGENTS|Bingo View LLM Wiki Schema]]
• [[GITHUB_SYNC|GitHub Sync Rules]]
• [[wiki/index|Index]]
• [[wiki/overview|Bingo View Second Brain]]
• [[wiki/maps/karpathy-llm-wiki-architecture|Karpathy LLM Wiki Architecture]]