Карта проекта: агенты знают, куда смотреть, ещё до чтения

Карта строится с помощью tree-sitter. В файлах TypeScript, TSX, JavaScript, Python и Go извлекаются функции, классы, методы, интерфейсы, типы, перечисления и константы вместе с диапазонами строк, сигнатурами и первым предложением документации. Ещё около 30 языков, например Rust, Java, PHP и Ruby, попадают на карту по пути к файлу.

• Импорты разрешаются до файлов проекта; тесты связываются с файлами, которые они импортируют, и с исходниками с совпадающими именами.
• Change together: файлы, изменявшиеся вместе минимум в двух из последних 500 коммитов, объединяются в пары; коммиты, затрагивающие более 40 файлов, игнорируются.
• Файлы находятся через git ls-files, .gitignore учитывается; папки вроде node_modules, dist и build, файлы больше 1 МБ, а также сгенерированные и минифицированные файлы пропускаются.
• В репозиториях с более чем 20 000 файлов индексируются только папки с исходниками (src, lib, app, packages/*/src…).

Карта добавляется агенту как MCP-сервер. Его инструкции велят агенту начинать задачу с map_related, смотреть map_outline перед чтением файла и map_usages перед изменением кода. В инструкции нового агента также попадает краткая сводка модулей проекта, точек входа и команды запуска тестов.

• map_related: файлы, которые задача, скорее всего, затрагивает, с ранжированием и причинами. Турецкие слова задачи (sepet, kupon, ödeme…) тоже совпадают с английскими именами в коде.
• map_outline: символы файла с диапазонами строк, число файлов, которые его импортируют, и его тесты.
• map_usages: где символ определён и вызывается, файлы, которые его импортируют, и его тесты; для файла: его импортёры и их импортёры.
• map_find: нечёткий поиск по именам символов и файлов с видом, file:line и сигнатурой.
• map_overview: модули, точки входа и команда запуска тестов. map_api читает реальный API установленной в node_modules версии пакета из его файлов .d.ts.

На каждую папку (проект или worktree) приходится одна карта, общая для всех работающих там агентов. За изменениями файлов следят, коммиты запускают пересчёт файлов, меняющихся вместе, а файл, о котором спрашивает агент, перепроверяется перед ответом. Карта строится на вашем компьютере и не тратит токены; каждый агент может читать только карту своей папки.

Вкладка Project map на странице Details проекта рисует файлы графом, раскрашенным по модулям: импорты серым, файлы, меняющиеся вместе, пунктирными оранжевыми линиями. Введите задачу и нажмите «Show», чтобы увидеть файлы, которые просмотрел бы агент, с причинами. Карточка «Project map impact» во вкладке AI ROI сравнивает разговоры с картой и без неё по успешности, прохождению с первого раза, токенам на задачу и доработкам.