🚀 Antigravity 2.0 초보자를 위한 10가지 철칙 — Google의 멀티 에이전트 기반 활용하기

Google I/O 2026에서 가장 큰 충격은 새로운 모델이 아니라 Antigravity 2.0이었습니다. AI 탑재 IDE였던 1.0에서, **멀티 에이전트 오케스트레이션 기반 (Multi-agent Orchestration Platform)**으로 완전히 탈바꿈했습니다.

내부 테스트 수치는 압도적입니다:

**93체의 에이전트 (Agent)**가 협력하여 260억 토큰을 소비하며 복잡한 시스템을 제로 베이스에서 구축 - 에이전트 팀이
완전한 OS를 제로 베이스에서 구축— API 비용은 1,000달러 미만 - Gemini 3.5 Flash가 타사의 최첨단 모델보다
12배 빠름, 품질 저하 없음

Antigravity 1.0이 '한 명의 AI 어시스턴트를 고용하는 것'이라면, 2.0은 '당신이 AI 시공 팀의 프로젝트 매니저(Project Manager)가 되는' 감각입니다. 하지만 강력한 도구에는 올바른 사용법이 있습니다. 실전에서 다듬은 10가지 철칙을 소개합니다.

설치 시 모드 선택 시, 초보자는 반드시 **두 번째인 '리뷰 주도 (Review-driven)'**를 선택하십시오:

모드	초보자용?	의미
세큐어 (Secure)	❌ 너무 시끄러움	매번 확인이 필요함
리뷰 주도 (Review-driven)	✅ 이것을 선택할 것	중요한 국면에서 정지, 확인 대기
풀 오토 (Full-auto)	❌ 위험함	에이전트가 폭주하여 나중에 피해를 발견함
커스텀 (Custom)	❌ 아직 빠름	익숙해진 후에 조정

또한, Settings → Agent → Permissions에서 git status나 ls와 같은 안전한 명령어를 화이트리스트 (Whitelist)에 등록하십시오. 확인 팝업으로 인한 스트레스가 대폭 줄어듭니다.

중요한 요청을 하기 전에, 입력창 왼쪽 상단의 모드 전환을 **「Planning」**으로 설정합니다.

당신의 입력: "EC 사이트의 홈페이지를 만들어줘"
↓
에이전트가 먼저 출력:
...

코드를 작성하기 전에 방향성을 확인할 수 있습니다 — 이는 나중에 수정하는 것보다 10배 더 효율적입니다.

Antigravity는 Google Docs와 같은 리뷰 경험을 제공합니다. 마음에 들지 않는 부분이 있다면, 새로운 프롬프트 (Prompt)를 쓰는 것이 아니라, **결과물에 직접 코멘트 (Comment)**를 남깁니다:

에이전트가 코드를 생성
당신의 코멘트 (결과물에 직접 기입):
→ "여기는 FastAPI를 사용해줘"
...

에이전트는 코멘트된 부분만 수정합니다. 프롬프트를 다시 쓰는 것보다 3~5배 빠르며, 올바른 부분은 그대로 유지됩니다.

여러 에이전트를 동시에 실행할 때의 가장 큰 함정: 두 에이전트가 동일한 파일을 건드리는 것입니다. Antigravity에는 머지 충돌 (Merge Conflict) 해결 기능이 없어, 나중에 작성된 쪽이 조용히 덮어씁니다.

해결책은 간단합니다:

Agent 1 → /api/ 만 담당 (백엔드)
Agent 2 → /components/ 만 담당 (프론트엔드)
Agent 3 → /tests/ 만 담당 (테스트)
...

지시는 자연어로 합니다: "에이전트 A는 백엔드 API를 작성해서 /api/에 저장해. 에이전트 B는 프론트엔드를 작성해서 /components/에 저장해. 서로의 폴더는 건드리지 마."

Antigravity는 세션 (Session)을 초월하여 기억하지 않습니다. 코멘트로 20분 동안 가르친 내용도 창을 닫으면 사라집니다.

철칙: 중요한 것을 에이전트에게 가르쳤다면, 즉시 규칙 파일 (Rules file)에 기록하십시오.

# .agents/rules/code-style.md
- Python은 PEP 8 준수
- Pydantic v2의 model_validate를 사용 (parse_obj 금지)
...

규칙에는 두 가지 스코프 (Scope)가 있습니다:

