Одна из главных проблем при использовании ИИ-агентов в разработке — потеря контекста. Каждый новый чат с Claude или другой моделью начинается с нуля: нужно заново объяснять архитектуру проекта, стек, договорённости команды. При этом токены расходуются быстро, особенно если агент анализирует весь код при каждом запросе. Решение, которое описывает автор гайда, — дать агенту постоянную локальную базу знаний через Obsidian.
Obsidian — приложение для ведения заметок, которое хранит данные в виде обычных текстовых markdown-файлов на локальном диске. Ключевая особенность — система ссылок между файлами: агент не читает весь проект, а переходит по связям к нужному разделу. Для интеграции с ИИ-агентами используется плагин Local REST API из каталога Community Plugins — он открывает доступ к хранилищу через протокол MCP (Model Context Protocol). MCP — стандарт, который позволяет языковым моделям обращаться к внешним инструментам и источникам данных в реальном времени; Claude поддерживает его нативно.
| Раздел базы знаний | Что хранит | Кто ведёт |
|---|---|---|
| context | ТЗ, требования, термины, записи встреч | Разработчик / агент |
| structure | Документация кодовой базы, описание файлов и модулей | Агент (актуализирует при каждом изменении) |
| daily-changes | Лог изменений кода и базы знаний по датам | Агент автоматически |
Структура базы знаний строится вокруг трёх разделов. Папка context хранит всё, что относится к постановке задачи: техническое задание, термины, требования, записи встреч. Папка structure — это живая документация кодовой базы: в идеале её дерево файлов повторяет структуру самого проекта. Папка daily-changes ведётся как лог: агент фиксирует в ней, что именно было изменено в коде и в базе знаний за каждую сессию. Каждый раздел содержит index.md — файл с оглавлением и инструкциями для агента по работе с этим разделом. Корневой README.md связывает всё вместе и задаёт общие правила поведения ИИ.
Структура базы знаний делится на три раздела: context (ТЗ, требования), structure (документация кода) и daily-changes (лог изменений).
Для подключения агента к проекту в корне репозитория создаётся файл CLAUDE.md (или AGENTS.md для других агентов). Claude автоматически включает его содержимое в каждый запрос — это системный промпт, описывающий роль агента и порядок работы с базой знаний. Пример из гайда предписывает агенту при получении любой задачи сначала прочитать README в Obsidian, найти релевантные разделы и только потом вносить изменения в код.
Подход масштабируется на командную работу: база знаний в Obsidian — это просто папка с файлами, которую можно добавить в отдельный Git-репозиторий. Разные разработчики работают с одной и той же документацией, агент актуализирует её после каждого изменения. Фактически команда получает документацию, которая поддерживается в актуальном состоянии автоматически, а не устаревает через неделю после написания. Для небольших проектов автор предлагает упрощённый вариант из трёх файлов: README.md, context.md и structure.md — без вложенных папок.
