Obsidian как бэкенд для ИИ-агентов: хранилище, которое само ведёт записи. Пошагово
Содержание
- Что получится в итоге
- Почему это просто файлы, и это хорошо
- Шаг 1. Разделите хранилище на две зоны
- Шаг 2. В каждой папке положите файл AGENTS.md
- Шаг 3. Заставьте агентов вести журнал
- Шаг 4. Пусть цифры собирают скрипты
- Шаг 5. Увидьте в заметках таблицу
- Шаг 6. Не сваливайте весь контекст в чат
- Шаг 7. Поставьте интерфейс поверх файлов
- Если вы работаете из России
- Что важно знать до старта
- Три вещи, на которых всё держится
Заметки у большинства копятся годами. Записали идею, сохранили статью, завели папку, и через месяц туда никто не заглядывает. Такой «второй мозг» нужно кормить каждый день, а отдачи почти нет. А если добавить ИИ-агента, он нередко устраивает кашу: пересказывает ваши мысли по-своему, и вы уже не знаете, что в записи вы, а что модель.
Есть другой подход: смотреть на Obsidian не как на блокнот, а как на бэкенд. Это обычная папка с текстовыми файлами, в которой данные собирают скрипты, работу журналируют агенты, а сверху можно поставить свой интерфейс. Заметки перестают пылиться и сами подсказывают, что делать. Схема не привязана к одному инструменту: в примере с ней работают Claude Code, Codex, Pi и Hermes, а подойдёт любой агент, который умеет читать и писать файлы.
Разберём, как это устроено по шагам.
Что получится в итоге
Хранилище Obsidian, в котором:
- ваши мысли лежат отдельно от того, что пишут агенты;
- у каждой папки есть инструкция для агента;
- агенты сами записывают в дневную заметку, что сделали;
- цифры по всем платформам попадают в заметки скриптами, а не моделью;
- накопленные заметки работают как таблица данных;
- агент становится лучше с каждым запуском, потому что читает свои прошлые выводы.
Для примера возьмём рабочее хранилище с дневными заметками, проектами, задачами и контентом. Для отдела компании устройство то же: вместо просмотров и подписчиков будут заявки, обращения или выручка.
Почему это просто файлы, и это хорошо
Хранилище Obsidian это папка. Внутри обычные текстовые файлы в формате markdown. Базы данных нет, облака нет. Отсюда главное преимущество: всё принадлежит вам. Ничего нельзя отключить по подписке, а любой инструмент может читать и писать эти файлы. Сменили агента, и не нужно переносить ни память, ни историю переписки. Всё лежит там же, где лежало.
Шаг 1. Разделите хранилище на две зоны
Первое правило: ваши идеи и «идеи» робота хранятся отдельно. Агенты склонны объединять и сокращать то, что вы не просили сокращать. И вы уже не поймёте, где ваша мысль, а где то, что модель решила считать вашей мыслью.
Поэтому хранилище делится на две части:
- Человеческая. Дневные заметки, задачи, проекты, люди, контекст, шаблоны, материалы для контента. Агент может переносить и копировать, но писать и править здесь не должен.
- Машинная. Скрипты, журналы, исследования, рабочие процессы, результаты. Тут агент свободен: читает, пишет, правит. Если он наведёт беспорядок, это не страшно.

В примере это выглядит так: папка 00 Human с подпапками 10 Daily Notes, 20 Tasks, 30 Projects, 40 Resources, 50 People, 70 Context, 80 Templates, 90 Content. И отдельная папка Machine с подпапками Outputs, Scripts и Workflows.
Шаг 2. В каждой папке положите файл AGENTS.md
Это инструкция для агента: что в этом разделе лежит, что можно трогать, а что нельзя и как здесь работать. Файл лежит в корне хранилища и в корне каждой папки. Читать его будет любой агент, будь то Claude Code, Codex или другой.
Корневой файл служит картой и сводом правил. Он прямо говорит: не читай всё хранилище ради контекста, возьми только то, что нужно для задачи. А ещё в нём проведена жёсткая граница между двумя зонами.

