Как разработчику построить систему заметок

Productivity

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

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

Что разработчику стоит записывать

Не всё заслуживает заметки. Четыре вида заметок окупаются стабильно:

Исправления и их причины. Как только упрямый баг сдался, запишите одну строку: симптом и настоящую причину. «Нестабильный тест авторизации — зависит от часового пояса, заморозить часы». Это самая ценная заметка из возможных: та же ошибка вас ещё найдёт, а искать вы будете как раз по тексту ошибки.

Решения и их причины. Почему курсорная пагинация, а не offset. Почему повторные попытки живут в воркере, а не в клиенте. Само решение останется в коде, а причина не останется нигде, если её не записать. А нужна вам потом именно причина.

Команды и заклинания. Точное сочетание флагов, порядок деплоя, однострочник на jq. Всё, что вы уже искали дважды.

Недодуманные идеи. Рефакторинг, на который сегодня нет времени, мысль о продукте, пришедшая посреди стендапа. Эти заметки окупаются дольше всех и испаряются быстрее всех.

Что не записывать: то, что уже фиксируют ваши инструменты (история git, трекер задач), и сырые расшифровки чего угодно. Заметки нужны для выводов.

Правило первое: запись занимает меньше пяти секунд

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

На практике это значит записывать оттуда, где вы уже находитесь:

  • В терминале — CLI для быстрых записей. В Notez это notez "дело было в размере пула соединений": бинарник на 3 МБ, который работает по SSH и принимает вывод через пайп, так что стектрейс попадает в заметку через | notez.

  • В браузере — что-то, до чего можно добраться из адресной строки. Наберите notez.dev/ваша мысль, и URL станет заметкой, без переключения на другое приложение.

  • В сессии с ИИ — если ваши ассистенты умеют работать по MCP, пусть сами записывают находки и решения в хранилище («сохрани заметку о том, что мы здесь решили»).

Общее у всех трёх: в момент записи не нужно выбирать, куда положить заметку, придумывать заголовок и что-то форматировать. Всё попадает в одни входящие.

Правило второе: структура появляется потом и только там, где себя окупает

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

Добавляйте структуру только там, где она делает то, чего не умеет поиск:

  • Теги — чтобы собрать всё. Когда нужны все заметки одного рода — каждая 1on1, всё с тегом research, — ставьте тег. Поиск находит похожие заметки, а тег гарантирует полный набор.

  • Ссылки — для связей. Заведите по короткой заметке на каждый проект и каждую систему и ссылайтесь на неё ([[ в Notez) каждый раз, когда о них заходит речь. Обратные ссылки сами соберут живой список всего, что касается проекта или системы, без всякой раскладки.

  • Доски — для заметок, которые ведут себя как задачи. На канбан-доске из тех же заметок живёт список «что попробовать», и отдельный таск-трекер не нужен.

  • Избранное — для пяти заметок, которые нужны каждый день. То, что вы открываете постоянно, должно открываться одним кликом, а не через поиск.

Правило третье: поиск прощает вам непоследовательность

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

Семантический поиск ищет по смыслу, а не по словам: запрос «та идея про кэширование» находит заметку о мемоизации. Это самое большое улучшение по сравнению с системами, где по заметкам ищут grep'ом: вам больше не нужно договариваться о терминах с самим собой из прошлого.

Второй механизм идёт дальше: вместо того чтобы искать заметку, задайте вопрос хранилищу. ИИ-чат в Notez находит нужные заметки и отвечает со ссылками на источники. На вопрос «что я писал про конвейер импорта?» вы получаете ответ, который можно сверить с самими заметками.

Десять минут обзора в неделю вместо часа раскладки

Единственное регулярное обслуживание, которое того стоит:

  1. Пролистайте записи за неделю.

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

  3. Удалите очевидно одноразовое. (Или не удаляйте: поиск переносит шум лучше, чем кажется.)

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

Оставьте себе выход

Одно правило для выбора инструментов: ваши заметки переживут любое приложение, поэтому выбирайте инструменты, которые это признают. Минимальная планка — экспорт в обычный текст или Markdown в любой момент. Notez экспортирует всё рабочее пространство в .zip с Markdown-файлами и вложениями, и то, чем пользуетесь вы, тоже должно до этой планки дотягивать. Системе, из которой можно уйти, можно доверить десять лет своих мыслей.

Вся система на одном экране

  • Записывайте оттуда, где вы есть, меньше чем за пять секунд, в одни входящие.

  • Никаких папок. Теги — для полных наборов, ссылки — для связей, избранное — для заметок на каждый день.

  • Ищите по смыслу; задавайте вопросы, когда искать дольше.

  • Десять минут обзора в неделю.

  • Экспорт в Markdown как запасной выход.

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

Читайте также