종류	경로	범위
글로벌 (Global)	~/.gemini/GEMINI.md	모든 프로젝트
워크스페이스 (Workspace)	.agents/rules/*.md	이 프로젝트만

같은 작업을 반복해서 요청하고 있지는 않습니까? "테스트를 생성해줘", "코드 리뷰해줘", "스테이징에 배포해줘" — 매번 설명하는 것을 그만두십시오. 워크플로우 (Workflow)를 생성합니다:

# .agents/workflows/generate-tests.md
- 현재 파일의 pytest 유닛 테스트를 생성
- 외부 의존성은 모크 (Mock)를 사용
...

이제 입력창에 /generate-tests를 입력하면 됩니다.

라고 입력하기만 하면 됩니다. 단락 설명이 하나의 슬래시(/)로 이어집니다. 워크플로우 (Workflow)는 중첩도 가능하며, 복합 파이프라인 (Composite Pipeline)도 구축할 수 있습니다.

초보자가 가장 자주 하는 실수: 전부 Claude Opus 4.5 Thinking으로 수행하는 것. 가장 똑똑하지만, 쿼터 (Quota)도 가장 많이 소비합니다.

올바른 패턴:

페이즈 (Phase)	모델 (Model)	이유
계획·설계	Claude Opus 4.5 Thinking	최고의 추론력
...	...	...

Antigravity는 태스크 (Task) 도중에 모델 전환이 가능합니다. 오른쪽 상단 패널에서 전환하면 동일한 대화를 계속 이어갈 수 있습니다. 높은 지능으로 계획하고, 효율적인 지능으로 실행하십시오. 결과는 같지만, 쿼터 소비는 대폭 줄어듭니다.

스킬 (Skill)은 에이전트 (Agent)의 지식 팩입니다. 하지만 에이전트는 모든 스킬을 자동으로 로드하지 않고, name과 description을 보고 기동 여부를 판단합니다.

좋은 설명:

name: db-migration-guide
description: DB 테이블 추가·변경 시, 프로젝트의
마이그레이션 (Migration) 규약과 Prisma 워크플로우를 제공

나쁜 설명 (에이전트가 사용하는 타이밍을 알 수 없음):

name: db-stuff
description: 데이터베이스 관련

공식: 「[트리거 조건]일 때, 이 스킬은 [무엇을 함]으로써 [어떤 결과]를 달성한다」

Antigravity의 플레이그라운드 (Playground) 기능은 아이디어의 빠른 검증 전용입니다. 프로젝트 생성도 설정도 필요 없습니다.

플로우 (Flow):

• 아이디어가 떠오름 → "에이전트가 Snake 게임을 만들 수 있을까?"
• 플레이그라운드를 열고 한 문장으로 설명
• 브라우저가 자동으로 열리며 테스트 수행
• 작동하면 → 본격적인 프로젝트로 변환
• 안 되면 → 5분 만에 종료, 손실 제로

플레이그라운드는 실현 가능성 검증용입니다. 제품 수준의 완성도를 기대하지 마십시오.

Antigravity는 Chrome 브라우저 제어 기능을 내장하고 있습니다. 에이전트가 자동으로 페이지를 열고, 버튼을 클릭하며, 스크린샷을 촬영합니다.

프롬프트 (Prompt)에 한 문장만 추가하면 됩니다:

「만들기가 끝나면 브라우저에서 테스트해서, 버튼이 작동하는지
데이터가 로드되는지 확인해줘」

에이전트가:

• 페이지를 엶
• DOM 구조를 분석
• 주요 요소를 클릭
• 결과를 스크린샷으로 보고

Selenium 불필요, Playwright 불필요. 프론트엔드 초보자에게 이것은 혁명적입니다.

무언가를 만들기 시작하기 전에, 딱 10분만 투자하여 이 3가지 파일을 설정하십시오.

- 비밀번호나 API 키는 절대 하드코딩 (Hard-code) 하지 말 것
- 모든 함수에 docstring 필수
- 신규 기능은 별도 파일로 분리
...

- 백엔드 (Backend): FastAPI + Pydantic v2
- 프론트엔드 (Frontend): React + TypeScript, any 타입 금지
- API 경로는 /api/v1 프리픽스 (Prefix) 사용
...

{ "hooks": [{ "event": "on_commit", "action": "run_workflow", "workflow": "run-tests", "filter": "src/**/*.py" }] }

이렇게 하면 매번 git commit 시 자동 테스트가 실행됩니다. 더 이상 의식할 필요가 없습니다.

Antigravity 2.0의 본질은 '더 똑똑한 AI'가 아니라, 당신이 프로젝트 매니저 (Project Manager)가 되고, 에이전트가 시공 팀이 되는 것입니다. 이 10가지 철칙을 익힌다면, Antigravity를 사용하는 것을 넘어 Antigravity를 지휘할 수 있게 될 것입니다.