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

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

SEO Note — бесплатный аутлайнер для Windows (один файл, ~2.45 МБ, без аккаунта). Без поиска по эмбеддингам, без «спроси хранилище», без синка. Узел в модель — когда нужен черновик объяснения или набросок тестов. Правда в файле — та же ось, что в источнике правды для ИИ.

Знания о коде 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 и владельцев; код — только если я вставлю.

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

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

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

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

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

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

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

Ловушки

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

Когда мало

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

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

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

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

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

• Шаблоны деревьев и PDF-гайд — скелеты под роли и методы (оплата для ИП через ЮKassa, когда подключена).
• Если гайд помог — можно написать или забрать готовые деревья на странице шаблонов.

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

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