Guides and resources for AI engineers: an agents course, five handbooks, a hands-on second-brain project and a vetted reading list.
JavaScript agent-skillsai-agentsai-engineeringclaudeclaude-codeclaude-skillsknowledge-graphknowledge-managementllmmcpobsidianpersonal-knowledge-basepkmsecond-brain
readme: resources with links
undefined-uiea031d8312d5
diff --git a/README.md b/README.mdindex 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 thegraph, 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).+## ContributingCorrections, resources and real examples are welcome. Read