Graphify: построение графа знаний из кодовой базы

Инструкция по установке и использованию Graphify для создания запросимого графа знаний из исходного кода, SQL-схем, конфигов и документации с детерминистическим AST-парсингом

Средний

Алексей Кузнецов

Системный администратор11 сентября 2026 г.2 мин чтения

Требования

Python 3.10+
Node.js 18+
Git
права на запись в проект

Установка Graphify

Установите пакет через pip. Graphify работает как CLI-инструмент и как библиотека. Graphify для кодовой базы — это как набор чертёжных инструментов для конструктора: каждый элемент на месте, связь видна, предсказуемость высокая.

pip install graphify

Инициализация в проекте

Перейдите в корень кодовой базы и выполните инициализацию. Будет создан файл конфигурации .graphify.yaml с базовыми настройками.

cd /path/to/project && graphify init

Настройка источников

Отредактируйте .graphify.yaml, указав типы файлов для анализа: исходный код, SQL-схемы, конфиги, документацию. Во-первых, определитесь с scope — что именно войдёт в граф.

sources:
  - "**/*.py"
  - "**/*.sql"
  - "**/*.yaml"
  - "**/*.pdf"
exclude:
  - "vendor/**"
  - ".git/**"

Построение графа

Запустите детерминистический AST-парсинг. Каждое ребро графа будет объяснено — нет векторного хранилища, только явные связи. Подробнее о создании графа знаний: Создание графа знаний кодовой базы с помощью Graphify.

graphify build

Запрос к графу

Интерактивный режим для запросов к построенному графу знаний. Можно задавать вопросы по структуре кода, зависимостям, схемам данных.

graphify query

Интеграция с AI-агентами

Подключите граф как навык для Claude Code, Cursor, Codex или Gemini CLI. Подробности в гайде по установке Graphify. Для сравнения: Ponytail для Claude Code работает по похожему принципу, но для других задач. Также см. оптимизацию агентных хабов и руководство по ECC.

# Пример для Claude Code
/graphify analyze

Graphify: пошаговое руководство по графу знаний кодовой базы

Установка Graphify для построения графа знаний из исходного кода, SQL-схем, конфигов и документации с помощью детерминистического AST-парсинга. Интеграция с Claude Code и AI-агентами.

Предварительные требования

Python 3.10+
Node.js 18+
Git
Права на запись в проект

Шаг 1: Установка Graphify

Установите пакет через pip. Graphify работает как CLI-инструмент и как библиотека.

pip install graphify

Что такое Graphify

Graphify — инструмент для построения графа знаний кодовой базы. Он анализирует исходный код, SQL-схемы, конфиги и документацию, создавая явные связи между элементами проекта без векторного хранилища.

Шаг 2: Инициализация в проекте

Перейдите в корень кодовой базы и выполните инициализацию. Будет создан файл конфигурации .graphify.yaml с базовыми настройками.

cd /path/to/project && graphify init

Шаг 3: Настройка источников

Отредактируйте .graphify.yaml, указав типы файлов для анализа: исходный код, SQL-схемы, конфиги, документацию. Во-первых, определитесь с областью анализа (scope) — что именно войдёт в граф.

sources:
  - "**/*.py"
  - "**/*.sql"
  - "**/*.yaml"
  - "**/*.pdf"
exclude:
  - "vendor/**"
  - ".git/**"

Шаг 4: Построение графа

Запустите детерминистический AST-парсинг. К каждому ребру графа прилагается пояснение — нет векторного хранилища, только явные связи. Подробнее о создании графа знаний: Создание графа знаний кодовой базы с помощью Graphify.

graphify build

Шаг 5: Запрос к графу

graphify query

Шаг 6: Интеграция с AI-агентами

Подключите граф как компонент для Claude Code, Cursor, Codex или Gemini CLI. Подробности в гайде по установке Graphify. Для сравнения: Ponytail для Claude Code работает по похожему принципу, но для других задач. Также см. оптимизацию сред AI-агентов и руководство по ECC.

Подключение к Claude Code

Команда /graphify analyze — это slash-команда для Claude Code, доступная после подключения Graphify как навыка (skill). Убедитесь, что навык установлен:

graphify install claude

или настройте через .claude/settings.json.

Поделиться:Telegram X / Twitter VK