Google Antigravity 2.0 활용 가이드: 결과를 검증하는 5가지 전략

Google Antigravity를 단순한 코드 자동완성 도구로 이해하면 현재 제품의 핵심을 놓치기 쉽습니다. 2025년 11월 공개된 초기 버전은 Editor View와 Agent Manager를 결합했지만, Google은 2026년 5월 Antigravity 2.0과 CLI를 발표했습니다. 현재 공식 Antigravity 2.0 개요는 2.0을 IDE와 독립적으로 실행되는 데스크톱 앱으로 설명합니다. 에이전트가 파일, 터미널, 웹, Chrome, 서브에이전트와 구현 계획을 다루고 사용자는 그 작업을 조율하는 구조입니다.

이 변화 때문에 “좋은 페르소나를 주면 된다”거나 “단계별 사고를 길게 설명하게 하라”는 일반적인 프롬프트 조언만으로는 부족합니다. 실제 성능과 안전성을 좌우하는 것은 작업 경계, 완료 조건, 승인 지점, 권한, 검증 증거입니다. 아래 다섯 전략은 각각 성공 여부를 확인할 수 있도록 구성했습니다.

2026년 7월 25일 기준 이용 조건: 공식 안내상 Antigravity는 Windows, macOS, Linux용 데스크톱 앱이며 만 18세 이상이 사용할 수 있습니다. 프롬프트와 지시는 영어만 공식 지원되므로 아래 예시도 영어로 제공합니다. 개인용 플랜은 현재 월 0달러로 표시되지만, 모델과 사용량 한도는 플랜·용량·작업량에 따라 달라질 수 있습니다. 최신 상태는 가격 페이지, 모델 목록, 플랜 및 쿼터 문서에서 다시 확인해야 합니다.

먼저 고르는 작업 방식

Antigravity 2.0의 선택지를 무조건 크게 사용할 필요는 없습니다. 작업 위험과 검증 비용에 맞춰 다음처럼 시작하면 됩니다.

작업	실행 모드	작업 공간	완료 증거
변수명 변경, 단일 명령 실행	Fast	Local	변경 diff, 관련 테스트
여러 파일에 걸친 기능·리팩터링	Planning	New Worktree	승인된 계획, 전체 테스트, 최종 diff
UI 동작 수정	Planning	New Worktree	테스트와 브라우저 스크린샷 또는 녹화
읽기 전용 구조·보안 조사	Planning	Local	근거 파일과 위치가 포함된 보고서, 변경 없음
서로 독립적인 조사·검증	Planning	쓰기 작업은 별도 Worktree	서브에이전트별 결과와 통합 결론

공식 문서도 Fast Mode는 이름 변경이나 작은 리팩터링처럼 국소적인 작업에, Planning Mode는 코드베이스 조사와 구현 계획이 필요한 작업에 맞춘다고 설명합니다.

전략 1. Project와 Worktree로 컨텍스트 경계를 먼저 고정한다

Antigravity 2.0에서 컨텍스트의 기본 단위는 “열어 둔 파일”이 아니라 Project에 연결한 폴더와 저장소입니다. 하나의 Project에 프런트엔드와 백엔드처럼 여러 폴더를 연결할 수 있고, Project마다 설정과 보안 정책이 분리됩니다. 에이전트는 기본적으로 Project 폴더와 Antigravity의 로컬 앱 데이터 디렉터리 안에서만 자동으로 작업합니다. 자세한 경계는 Projects 문서와 Agent Settings 문서에서 확인할 수 있습니다.

실전에서는 다음 순서가 안전합니다.

이번 목표에 필요한 저장소만 Project에 추가합니다.
빠른 대화형 수정은 Local Mode, 여러 파일을 건드리거나 병렬 작업을 하는 경우는 New Worktree Mode를 선택합니다.
첫 지시에 포함 범위와 제외 범위를 모두 적습니다.
수정 전후의 git status와 변경 파일 목록을 증거로 요구합니다.

Goal: Add validation to the checkout API.
In scope: backend/src/checkout, shared/contracts
Out of scope: deployment, database schema, frontend
Before editing: list the project roots, candidate files, and current git status.
Do not read or modify paths outside the project.

테스트 방법: 작업 시작 보고서의 Project 루트가 의도한 폴더와 일치하고, 완료 후 diff에 제외 영역의 파일이 하나도 없어야 통과입니다. 복잡한 작업에서 New Worktree를 골랐다면 활성 체크아웃의 git status가 그대로인지도 확인합니다.

전략 2. 페르소나 대신 Rules와 완료 계약을 쓴다

