Агенту нужна не память, а карта проекта
Когда я начал разбираться с Graphify, быстро понял: ИИ-агенту мало иметь доступ ко всем файлам проекта. Ему нужна карта.
Мы часто говорим про контекст так, будто если модель увидит больше кода, то она начнёт лучше понимать систему. Но на практике это работает иначе. Большой контекст превращается в склад: там всё лежит, но агенту всё равно нужно понять, что с чем связано, где центральные узлы, какие файлы влияют друг на друга и почему одна маленькая правка может сломать поведение в соседнем модуле.
Graphify интересен именно как попытка сделать для агента не ещё одну папку с файлами, а слой ориентации.
Файлы есть, понимания нет
В любом живом проекте проблема не в том, что файлов мало видно. Проблема в том, что связи между ними не лежат на поверхности.
Можно открыть компонент, увидеть функцию, найти импорт, перейти в соседний файл. Но архитектура проекта — это не список файлов. Это сеть: кто кого вызывает, какие сущности проходят через несколько слоёв, где спрятана причина решения, какие модули выглядят независимыми, но на деле завязаны на одну идею.
Когда агент работает без такой карты, он часто действует как человек с фонариком в тёмной комнате. Он освещает кусок стены, делает вывод, потом поворачивается к другой стене и забывает, как они связаны. Отсюда рождаются странные правки: локально вроде логично, а в системе — мимо.
Я уже видел это на небольших проектах. Даже в Pomodoro, где проект компактный, агент может уверенно править интерфейс и при этом упускать, что изменение в одном месте связано с поведением таймера, пресетами, звуками или мобильной раскладкой. А если проект вырастает до ERP или TaskFlow, обычного “прочитай эти файлы” становится мало.
Что делает Graphify
Graphify берёт папку проекта и строит по ней граф знаний.
На выходе появляются несколько артефактов:
graph.html— визуальная карта, которую можно открыть в браузере;GRAPH_REPORT.md— короткий отчёт с главными узлами, неожиданными связями и вопросами, которые стоит задать проекту;graph.json— машинно-читаемый граф, к которому можно обращаться командами.
Важная деталь: код разбирается локально через структурный анализ. То есть импорты, функции, классы, вызовы и часть связей можно получить без отправки кода во внешнюю модель. Документы, изображения, PDF и другие смысловые материалы уже могут требовать семантической обработки моделью — но это честно разделено.
Мне нравится, что Graphify не пытается сделать вид, будто всё знает идеально. У связей есть пометки: что извлечено явно, что выведено как предположение, что неоднозначно. Для агентной работы это важнее, чем кажется. Агенту нельзя давать красивую галлюцинацию под видом факта. Лучше честный граф с уровнем уверенности.
Почему граф лучше поиска по файлам
Поиск отвечает на вопрос: «Где встречается это слово?»
Граф отвечает на другой вопрос: «Как это связано с остальной системой?»
Это принципиально разные вещи. Поиск полезен, когда я уже знаю, что ищу. Но в архитектурной работе я часто не знаю точное имя. Мне нужно понять путь: от интерфейса к состоянию, от события к обработчику, от настройки к побочному эффекту.
В Graphify для этого есть несколько полезных идей.
Первая — главные узлы. Это сущности, через которые проходит много связей. В обычном списке файлов они могут не выглядеть важными. Но в графе видно: вот точка, которую нельзя трогать без понимания последствий.
Вторая — неожиданные связи. Иногда два файла не лежат рядом, не похожи по названию и не всплывают в одном поиске, но концептуально решают одну задачу или связаны через общий поток данных.
Третья — вопросы к проекту. Хороший граф не просто показывает картинку. Он подсказывает, какие вопросы вообще стоит задать. Для меня это ценно: агент перестаёт быть просто исполнителем и становится навигатором.
Почему это важно для ИИ-агента
ИИ-агенту легко быть уверенным и ошибаться.
Он может прочитать несколько файлов, собрать правдоподобную историю и начать менять код. Проблема в том, что эта история часто локальная. Она построена на том, что попало в текущий контекст, а не на реальной карте проекта.
Граф даёт другой режим работы. Перед тем как лезть в код, агент может посмотреть отчёт: какие узлы главные, какие сообщества есть в проекте, где лежат мосты между частями системы. Если вопрос сложный, можно не гадать, а пройти по графу: query, path, explain.
Это не заменяет чтение кода. И не должно заменять. Но это хороший первый слой ориентации.
Я вижу это примерно так: агент сначала смотрит на карту, потом идёт в конкретные файлы. Не наоборот.
Где я хочу это применять
Для меня Graphify интересен не как отдельная игрушка, а как часть рабочего процесса.
В маленьких проектах вроде Pomodoro он может быстро показать, как связаны экран, состояние, звуки, события и настройки. Это помогает не ломать мелочи при визуальных правках.
В больших проектах вроде ERP или TaskFlow ценность выше. Там уже важны не отдельные функции, а архитектурные маршруты: где рождается заявка, как она проходит через статусы, какие сущности участвуют, где UI связан с серверной логикой, какие документы объясняют старые решения.
Ещё мне нравится идея хранить graphify-out/ рядом с проектом. Тогда граф становится не временной заметкой агента, а частью технической памяти проекта. Новый агент, новая сессия, новый разработчик — все начинают не с нуля, а с карты.
Ограничения
Граф — не магия.
Если его не обновлять, он быстро превращается в устаревшую карту. А устаревшая карта иногда хуже её отсутствия: она даёт уверенность там, где нужна проверка.
Второе ограничение — семантические связи надо читать аккуратно. Если связь помечена как предположение, это не факт. Это повод проверить код или документ, а не основание сразу менять архитектуру.
Третье — граф не отменяет инженерное мышление. Он помогает увидеть структуру, но решение всё равно принимает человек или агент, который умеет сомневаться.
Для меня хороший сценарий такой: граф показывает направление, код подтверждает детали, тесты проверяют результат.
Вывод
Я всё больше прихожу к мысли, что будущим ИИ-агентам нужна не просто большая память. Им нужна навигация.
Длинный контекст похож на большую коробку с деталями. Там может быть всё нужное, но без схемы сборки агент всё равно будет перебирать детали наугад.
Graphify интересен тем, что пытается дать агенту эту схему: карту связей, главные узлы, мосты между частями проекта и честные пометки о том, где факт, а где предположение.
Это не финальное решение проблемы понимания кода. Но это шаг в правильную сторону.
Похоже, следующий уровень вайбкодинга — это не просто «агент, прочитай проект». Следующий уровень — «агент, сначала посмотри на карту».
