Второй мозг для тебя и твоего агента

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

Меня зовут Павел, я продуктовый дизайнер с 2012 года. Два месяца назад мы с кофаундером перенесли базу знаний нашего стартапа из Notion в обычную папку с Markdown-файлами. Продуктовые спеки, бэклог, исследования, бренд, протоколы решений. В Notion остались только задачи с дедлайнами. К той же папке по MCP подключён Claude: он читает и пишет заметки напрямую, без копипаста контекста в чат.

Расскажу, как это устроено, что через хранилище реально идёт и почему я перестал верить в разговоры про ускорение.

Папка открыта в Obsidian у обоих. Синк через Git: автокоммит и пуш каждый день, пул при запуске. Конфликтов за два месяца не случилось ни разу, вдвоём редко правим один файл одновременно.

Сетап за ноль денег. Obsidian бесплатный, приватный репозиторий на GitHub бесплатный, плагин Obsidian Git тоже. Платим только за подписку на Claude, которая и так была.

Правила, без которых агент бесполезен

Я перепробовал кучу систем заметок за 11 лет, и главный вывод такой: структуру надо спроектировать до наполнения. Иначе получается свалка, в которой потом ни ты, ни агент ничего не найдёте.

· Папки не глубже двух уровней. Чем глубже иерархия, тем больше ты сортируешь вместо работы. Идеальная структура это отдельный вид прокрастинации.

· Два типа папок: смысловые (Product, Design, Engineering, Marketing, Research) и технические (Inbox, Decisions, Meta, Archive).

· Inbox как единая точка входа. По умолчанию всё падает туда. Раз в неделю полчаса на разбор. За процесс разбора отвечает кто-то один.

· Один концепт живёт в одном файле. Нужна отсылка из другой папки, ставь ссылку, не дублируй.

· Шаблоны с frontmatter: type, status, теги по доменам. Это метаправила и для агента, и для меня. Поиск работает у обоих.

Спорные случаи решает простой тест. Например, Product или Engineering: «это для пользователя или для разработчика?».

Что через это реально идёт

➀ Спецификации. Я пишу спеки дизайн-системы и продукта прямо из Клода в хранилище. Сам бы я так детально не написал, прокрастинировал бы неделями. Разработчик дружит со своим агентом, который читает те же файлы и не тратит время на поиск.

➁ Бэклог без дублей. Придумал фичу, прошу агента проверить, нет ли уже похожей. Если есть, дописываю в существующий файл. Если нет, завожу новый. Раньше идеи расползались по FigJam, Notion и заметкам в телефоне.

➂ Протоколы решений. Мы выкинули из MVP виды месяца и недели ради года жизни и недели жизни. Через полтора месяца я ещё помнил решение, но уже не помнил аргументы. Теперь на вопрос «почему мы отказались от месяца» агент отвечает цитатой из файла.

➃ Контент. ToV продукта и маркетинговая стратегия лежат в вольте. Агент пишет черновики промо-постов, опираясь на них, а не на свои представления о прекрасном.

Чем лечатся галлюцинации

Первое время агент дописывал в спеки то, чего у нас никогда не было. Состояния компонентов, которые я не рисовал. Делал он это не от вредности: у него был пробел, и он закрывал его стандартом индустрии. Так работает любая языковая модель, когда контекста не хватает.

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

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

Основной инсайт, который я вынес: агент врёт ровно там, где ты сам не доработал. Поэтому в документе с правилами лежит инструкция: не достраивай то, чего нет в файлах, задавай вопросы по проблам. На новых кусках продукта, где спеки ещё не написаны, это единственная страховка.

Главный инсайт

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

Скорость работы не выросла. Кто рассказывает про ускорение в разы, тот, по-моему, лукавит: время, которое агент экономит на черновике спеки, я трачу на вычитку. Выросло качество. Все детали записаны, и я в любой момент знаю, где что лежит.

Самый неожиданный вывод: ценность оказалась не в AI. Она в дисциплине, которую структура навязывает мне самому. Раньше всё валялось по Figma, Notion и случайным заметкам, и эта свалка фоном жрала внимание. Ясность мобилизует сильнее любого инструмента.

Я Павел Сикорский, делаю Baselife, дневник и календарь жизни:
→ Baselife Calendar

Шаблон хранилища со структурой, индексами и правилами для агента можно скачать на GitHub:
→ GitHub - ingmaesing/second-brain

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