# Antigravity запускає агентів. Maguyva дає їм карту.

Canonical source: https://maguyva.ai/uk/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 — це IDE, створене насамперед для агентів: вони планують і редагують у редакторі, терміналі й браузері. На реальному монорепозиторії їм усе одно потрібна карта того, який файл важливий. Maguyva індексує вашу кодову базу і повертає її через MCP (семантика, AST, граф і текст), тож на «де відбувається автентифікація» ви отримуєте реальний потік автентифікації, а не сім тестових заглушок.

> Antigravity запускає агента. Maguyva каже йому, який файл змінити.

## Що робить кожен шар

Чотири частини. У кожної своя робота.

### Antigravity

Місце, де ваші агенти планують, редагують і перевіряють.

### @-згадки + правила

Ручний контекст працює, поки репозиторій не стає завеликим.

### Maguyva

Автоматичне отримання фактів про кодову базу через MCP.

### Робочі простори, а не користувачі

Агенти не платять за місця. [Переглянути ціни](https://maguyva.ai/uk/pricing)

## Antigravity запускає агентів. Дайте йому це робити.

Проблема не в IDE для агентів. Agent Manager, виконання в кількох інтерфейсах і файли правил чудові, і ви вже користуєтеся ними для:

- Планування й запуску агентів у редакторі, терміналі й браузері.
- Багатофайлових правок, коли зміна локальна.
- Правил агента для конвенцій репозиторію та стильових обмежень.
- `@`-згадок, щоб підтягнути конкретний файл у контекст.

Продовжуйте так робити. Нічого з цього нікуди не зникає.

Але в реальному монорепозиторії (TypeScript із залежностями воркспейсів, Python-сервіси, змішані пакети) контекст агента ламається в ту мить, коли потрібний файл ще не потрапив у поле зору агента.

## Ручні виправлення, які ви вже пробували, — і де вони ламаються

Чотири ручні виправлення в парі зі своїм режимом відмови. Ліворуч — що ви робите сьогодні. Праворуч — де воно ламається.

### // згадайте файли

Ви `@`-згадуєте три файли, які, на вашу думку, важливі. Агент акуратно редагує всередині них.

### // згадка — це здогадка

Це працює, коли ви вже знаєте, які файли задіяні. Автономному агенту потрібні файли, про які ви навіть не здогадувалися.

### // вставте фрагменти

Ви вставляєте 200 рядків з іншого пакета в агента, щоб дати йому достатньо контексту.

### // вставлений код застаріває

Фрагмент, який ви вставили о 9 ранку, не враховує ребейз, який ваш колега влив об 11-й. Агент редагує, спираючись на примарну версію пакета.

### // напишіть документ-контекст

Ви пишете файл правил агента або markdown про архітектуру. Сьогодні він правильний.

### // документація застаріває швидше за код

Усе, що ви пишете вручну, з часом розходиться з реальністю. Джерело істини — код. Документ, що пояснює шар черг, правильний тиждень, а потім хибний назавжди.

### // зберігайте файли правил

Ви додаєте правила агента для найменувань, лінту й команд збірки. Чудово для поведінки.

### // правила ≠ індекс

Правила — правильне місце для “завжди запускай pnpm tsc -b перед комітами”. Але це не індекс, який можна опитати, для кожного символу, файлу й місця виклику у вашому монорепозиторії.

## Maguyva — це шар під усім цим

Це не заміна Antigravity. Це шар контексту репозиторію, що тримається на його підтримці MCP.

- **Семантика + AST + граф + текст**: пошук за змістом, структурою, залежністю чи буквальним збігом. Кожен результат повертає шлях до файлу й номер рядка.
- **Крос-пакетний за замовчуванням**: місця виклику й імпортери в кожному пакеті монорепозиторію, а не лише у відкритому агентом.
- **Враховує гілку**: Maguyva бачить саме ту версію коду, яку редагує агент.
- **Створено для автономності**: агенту, що планує багато правок, потрібен радіус впливу наперед, а не після того, як CI загориться червоним.

> Antigravity вирішує, що редагувати.
> Maguyva каже агенту, *чого торкнеться правка.*

## Три робочі процеси для монорепозиторію

Крос-пакетно, крос-мовно. Обґрунтовано реальним графом викликів, а не grep'ом агента.

### 01. Знайти потік автентифікації між пакетами, нічого не згадуючи

```text
agent> де в цьому монорепозиторії відбувається автентифікація?

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 точки входу в 4 пакетах, відсортовано за щільністю місць виклику.
[exit 0]
```

Ви не згадали жодного файлу. Ви не вставляли фрагмент. В агента є чотири важливі файли в правильному порядку — і він може зробити обґрунтовану правку.

### 02. Знайти реальну реалізацію, а не тестову заглушку

```text
agent> як normalizePhoneNumber обробляє E.164?

semantic::query("normalize phone E.164")
  packages/shared/util/phone.ts:88     normalizePhoneNumber()  ← реальна реалізація
  packages/api/test/phone.spec.ts:14   jest.mock(...)          ← заглушка
[exit 0]
```

Назви брешуть. Моки затіняють реальний код. Maguyva ранжує реальну реалізацію вище за тестовий мок у кожному пакеті.

### 03. Перевірте радіус впливу, перш ніж агент почне рефакторити

```text
agent> що викликає QueueDispatcher.publish у всьому монорепозиторії?

graph::callers(QueueDispatcher.publish)
  3 in packages/billing/*
  1 in packages/audit/*
  1 in packages/notifications/*
  1 in services/python-worker/*  ← крос-мовно через gRPC-стаб
[exit 0]
```

Крос-пакетно, а для поліглотного репозиторію ще й крос-мовно, місця виклику з'являються прямо в результаті. Автономний агент отримує радіус впливу ще до правки, а не після того, як CI загориться червоним.

## Налаштування з Antigravity

Три кроки. Тариф Free: 3 репозиторії, До 50 тис. проіндексованих рядків репозиторію, без кредитної картки.

### 01. Проіндексуйте репозиторій на maguyva.ai

Оберіть монорепозиторій, де проблема контексту відчувалася найгостріше.

### 02. Додайте Maguyva як MCP-сервер в Antigravity

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

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

### 03. Поставте одне запитання, відповідь на яке вже знаєте

Не спрямовуйте агента одразу на всю компанію. Почніть з одного репозиторію й одного перевірюваного запитання, як-от «що викликає `formatInvoice` у всіх пакетах?»

## Проіндексуйте один репозиторій, який ви вже добре знаєте.

Перевірте одне запитання, відповідь на яке можна підтвердити.