Skip to content

Guides and resources for AI engineers: an agents course, five handbooks, a hands-on second-brain project and a vetted reading list.

readme: resources with links

undefined-uiea031d8312d5
diff --git a/README.md b/README.md
index a584dcb..0025096 100644
--- a/README.md
+++ b/README.md
@@ -150,6 +150,81 @@ Claude Code, and with any agent that reads files. Obsidian is a viewer for the
graph, not a dependency. If you walk away from every tool named in this repo,
you keep the folder and everything in it.
+## Learning materials
+
+The source document, and the research behind the design decisions in this guide.
+
+**[Karpathy's llm-wiki gist](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f)**
+(4 April 2026). The pattern everything here builds on. Short, written as an idea
+file to paste into your own agent rather than as a spec. Read it first.
+
+**[From Local to Global: A Graph RAG Approach to Query-Focused
+Summarization](https://arxiv.org/abs/2404.16130)** (arXiv:2404.16130, Microsoft
+Research). Why chunk retrieval fails on questions about a whole corpus, which is
+exactly what people want from a second brain. Code:
+[microsoft/graphrag](https://github.com/microsoft/graphrag).
+
+**[HippoRAG: Neurobiologically Inspired Long-Term Memory for
+LLMs](https://arxiv.org/abs/2405.14831)** (arXiv:2405.14831). Graph retrieval
+with personalised PageRank for multi-hop questions. The closest published
+analogue of an agent walking links outward from a page.
+
+**[Lost in the Middle: How Language Models Use Long
+Contexts](https://arxiv.org/abs/2307.03172)** (arXiv:2307.03172, TACL). The
+empirical reason not to paste your whole vault into context, and the basis for
+the [context budget](docs/07-retrieval/context-budget.md) rules here.
+
+**[Andy Matuschak's notes](https://notes.andymatuschak.org)**. Evergreen notes,
+written in public. Also the strongest argument against this whole approach: if
+the writing is the thinking, delegating it means not doing it.
+
+Plus **How to Take Smart Notes** (Ahrens) and **Building a Second Brain**
+(Forte), both written before agents existed, which is what makes them worth
+reading now. Full list with notes: [resources/reading.md](resources/reading.md)
+and [resources/papers.md](resources/papers.md).
+
+## Tools
+
+**Core stack.** [Obsidian](https://obsidian.md) for storage,
+[Web Clipper](https://obsidian.md/clipper) for capture,
+[Claude Code](https://code.claude.com/docs/en/setup) for maintenance.
+
+**Plugins.** [Dataview](https://github.com/blacksmithgu/obsidian-dataview) for
+queries over frontmatter,
+[Templater](https://github.com/SilentVoid13/Templater) for pages you write by
+hand, and
+[Local REST API](https://github.com/coddingtonbear/obsidian-local-rest-api) if
+you want MCP access. That plugin now ships a built-in MCP server, so a separate
+one is often unnecessary; see [MCP for Obsidian](docs/02-setup/mcp-obsidian.md).
+
+**Capture and processing.** [yt-dlp](https://github.com/yt-dlp/yt-dlp),
+[youtube-transcript-api](https://github.com/jdepoix/youtube-transcript-api),
+[OCRmyPDF](https://github.com/ocrmypdf/OCRmyPDF),
+[Zotero](https://www.zotero.org).
+
+**Graph and search.** [ripgrep](https://github.com/BurntSushi/ripgrep),
+[NetworkX](https://networkx.org), [Kuzu](https://kuzudb.com),
+[Gephi](https://gephi.org).
+
+Full list, including alternatives to Obsidian:
+[resources/tools.md](resources/tools.md).
+
+## Other implementations
+
+Worth reading before writing your own page contracts.
+
+- **[Astro-Han/karpathy-llm-wiki](https://github.com/Astro-Han/karpathy-llm-wiki)**.
+ The pattern as one installable skill for Claude Code, Cursor and Codex.
+ Its list of what the author deliberately did not build is the most useful part.
+- **[micuintus/llm-wiki](https://github.com/micuintus/llm-wiki)**. Deliberately
+ minimal, convention-based rather than code-enforced. Good counterpoint.
+- **[NicholasSpisak/second-brain](https://github.com/NicholasSpisak/second-brain)**.
+ Four skills installable through npm, close to the original gist.
+- **[eugeniughelbur/obsidian-second-brain](https://github.com/eugeniughelbur/obsidian-second-brain)**.
+ Around 43 commands, works across Claude, Codex and Gemini.
+
+More context on each: [resources/skills.md](resources/skills.md).
+
## Contributing
Corrections, resources and real examples are welcome. Read