“시니어 보안 엔지니어처럼 행동하라”는 역할 지시는 관점을 줄 뿐, 무엇을 수정하고 어떤 검사로 끝낼지는 정하지 못합니다. 반복되는 제약은 Rules에 기록하고, 개별 작업에는 관찰 가능한 완료 조건을 붙이는 편이 낫습니다.

저장소 전용 Rules는 Git 루트의 .agents/rules 아래 Markdown 파일로 둘 수 있습니다. 항상 지켜야 하는 규칙은 Always On, 특정 파일군에만 필요한 규칙은 Glob 활성화를 선택합니다. 예를 들어 다음 계약은 기술 스택과 관계없이 결과를 점검할 수 있게 합니다.

# Change contract

- Modify only files required by the stated goal.
- Before editing, list candidate files and non-goals.
- Run the repository's relevant tests after changing code.
- Report changed files, exact verification commands, and exit status.
- Never deploy, push, or change external services.

작업 프롬프트도 “코드를 만들어 줘” 대신 아래 네 칸을 채웁니다.

Goal: Reject checkout requests without a request ID.
Constraints: Preserve the public response schema. No database migration.
Acceptance: The new test fails before the fix and passes after it.
Evidence: Show the test name, command, exit status, and final diff summary.

테스트 방법: 새 대화에서 같은 유형의 작업을 요청해도 수정 전 범위 확인, 정해진 검사, 완료 보고 형식이 반복되어야 합니다. 매번 추가 프롬프트로 누락을 보정해야 한다면 페르소나를 강화할 문제가 아니라 Rule이나 완료 조건을 고칠 문제입니다.

전략 3. Planning Mode와 Artifact Review를 변경 전 게이트로 쓴다

복잡한 작업에서는 긴 추론을 채팅으로 요구하기보다 Antigravity의 Implementation Plan Artifact를 검토하는 편이 구체적입니다. Artifacts 문서에 따르면 Artifact에는 구현 계획, 코드 diff, 아키텍처 다이어그램, 이미지, 브라우저 녹화 등이 포함됩니다. Planning Mode와 Request Review 정책을 함께 사용하면 에이전트가 계획이나 diff를 만든 뒤 승인 전까지 멈추게 할 수 있습니다.

계획에서 확인할 항목은 다섯 가지면 충분합니다.

변경할 파일과 각 파일의 책임
공개 API, 데이터, 사용자 동작에 미치는 영향
하지 않을 일과 범위 밖 항목
실패 가능성과 되돌리는 방법
실행할 테스트와 수집할 증거

계획이 기대와 다르면 새 프롬프트를 처음부터 쓰지 않아도 됩니다. Implementation Plan 문서가 설명하는 것처럼 Artifact에 인라인 코멘트를 남겨 범위를 줄이거나 기술 선택을 교정한 뒤 계획을 다시 받습니다.

테스트 방법: Planning Mode와 Request Review를 켠 첫 단계에서는 로컬 파일 변경 없이 검토 가능한 계획이 먼저 나와야 합니다. 계획에 완료 조건이나 제외 범위가 빠져 있으면 승인하지 않습니다. 승인 후에는 최종 diff가 계획의 파일 목록을 벗어나지 않아야 합니다.

전략 4. 최소 권한을 기본값으로 만들고 자동 실행은 좁게 연다

Antigravity 권한은 Deny, Ask, Allow 세 목록으로 평가되며 우선순위는 Deny > Ask > Allow입니다. Project 내부 파일 읽기·쓰기는 기본 허용되지만, 명령 실행, MCP, 웹 조작, Project 밖 파일은 기본적으로 승인을 요청합니다. 웹 페이지를 읽는 read_url과 클릭·입력 같은 동작을 하는 execute_url도 별도 권한입니다. 구체적인 리소스 형식은 Agent Permissions 문서에 나와 있습니다.

초기에는 모든 명령을 자동 실행하지 말고, 반복해서 쓰는 검증 명령만 좁게 허용합니다.

Allow
command(npm run test)
command(npm run lint)

Deny
command(git push)
command(rm -rf)
write_file(.git/)

나머지는 별도의 Ask command(*) 규칙을 추가하지 않고 보안 기본값인 Ask에 맡기는 편이 좋습니다. Ask command(*)는 더 구체적인 Allow보다 우선하므로 위의 자동 허용까지 무효화할 수 있기 때문입니다. 배포, 원격 저장소 변경, 결제·관리자 화면 조작은 편의보다 승인 지점을 유지하는 것이 중요합니다.

