# A second brain for Claude Code, and where it stops > Source: > Published: 2026-11-07 00:00:00+00:00 Blog # A second brain for Claude Code, and where it stops Published: November 7, 2026 A second brain for Claude Code is usually a folder of markdown notes, often an Obsidian vault, that you start Claude Code in, with a `CLAUDE.md` at the root that tells it how the notes are organized. Claude reads and writes the notes; you read them in Obsidian. For one person on one machine it works well. It does not reach a teammate, another machine, or another coding agent, and that is the part this note is about. ## What is a Claude Code second brain? Three layers, all plain files. The **notes** are the markdown pages, written by you, by Claude, or both. The **schema** is a `CLAUDE.md` (or `AGENTS.md`) at the root that says where things go, how pages are named and what Claude should do with a new source. The **viewer** is Obsidian, which shows the same files as linked pages. Nothing needs a plugin or a server: Claude Code works on the folder with its normal file tools. It is the same shape as [Karpathy's LLM wiki](https://gethrbr.com/blog/karpathy-llm-wiki), which is where much of the 2026 interest came from: the agent files what it learns once, cross-links it, and answers from the pages instead of rediscovering the same facts every session. ## What does Claude Code load from the vault? Less than people assume, and in a fixed order. From Anthropic's [memory docs](https://code.claude.com/docs/en/memory): | File | When Claude gets it | Who writes it | |---|---|---| | `CLAUDE.md` in the folder you start in, and above it | At launch, the whole file | You | | `CLAUDE.md` in a subfolder | Only once Claude reads or edits a file in that subfolder | You | | A file named with `@path` inside a CLAUDE.md | With the file that imports it, up to four hops deep | You | | Any other note in the vault | Only if Claude decides to open it | You or Claude | | Auto memory, `MEMORY.md` | At launch, the first 200 lines or 25KB | Claude | So the root `CLAUDE.md` is the one page you can count on being read. Put the map there: the folders, what each holds, and which index page to open first. Everything else is a page Claude has to choose to read. Anthropic suggests keeping each CLAUDE.md under 200 lines; imports organize a long file but do not make it cheaper, because imported files load with it. ## How do I set one up? - **Make the folder.** Open it as a vault in Obsidian if you want to read it there, and start`claude` in it. - **Write the root CLAUDE.md.** The folder layout, a naming rule for pages, and what to do with a new source: summarize it, update the pages it touches, add a line to a log. - **Keep one index page.** A list of every page with one line each. Claude opens it first and decides from it what else to read. - **Keep it shallow.** A few top folders beat a deep tree, because Claude has to find a page before it can use it. - **Put the vault in git.** It gives you history, and a way to undo an edit Claude should not have made. ## Is auto memory already a second brain? Partly. Claude Code writes its own notes to `~/.claude/projects//memory/` and loads the start of `MEMORY.md` into every session. It is a good memory of how you like to work. It is also machine-local: the docs say the files are not shared across machines or cloud environments, and only Claude Code reads them. A vault you choose to sync goes further, but it is still yours alone. ## Where a personal second brain stops Take one decision. In `#eng-payments` the team agrees that webhook handlers return a 200 and enqueue, and never do the work inline. You write it into your vault. Then: - **Your teammate's agent never sees it.** The note is on your machine, in your vault. - **Other agents read other files.** Codex reads`AGENTS.md` and never`CLAUDE.md` , and Cursor and Copilot each have rule files of their own. A Claude-shaped vault reaches Claude. The[AGENTS.md vs CLAUDE.md](https://gethrbr.com/blog/agents-md-vs-claude-md) note covers which tool loads what. - **Nothing gates what goes in.** Alone, you are the gate. Shared, one wrong page is repeated by every agent that reads it; see[agent memory poisoning](https://gethrbr.com/blog/agent-memory-poisoning) . - **Nothing tells you a page went stale.** When the queue is replaced, the old page stays until somebody remembers it. - **Nobody knows which pages are used.** You can see what is in the vault, not what any session actually read. ## A second brain for a team's agents This is what Harbor is for. It is shared memory for engineering teams using coding agents: one store that Claude Code, Codex, Cursor and GitHub Copilot all read, wired with `npx harborloop init`. It learns from your sessions and, if you connect them, from Slack threads, pull request reviews and docs. You set the gate: routine rules can go live on trial, and a secret, an install step or a clash Harbor cannot settle waits for a person. Each session gets the rules that fit its task, not the whole store, and every rule shows how often it was served and how often an answer cited it. A cite is evidence a rule was used, not proof it was obeyed. Keep the vault for your own notes, papers and drafts. It is very good at that. Put what the team decided where every agent on the team can get it. ## Questions ### What is a second brain for Claude Code? A folder of markdown notes, often an Obsidian vault, that you start Claude Code in, with a CLAUDE.md at the root describing how the notes are organized. Claude reads and writes the notes with its normal file tools, and you read them in Obsidian. No plugin or server is needed. ### Does Claude Code read every note in my Obsidian vault? No. At launch it loads the CLAUDE.md files in the folder you start in and above it, files those import with @path (up to four hops), and the first 200 lines or 25KB of its auto memory. A CLAUDE.md in a subfolder loads once Claude works in that subfolder. Any other note is read only if Claude decides to open it. ### Is Claude Code auto memory a second brain? Partly. Claude writes notes to ~/.claude/projects//memory/ and loads the start of MEMORY.md every session. It is machine-local, not shared across machines or cloud environments, and only Claude Code reads it. ### Can a team share a Claude Code second brain? Not as is. The vault is on one person's machine, Codex, Cursor and Copilot read their own files, and nothing gates what goes in or flags a page that went stale. A team needs one store every agent reads, a gate on what goes live, and a count of which rules sessions used. Harbor is built for that.