Если агент сомневается, куда положить файл, он кладёт его в машинную зону. Перенести в человеческую вы можете сами. Чужие слова агенту нельзя сокращать и «причёсывать».
Шаг 3. Заставьте агентов вести журнал
Главная инструкция в корневом файле: всё, что агент сделал, он записывает в сегодняшнюю дневную заметку. Вы не ведёте дневник, журнал заполняется сам. В примере в файле прописаны шесть правил для каждой сессии. Вот их смысл:
- Запиши, что сделал, в сегодняшнюю заметку: одна строка с временем, действием и ссылкой на то, что создано. Если заметки нет, создай её из шаблона.
- Цифры берутся из скриптов, а не от тебя. Не оценивай, не округляй и не переноси старое значение. Если значение не прочиталось, скрипт пишет
unknown, а не ноль.- Свойства одинаковые во всех заметках одного типа. Не придумывай новые статусы, используй те, что в шаблоне.
- Перед рабочим процессом прочитай его папку: сначала
AGENTS.md, потомFINDINGS.md, потомSKILL.md.- После процесса запиши, чему научился: что было, какие факты, какой урок на следующий раз.
- Никаких паролей, ключей и токенов в заметках. Скрипты берут секреты из переменных окружения.

Ниже в том же файле идёт список «Остановись и спроси сначала». Туда попало всё, что уходит за пределы компьютера (письма, публикации, сообщения), удаление и массовое переименование заметок, переписывание чужого текста и правка шаблонов. Последнее важно: изменив свойства шаблона, вы меняете базу для всех будущих заметок.
Шаг 4. Пусть цифры собирают скрипты
Наверху каждой заметки Obsidian показывает свойства. Это блок данных в начале файла, так называемый front matter. В примере в шаблоне дневной заметки 32 свойства: тип, статус, дата, теги, а дальше метрики по каждой платформе: просмотры, подписчики, выручка и так далее. Пока заметка пустая, значения стоят как Empty.

Заполняет их не модель. У каждой платформы свой скрипт-сборщик. Он запускается по расписанию, обращается к официальному API и записывает значения в свойства. Скрипты лежат в Machine/Scripts/collectors/.

Это даёт три плюса. Вы не вводите данные руками. Данные собираются одинаково каждый день. И они не проходят через вероятностный фильтр ИИ, то есть модель не может их «угадать» или округлить. Откройте дневную заметку в любой момент, и цифры уже там.
Шаг 5. Увидьте в заметках таблицу
Теперь представьте каждую дневную заметку как строку, а каждое свойство как столбец. Получается таблица данных. Одинаковые свойства во всех заметках одного типа превращают Obsidian в полноценную базу. Дальше можно добавить столбец с работой агентов: что делал, сколько раз, с каким результатом.

В этом и смысл всей схемы: когда данные лежат так, поверх них можно строить что угодно. Агенты могут сворачивать историю заметок в выводы, а интерфейс может показывать, где нужно ваше внимание.
Шаг 6. Не сваливайте весь контекст в чат
Типичная ошибка: скормить агенту всё хранилище, думая, что больше контекста значит лучший ответ. На деле агент тонет. Это как дать человеку стопку материалов: начало и конец он запомнит, а середина потеряется.
Файлы AGENTS.md решают именно это. Агент сначала читает карту хранилища, коротко и по делу. Потом заходит в нужную папку и берёт только то, что нужно для этой работы: процесс, сегодняшнюю заметку и файл с выводами.

