Flutter 개발자를 위한 Antigravity 2.0: 실질적으로 중요한 CLI, SDK 및 에이전트 워크플로 (Agentic

요약 (TL;DR): Antigravity 2.0은 Gemini CLI를 더 빠른 Go 기반 CLI (agy)로 대체하고, 커스텀 에이전트 워크플로 (Agentic Workflows)를 위한 SDK를 추가하며, 에이전트에게 실행 중인 앱의 실시간 컨텍스트를 제공하는 Dart & Flutter MCP 서버를 출시합니다. 마이그레이션 마감일은 2026년 6월 18일입니다. Flutter 개발자에게 가장 중요한 세 가지는 AGENTS.md, 에이전트 핫 리로드 (Agentic Hot Reload), 그리고 Stitch → MCP → Flutter 파이프라인입니다.

Gemini CLI는 2026년 6월 18일에 은퇴합니다. 만약 이를 사용하는 Flutter 개발자라면, 단순히 도구를 업그레이드하는 것이 아니라 AI가 워크플로에 통합되는 방식의 모델 자체를 마이그레이션하는 것입니다. Flutter 3.44과 함께 Google I/O 2026에서 발표된 Antigravity 2.0은 단순한 이름 변경이 아닙니다. 이는 기존의 하나의 VS Code 포크(fork)가 제공하던 기능을 네 가지의 별도 인터페이스로 나눈 것입니다:

• Antigravity Desktop: 통합 에이전트 패널이 포함된 IDE 스타일의 에디터
• Antigravity CLI (agy): Go로 구축된 터미널 우선 에이전트로, 빠르고 스크립트 작성이 가능함
• Antigravity SDK: 커스텀 에이전트 워크플로 (Agentic Workflows)를 위한 프로그래밍 방식의 API
• Managed Agents: 단 한 번의 API 호출로 생성되는 클라우드 격리 Linux 환경

이 기사는 마케팅 개요가 아닌, Flutter 개발자에게 실질적이고 실용적인 우위를 제공하는 세 가지 요소에 집중합니다.

1. AGENTS.md: 프로젝트의 AI 헌법

AGENTS.md란 무엇인가? 이는 Flutter 프로젝트의 루트(root)에 배치하는 Markdown 파일입니다. Antigravity는 모든 에이전트 세션이 시작될 때 이 파일을 읽으며, 프로젝트 전체에 대한 상시 지침 세트로 사용합니다. 이는 매 프롬프트마다 아키텍처 규칙을 복사하여 붙여넣던 습관을 대체합니다.

# Project Agent Rules

- Architecture: Clean Architecture, feature-based folder structure
...

이 파일을 버전 관리 시스템에 포함시키세요. 팀의 모든 개발자와 모든 에이전트 세션은 동일한 컨텍스트에서 시작합니다. 이제 새로운 에이전트를 온보딩하는 것은 새로운 개발자를 온보딩하는 것과 동일합니다.

이 파일은 하위 호환성도 유지합니다. GEMINI.md도 여전히 읽히지만, 두 파일이 모두 존재할 경우 AGENTS.md가 우선권을 갖습니다.

2. Antigravity CLI를 설치하고 지금 바로 마이그레이션하세요

agy란 무엇인가요? 이는 gemini를 대체하는 Go 언어로 구축된 터미널 기반 에이전트인 Antigravity CLI입니다. 더 빠르고, 적절한 TUI (Text User Interface)를 제공하며, 데스크톱 앱과 동일한 기반 모델 및 플러그인 시스템을 공유합니다.

# macOS / Linux
curl -fsSL https://antigravity.google/install.sh | bash

...

기존의 Gemini CLI 설정이 있는 경우, 마이그레이션은 첫 실행 시 자동으로 수행되거나(감지 후 프롬프트 표시) 수동으로 진행할 수 있습니다:

agy plugin import gemini

사용자의 에이전트 기술 (Agent Skills), 훅 (Hooks), 하위 에이전트 (Subagents), 그리고 확장 기능 (Extensions, 현재는 Antigravity Plugins로 명칭 변경)이 그대로 유지됩니다. 향후 전역 설정 (Global config)은 ~/.antigravity/에 저장됩니다.

3. Dart & Flutter MCP 서버 활성화하기

Flutter MCP 서버란 무엇인가요? MCP (Model Context Protocol)는 에이전트에게 개발 환경에 대한 실시간적이고 구조화된 접근 권한을 부여하기 위한 표준입니다. Dart & Flutter MCP 서버를 사용하면 사용자가 채팅창에 코드를 직접 붙여넣지 않아도, Antigravity가 위젯 트리 (Widget tree), 활성 경로 (Active routes), Dart 분석 결과 (Dart analysis output), 그리고 실행 중인 앱 상태 (Running app state)를 읽을 수 있습니다.

Antigravity IDE 내에서 다음과 같이 설치하세요:

1. Cmd/Ctrl + L을 눌러 에이전트 패널을 엽니다.
2. Dart & Flutter MCP server를 검색합니다.
3. 설치 후 재시작합니다.

활성화되면 에이전트는 실행 중인 에뮬레이터의 상태를 확인하고 이에 따라 동작할 수 있습니다. 이것이 바로 에이전트 기반 핫 리로드 (Agentic Hot Reload)를 가능하게 하는 핵심입니다.

4. 에이전트 기반 핫 리로드 (Agentic Hot Reload): 몇 초 만에 프롬프트에서 에뮬레이터로

에이전트 기반 핫 리로드 (Agentic Hot Reload)란 무엇인가요? Antigravity의 에이전트가 Flutter 파일을 수정하면, 자동으로 Flutter의 핫 리로드 (Hot reload)를 트리거합니다. 수동으로 r을 입력할 필요도, 창을 전환할 필요도 없습니다. 에이전트 패널에서 UI 변경 사항을 설명하면, Dart 파일이 업데이트되고 에뮬레이터에 즉시 반영됩니다.

Antigravity 설정에서 **에이전트 주도 모드 (Agent-driven mode)**로 전환하여 이 기능을 활성화할 수 있습니다. 이 모드에서 에이전트는 매 단계마다 승인을 요청하지 않고 명령(핫 리로드 포함)을 실행합니다. 프로덕션 프로젝트의 경우, 동일한 기능을 제공하면서도 flutter pub add나 파일 삭제와 같은 명령을 실행하기 전에 에이전트가 멈춰서 확인을 요청하는 **검토 주도 모드 (Review-driven mode)**를 사용하는 것이 좋습니다.

5. Stitch → Antigravity → Flutter 파이프라인

Antigravity를 사용하여 디자인에서 실행 가능한 Flutter 앱으로 어떻게 전환할 수 있을까요? Flutter 커뮤니티가 구축해 온 워크플로(Workflow)는 세 가지 도구를 순차적으로 사용합니다.

1단계: Stitch에서 디자인하기

플랫폼 (Android/iOS), 디자인 시스템 (Material 3), 접근성 요구 사항, 화면, 컴포넌트 등 전체 컨텍스트를 포함하여 화면을 설명하세요. Stitch는 구조화된 디자인 아티팩트 (Design artifact)를 출력합니다.

2단계: MCP를 통해 연결하기

MCP 커넥터 (Connectors)를 통해 Stitch 출력물을 내보냅니다. 이는 디자인을 스크린샷이 아닌, 타입이 지정된 디자인 토큰 (Design tokens) 및 레이아웃 데이터로서 Antigravity 에이전트 (Agent)에 구조화된 컨텍스트로 전달합니다.

3단계: 아키텍처와 함께 에이전트에게 프롬프트 입력하기

Antigravity 에이전트 (Agent) 탭에서 다음과 같이 입력합니다:

Stitch 내보내기 파일을 사용하여 습관 추적기 (Habit tracker) 화면을 구축해줘.
클린 아키텍처 (Clean Architecture)를 따를 것. Riverpod를 사용하고, Material 3 토큰을 사용하며, 라이트 모드와 다크 모드를 모두 지원할 것. 하드코딩된 문자열은 사용하지 말 것.

10~12분 안에 실행 가능한 Flutter + Dart 코드를 얻을 수 있습니다. 그 다음 flutter run을 실행하세요.

수동으로 검토해야 할 사항: 복잡한 비동기 상태 (Async state), 플랫폼 채널 (Platform channels), 네이티브 플러그인 통합 (Native plugin integrations), 그리고 민감한 권한과 관련된 모든 사항입니다. 에이전트는 스캐폴딩 (Scaffolding)을 잘 처리하지만, 비즈니스 로직의 예외 케이스 (Edge cases)는 여전히 사람의 검토가 필요합니다.

6. Antigravity SDK: Flutter 에이전트 워크플로 자동화

Antigravity SDK의 용도는 무엇인가요? 데스크톱 및 CLI를 구동하는 것과 동일한 에이전트 하네스 (Agent harness)에 대한 프로그래밍 방식의 액세스를 제공하며, Gemini 3.5 Flash (현재 기본 모델로, 이전 세대보다 4배 빠르고 더 높은 벤치마크 점수를 기록함)에 최적화되어 있습니다. 다음과 같은 용도로 사용하세요:

• PR 머지 (Merge) 전 CI 단계에서 Flutter 린트 및 수정 (Lint-and-fix) 에이전트 실행
• 디자인 시스템 토큰을 이해하고 생성된 코드 전반에 이를 강제하는 커스텀 에이전트 구축
• 다단계 워크플로 자동화: 생성(Generate) → 테스트(Test) → 수정(Fix) → 커밋(Commit). 이때 매니지드 에이전트 (Managed Agents)가 각 실행을 위한 격리된 Linux 환경을 제공합니다.

매니지드 에이전트 (Managed Agents)는 단 한 번의 API 호출로 완전히 격리된 환경을 실행(spin up)하며, 멀티 턴 세션 (multi-turn sessions) 동안 지속적인 상태 (persistent state)를 유지합니다. 이는 대규모 Flutter 코드베이스를 새로운 API로 마이그레이션하는 것과 같은 장기 실행 작업 (long-running tasks)에 유용합니다.

가격 참조 (Pricing Reference)

플랜 (Plan)	월간 (Monthly)	사용량 제한 (Usage limit)
Free (Individual)	$0	2026년 6월 18일 지원 종료
...

마감일: 개인을 위한 무료 Gemini Code Assist는 2026년 6월 18일에 요청 처리를 중단합니다. 그 날짜 이전에 유료 플랜을 구독하거나 CLI 마이그레이션을 완료해야 합니다.

실무에서의 변화점

Antigravity 2.0은 좋은 Flutter 코드가 무엇인지에 대한 정의를 바꾸지는 않습니다. 클린 아키텍처 (Clean Architecture)는 여전히 클린 아키텍처이며, Riverpod의 동작 방식도 동일합니다. 변하는 것은 여러분이 직접 작성해야 하는 스캐폴딩 (scaffolding)과 보일러플레이트 (boilerplate)의 양입니다.

이를 가장 잘 활용하는 개발자들은 AGENTS.md를 진지하게 다루고, 프로덕션 (production)에 영향을 주는 모든 작업에 리뷰 주도 모드 (Review-driven mode)를 사용하며, 복잡한 상태 로직 (state logic) 및 네이티브 통합 (native integrations)에 대해서는 인간의 검토 (human review)를 유지합니다. 에이전트는 적절한 작업에 대해서는 매우 빠릅니다. 무엇이 적절한 작업인지 파악한다면, 재작업 (rework) 없이 속도를 얻을 수 있습니다.

_출처: Flutter docs — Antigravity · Flutter docs — Antigravity CLI · Google Developers Blog — Gemini CLI to Antigravity CLI transition · TechCrunch — Google I/O 2026 coverage · MarkTechPost — Antigravity 2.0 full breakdown