# Сначала карта, потом ревью

Canonical source: https://maguyva.ai/ru/blog/map-first-review-second

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

Date: 2026-09-07 · Author: Maguyva Team

> Дайте кодирующему агенту опору в карте репозитория до того, как он начнёт писать. Пусть Greptile ревьюит пул-реквест после. Взаимодополняющая пара, а не замена.

По обе стороны пул-реквеста находятся две разные задачи. Прежде чем агент начнёт писать, ему нужна карта дерева, которое он собирается изменить. После того как агент открыл PR, что-то должно прочитать это изменение в сопоставлении с остальной системой и оставить комментарии, по которым человек может действовать.

Эти задачи выглядят похоже издалека, потому что обе включают «понимание кодовой базы». Это не один и тот же продукт. Одна отвечает на вопрос «куда должно приземлиться это изменение?». Другая отвечает на вопрос «что сломал этот diff, что пропустит построчный линтер?». Смешать их значит получить более слабый первый черновик и более шумное ревью.

Этот текст — руководство по совместному рабочему процессу. Maguyva — карта, которую агент запрашивает первой. Greptile — агент ревью, который комментирует PR после. Эта пара взаимодополняюща по построению: Maguyva не ревьюит пул-реквесты, а Greptile не заменяет слой контекста, который агент использовал, чтобы их написать.

## Почему это разделение полезно

Кодирующий агент, отталкивающийся от априорных знаний из обучения плюс несколько вставленных файлов, придумает правдоподобный путь и отредактирует его. Это провал «неправильного файла», и это проблема поиска. Maguyva — удалённый слой контекста кодовой базы по MCP: семантический, структурный (AST), графовый/зависимостный и текстовый поиск сливаются в ранжированные результаты, плюс поиск символов и получение файлов. Обоснованные ответы возвращаются в виде `path/file.ext:line`, так что вы можете отклонить промах до того, как появится патч. Утверждение остаётся скромным: меньше галлюцинированных правок. Модель всё ещё может угадывать. Просто первый шаг перестаёт быть угадыванием.

Greptile — это агент ревью кода на основе ИИ. По их собственным словам, он автоматически ревьюит каждый пул-реквест с полным пониманием кодовой базы, противопоставляя это традиционным линтерам, которые проверяют файлы изолированно, а не всю систему. Настройка заключается в установке приложения GitHub или GitLab и выборе репозиториев. Нет локального индекса, который вам нужно эксплуатировать. Хостинг — Greptile Cloud (они заявляют о соответствии SOC 2 Type II, с отчётом, доступным по запросу), с опцией самостоятельного хостинга для предприятий.

Их собственный пронумерованный процесс таков: подключиться и построить граф зависимостей каждой функции, класса и зависимости; при каждом пул-реквесте анализировать изменение, используя этот полный граф репозитория, и публиковать находки в виде комментариев PR с предложенными исправлениями примерно за три минуты; каждый комментарий может передать проблему кодирующему агенту, которым команда уже пользуется. Они также заявляют, что читают предыдущие комментарии людей к PR с течением времени, чтобы изучить стандарты кода команды и уменьшить шумные предложения. По их словам, их обучающейся системе нужно 2–3 недели, чтобы адаптироваться.

Это ревью, а не черновик. Сильная сторона Greptile — контекст полного графа репозитория на изменение, которое уже приземлилось в PR, а затем замкнутый цикл, отправляющий находку в Claude Code, Codex, Conductor, Cursor или Devin. Сильная сторона Maguyva — ранжированная карта, которую агент запросил до того, как это изменение было написано. Используйте оба. Не просите ни один из них делать работу другого.

Официальная интеграция продуктов Maguyva–Greptile от первой стороны не заявлена. Она вам и не нужна. Maguyva разговаривает с агентом через MCP. Greptile разговаривает с GitHub или GitLab через своё приложение. Они встречаются на пул-реквесте. Никакого связующего скрипта, никакого cron, соединяющего один инструмент с другим. Эта пара обходится без bash, потому что каждый продукт уже занимает ту поверхность, которая ему принадлежит.

## Чем это не является

Это не разгром Greptile. Это не страница «смените рецензента». Greptile запустился на Hacker News 5 марта 2024 года как компания Y Combinator W24, и та ветка обсуждения — то, как многие люди впервые узнали об этом продукте. Если именно так вы их нашли, продолжайте ими пользоваться. Эта страница — недостающая передняя половина того цикла: дать агенту опору заранее, чтобы PR, который видит Greptile, уже нацеливался на правильные файлы.

Маркетинговые материалы Greptile ведут с утверждениями о скорости ревью и обнаружении багов. Относитесь к ним как к собственным заявлениям Greptile, а не как к независимо проверенным цифрам. Этот текст не повторяет их как факты.

Покрытие языков — та же самая честность. Greptile формулирует поддержку как охват всех языков программирования, а не перечисленный список; точное число не указано. Maguyva публикует поддержку более 279 языков и текстовых технологий, с техническим разделением (AST на основе парсера против только текста) на сайте, когда вопрос технический. Это разные продукты, делающие разные заявления. Не смешивайте их.

Цены Greptile не указаны в материалах, которые может использовать этот текст. Платные планы существуют; см. их страницу тарифов. Maguyva берёт плату за рабочее пространство, а не за место. Планы начинаются бесплатно. [Страница тарифов](/ru/pricing) перечисляет опубликованные уровни, если вам нужны цифры по рабочим пространствам.

## Рабочий процесс

