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

Canonical source: https://maguyva.ai/cs/for-antigravity

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).

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 vaši 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ů.

> 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.

### Antigravity

Kde vaši agenti plánují, editují a ověřují.

### @ zmínky + pravidla

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

### Maguyva

Automatická fakta o kódové základně přes MCP.

### Za pracovní prostor, ne za uživatele

Za agenty se neúčtují samostatné licenční poplatky. [Zobrazit ceník](https://maguyva.ai/cs/pricing)

## Antigravity spouští agenty. Nechte 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áte 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áhnete konkrétní soubor do kontextu.

Pokračujte 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é jste už zkusili, a kde selhávají

Čtyři ruční postupy a jejich slabá místa. Vlevo = co děláte dnes. Vpravo = kde to selže.

### // zmiňte soubory

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

### // zmínění je odhad

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

### // vložte úryvky

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

### // vložený kód zastará

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

### // napište kontextový dokument

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

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

Cokoli napíšete 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.

### // nechte si soubory s pravidly

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

### // 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 vašem 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**: hledejte 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é.
- **Zohledňuje větev**: Maguyva vidí tu verzi kódu, kterou agent zrovna edituje.
- **Postaveno pro autonomii**: agent, který plánuje spoustu editů, potřebuje rozsah 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.

### 01. Najděte auth flow napříč balíčky, aniž byste cokoli zmiňovali

```text
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ínili jste soubor. Nevložili jste úryvek. Agent má čtyři důležité soubory, ve správném pořadí, a může udělat podložený edit.

### 02. Najděte skutečnou implementaci, ne testovací stub

```text
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.

### 03. Zkontrolujte rozsah dopadu, než agent refaktoruje

```text
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áte polyglotní repozitář, se místa volání objeví přímo v textu. Autonomní agent dostane rozsah 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 kreditní karty.

### 01. Indexujte repozitář na maguyva.ai

Vyberte monorepo, kde vám chybějící kontext působil největší potíže.

### 02. Přidejte Maguyva jako MCP server v Antigravity

`~/.gemini/config/mcp_config.json`

```json
{
  "mcpServers": {
    "maguyva": {
      "serverUrl": "https://maguyva.tools/mcp",
      "headers": {
        "Authorization": "Bearer mgv_xxxx"
      }
    }
  }
}
```

### 03. Položte jednu otázku, jejíž odpověď už znáte

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

## Indexujte jeden repozitář, který už znáte.

Otestujte jednu otázku, jejíž odpověď dokážete ověřit.