Спочатку карта, потім рев'ю

По обидва боки пул-реквесту стоять дві різні задачі. Перш ніж агент почне писати, йому потрібна карта дерева, яке він збирається змінити. Після того як агент відкрив 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 бере плату за робочий простір, а не за місце. Плани починаються безкоштовно. Сторінка тарифів перелічує опубліковані рівні, якщо вам потрібні цифри по робочих просторах.

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

Три іменовані етапи. Виконуйте їх у цьому порядку. Не пропускайте жоден із них, коли пробуєте цю пару вперше.

1. Контекст Maguyva

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

Поставте запитання, яке ви можете оцінити, перш ніж хтось напише хоч рядок. «Де обробляється закінчення сесії і що це викликає?» — кращий перший хід, ніж «полагодь автентифікацію». Вимагайте цитат. Відкрийте результати file.ext:line. Простежте символ. Підтвердьте залежність, яку ви збираєтеся торкнутися.

Maguyva надає 11 клієнтських MCP-інструментів для пошуку, символів, аналізу залежностей, отримання файлів, контексту репозиторію та детермінованих службових робочих процесів. Чотири режими пошуку зливаються в ранжовані результати; find_symbol — окремий інструмент, коли ви вже знаєте ім’я. Документація описує найкоротший шлях: почати безкоштовно, проіндексувати репозиторій, який ви вже знаєте, підключити клієнта, потім поставити одне запитання, яке можна перевірити.

Знімки позначені часом, тож агент може визначити, яку версію дерева він читає. Чесне обмеження — несинхронізована локальна робота. Якщо правка існує лише в робочому дереві й не була запушена, розміщена карта поки що її не містить. Файли інструкцій (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.