Три именованных этапа. Выполняйте их в этом порядке. Не пропускайте ни один из них, когда пробуете эту пару впервые.

### 1. Контекст Maguyva

Проиндексируйте один репозиторий, который вы уже знаете. Подключите MCP-клиента, в котором вы уже пишете код — Claude Code, Cursor, Codex CLI, VS Code, Windsurf или другого MCP-совместимого клиента. У Maguyva есть руководства по настройке для 24 задокументированных MCP-клиентов, и она может подключаться к другим клиентам, поддерживающим стандартную конфигурацию MCP.

Задайте вопрос, который вы можете оценить, прежде чем кто-либо напишет хоть строчку. «Где обрабатывается истечение сессии и что это вызывает?» — лучший первый ход, чем «почини аутентификацию». Требуйте цитат. Откройте результаты `file.ext:line`. Проследите символ. Подтвердите зависимость, которую вы собираетесь затронуть.

Maguyva предоставляет 11 клиентских MCP-инструментов для поиска, символов, анализа зависимостей, получения файлов, контекста репозитория и детерминированных служебных рабочих процессов. Четыре режима поиска сливаются в ранжированные результаты; `find_symbol` — отдельный инструмент, когда вы уже знаете имя. [Документация](/ru/docs) описывает кратчайший путь: начать бесплатно, проиндексировать репозиторий, который вы уже знаете, подключить клиента, затем задать один вопрос, который можно проверить.

Снимки помечены временем, так что агент может определить, какую версию дерева он читает. Честное ограничение — несинхронизированная локальная работа. Если правка существует только в рабочем дереве и не была запушена, размещённая карта пока её не содержит. Файлы инструкций (`CLAUDE.md`, `AGENTS.md`) по-прежнему находят здесь своё место для соглашений и того, что не следует трогать. Это не живая карта. Используйте их для поведения. Используйте Maguyva для фактов.

Не позволяйте агенту открывать PR, пока цитаты не выдержат контакт с репозиторием. Этот барьер — весь смысл этого этапа.

### 2. PR агента

Тот же агент теперь пишет изменение в клиенте, за который вы уже платите. Maguyva — не редактор и не рецензент. Агент по-прежнему производит diff. Вы по-прежнему открываете пул-реквест на GitHub или GitLab так же, как уже делаете.

Что должно отличаться — это первый файл. PR должен называть обработчик, который действительно реализует поведение, вызывающую сторону, которая сломается, и тест, который упадёт, если изменение неверно. Если этап 1 был пропущен, этап 3 потратит свои комментарии на изменение, приземлившееся не в тот пакет. Greptile всё ещё может находить системные проблемы. Ему не должно приходиться ещё и восстанавливаться после галлюцинированного пути.

Держите PR в узких рамках. Обоснованный первый файл — не лицензия на переписывание модуля. Эта взаимодополняющая пара работает, когда агент сделал одну работу с картой, а затем попросил рецензента сделать другую работу над ограниченным diff.

### 3. Ревью Greptile

Greptile уже подключён к репозиторию через приложение GitHub или GitLab. На новом пул-реквесте он анализирует изменение, используя построенный им полный граф репозитория, и публикует находки в виде комментариев с предложенными исправлениями. Их собственные материалы отводят на этот проход около трёх минут.

Читайте комментарии так, как читали бы внимательного коллегу по команде: откройте процитированное место, решите, реальна ли находка, затем действуйте. Там, где Greptile предлагает «Fix with your Agent», он отправляет проблему — пути к файлам, номера строк, предложенный код — в Claude Code, Codex, Conductor, Cursor или Devin. «Fix All» отправляет все проблемы ревью сразу. Они также поставляют Greptile MCP и плагин для Claude Code для этой передачи. Maguyva нет в этом поименованном списке целей; это отсутствие не проблема. Maguyva уже сделала свою работу на этапе 1. Кодирующий агент, написавший PR, — это тот, кто должен получить нагрузку с исправлением.

Ожидайте шум в первые 2–3 недели, пока обучающаяся система Greptile адаптируется к комментариям, которые ваша команда действительно оставляет. Это их заявленный график, а не дефект пары. Ревью человека остаётся в цикле. Greptile — автоматизированный первый проход, а не кнопка слияния.

Если комментарий Greptile указывает на файл, который агент ни разу не запрашивал на этапе 1, это полезный сигнал. Либо карта упустила вызывающую сторону, либо агент пропустил цитату. Исправьте черновик в соответствии с комментарием. Не отключайте рецензента.

## Как сохранить эту взаимодополняемость честной

- Maguyva всегда первой. Ревью PR с неправильным файлом всё равно остаётся ревью неправильного файла.
- Greptile всегда после. Хорошо процитированный черновик всё равно нуждается в прочтении diff на уровне всей системы.
- Не просите Maguyva публиковать комментарии к PR. Она этого не делает.
- Не просите Greptile быть первым слоем поиска агента, пока он всё ещё выбирает путь. Это не та работа, для которой построено их приложение GitHub или GitLab.
- Не выдумывайте bash-конвейер, который их «синхронизирует». PR — это интерфейс.
- Проверяйте обе стороны независимо. Проиндексируйте репозиторий, который вы уже знаете. Задайте один вопрос, который можно проверить. Затем откройте небольшой PR и прочитайте, что Greptile действительно комментирует.

Когда этому дают имя, цикл становится обычным. Сначала карта. Потом PR агента. Потом ревью. Каждый продукт остаётся на той стороне пул-реквеста, на которой он хорош.

`// map first. review second. in that order.`