Найти в Дзене

Как я случайно собрал систему управления документами из GitHub и AI

Я перестал искать систему управления документами. Она уже была в моем наборе инструментов - я просто не думал использовать их так. Приватный GitHub-репозиторий, Markdown-файлы, семантический индекс и Claude Code сверху. Вот и вся система. Я ищу по смыслу, а не по ключевым словам. "О чем договорились с клиентом по ценам в феврале?" - и получаю конкретный файл и абзац за секунды. Среди сотен документов. Дальше Claude подхватывает контекст с окном в 1 миллион токенов, читает соседние файлы и находит связи, которые я бы сам никогда не увидел. Заметки со встреч, брифы клиентов, стратегические документы, транскрипты звонков - все лежит в одном репозитории, все проиндексировано. Markdown стал универсальным языком для AI. LLM-модели парсят его на 20-30% эффективнее, чем HTML. Нет привязки к вендору. Читается и тобой, и любым AI-инструментом на рынке. Когда я начинал, казалось странным хранить заметки со встреч в тех же файлах, что и код. Но Markdown - это просто текст. Он открывается где угод
Оглавление

Я перестал искать систему управления документами. Она уже была в моем наборе инструментов - я просто не думал использовать их так.

Приватный GitHub-репозиторий, Markdown-файлы, семантический индекс и Claude Code сверху. Вот и вся система.

Что это дает

Я ищу по смыслу, а не по ключевым словам. "О чем договорились с клиентом по ценам в феврале?" - и получаю конкретный файл и абзац за секунды. Среди сотен документов.

Дальше Claude подхватывает контекст с окном в 1 миллион токенов, читает соседние файлы и находит связи, которые я бы сам никогда не увидел.

Заметки со встреч, брифы клиентов, стратегические документы, транскрипты звонков - все лежит в одном репозитории, все проиндексировано.

Почему Markdown

Markdown стал универсальным языком для AI. LLM-модели парсят его на 20-30% эффективнее, чем HTML. Нет привязки к вендору. Читается и тобой, и любым AI-инструментом на рынке.

Когда я начинал, казалось странным хранить заметки со встреч в тех же файлах, что и код. Но Markdown - это просто текст. Он открывается где угодно, не ломается, не требует специального софта.

Почему GitHub

Полная история изменений. Каждая правка отслеживается. Откатить можно что угодно. Бесплатно для неограниченного числа приватных репозиториев.

Это то, чего не хватает большинству систем управления документами - настоящий версионный контроль. Не "последнее изменение 3 дня назад", а полный diff каждой правки с возможностью вернуться на любой момент.

Как работает семантический поиск + Claude Code

Два слоя вместе:

Быстрый поиск - находит нужные документы мгновенно по концепции, а не по точному совпадению слов. Спрашиваешь "обсуждение бюджета на Q2" - находит файл, даже если там написано "финансовое планирование на второй квартал".

Глубокий анализ - Claude читает найденные файлы и дает инсайты, которые невозможно получить обычным поиском. Он видит паттерны между документами, напоминает о связанных решениях из других встреч, замечает противоречия.

Это как иметь ассистента, который проиндексировал и прочитал каждый документ, который ты когда-либо написал.

Сколько это стоит

Дополнительно - ноль. Я уже плачу за Claude Code для инженерной работы. GitHub бесплатный. Индексация работает локально. Система управления документами - побочный эффект инструментов, которые я уже использую.

Для чего это НЕ подходит

Ничего плохого в Notion, Google Docs или любом другом инструменте - они отлично справляются с совместной работой в реальном времени. Когда нужно вместе редактировать документ с командой - это их территория.

Мой подход - для персональной базы знаний. Той, где нужно думать, искать и находить связи между сотнями файлов. Где AI действительно читает твои документы, а не просто ищет совпадения.

Как начать

Инженеры работали так десятилетиями. Markdown + Git + терминал. AI просто сделал это доступным для всех остальных.

  1. Создай бесплатный приватный репозиторий на GitHub
  2. Перенеси документы туда как .md файлы (большинство инструментов умеют экспортировать в Markdown)
  3. Установи Claude Code и направь его на репозиторий
  4. Добавь файл CLAUDE.md с контекстом проекта

А как вы организуете свои рабочие документы? Интересно послушать, что работает у вас.