테스트 방법: 허용한 테스트 명령은 추가 질문 없이 실행되고, 허용하지 않은 pwd 같은 무해한 명령은 승인 카드를 띄우는지 확인합니다. Deny 목록은 설정 화면에서 대상 문자열을 확인하되, 삭제나 푸시 명령을 실제로 실행해 시험하지는 않습니다.

전략 5. 서브에이전트를 역할이 아니라 증거 생산 단위로 나눈다

서브에이전트는 “보안 전문가 페르소나”를 여러 개 만드는 기능이 아닙니다. Asynchronous Subagents 문서에 따르면 각 서브에이전트는 부모의 기존 대화 기록을 물려받지 않는 별도 컨텍스트에서 실행됩니다. 따라서 독립적으로 판정할 수 있는 입력, 범위, 산출물이 있어야 합니다.

좋은 분할은 다음처럼 결과를 합칠 수 있습니다.

research 서브에이전트: 관련 파일, 호출 경로, 위험 지점을 근거 위치와 함께 보고
구현 담당: 승인된 계획 안에서 코드와 테스트 수정
검증 담당: 변경하지 않고 지정된 테스트를 실행해 명령과 종료 상태 보고
브라우저 담당: /browser로 사용자 여정을 실행하고 스크린샷 또는 녹화 생성

쓰기 작업을 병렬화한다면 같은 Local 폴더를 공유하지 말고 별도 Worktree를 사용합니다. 서로 의존하는 변경은 병렬화하지 않고, 조사와 테스트처럼 독립적인 작업부터 분리합니다.

완료 프롬프트에는 다음 증거를 명시합니다.

Definition of done:
1. The targeted test reproduces the bug before the fix.
2. The targeted test and the full relevant suite pass after the fix.
3. For UI behavior, run the browser journey and attach a screenshot.
4. Report changed files, commands, exit status, and remaining risks.
5. Do not call the task complete if any required evidence is missing.

브라우저 스크린샷은 화면 상태를 보여 주지만 코드의 회귀 여부까지 증명하지는 않습니다. 반대로 단위 테스트 통과만으로 실제 UI 동작을 보장할 수도 없습니다. Walkthrough와 Screenshots는 리뷰를 돕는 Artifact이고, 테스트 로그와 함께 볼 때 완료 증거가 됩니다.

테스트 방법: 최종 Walkthrough에서 변경 파일, 실행한 명령, 종료 상태, UI 증거, 남은 위험을 각각 찾을 수 있어야 합니다. “완료했습니다”라는 요약이나 Artifact가 존재한다는 사실만으로는 통과시키지 않습니다.

30분 안에 다섯 전략을 점검하는 연습

실제 서비스 기능 대신 로컬 데모의 입력 오류 문구 하나를 바꾸는 작은 작업으로 시작해 보세요.

데모 저장소만 포함한 Project를 만들고 New Worktree를 선택합니다.
수정 범위, 금지 작업, 테스트 명령을 Rule과 프롬프트에 적습니다.
Planning Mode와 Request Review로 계획을 먼저 검토합니다.
테스트 명령만 Allow하고 네트워크·원격 변경은 기본 Ask 또는 Deny로 둡니다.
구현 후 테스트 종료 상태와 UI 스크린샷을 모두 요구합니다.

계획 전 무단 변경이 없고, 원래 체크아웃이 깨끗하며, diff가 범위 안에 있고, 테스트와 화면 증거가 함께 남았다면 워크플로가 제대로 작동한 것입니다. 실패했다면 더 긴 프롬프트를 쓰기 전에 Project 경계, Rule, 권한, 완료 조건 중 어느 계약이 빠졌는지부터 찾습니다.

결론

Antigravity 2.0을 잘 쓰는 기준은 생성한 코드의 양이나 “10배 생산성” 같은 검증하기 어려운 구호가 아닙니다. 의도한 범위만 바뀌었는가, 위험한 동작은 승인되었는가, 테스트와 사용자 동작 증거가 남았는가가 더 좋은 기준입니다.

Project로 컨텍스트를 제한하고, Rules로 반복 제약을 고정하고, Planning Mode에서 계획을 승인하고, 최소 권한으로 실행하고, 서브에이전트와 Artifacts로 결과를 검증하십시오. 이 다섯 단계가 갖춰지면 Antigravity는 막연한 AI 코딩 도구가 아니라 감사 가능한 엔지니어링 워크플로가 됩니다.

Google Antigravity 2.0 활용 가이드: 검증 가능한 5가지 엔지니어링 전략

핵심 요약