Nejdřív mapa, pak revize

Na obou stranách pull requestu stojí dva odlišné úkoly. Než agent začne psát, potřebuje mapu stromu, který se chystá změnit. Poté, co agent otevře PR, by měl něco přečíst tuto změnu vůči zbytku systému a nechat komentáře, podle kterých může jednat člověk.

Tyto úkoly vypadají z dálky podobně, protože oba zahrnují „porozumění kódové bázi“. Nejsou to stejný produkt. Jeden odpovídá na otázku „kam by tato změna měla přistát?“. Druhý odpovídá na otázku „co tento diff porušil, co linter kontrolující řádek po řádku přehlédne?“. Jejich zaměnění dává horší první koncept a hlučnější revizi.

Tento text je průvodce společným pracovním postupem. Maguyva je mapa, kterou agent dotazuje jako první. Greptile je agent revize, který PR komentuje pak. Tato dvojice je konstrukčně doplňující: Maguyva nerevidiuje pull requesty a Greptile nenahrazuje vrstvu kontextu, kterou agent použil k jejich napsání.

Proč je toto rozdělení užitečné

Kódovací agent, který vychází z tréninkových priorů plus pár vložených souborů, si vymyslí věrohodnou cestu a upraví ji. To je selhání „špatného souboru“ a je to problém vyhledávání. Maguyva je vzdálená vrstva kontextu kódové báze přes MCP: sémantické, strukturální (AST), grafové/závislostní a textové vyhledávání se slévá do seřazených výsledků, plus vyhledávání symbolů a získávání souborů. Podložené odpovědi se vracejí jako path/file.ext:line, takže omyl můžete odmítnout dřív, než patch vůbec existuje. Tvrzení zůstává skromné: méně halucinovaných úprav. Model může i tak hádat. Prostě první krok už není hádání.

Greptile je agent revize kódu s umělou inteligencí. Vlastními slovy automaticky revidiuje každý pull request s úplným porozuměním kódové bázi a staví to proti tradičním linterům, které kontrolují soubory izolovaně, ne celý systém. Nastavení spočívá v instalaci aplikace GitHub nebo GitLab a výběru repozitářů. Není tu žádný lokální index, který byste museli provozovat. Hostováno je to na Greptile Cloud (uvádějí soulad se SOC 2 Type II, se zprávou dostupnou na vyžádání), s možností vlastního hostování nabízenou podnikům.

Jejich vlastní číslovaný proces je: připojit se a vybudovat graf závislostí každé funkce, třídy a závislosti; při každém pull requestu analyzovat změnu pomocí tohoto úplného grafu repozitáře a zveřejnit nálezy jako komentáře PR s navrženými opravami zhruba za tři minuty; každý komentář může předat problém kódovacímu agentovi, kterého tým už používá. Uvádějí také, že v čase čtou předchozí lidské komentáře k PR, aby se naučili standardy kódu týmu a omezili hlučné návrhy. Jejich učicí se systém podle jejich slov potřebuje 2–3 týdny na přizpůsobení.

Toto je revize, ne psaní. Silnou stránkou Greptile je kontext úplného grafu repozitáře na změnu, která už v PR přistála, a pak uzavřená smyčka, která nález pošle do Claude Code, Codex, Conductor, Cursor nebo Devin. Silnou stránkou Maguyva je seřazená mapa, kterou agent dotázal dřív, než byla tato změna napsána. Používejte oba. Nežádejte po žádném z nich, aby dělal práci toho druhého.

Oficiální integrace produktů Maguyva–Greptile od první strany není uvedena. Ani ji nepotřebujete. Maguyva mluví s agentem přes MCP. Greptile mluví s GitHub nebo GitLab přes svou aplikaci. Setkávají se u pull requestu. Žádný lepicí skript, žádný cron, který propojuje jeden nástroj s druhým. Tato dvojice se obejde bez bash, protože každý produkt už stojí na povrchu, který mu patří.

Co tohle není

Toto není demolice Greptile. Není to stránka „vyměňte si recenzenta“. Greptile odstartoval na Hacker News 5. března 2024 jako firma Y Combinator W24 a to vlákno je způsob, jakým se s produktem poprvé seznamovala spousta lidí. Pokud jste je takto našli i vy, zůstaňte u nich. Tato stránka je chybějící přední polovina té smyčky: zakotvit agenta předem, aby PR, který Greptile vidí, už mířil na správné soubory.

Marketingové materiály Greptile vedou tvrzeními o rychlosti revize a odhalování chyb. Berte je jako vlastní tvrzení Greptile, ne jako nezávisle ověřená čísla. Tento text je neopakuje jako fakta.

Pokrytí jazyků je stejný druh poctivosti. Greptile rámuje podporu jako pokrytí všech programovacích jazyků, ne jako vyjmenovaný seznam; přesné číslo není uvedeno. Maguyva zveřejňuje podporu více než 279 jazyků a textových technologií, s technickým rozdělením (AST podpořené parserem versus jen text) na webu, když je otázka technická. Jsou to různé produkty s různými tvrzeními. Nemíchejte je.

Ceny Greptile nejsou uvedeny v podkladech, které tento text smí použít. Placené plány existují; viz jejich stránku s cenami. Maguyva účtuje za pracovní prostor, ne za místo. Plány začínají zdarma. Stránka s cenami uvádí zveřejněné úrovně, pokud potřebujete čísla pracovního prostoru.

Pracovní postup

Tři pojmenované fáze. Provádějte je v tomto pořadí. Žádnou z nich při prvním vyzkoušení této dvojice nepřeskakujte.

1. Kontext Maguyva

