Дерево заметок разработчика + ИИ

Описание PR нормальное. Тред в Slack, из которого всё выросло, исчез. Через полгода спрашивают, почему очередь FIFO «пока что», и ответ размазан по трём местам. Для этого не нужен ещё один ИИ в IDE — нужна устойчивая ветка решений и багов рядом с репо, офлайн, если так велит политика.

С этого сайта качают три сборки. SEO Note 2.1 — текущая: Electron-приложение (установщик ~121 МБ) под Windows 10/11 64-бит и Linux x64, с Markdown, редактором дерева, ИИ, обращающимся к вашей модели — локальной или любой с OpenAI-совместимым API, веб-клиппером и git-синхронизацией файла. Для Android 6.0+ и новее есть подписанный релизным ключом APK (~10 МБ) того же интерфейса; заметки в нём лежат папкой Markdown-файлов на устройстве, а пароль, синхронизация, веб-клиппер и ИИ отвечают явным отказом. Классическая сборка 1.3.34 (~2,5 МБ, Win32) осталась на странице загрузки для Windows 7, 8 и 32-битных ПК, куда 2.1 не устанавливается; её файл заметок — .seo. Все три работают офлайн и без аккаунта: выберите сборку или прочитайте, чем отличаются 2.1 и 1.3.34.

SEO Note — бесплатный аутлайнер для Windows (один файл, без аккаунта; классическая сборка 1.3.34 — ~2,5 МБ, SEO Note 2.1 — Electron на ~121 МБ). Поиска по эмбеддингам и семантического индекса нет: «Спросить по заметкам» опирается на локальный полнотекстовый поиск и берёт до шести заметок контекстом. Узел в модель — когда нужен черновик объяснения или набросок тестов: копируете наружу либо вызываете свой подключённый адрес прямо из 2.1. Правда в файле — та же ось, что в источнике правды для ИИ.

Знания о коде vs чат

В SEO Note

• Спеки / acceptance
• ADR (контекст, решение, следствия)
• Баги + repro
• Указатели на runbook (не секреты)

В чате с ИИ

• «Объясни ADR джуну»
• Черновик тест-кейсов из acceptance
• Штурмы рефакторинга
• Одноразовый rubber duck

DevNotes.sn
  Продукт / сервис
    Спеки
      Checkout v2 — acceptance
    ADR
      0017 — очередь FIFO пока что
        Контекст / Решение / Следствия
        Статус: принято 2026-03-02
    Баги
      INV-4421 — гонка двойного списания
        Repro / Ожидание / Факт / Фикс
    Промпты
      Объясни ADR
      Тесты из acceptance
  Scratch
  Архив

Вставка + промпт

Промпт — Объясни ADR
Контекст: [один узел ADR]
Аудитория: новый человек в команде, 5 минут.
Задача: простое резюме + почему отвергли альтернативы; риски — только если есть в тексте.
Правила: не выдумывай ticket ID и владельцев; код — только если я вставлю.

Пример: ADR-узел, написанный за пять минут

Так выглядит узел, который спасает через полгода — ровно те же четыре поля, что у настоящего ADR, без церемоний:

0021 — Экспорт PDF: wkhtmltopdf «пока что»
Контекст: счета должны выглядеть одинаково в бухгалтерии и у клиента;
  браузерный печать-диалог даёт три расхождения на принтерах.
Решение: wkhtmltopdf в CI, один HTML-шаблон на клиента.
Отвергли: HTML→скриншоты (шрифты плывут), нативный PDF (дольше на 2 недели).
Следствия: +38 МБ образа; пересмотр, если появится требование выбора шрифта.
Статус: принято 2026-08-14, ticket DEV-118

Заметьте: ни строчки кода и ни одного хоста — узел можно вставлять в чат «объясни джуну» без риска. Полезная формулировка из ответа модели переезжает в Следствия, а не живёт в переписке.

Никогда не вставляйте: API-ключи, токены, строки подключений, ПДн клиентов из логов, пароли продакшена, целые .env. Хосты маскируйте, если требует политика. Runbook с секретами: дерево runbook сисадмина.

Гигиена недели

1 После решения — черновик ADR в тот же день

2 Ticket ID текстом в узле

3 На скверных багах — Repro, пока не стёрся

4 По желанию: ИИ-объяснение для онбординга

5 Устаревшие ADR — в Архив, не в корзину

Ловушки

• Чат как единственное хранилище ADR
• Половина кодовой базы «для контекста» (шум + утечка)
• ADR без статуса и даты
• Личный Scratch смешан со Спеками без подписи

Частые вопросы

Где хранить ADR и спеки, если корпоративной wiki нет? В локальном аутлайнере: родитель-узел на сервис, внутри Спеки, ADR и Баги. ADR — четыре поля (контекст, решение, отвергнутые альтернативы, следствия) плюс статус с датой. Файл лежит рядом с репо и бэкапится как обычный документ.

Можно ли отправлять код в ИИ на объяснение? Надёжнее — один узел с ADR или спекой, без исходников. Ключи, строки подключения, .env и ПДн из логов не вставляются никогда; хосты маскируйте.

Заменит ли SEO Note Confluence или Notion? Нет, командные RFC и живое ревью остаются в wiki. SEO Note закрывает личный слой: журнал решений, air-gap машин, блокнот по клиенту, промпты рядом со спеками.

Работает без интернета? Полностью: 2.1 — установщик ~121 МБ, классическая 1.3.34 — ~2,5 МБ; ни аккаунта, ни синка. Модель — только когда сами откроете чат.

Как перенести решения из тредов в Slack и PR? В день, когда решение принято, напишите черновик ADR за пять минут: контекст, решение, что отвергли и почему, статус с датой и ID тикета. Тред обесценится — узел останется.

Когда мало

Командные wiki, RFC и code review никуда не деваются. SEO Note силён для личного или air-gap журнала решений, клиентских блокнотов на закрытом Windows и библиотеки промптов рядом со спеками — шаблоны промптов.

Что сделать дальше

1. Создайте Спеки / ADR / Баги под одним сервисом
2. Запишите один реальный ADR с прошлого месяца
3. Заведите один баг с Repro
4. Прогоните «Объясни ADR»; полезные формулировки — в Следствия
5. Бэкапьте файл вместе с важными документами

Скачайте SEO Note бесплатно и держите «почему так сделали» вне одноразовых тредов.

Дальше по теме

• Шаблоны деревьев и PDF-гайд — скелеты под роли и методы, которые можно скопировать в своё дерево.
• Если гайд помог — можно написать или забрать готовые деревья на странице шаблонов.

Смежные инструменты (VPS под локальные модели, курсы, VPN) здесь не встроены в каждый абзац: если появится партнёрская ссылка — она будет помечена и не обязательна для работы SEO Note.

Далее: Дерево PM · Фриланс · Что не вставлять · Runbook сисадмина · Шаблоны