Создание графа знаний кодовой базы с помощью Graphify
Инструкция по развертыванию и использованию Graphify для преобразования исходного кода, документации и схем в структурированный граф знаний для AI-агентов.
Требования
- Установленный Node.js (рекомендуется последняя LTS версия)
- Доступ к терминалу (Linux, macOS или WSL2)
- Установленный AI-ассистент (Claude Code, Cursor или Gemini CLI)
- Базовые навыки работы с Git
Установка Graphify
С практической точки зрения, Graphify — это инструмент, который использует детерминированный парсинг AST (Abstract Syntax Tree) через tree-sitter. Это обеспечивает предсказуемость результата: в отличие от векторных баз данных, здесь связи между компонентами определяются структурой кода, а не вероятностным сходством векторов. Для начала необходимо установить пакет глобально через npm.
npm install -g @graphify/cliИнициализация графа знаний
Чтобы превратить ваш проект в граф, необходимо запустить команду инициализации в корневой директории проекта. Graphify проанализирует файлы, включая SQL-схемы, конфигурации и даже PDF-документацию. Если вы хотите использовать локальную модель (например, через Ollama) для обработки не-кодовых файлов, убедитесь, что локальный сервер запущен. Это критически важно для обеспечения полной конфиденциальности данных, так как весь парсинг происходит локально.
# Перейдите в директорию вашего проекта
cd /path/to/your/project
# Запустите создание графа
graphifyАнализ результатов
После завершения процесса Graphify генерирует несколько артефактов. Во-первых, это интерактивный файл graph.html, который можно открыть в браузере для визуального изучения связей. Во-вторых, это graph.json для программного использования. В-третьих, вы получите GRAPH_REPORT.md — это аудит-отчет, который позволяет человеку проверить, насколько корректно инструмент интерпретировал архитектуру проекта.
ls -l graph.html graph.json GRAPH_REPORT.mdИспользование в AI-ассистентах
Теперь, когда граф построен, вы можете использовать его как «навык» (skill) в вашем AI-ассистенте. Вместо того чтобы заставлять модель «гадать» по фрагментам файлов (что часто приводит к галлюцинациям), вы предоставляете ей контекст через команды. В Claude Code или Cursor используйте префикс /graphify для запросов. Это позволяет агенту понимать не только текст, но и логические связи между функциями, классами и схемами данных.
/graphify How does the authentication flow work in this project?Продвинутые команды управления
Для более тонкой настройки процесса используйте специализированные команды. Если вам нужно проверить конкретный путь или уточнить запрос, используйте расширенные флаги. Помните, что предсказуемость системы зависит от чистоты исходных файлов. Если в коде есть синтаксические ошибки, AST-парсер может пропустить часть узлов.
# Запрос по конкретному пути
graphify query --path src/auth
# Получение объяснения связей
graphify explainСоздание графа знаний кодовой базы с помощью Graphify: AST-парсинг для AI-агентов
Инструкция по развертыванию и использованию Graphify для преобразования исходного кода, документации и схем в структурированный граф знаний для AI-агентов.
Предварительные требования
- Установленный Node.js (рекомендуется последняя LTS-версия)
- Доступ к терминалу (Linux, macOS или WSL2)
- AI-ассистент (Claude Code, Gemini CLI) или IDE с поддержкой AI (Cursor)
- Базовые навыки работы с Git
Установка Graphify
Практически Graphify — это инструмент, который использует детерминированный парсинг AST (Abstract Syntax Tree) через tree-sitter. Это обеспечивает предсказуемость результата: в отличие от векторных баз данных, связи между компонентами определяются структурой кода, а не вероятностным сходством векторов. Для начала установите пакет глобально через npm.
npm install -g @graphify/cli
Инициализация графа знаний
Чтобы превратить проект в граф, запустите инициализацию в корневой директории. Graphify проанализирует файлы, включая SQL-схемы, конфигурации и PDF-документацию. Если планируете использовать локальную модель (например, через Ollama) для обработки не-кодовых файлов, убедитесь, что локальный сервер запущен. Это критически важно для конфиденциальности: весь парсинг происходит локально.
# Перейдите в директорию проекта
cd /path/to/your/project
# Запустите создание графа
graphify
Анализ результатов
После завершения Graphify генерирует несколько артефактов:
- Интерактивный
graph.html— откройте в браузере для визуального изучения связей. graph.json— для программного использования.GRAPH_REPORT.md— аудит-отчет, чтобы проверить, насколько корректно инструмент интерпретировал архитектуру.
ls -l graph.html graph.json GRAPH_REPORT.md
Использование в AI-ассистентах
Теперь граф можно подключить как «навык» (skill) в AI-ассистенте. Вместо того чтобы заставлять модель «гадать» по фрагментам файлов (что часто приводит к галлюцинациям), вы даёте ей контекст через команды. В Claude Code или Cursor используйте префикс /graphify для запросов. Это позволяет агенту понимать не только текст, но и логические связи между функциями, классами и схемами данных.
/graphify How does the authentication flow work in this project?
Продвинутые команды управления
Для тонкой настройки используйте специализированные команды. Предсказуемость системы зависит от чистоты исходных файлов: если в коде есть синтаксические ошибки, AST-парсер может пропустить часть узлов.
# Запрос по конкретному пути
graphify query --path src/auth
# Получение объяснения связей
graphify explain