Mycelium: карта для вашего AI-помощника

Замечали такую картину? Запускаете Claude Code, Cursor или Copilot, а он открывает файл за файлом, пытаясь найти нужный контекст. Двадцать минут спустя — прочитано сорок файлов, половина забыта, и ваш «умный» помощник уверенно предлагает изменения, которые完全不 accounting для архитектуры вашего проекта.

Знакомо? Вы не одиноки. И это, пожалуй, главная головная боль AI-assisted разработки прямо сейчас.

Проблема контекста

Вот в чём штука: AI-агенты хороши ровно настолько, насколько хорош их контекст. Дайте им правильную информацию — напишут элегантный и точный код. Скормите поток ненужных файлов — получите спагетти, которое проще переписать с нуля.

Проблема в том, что большинство AI-инструментов начинают работу практически вслепую. Они не знают, где у вас аутентификация, где бизнес-логика, а где легаси-код, который трогать нельзя. Поэтому угадывают. Открывают файлы по алфавиту, по порядку импортов — в общем, как получится. Медленно, расточительно и часто безрезультатно.

На сцену выходит Mycelium

Mycelium работает иначе. Вместо того чтобы позволить AI-агенту блуждать по кодовой базе вслепую, инструмент строит подробную карту всего проекта — какие файлы есть, какие зависимости между ними, как всё связано. Когда агенту нужно внести изменение, он запрашивает эту карту и получает только те файлы, которые действительно нужны — с понятными описаниями на человеческом языке.

Как это работает: один раз запускаете npx @kopikocappu/mycelium init, и Mycelium парсит всю кодовую базу, резолвит импорты, строит граф зависимостей. Плюс использует небольшую AI-модель (Claude Haiku) для описания каждого файла.

Дальше, перед любой задачей, агент вызывает /preflight с описанием того, что нужно сделать. Mycelium возвращает четыре файла — не сорок.

Больше, чем поиск файлов

Но Mycelium умеет не только находить нужные файлы. Там есть несколько фишек, которые делают инструмент по-настоящему полезным для команд:

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

История изменений агента логирует каждую модификацию файла с временными метками, описанием задачи и «личностью» агента. Это тот аудит, которого так не хватало AI-инструментам. Теперь видно, что именно поменяли AI-ассистенты и когда.

Семантический поиск — ищете по смыслу, а не по ключевым словам. Запрос «обработка платежей» найдёт нужные файлы, даже если слово «payment» не встречается ни в одном из них. Особенно удобно в больших кодовых базах, где терминология со временем размылась.

Приватность, которой можно верить

Для корпоративных пользователей важная деталь: Mycelium работает локально на вашей машине на localhost:47821. Код не уходит в облако и не анализируется сторонними сервисами. Это локальный инструмент, который не лезет в вашу работу.

Стоит ли овчинка выделки?

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

Но для команд, масштабных проектов или для тех, кто устал наблюдать, как AI-ассистент десять минут ищет нужный файл — Mycelium реально повышает продуктивность. Одноразовые затраты на настройку окупаются каждый раз, когда вашему агенту нужны контекст и понимание.

Обещание звучит заманчиво: AI-помощник, который наконец понимает, с чем работает. Четыре файла. Без угадаек. Код, который соответствует архитектуре.

Если вас бесило, как AI-агенты вроде бы умные, но постоянно промахиваются мимо сути — Mycelium может стать той самой картой, которую вы ждали.