Файл с выводами, FINDINGS.md, делает агента лучше с каждым запуском. В примере для процесса по созданию коротких анимированных клипов в папке лежат материалы и инструкции. После каждого клипа в этот файл записывают, какие цифры получились, какие темы сработали, какие шутки зашли. Перед следующим запуском агент обязан это прочитать. Получается не просто «вот инструкция», а «вот инструкция, вот где мы сейчас и вот что мы узнали за множество прошлых раз». В компании то же можно сделать для ответов клиентам, разбора заявок или подготовки отчётов.
Шаг 7. Поставьте интерфейс поверх файлов
Можно остановиться и на предыдущем шаге: работать в Obsidian или просто в терминале. Но удобнее, когда сверху есть панель. В примере её сделали своим приложением: оно читает те же markdown-файлы, запускает те же скрипты и использует те же подключения. По духу интерфейс взят у медиаплееров и игровых приставок: прокручиваемые карточки, крупные заголовки.

Панель меняется в течение дня: подтягивает дела, показывает почту и то, что требует внимания. Раздел «Нужно от вас» строится на истории, которая накопилась в свойствах. Туда попадают дела, которые двигают работу вперёд.

Это не просто витрина. Через панель можно действовать. Если нужно ответить на письмо, и почта подключена на бэкенде, черновик создаётся и отправляется прямо отсюда. В примере по каждому решению есть доказательства, рекомендуемый шаг и четыре исхода: продолжить, запросить контекст, отказаться, отложить. Рядом поле, где записывают, почему выбрано именно так, чтобы потом не гадать. Там же видны остановленные запуски агентов с пометкой, что нужно посмотреть.
Так же можно запускать любые рабочие процессы агентов и исследование контента: выбрать несколько публикаций по теме, отправить агентов собрать комментарии и понять, о чём говорят люди. Предложения агентов опираются на реальную историю, а не на догадки.
Если вы работаете из России
Схема держится на обычных файлах, поэтому от конкретного сервиса почти не зависит. Хранилище лежит у вас на компьютере или сервере, и данные никуда не уходят.
Из упомянутых агентов Claude Code и Codex из России напрямую не работают. Но схема от них не зависит: подойдёт любой агент, который читает и пишет файлы. В примере названы ещё Pi и Hermes. Проверьте, можно ли запустить их у себя на сервере вместе с открытой моделью: тогда схема работает без зарубежных сервисов. Можно взять и российскую модель, если она справляется с инструкциями в AGENTS.md.
Скрипты-сборщики вызывают официальные API платформ. Если сервис отсюда недоступен, скрипт для него не заработает. Берите источники, которые открыты вам: CRM, бухгалтерию, службу поддержки, свои базы. Принцип тот же: скрипт по расписанию кладёт цифры в свойства.
Что важно знать до старта
- Агенту нужны границы. Без жёсткого разделения зон он будет переписывать ваши заметки. Начните с правила: в человеческую зону не писать.
- Цифры только от скриптов. Если модель заполняет метрики, вы не знаете, угадала она или посчитала. Пусть пишет
unknown, а не ноль. - Один формат свойств. Одинаковые названия и значения из фиксированного списка во всех заметках одного типа. Иначе таблицы не получится. Менять шаблон надо осторожно.
- Ключи и пароли в заметки не кладут. Скрипты берут секреты из переменных окружения.
- Опасные действия через подтверждение. Отправка писем, публикации, удаление и массовые правки: сначала спросить.
- Интерфейс сложнее, чем кажется. Правила и файлы это текст, их можно ввести сразу. Панель поверх них уже отдельная разработка: много мелких деталей, поставленных друг на друга.
- Выводы нужно вести.
FINDINGS.mdработает, только если агент обязан его читать и обновлять. Это закрепляется в правилах.
Три вещи, на которых всё держится
Если убрать подробности, остаются три принципа. Markdown-файлы со свойствами. Файл AGENTS.md в каждой папке. И способ вести выводы, чтобы агенты улучшались. Дальше на этом можно строить что угодно.
Мы в Агентехе учим сотрудников выстраивать такие правила для своих агентов: что можно, что нельзя и что сначала согласовать с человеком. Как устроено обучение.