Агент выдаёт средние ответы, потому что ничего не знает о твоём продукте

Модели стали очень хороши. Теперь всё упирается в то, что они знают о тебе и твоём проекте. Чтобы структурировать контекст между мной, кофаундером и агентом, я собрал общий vault с папками, индексами и скиллами. Делюсь шаблоном на GitHub, развернёшь за пару минут и начнёшь заполнять своими знаниями.

Структура базы знаний продукта
Структура базы знаний продукта

Что происходит без контекста

Без твоего контекста агент делает одно из двух: лезет в открытые источники и выдаёт усреднённый ответ или выдумывает. Для ресёрча внешнего мира это полезно. Но когда ты работаешь над своим продуктом, пишешь пост или разбираешь своё поведение, он скорее уведёт не туда.

С командой разрыв только растёт. Продукт с недокументированными фичами и кодом становится головной болью. Знание живёт в головах, на каждом пересказе изменяется, а когда человек уходит, исчезает совсем.

Я видел это в Avito: куски легаси, которые инженеры боялись трогать, потому что никто уже не помнил, как оно работает. Агент без контекста упирается в ту же стену, что и новичок. Только спросить коллегу он не может.

База знаний в Obsidian закрывает разрыв. Контекст лежит в простых текстовых файлах. Claude их читает. Ничего не искажается и не теряется.

Зачем я сделал для агента второй мозг

Я перепроверяю всё, что делает мой агент, потому что мне тяжело отпускать контроль. Делегировать помогла общая структура, в которой я всегда знаю, что где лежит.

Личную базу я завёл несколько лет назад. Собрал кастомный Zettelkasten в Obsidian и постепенно наполнял. Подключить к нему Claude оказалось легко, потому что я понимал как и откуда в базе взялись знания, и настроил процесс автоматического добавления.

Общую базу для работы над моим продуктом вместе с кофаундером я спроектировал с нуля, сразу оптимизируя под работу с Claude. Теперь мы наполняем её вместе, и если продукт вырастет, легко подключим новых людей.

Граф моей личной базы знаний
Граф моей личной базы знаний

Что я делаю с личной базой

· Исследование контекста: «Покажи всё, что я знаю по теме, и подсвети пробелы».

· Поведенческие паттерны: «Посмотри мои записи из терапии и дневник, подсвети деструктивное поведение, которое я повторяю из раза в раз».

· Черновики постов: «Посмотри мои наброски по теме и собери черновик вокруг нужной мысли».

· Целеполагание: «Прочитай вижен на десять лет, цели на год, фокус на месяц и задачи на неделю, подскажи, на чём мне сфокусироваться сейчас».

Граф базы моего продукта
Граф базы моего продукта

Что я делаю с базой продукта

Она пока маленькая, многое делаю руками. Но Claude уже тащит:

· Беклог: «Придумал фичу, посмотри, есть ли похожее. Дополни или заведи новую заметку».

· Статус апдейт: «Что сделано и что осталось до запуска MVP».

· Промо: «Возьми наш ToV, маркетинговую стратегию и хорошие примеры, собери пост на определенную тему».

· Исследования: «Начни с того, что мы уже знаем, чтобы не копать одно и то же по кругу».

Как завести такую базу для своих проектов

Принцип простой: сначала спроектируй структуру, потом наполняй.

➀ Выбери инструмент. Конкретный конечно не важен. Бери то, что команда реально будет использовать, а не саботировать. Я работаю в Obsidian. По сути простая оболочка над текстовыми файлами.

➁ Собери структуру. Простую и понятную собрать не так тривиально. Итерируй с агентом под свои задачи. Не делай больше двух уровней вложенности, иначе запутаешь и себя, и агента. Что точно понадобится:

· инбокс для быстрого захвата входящих

· тематические папки (design, marketing, engineering, brand, business)

· процессные папки (team, processes, releases, meetings, decisions)

· технические папки (templates, attachments, bases, archive)

· дашборд для навигации человеком

· документ с правилами для навигации агентом

➂ Заведи темплейты. Для всего повторяющегося заведи шаблоны заметок с нужной мета-информацией. У меня: Decision, Meeting, Note, Person, Post, Release.

➃ Настрой индексы. Первым в каждой папке лежит документ с описанием, что внутри и в каком статусе. Все индексы ссылаются на дашборд и на правила. Так агент будет жрать меньше токенов при поиске.

➄ Договорись о процессах. Одному это лишнее, с командой проговори на берегу, иначе база превратится в свалку. Что прописать: как наполняется инбокс и кто его разбирает, как называть файлы, как связывать заметки и можно ли без связей (нельзя), что делать с устаревшим, как онбордить людей.

➅ Настрой синхронизацию. Делай сразу по уму через GitHub, с надежной историей версий. Но можно посинкать и через любое облако вроде iCloud.

➆ Подружи базу с агентом. Настрой MCP между агентом и заметками, чтобы он читал и писал. Напиши документ с правилами: расскажи юзкейсы, и он сам всё оформит и разложит. Добавь скиллы под частые работы, чтобы не жёг лишние токены.

➇ Протестируй. Самое интересное. Попроси агента сделать реальную задачу в базе и посмотри, как он работает с твоим контекстом, а не угадывает.

Мой шаблон на Гитхабе

Собирать с нуля необязательно. Я упаковал проектную версию базы в шаблон на GitHub: папки с индексом в каждой, шаблоны заметок, правила для агента и пара скиллов. Качаешь, открываешь как vault в Obsidian, включаешь Dataview и встроенный Templates, и через пару минут наполняешь своими знаниями. Без терминала и кода.

Ты и так уже это делаешь

Каждый день проектируешь информационную архитектуру, нейминг, иерархию и пишешь спеки для чужих продуктов. Делай это системно, в первую очередь для себя, и кайфанёшь от пользы.

Заглядывай в канал, там я рассказываю больше о том, как строю свой продукт Baselife и системы вокруг него. → https://t.me/initsrightplace