# Antigravity uruchamia agenty. Maguyva daje im mapę.

Canonical source: https://maguyva.ai/pl/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 to IDE zaprojektowane z myślą o agentach: agenci planują i edytują w edytorze, terminalu i przeglądarce. W prawdziwym monorepo nadal potrzebują mapy tego, który plik ma znaczenie. Maguyva indeksuje Twój kod i udostępnia go z powrotem przez MCP (semantyczne, AST, grafowe i tekstowe), więc pytanie „gdzie odbywa się uwierzytelnianie” zwraca rzeczywisty przepływ uwierzytelniania, a nie siedem atrap testowych.

> Antigravity uruchamia agenta. Maguyva mówi mu, jakiego pliku dotknąć.

## Co robi każda warstwa

Cztery elementy. Każdy ma swoje zadanie.

### Antigravity

Gdzie Twoje agenty planują, edytują i weryfikują.

### @ wzmianki + reguły

Ręczny kontekst wygrywa, dopóki repo nie jest duże.

### Maguyva

Automatycznie pozyskiwane fakty o kodzie przez MCP.

### Workspace'y, nie użytkownicy

Bez osobnych opłat za każdego agenta. [Zobacz cennik](https://maguyva.ai/pl/pricing)

## Antigravity uruchamia agenty. Pozwól mu na to.

IDE agentowe nie jest problemem. Agent Manager, wykonywanie zadań w wielu interfejsach i pliki reguł są świetne i już z nich korzystasz do:

- Planowania i uruchamiania agentów w edytorze, terminalu i przeglądarce.
- Edycji wielu plików, gdy zmiana jest lokalna.
- Reguł agenta dla konwencji repo i reguł stylu.
- Wzmianek `@`, by wciągnąć konkretny plik do kontekstu.

Rób tak dalej. Nic z tego nie znika.

Ale w prawdziwym monorepo (TypeScript z zależnościami workspace, usługi w języku Python, mieszane pakiety) kontekst agenta pęka w momencie, gdy istotny plik nie jest jeszcze na radarze agenta.

## Ręczne obejścia, które już wypróbowałeś, i gdzie zawodzą

Cztery ręczne obejścia zestawione z ich trybem awarii. Lewo = co robisz dzisiaj. Prawo = gdzie to zawodzi.

### // wspomnij pliki

Wzmiankujesz `@` trzy pliki, które Twoim zdaniem mają znaczenie. Agent edytuje w nich bez zarzutu.

### // wzmiankowanie to zgadywanie

Działa, gdy już wiesz, które pliki są zaangażowane. Autonomiczny agent potrzebuje plików, o których wspomnieniu nie wiedziałeś.

### // wklej fragmenty

Wklejasz 200 linii z innego pakietu do agenta, żeby dać mu wystarczający kontekst.

### // wklejony kod się dezaktualizuje

Fragment wklejony o 9 rano nie odzwierciedla rebase'a, który Twój kolega z zespołu wprowadził o 11. Agent edytuje na podstawie fantomowej wersji pakietu.

### // napisz dokument kontekstowy

Piszesz plik reguł agenta lub markdown z architekturą. Dziś jest aktualny.

### // dokumentacja dezaktualizuje się szybciej niż kod

Wszystko, co napiszesz ręcznie, z czasem odbiega od stanu faktycznego. Kod jest źródłem prawdy. Dokument opisujący warstwę kolejki jest poprawny przez tydzień, a potem błędny na zawsze.

### // trzymaj się plików reguł

Dodajesz reguły agenta dla nazewnictwa, lintowania i komend budowania. Świetne dla zachowania.

### // reguły ≠ indeks

Reguły to dobre miejsce na “zawsze uruchamiaj pnpm tsc -b przed commitem.” Nie są przeszukiwalnym indeksem każdego symbolu, pliku i miejsca wywołania w Twoim monorepo.

## Maguyva to warstwa pod spodem

To nie zamiennik Antigravity. Warstwa kontekstu repo, która opiera się na jego obsłudze MCP.

- **Semantyczne + AST + graf + tekst**: wyszukiwanie po znaczeniu, strukturze, zależności lub dosłownym tekście. Każdy wynik zwraca ścieżkę pliku i numer linii.
- **Między pakietami domyślnie**: miejsca wywołań i elementy importujące ten kod w każdym pakiecie monorepo, nie tylko w tym, który ma otwarty agent.
- **Z uwzględnieniem gałęzi**: Maguyva widzi wersję kodu, którą edytuje agent.
- **Zbudowane pod autonomię**: agent, który planuje wiele edycji, potrzebuje znajomości zasięgu wpływu z góry, a nie po tym, jak CI zaświeci na czerwono.

> Antigravity decyduje, co edytować.
> Maguyva mówi agentowi, *czego dotyka edycja.*

## Trzy przepływy pracy w monorepo

Między pakietami, między językami. Ugruntowane na rzeczywistym grafie wywołań, a nie na grep agenta.

### 01. Znajdź przepływ uwierzytelniania między pakietami, bez wspominania czegokolwiek

```text
agent> gdzie w tym monorepo odbywa się uwierzytelnianie?

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

→ 4 punkty wejścia w 4 pakietach, uszeregowane wg gęstości wywołań.
[exit 0]
```

Nie wspomniałeś o pliku. Nie wkleiłeś fragmentu. Agent ma cztery istotne pliki, we właściwej kolejności, i może wykonać ugruntowaną edycję.

### 02. Znajdź prawdziwą implementację, nie atrapę testową

```text
agent> jak normalizePhoneNumber obsługuje E.164?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← prawdziwa impl.
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← atrapa
[exit 0]
```

Nazwy kłamią. Atrapy przesłaniają prawdziwy kod. Maguyva stawia prawdziwą implementację wyżej niż atrapę testową, we wszystkich pakietach.

### 03. Sprawdź zasięg wpływu, zanim agent zrefaktoryzuje

```text
agent> co wywołuje QueueDispatcher.publish w całym monorepo?

graph::callers(QueueDispatcher.publish)
  3 w packages/billing/*
  1 w packages/audit/*
  1 w packages/notifications/*
  1 w services/python-worker/*  ← między językami przez stub gRPC
[exit 0]
```

Między pakietami, a przy poliglotycznym repo — także między językami, miejsca wywołań pojawiają się od razu. Autonomiczny agent poznaje zasięg wpływu przed edycją, a nie po tym, jak CI zaświeci na czerwono.

## Konfiguracja z Antigravity

Trzy kroki. Plan Free: 3 repozytoria, Do 50 tys. zindeksowanych linii repo, bez karty kredytowej.

### 01. Zaindeksuj repo na maguyva.ai

Wybierz monorepo, w którym najbardziej doskwierał Ci brak kontekstu.

### 02. Dodaj Maguyva jako serwer MCP w Antigravity

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

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

### 03. Zadaj jedno pytanie, na które już znasz odpowiedź

Nie kieruj agenta na całą firmę. Zacznij od jednego repo i jednego sprawdzalnego pytania, np. „co wywołuje `formatInvoice` w różnych pakietach?”

## Zaindeksuj jedno repo, które już znasz.

Sprawdź jedno pytanie, którego odpowiedź możesz zweryfikować.
