AI agentsAI-агенты

Second brain, checkpoint 1: one entry point

#SecondBrain #AIagents #ClaudeCode

Seven months after the first folder of notes, I threw out the classic note-taking methods and rebuilt the memory around one rule: an agent starts from a single index and opens only what it needs.

What changed

The first version followed human methods: PARA, Zettelkasten, maps of content. They are great for a person browsing notes. For an agent they were overhead: many small linked files, many hops to find one fact. My skills also lived in a separate repo and were copied into every project, so copies went stale.

Now there is one INDEX (path, type, one-line summary), a folder per project with what is in flight and the decisions, shared know-how, and a log. The old skill copies are retired: every skill lives in one place and keeps its own changelog.

Measured, not guessed

I ran the same benchmark tasks before and after. Passed tasks went from 5/6 to 6/6, and the context agents read dropped from 410k to 271k tokens, about a third less.

What works

  • One entry point instead of hopping between links.
  • A new session knows what is in flight from the first message.
  • Skills in one place, each with a history of changes.
  • A third fewer tokens on the same tasks.

What still hurts

  • No size limits yet: notes and the index can only grow.
  • Logs are append-only, nothing rotates into an archive.
  • Six benchmark tasks is a small sample.

Next step: rules that stop the vault from growing into a dump.

Второй мозг, промежуточный итог 1: одна точка входа

#SecondBrain #AIagents #ClaudeCode

Через семь месяцев после первой папки заметок я выкинул классические методики и пересобрал память вокруг одного правила: агент стартует с единого индекса и открывает только то, что нужно.

Что поменялось

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

Теперь есть один INDEX (путь, тип, краткое описание в одну строку), папка на каждый проект с текущей работой и решениями, общие знания и журнал. Старые копии скиллов выведены из строя: каждый скилл живёт в одном месте и ведёт свою историю изменений.

Измерено, а не на глаз

Я прогнал одни и те же тестовые задачи до и после. Пройдено стало 6 из 6 вместо 5 из 6, а контекст, который читают агенты, упал с 410 до 271 тысячи токенов, примерно на треть.

Что работает

  • Одна точка входа вместо прыжков по ссылкам.
  • Новая сессия знает, что в работе, с первого сообщения.
  • Скиллы в одном месте, у каждого своя история изменений.
  • На треть меньше токенов на тех же задачах.

Что ещё болит

  • Лимитов размера пока нет: заметки и индекс могут только расти.
  • Журналы только дописываются, в архив ничего не уходит.
  • Шесть тестовых задач — маленькая выборка.

Следующий шаг: правила, которые не дадут хранилищу превратиться в свалку.

— Dmitry