Как программисту вести рабочие заметки?
Полезны четыре вида заметок: дневник работы (что сделал, где остановился — для возврата после переключения), заметки о решениях (почему выбран такой подход, как ADR), «сегодня узнал» (TIL — короткие находки с примерами) и шпаргалки по командам и инструментам. Храните их рядом с кодом (в репозитории) или в личной базе с быстрым поиском.
Обновлено
Какие заметки окупаются
- Закладка перед переключением: «остановился на тесте X, следующее — Y».
- Решения: контекст, варианты, выбор, последствия.
- Разбор багов: симптом, причина, фикс — чтобы не искать заново.
- Команды и конфиги, которые нужны раз в полгода.
Где хранить
То, что касается проекта и нужно команде, — в репозитории: README, docs, ADR. Личное — дневник, TIL, шпаргалки — в заметках с хорошим поиском. ИИ-ассистенты в редакторе можно подключить к заметкам через MCP, чтобы они видели ваш контекст.
Частые ошибки
- Держать решения только в чатах команды.
- Не записывать причину бага — через месяц та же отладка.
- Заметки без поиска и названий.
Пример
Через полгода снова падает деплой с той же ошибкой сертификата. Поиск по заметкам «certificate» находит разбор: причина, команда для исправления, ссылка на обсуждение. 5 минут вместо двух часов.
Частые вопросы по теме
Что такое ADR?
Architecture Decision Record — короткая запись архитектурного решения с контекстом и последствиями.
Вести заметки в Obsidian или в репозитории?
Командное — в репозитории, личное — где удобнее искать.
Что такое TIL?
Today I Learned — короткие заметки о новых находках.
Можно ли подключить заметки к ИИ-ассистенту в IDE?
Да, через MCP, если сервис заметок его поддерживает.
Сколько времени тратить на заметки?
Минуты в день — окупаются при первом повторении проблемы.
Как это устроено в Fast Notes
Fast Notes можно подключить к Cursor, VS Code или Claude Code через MCP: ассистент найдёт ваши заметки и запишет итоги работы.
Похожие вопросы
Как подключить свои заметки к Claude, Cursor или другому ИИ-ассистенту?
Через MCP — открытый стандарт подключения данных к ИИ-ассистентам. Если сервис заметок даёт удалённый MCP-сервер…
02Зачем вести журнал решений?
Журнал решений — список важных решений с датой, контекстом, вариантами, выбором и ожидаемым результатом. Через время он…
03Почему переключение между задачами так утомляет?
Каждое переключение требует выгрузить из головы одну задачу и загрузить другую — на это уходят время и внимание, а…
04Как фрилансеру вести заметки по клиентам и проектам?
На каждого клиента — заметка с контактами, условиями (ставка, сроки оплаты, формат правок), историей договорённостей и…
05Как юристу вести заметки по делам и клиентам?
По каждому делу — заметка с хронологией событий, процессуальными сроками, списком документов, позицией и…
06Как рекрутеру вести заметки по кандидатам и не нарушить 152-ФЗ?
С получения резюме вы обрабатываете персональные данные и отвечаете по 152-ФЗ: нужно правовое основание (обычно…