# Как дать агенту карту проекта через Graphify

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

## Где взять

| Что открыть | Зачем | Ссылка / команда |
| --- | --- | --- |
| **Graphify GitHub** | Основной репозиторий, README, команды установки и примеры результата. | [github.com/Graphify-Labs/graphify](https://github.com/Graphify-Labs/graphify) |
| **Документация** | Короткий quickstart: установка, регистрация skill, запуск графа. | [graphify.com/docs](https://graphify.com/docs) |
| **Установка** | Пакет называется `graphifyy`, команда после установки — `graphify`. | [graphify.com/docs/install](https://graphify.com/docs/install) |

## Когда это нужно

- [ ] Проект уже больше пары файлов, и агент каждый раз заново ищет, где что лежит.
- [ ] Claude Code, Codex или Cursor тратит контекст на перечитывание структуры вместо решения задачи.
- [ ] В кодовой базе много связей: сервисы, роуты, модели, схемы, документы, тесты.
- [ ] Нужно быстро понять, какие файлы, функции и концепты связаны между собой.
- [ ] Хочется перед сложной правкой сначала дать агенту карту проекта, а уже потом просить код.

## Как установить

- [ ] Проверь, что установлен Python 3.10+.
- [ ] Поставь Graphify из официального пакета `graphifyy`.
- [ ] Зарегистрируй skill для своего ассистента командой `graphify install`.
- [ ] Если работаешь в Codex, используй установку под Codex или проектную установку.
- [ ] Если команда `graphify` не находится, обнови shell PATH или запусти через `uvx --from graphifyy`.

```
uv tool install graphifyy
graphify install

# проектная установка
graphify install --project
graphify install --project --platform codex

# если команда graphify не находится
uv tool update-shell
uvx --from graphifyy graphify install
```

## Первый прогон проекта

- [ ] Открой терминал в корне проекта.
- [ ] Запусти построение графа для текущей папки.
- [ ] Дождись папки `graphify-out`.
- [ ] Открой `graph.html`, чтобы глазами проверить карту.
- [ ] Прочитай `GRAPH_REPORT.md`: там ключевые концепты, связи и вопросы по проекту.
- [ ] Сохрани `graph.json`: это база, по которой агент сможет отвечать без полного перечитывания файлов.

```
graphify .

# что должно появиться
graphify-out/
  graph.html
  GRAPH_REPORT.md
  graph.json
```

## Как пользоваться с агентом

- [ ] Перед большой задачей попроси агента сначала изучить `GRAPH_REPORT.md`.
- [ ] Для вопроса по архитектуре проси не читать весь проект, а сначала найти нужные узлы в графе.
- [ ] После крупной правки обновляй граф, иначе агент будет работать по старой карте.
- [ ] Используй `graphify explain`, когда нужно понять конкретный модуль, класс, роут или сущность.
- [ ] Используй `graphify path`, когда нужно понять связь между двумя частями системы.

```
graphify explain "APIRouter"
graphify path "FastAPI" "ModelField"
graphify query "где в проекте создаётся пользователь и какие модули это используют?"
```

## Что проверить после установки

- [ ] Агент ссылается на конкретные узлы, модули и связи, а не просто угадывает по названиям файлов.
- [ ] Повторный вопрос по проекту не заставляет его заново читать десятки файлов.
- [ ] В `GRAPH_REPORT.md` есть понятные концепты, а не пустой список файлов.
- [ ] В `graph.html` можно кликать по узлам, искать и фильтровать карту.
- [ ] После обновления проекта граф пересобирается без ошибок.

## Когда не надо ставить

| Ситуация | Что сделать вместо этого |
| --- | --- |
| Проект из 2-3 файлов | Дай агенту файлы напрямую, граф будет лишним. |
| Нужно поправить одну строку | Сначала сделай точечную задачу, не строй инфраструктуру ради микроправки. |
| Проект меняется каждые 10 минут | Обновляй граф только перед крупной задачей, иначе будешь обслуживать карту вместо работы. |

Смысл Graphify не в красивой картинке. Смысл в том, чтобы агент тратил контекст на решение, а не на вечное знакомство с проектом заново.

---

Источник: https://localhost:3000/m/kak-dat-agentu-kartu-proekta-cherez-graphify