# Antigravity ajaa agentit. Maguyva antaa niille kartan.

Canonical source: https://maguyva.ai/fi/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 on agenttiensisijainen IDE: agentit suunnittelevat ja muokkaavat editorin, terminaalin ja selaimen yli. Oikeassa monorepossa ne tarvitsevat silti kartan siitä, mikä tiedosto on tärkeä. Maguyva indeksoi koodikantasi ja tarjoaa sen takaisin MCP:n yli (semanttinen, AST, graafi ja teksti), joten “missä autentikointi tapahtuu” palauttaa oikean autentikointivuon, ei seitsemää testitynkää.

> Antigravity ajaa agentin. Maguyva kertoo sille, mihin tiedostoon koskea.

## Mitä kukin kerros tekee

Neljä palaa. Jokaisella on tehtävänsä.

### Antigravity

Missä agenttisi suunnittelevat, muokkaavat ja varmentavat.

### @-maininnat + säännöt

Manuaalinen konteksti toimii, kunnes repo kasvaa isoksi.

### Maguyva

Automaattiset koodikannan faktat MCP:n yli.

### Työtiloja, ei käyttäjäpaikkoja

Agenteista ei veloiteta käyttäjäpaikkamaksuja. [Katso hinnoittelu](https://maguyva.ai/fi/pricing)

## Antigravity ajaa agentit. Anna sen tehdä se.

Agentti-IDE ei ole ongelma. Agent Manager, moniympäristöinen suoritus ja sääntötiedostot ovat erinomaisia, ja käytät niitä jo:

- Agenttien suunnitteluun ja ajamiseen editorin, terminaalin ja selaimen yli.
- Monitiedostomuokkauksiin, kun muutos on paikallinen.
- Agenttisääntöihin repon käytännöille ja tyylisäännöille.
- `@`-mainintoihin tietyn tiedoston tuomiseksi kontekstiin.

Jatka sitä. Mikään niistä ei katoa minnekään.

Mutta oikeassa monorepossa (TypeScript työtilariippuvuuksineen, Python-palvelut, sekapaketit) agentin konteksti hajoaa heti, kun oleellinen tiedosto ei ole vielä agentin tutkassa.

## Manuaaliset korjaukset, joita olet jo kokeillut, ja missä ne hajoavat

Neljä manuaalista korjausta yhdistettynä niiden vikaantumistapaan. Vasen = mitä teet tänään. Oikea = missä se hajoaa.

### // mainitse tiedostot

Mainitset `@`-merkillä kolme tiedostoa, joiden luulet olevan oleellisia. Agentti muokkaa niiden sisällä siististi.

### // mainitseminen on arvaus

Se toimii, kun jo tiedät, mitkä tiedostot ovat mukana. Autonominen agentti tarvitsee tiedostot, joita et osannut mainita.

### // liitä koodinpätkät

Liität 200 riviä toisesta paketista agentille antaaksesi sille tarpeeksi kontekstia.

### // liitetty koodi vanhenee

Klo 9 liittämäsi pätkä ei heijasta rebasea, jonka tiimikaverisi teki klo 11. Agentti muokkaa pakettia, joka on jo haamuversio.

### // kirjoita kontekstidokumentti

Kirjoitat agenttisääntötiedoston tai arkkitehtuurimarkdownin. Se pitää paikkansa tänään.

### // dokumentit vanhenevat koodia nopeammin

Kaikki käsin kirjoitettu vanhenee vähitellen. Koodi on totuuden lähde. Jonoa kuvaava dokumentti on oikein viikon, sitten väärin loputtomiin.

### // pidä sääntötiedostot

Lisäät agenttisääntöjä nimeämiselle, lintaukselle ja build-komennoille. Loistavaa käytöksen ohjaamiseen.

### // säännöt ≠ indeksi

Säännöt ovat oikea paikka lauseelle “aja aina pnpm tsc -b ennen committeja.” Ne eivät ole kysyttävä indeksi jokaisesta symbolista, tiedostosta ja kutsupaikasta monorepossasi.

## Maguyva on kerros alla

Ei Antigravity-editorin korvaaja. Repokontekstin kerros, joka nojaa sen MCP-tukeen.

- **Semanttinen + AST + graafi + teksti**: haku merkityksen, rakenteen, riippuvuuden tai kirjaimellisen tekstin perusteella. Jokainen osuma palauttaa tiedostopolun ja rivinumeron.
- **Pakettirajat ylittävä oletuksena**: kutsupaikat ja tuojat jokaisessa monorepon paketissa, ei vain siinä, joka agentilla on avoinna.
- **Haaratietoinen**: Maguyva näkee sen koodiversion, jota agentti muokkaa.
- **Rakennettu autonomialle**: agentti, joka suunnittelee monta muokkausta, tarvitsee vaikutusalueen etukäteen, ei sen jälkeen kun CI muuttuu punaiseksi.

> Antigravity päättää, mitä muokata.
> Maguyva kertoo agentille, *mitä muokkaus koskettaa.*

## Kolme monorepo-työnkulkua

Pakettien ja kielten rajat ylittäen. Ankkuroitu oikeaan kutsugraafiin, ei agentin grepiin.

### 01. Löydä autentikointivuo pakettien yli, mainitsematta mitään

```text
agent> missä autentikointi tapahtuu tässä monorepossa?

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 aloituskohtaa 4 paketissa, järjestettynä kutsupaikkojen tiheyden mukaan.
[exit 0]
```

Et maininnut tiedostoa. Et liittänyt koodinpätkää. Agentilla on ne neljä tiedostoa, jotka ovat oleellisia, oikeassa järjestyksessä, ja se voi tehdä ankkuroidun muokkauksen.

### 02. Löydä oikea toteutus, ei testitynkää

```text
agent> miten normalizePhoneNumber käsittelee E.164-muodon?

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

Nimet valehtelevat. Mockit peittävät oikean koodin. Maguyva järjestää oikean toteutuksen testimockin yläpuolelle, jokaisessa paketissa.

### 03. Tarkista vaikutusalue ennen kuin agentti refaktoroi

```text
agent> mikä kutsuu QueueDispatcher.publish-metodia koko monorepossa?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← kielten välillä gRPC-tyngän kautta
[exit 0]
```

Pakettien ja kielten rajat ylittäen, kun repo on monikielinen, kutsupaikat tulevat esiin suoraan. Autonominen agentti saa vaikutusalueen ennen muokkausta, ei sen jälkeen kun CI muuttuu punaiseksi.

## Asennus Antigravity-editorilla

Kolme vaihetta. Free-taso: 3 repositoriota, Enintään 50 000 indeksoitua repo-riviä, ei luottokorttia.

### 01. Indeksoi repo osoitteessa maguyva.ai

Valitse monorepo, jossa puutteellinen konteksti on aiheuttanut eniten ongelmia.

### 02. Lisää Maguyva MCP-palvelimeksi kohteessa Antigravity

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

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

### 03. Kysy yksi kysymys, jonka vastauksen jo tiedät

Älä osoita agenttia koko yritykseesi. Aloita yhdestä reposta ja yhdestä todennettavasta kysymyksestä, kuten “mikä kutsuu `formatInvoice`-funktiota pakettien yli?”

## Indeksoi yksi repo, jonka jo tunnet.

Testaa yksi kysymys, jonka vastauksen voit tarkistaa.