Přeskočit na obsah

Pro uživatele Antigravity

Antigravity spouští agenty.
Maguyva jim dává mapu.

Antigravity je agent-first IDE: agenti plánují a editují napříč editorem, terminálem a prohlížečem. Ve skutečném monorepu pořád potřebují mapu toho, který soubor je důležitý. Maguyva indexuje tvou codebase a vrací ji přes MCP (sémantika, AST, graf a text), takže „kde se řeší auth“ vrátí skutečný auth flow, ne sedm testovacích stubů.

Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.

Antigravity spouští agenta. Maguyva mu řekne, kterého souboru se má dotknout.

Co dělá každá vrstva

Čtyři části. Každá má svůj úkol.

// agent ide

Antigravity

Kde tví agenti plánují, editují a ověřují.

// manuální kontext

@ zmínky + rules

Manuální kontext funguje, dokud repozitář nezačne být velký.

// codebase

Maguyva

Automatická fakta o codebase přes MCP.

Antigravity spouští agenty. Nech ho.

Agent IDE není problém. Agent Manager, provádění napříč více plochami a soubory s pravidly jsou skvělé a už je používáš pro:

  • Plánování a spouštění agentů napříč editorem, terminálem a prohlížečem.
  • Editace více souborů, když je změna lokální.
  • Pravidla pro agenty ohledně konvencí repozitáře a stylistických pravidel.
  • @-zmínky, kterými vtáhneš konkrétní soubor do kontextu.

Pokračuj v tom. Nic z toho nezmizí.

Ale ve skutečném monorepu (TypeScript se závislostmi mezi workspaces, Python služby, smíšené balíčky) se agentův kontext rozpadne ve chvíli, kdy relevantní soubor ještě není na radaru agenta.

Manuální opravy, které jsi už zkusil, a kde selhávají

Čtyři manuální opravy spárované se svým selháním. Vlevo = co děláš dnes. Vpravo = kde to selže.

// the fix

// zmiň soubory

Pomocí @ zmíníš tři soubory, o kterých si myslíš, že jsou důležité. Agent v nich edituje čistě.

// where it breaks

// zmínění je odhad

Funguje to, když už víš, které soubory jsou zapojené. Autonomní agent potřebuje soubory, o kterých jsi nevěděl, že je máš zmínit.

// the fix

// vlož úryvky

Vložíš 200 řádků z jiného balíčku do agenta, aby měl dost kontextu.

// where it breaks

// vložený kód zastará

Úryvek, který jsi vložil v 9 ráno, neodráží rebase, který kolega odeslal v 11. Agent edituje proti fantomové verzi balíčku.

// the fix

// napiš kontextový dokument

Napíšeš soubor s pravidly pro agenta nebo architektonický markdown. Dnes to sedí.

// where it breaks

// dokumentace zastarává rychleji než kód

Cokoli napíšeš ručně, časem zastará. Kód je zdroj pravdy. Dokument popisující vrstvu fronty je správný tak týden, pak už navždy ne.

// the fix

// nech si soubory s pravidly

Přidáš pravidla pro agenta pro pojmenování, lint a build příkazy. Skvělé pro chování.

// where it breaks

// pravidla ≠ index

Pravidla jsou správné místo pro „vždy spusť pnpm tsc -b před commitem.“ Nejsou prohledávatelný index každého symbolu, souboru a místa volání ve tvém monorepu.

Maguyva je vrstva pod tím

Není to náhrada za Antigravity. Je to vrstva kontextu repozitáře, která se napojuje na jeho MCP podporu.

  • Sémantika + AST + graf + text hledej podle významu, struktury, závislosti nebo doslovného textu. Každý zásah vrátí cestu k souboru a číslo řádku.
  • Napříč balíčky ve výchozím nastavení místa volání a importéry napříč všemi balíčky v monorepu, ne jen tím, co má agent zrovna otevřený.
  • Vnímá větve Maguyva vidí tu verzi kódu, kterou agent zrovna edituje.
  • Postaveno pro autonomii agent, který plánuje spoustu editů, potřebuje dosah dopadu předem, ne až po tom, co CI zčervená.

Antigravity rozhoduje, co se bude editovat.

Maguyva agentovi řekne, čeho se ten edit dotkne.

Tři workflow napříč monorepem

Napříč balíčky, napříč jazyky. Podložené skutečným grafem volání, ne grepem agenta.

// workflow 01

Najdi auth flow napříč balíčky, aniž bys cokoli zmiňoval

agent> kde se v tomhle monorepu řeší autentizace?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           token verify
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  rbac gate

 4 vstupní body napříč 4 balíčky, seřazené podle hustoty míst volání.
[exit 0]

Nezmínil jsi soubor. Nevložil jsi úryvek. Agent má čtyři důležité soubory, ve správném pořadí, a může udělat podložený edit.

// workflow 02

Najdi skutečnou implementaci, ne testovací stub

agent> jak normalizePhoneNumber zachází s E.164?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← skutečná impl
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← stub
[exit 0]

Jména lžou. Mocky zastiňují skutečný kód. Maguyva řadí skutečnou implementaci nad testovací mock, napříč každým balíčkem.

// workflow 03

Zkontroluj dosah dopadu, než agent refaktoruje

agent> co volá QueueDispatcher.publish napříč monorepem?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← napříč jazyky přes gRPC stub
[exit 0]

Napříč balíčky, a napříč jazyky, pokud máš polyglotní repozitář, se místa volání objeví přímo v textu. Autonomní agent dostane dosah dopadu ještě předtím, než edituje, ne až po tom, co CI zčervená.

Nastavení s Antigravity

Tři kroky. Free tarif: 3 repozitáře, Až 50K zaindexovaných řádků repa, bez karty.

  1. // step 01

    Indexuj repozitář na maguyva.ai

    Vyber monorepo, kde tě kontext bolel nejvíc.

  2. // step 02

    Přidej Maguyva jako MCP server v Antigravity

    // ~/.gemini/antigravity/mcp_config.json
    {
      "mcpServers": {
        "maguyva": {
          "serverUrl": "https://maguyva.tools/mcp",
          "headers": {
            "Authorization": "Bearer <your-key>"
          }
        }
      }
    }
  3. // step 03

    Polož jednu otázku, jejíž odpověď už znáš

    Nemiř agenta na celou firmu. Začni jedním repozitářem a jednou ověřitelnou otázkou, třeba „co volá formatInvoice napříč balíčky?“