Naindexujte jeden repozitář, který už znáte. Připojte MCP klienta, ve kterém už píšete kód — Claude Code, Cursor, Codex CLI, VS Code, Windsurf nebo jiného MCP kompatibilního klienta. Maguyva má návody na nastavení pro 24 zdokumentovaných MCP klientů a umí se připojit i k dalším klientům, kteří podporují standardní konfiguraci MCP.

Položte otázku, kterou dokážete posoudit, dřív, než kdokoli napíše řádek. „Kde se řeší vypršení relace a co to volá?“ je lepší první tah než „oprav autentizaci“. Vyžadujte citace. Otevřete výsledky file.ext:line. Sledujte symbol. Potvrďte závislost, které se chystáte dotknout.

Maguyva zpřístupňuje 11 zákaznických MCP nástrojů napříč vyhledáváním, symboly, analýzou závislostí, získáváním souborů, kontextem repozitáře a deterministickými servisními pracovními postupy. Čtyři režimy vyhledávání se slévají do seřazených výsledků; find_symbol je samostatný nástroj, když už jméno znáte. Dokumentace popisuje nejkratší cestu: začít zdarma, naindexovat repozitář, který už znáte, připojit klienta, pak položit jednu otázku, kterou umíte ověřit.

Snímky mají časové razítko, takže agent pozná, kterou verzi stromu čte. Poctivým omezením je nesynchronizovaná lokální práce. Pokud úprava existuje jen v pracovním stromu a nebyla napushovaná, hostovaná mapa ji ještě neobsahuje. Instrukční soubory (CLAUDE.md, AGENTS.md) tu mají i nadále své místo pro konvence a to, čeho se nedotýkat. Nejsou to živá mapa. Používejte je pro chování. Používejte Maguyva pro fakta.

Nenechte agenta otevřít PR dřív, než citace přežijí kontakt s repozitářem. Tato brána je celý smysl této fáze.

2. PR agenta

Stejný agent teď píše změnu v klientovi, za který už platíte. Maguyva není editor ani recenzent. Agent stále produkuje diff. Vy stále otevíráte pull request na GitHub nebo GitLab tak, jak to už děláte.

Co by mělo být jiné, je první soubor. PR by měl pojmenovat handler, který dané chování skutečně implementuje, volajícího, který se rozbije, a test, který selže, pokud je změna špatná. Pokud byla fáze 1 přeskočena, fáze 3 utratí své komentáře na změnu, která přistála ve špatném balíčku. Greptile pořád dokáže najít systémové problémy. Neměl by se navíc muset zotavovat z halucinované cesty.

Držte PR úzce zaměřený. Podložený první soubor není licence k přepsání modulu. Tato doplňující se dvojice funguje, když agent odvedl jednu práci s mapou a pak požádal recenzenta, aby udělal jinou práci na ohraničeném diffu.

3. Revize Greptile

Greptile je už připojený k repozitáři přes aplikaci GitHub nebo GitLab. U nového pull requestu analyzuje změnu pomocí úplného grafu repozitáře, který vybudoval, a zveřejňuje nálezy jako komentáře s navrženými opravami. Jejich vlastní materiály udávají tento průchod na zhruba tři minuty.

Čtěte komentáře tak, jak byste četli pozorného kolegu z týmu: otevřete citované místo, rozhodněte, zda je nález reálný, pak jednejte. Tam, kde Greptile nabízí „Fix with your Agent“, pošle problém — cesty k souborům, čísla řádků, navržený kód — do Claude Code, Codex, Conductor, Cursor nebo Devin. „Fix All“ pošle všechny problémy z revize najednou. Dodávají také Greptile MCP a plugin pro Claude Code pro toto předání. Maguyva na tomto pojmenovaném seznamu cílů není; tato nepřítomnost není problém. Maguyva už svou práci odvedla ve fázi 1. Kódovací agent, který PR napsal, je ten, kdo by měl dostat opravný náklad.

V prvních 2–3 týdnech čekejte šum, zatímco se učicí se systém Greptile přizpůsobuje komentářům, které váš tým skutečně nechává. To je jejich uvedený harmonogram, ne vada dvojice. Lidská revize zůstává ve smyčce. Greptile je automatizovaný první průchod, ne tlačítko sloučení.

Pokud komentář Greptile ukazuje na soubor, který agent ve fázi 1 nikdy nedotázal, je to užitečný signál. Buď mapa přehlédla volajícího, nebo agent vynechal citaci. Opravte koncept podle komentáře. Nevypínejte recenzenta.

Jak udržet toto doplňování se poctivé

• Maguyva vždy první. Revize PR se špatným souborem je pořád revize špatného souboru.
• Greptile vždy pak. Dobře citovaný koncept přesto potřebuje přečtení diffu na úrovni celého systému.
• Nežádejte Maguyva, aby zveřejňovala komentáře k PR. Nedělá to.
• Nežádejte Greptile, aby byl první vyhledávací vrstvou agenta, zatímco ještě vybírá cestu. To není práce, na kterou je postavená jejich aplikace GitHub nebo GitLab.
• Nevymýšlejte bash pipeline, který je „synchronizuje“. Rozhraním je PR.
• Ověřujte obě strany nezávisle. Naindexujte repozitář, který už znáte. Položte jednu otázku, kterou umíte ověřit. Pak otevřete malý PR a přečtěte si, co Greptile skutečně komentuje.

Když tomu dáte jméno, smyčka je obyčejná. Nejdřív mapa. Pak PR agenta. Pak revize. Každý produkt zůstává na té straně pull requestu, ve které je dobrý.

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