Чек-лист

Граф знаний Obsidian + Claude Code

Граф знаний в Obsidian как память для Claude Code по «сетапу Карпаты»: три слоя — raw (сырьё), wiki (Claude сам превращает сырьё в статьи) и output (готовые артефакты). Свалка файлов памятью не станет.

Содержание5 глав
  1. 011. Идея вместо обычного RAG
  2. 022. Механика с Obsidian и Claude Code
  3. 033. Архитектура: три слоя по Карпатому
  4. 044. Три операции с вики
  5. 055. Практические советы

Обычный чат с ИИ каждый раз пересобирает ответ из загруженных файлов заново — знания не накапливаются. Есть другая схема: агент постепенно строит и поддерживает постоянную вики поверх твоих заметок в Obsidian, и она становится только богаче со временем. Вот как устроена архитектура и что с ней делать на практике.

Важно
В оригинальном паттерне Андрея Карпатого (LLM Wiki) третий слой — не «готовые артефакты», а «схема»: документ вроде `CLAUDE.md`, который описывает LLM структуру и правила самой вики. Презентации и отчёты — это, скорее, результат операции «запрос» поверх вики, которую при желании можно сохранить как ещё одну её страницу; отдельный слой «аутпут

1. Идея вместо обычного RAG

  • Проблема: в типичном RAG-подходе (NotebookLM, загрузка файлов в чат) агент каждый раз заново собирает ответ из фрагментов источников — знания не накапливаются между запросами.
  • Альтернатива: агент постепенно строит и поддерживает постоянную вики — структурированный набор взаимосвязанных markdown-файлов между тобой и сырыми источниками.
  • Разница: при добавлении нового источника агент не просто индексирует его — он сразу интегрирует материал в вики: обновляет карточки, отмечает противоречия со старыми данными, усиливает синтез.

2. Механика с Obsidian и Claude Code

  • Логика: хранилище (vault) Obsidian — обычная папка с markdown-файлами на диске; само приложение бесплатно для личного использования.
  • Подключение: Claude Code, открытый в этой же папке, видит все заметки как обычные файлы — отдельной интеграции или API не требуется.
  • Роли: Obsidian — среда для просмотра и навигации (граф связей, вики-ссылки), Claude Code — тот, кто читает и пишет файлы вики.

3. Архитектура: три слоя по Карпатому

  • Слой 1, сырьё: неизменяемая коллекция источников — статьи, транскрипты, PDF; агент только читает их и никогда не редактирует.
  • Слой 2, вики: директория markdown-файлов, которые агент сам генерирует и поддерживает — карточки сущностей, сравнения, обзоры, перекрёстные ссылки.
  • Слой 3, схема: документ вроде CLAUDE.md (для Claude Code) или AGENTS.md (для Codex) — описывает структуру вики и порядок работы; именно он делает агента дисциплинированным хранителем вики, а не обычным чат-ботом.

4. Три операции с вики

  • Ingest (приём): агент читает новый источник, обсуждает с тобой ключевые выводы и обновляет карточки и индекс — один источник может затронуть 10-15 страниц вики.
  • Query (запрос): агент ищет нужные страницы, читает их и синтезирует ответ со ссылками; удачный ответ можно сохранить обратно в вики отдельной страницей, а не терять в истории чата.
  • Lint (проверка): периодически агент ищет в вики противоречия между страницами, устаревшие утверждения и страницы-сироты без входящих ссылок.

5. Практические советы

  • Навигация: index.md — каталог всех страниц вики по категориям с кратким описанием каждой; log.md — хронологический журнал операций, который легко фильтровать обычными unix-командами.
  • Инструменты Obsidian: Web Clipper конвертирует веб-статьи в markdown прямо в хранилище; граф связей показывает, какие страницы стали хабами, а какие остались без ссылок.
  • При росте вики: на умеренном масштабе (около сотни источников, сотни страниц) достаточно одного индексного файла; для большего объёма можно подключить локальный поисковый движок с гибридным BM25/векторным поиском по markdown без облака.

Obsidian — это среда для просмотра, LLM — тот, кто пишет вики, а сама вики — растущая база знаний, а не разовый ответ.