Перейти к содержимому

Для пользователей Antigravity

Antigravity запускает агентов.
Maguyva даёт им карту.

Antigravity — это IDE, ориентированная на агентов: агенты планируют и редактируют код в редакторе, терминале и браузере. На настоящем монорепозитории им всё равно нужна карта того, какой файл имеет значение. Maguyva индексирует вашу кодовую базу и отдаёт её обратно через MCP (семантика, AST, граф и текст), так что запрос «где происходит авторизация» возвращает реальный поток авторизации, а не семь тестовых заглушек.

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

Antigravity запускает агента. Maguyva подсказывает ему, какой файл трогать.

Что делает каждый слой

Четыре элемента. У каждого своя роль.

// агентная IDE

Antigravity

Где ваши агенты планируют, редактируют и проверяют.

// ручной контекст

@-упоминания + правила

Ручной контекст работает — пока репозиторий не станет большим.

// кодовая база

Maguyva

Автоматические факты о кодовой базе через MCP.

// кто платит

Рабочие пространства, а не места

Агенты не платят за места. Смотреть тарифы

Antigravity запускает агентов. Пусть запускает.

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

  • Планирования и запуска агентов в редакторе, терминале и браузере.
  • Правок по нескольким файлам, когда изменение локально.
  • Правил агента для соглашений репозитория и стилистических ограничений.
  • @-упоминаний, чтобы подтянуть конкретный файл в контекст.

Продолжайте делать это. Никуда это не денется.

Но в настоящем монорепозитории (TypeScript с зависимостями между рабочими пространствами, сервисы на Python, смешанные пакеты) контекст агента ломается в тот момент, когда нужный файл ещё не попал в поле зрения агента.

Ручные обходные пути, которые вы уже пробовали, — и где они ломаются

Четыре ручных приёма и то, как они ломаются. Слева — то, что вы делаете сегодня. Справа — где это даёт сбой.

// the fix

// упомяните файлы

Вы @-упоминаете три файла, которые кажутся важными. Агент аккуратно редактирует внутри них.

// where it breaks

// упоминание — это догадка

Это работает, когда вы уже знаете, какие файлы задействованы. Автономному агенту нужны файлы, о которых вы даже не догадывались, что их нужно упомянуть.

// the fix

// вставьте фрагменты

Вы вставляете 200 строк из другого пакета в агента, чтобы дать ему достаточно контекста.

// where it breaks

// вставленный код устаревает

Фрагмент, который вы вставили в 9 утра, не отражает ребейз, который коллега влил в 11. Агент редактирует код против призрачной версии пакета.

// the fix

// напишите документ с контекстом

Вы пишете файл правил агента или markdown с архитектурой. Сегодня он верен.

// where it breaks

// документация устаревает быстрее кода

Всё, что вы пишете вручную, со временем расходится с реальностью. Источник истины — код. Документ, объясняющий слой очередей, верен неделю, а потом неверен навсегда.

// the fix

// держите файлы правил

Вы добавляете правила агента для именования, линтера и команд сборки. Отлично работает для поведения.

// where it breaks

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

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

Maguyva — это слой снизу

Это не замена Antigravity. Слой контекста репозитория, который подключается через её поддержку MCP.

  • Семантика + AST + граф + текст поиск по смыслу, структуре, зависимости или буквальному тексту. Каждое совпадение возвращает путь к файлу и номер строки.
  • Между пакетами по умолчанию места вызова и импортёры по всем пакетам монорепозитория, а не только по тому, что сейчас открыт у агента.
  • С учётом веток Maguyva видит ту версию кода, которую редактирует агент.
  • Создано для автономности агенту, который планирует множество правок, нужен радиус влияния заранее, а не после того, как CI покраснеет.

Antigravity решает, что редактировать.

Maguyva показывает агенту, чего касается правка.

Три сценария работы с монорепозиторием

Между пакетами, между языками. Обоснованно — на основе реального графа вызовов, а не grep'а агента.

// workflow 01

Найдите поток авторизации во всех пакетах, ничего не упоминая

agent> где в этом монорепозитории происходит авторизация?

graph::query("authentication flow")
  packages/web/src/auth/session.ts:42       middleware
  packages/api/src/auth/jwt.ts:88           проверка токена
  packages/shared/src/auth/types.ts:12      AuthContext
  packages/admin/src/auth/admin-only.ts:31  RBAC-шлюз

 4 точки входа в 4 пакетах, отсортированы по плотности мест вызова.
[exit 0]

Вы не упомянули ни одного файла. Вы не вставили ни одного фрагмента. У агента есть четыре нужных файла в правильном порядке, и он может сделать обоснованную правку.

// workflow 02

Найдите настоящую реализацию, а не тестовую заглушку

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 ранжирует настоящую реализацию выше тестового мока, в каждом пакете.

// workflow 03

Проверьте радиус влияния перед тем, как агент выполнит рефакторинг

agent> что вызывает QueueDispatcher.publish во всём монорепозитории?

graph::callers(QueueDispatcher.publish)
  3 в packages/billing/*
  1 в packages/audit/*
  1 в packages/notifications/*
  1 в services/python-worker/*  ← межъязыковой вызов через gRPC-заглушку
[exit 0]

Между пакетами и, если у вас полиглотный репозиторий, между языками — места вызова всплывают прямо в выводе. Автономный агент получает радиус влияния до правки, а не после того, как CI покраснеет.

Настройка с Antigravity

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

  1. // step 01

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

    Выберите монорепозиторий, где нехватка контекста ощущается острее всего.

  2. // step 02

    Добавьте Maguyva как MCP-сервер в Antigravity

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

    Задайте один вопрос, ответ на который вы уже знаете

    Не направляйте агента сразу на всю компанию. Начните с одного репозитория и одного проверяемого вопроса — например, «что вызывает formatInvoice в разных пакетах?»