[Antigravity 2.0] 프로젝트·권한·스케줄링 핵심 정리

안녕하세요. 재아군의 관찰인생입니다.

Antigravity 시리즈 4편입니다.

이번 글에서는 공식 Features 문서를 기준으로 Antigravity 기능 중 실무에 바로 영향을 주는 부분을 정리합니다.

 

핵심은 Project, Worktree, Scoped Settings, 권한, Scheduled Tasks입니다. 에이전트가 강력해질수록 "무엇을 할 수 있는가"보다 "어디까지 허용할 것인가"가 더 중요해집니다.

핵심 요약: Antigravity 2.0의 주요 기능은 에이전트를 더 자율적으로 만드는 동시에 Project 단위 권한, Worktree 격리, 승인 흐름으로 위험을 통제하는 방향으로 설계되어 있습니다.

1. Projects: 에이전트 작업의 기본 단위

Antigravity 2.0에서 에이전트는 Project 안에서 작업합니다. 공식 문서에 따르면 이전 Agent Manager에서는 에이전트가 단일 workspace folder에 엄격하게 매핑되었지만, Antigravity 2.0에서는 Project 개념으로 확장됩니다.

Project는 단순한 폴더 묶음이 아닙니다. Worktree, 설정, 권한, 여러 폴더 접근 범위를 함께 관리하는 운영 단위입니다.

Project 기능	의미	실무 활용
Worktree Support	격리된 Git worktree에서 작업	위험한 변경을 메인 작업 폴더와 분리
Scoped Settings	Project별 설정 적용	신뢰 프로젝트와 외부 코드 프로젝트를 다르게 운영
Scoped Permissions	권한 부여를 Project에 연결	허용된 작업을 반복 승인 없이 처리
Multi-Folder Access	여러 폴더를 한 Project에서 사용	프론트엔드와 백엔드 저장소를 함께 분석

2. Scoped Settings와 권한 프리셋

Features 문서는 설정이 Project 범위로 적용될 수 있다고 설명합니다. 신뢰할 수 있는 Project에는 더 허용적인 설정을, 외부에서 받은 코드나 민감한 폴더에는 더 제한적인 설정을 둘 수 있습니다.

문서에서 언급된 주요 프리셋은 Default, Full machine, Unrestricted입니다. 이름만 봐도 알 수 있듯이 뒤로 갈수록 접근 범위가 넓어집니다.

프리셋	운영 관점	추천 정도
Default	기본 보호 장치가 있는 시작점	처음에는 이 설정 권장
Full machine	전체 머신 접근 범위가 커짐	신뢰된 작업에서만 신중히 사용
Unrestricted	가장 넓은 권한	일상 작업 기본값으로는 비추천

보안 기준: 권한 프리셋은 편의 기능이 아니라 사고 범위를 정하는 안전장치입니다. Project를 만들 때마다 "이 에이전트가 읽고 써도 되는 경계"를 먼저 정해야 합니다.

3. Project 밖 Conversation은 빠른 실험용입니다

Antigravity 2.0은 Project 밖에서도 빠른 일회성 Conversation을 시작할 수 있습니다. 문서에 따르면 이런 세션은 격리된 로컬 scratch folder에서 실행됩니다.

이 기능은 "지금 바로 질문하고 작은 실험을 해보고 싶다"는 상황에 유용합니다. 다만 실제 제품 저장소를 수정하거나 팀 작업을 이어가야 한다면 Project 안에서 진행하는 것이 추적과 권한 관리에 유리합니다.

구분	Project 안 Conversation	Project 밖 Conversation
작업 위치	연결된 Project 폴더	격리된 scratch folder
권한	Project 설정과 권한 중심	별도 설정과 권한, global 권한 일부 상속
추천 용도	실제 코드 작업	짧은 조사, 샘플 생성, 아이디어 검토

4. Scheduled Tasks: 에이전트에게 시간을 줄 수 있다

Scheduled Tasks는 사용자가 자리를 비운 동안에도 에이전트에게 메시지를 보낼 수 있게 하는 기능입니다. 문서에서는 Gemini 3.5 Flash 모델을 활용한다고 설명합니다.

반복 실행도 지원합니다. 예를 들어 매일 아침 의존성 취약점 변경을 확인하거나, 매주 릴리즈 노트를 요약하거나, 특정 브랜치 상태를 점검하는 식의 사용이 가능합니다.

Scheduled Tasks 활용 예시

매일 09:00
  - main 브랜치의 최근 변경 요약
  - 실패한 테스트 로그 확인
  - 보안 업데이트 후보 정리

매주 금요일 17:00
  - 이번 주 merged PR 정리
  - 다음 주 기술 부채 후보 5개 추천
  - 문서 업데이트 누락 항목 점검

5. Secure by Default: 기본은 승인과 경계

Features 문서의 보안 설명에서 중요한 부분은 두 가지입니다. 첫째, 기본적으로 에이전트가 터미널 명령을 실행하기 전에 명시적 허가를 요청합니다. 둘째, 기본적으로 에이전트는 Project에 제공된 폴더 안에서 읽고 쓸 수 있습니다.

이 기본값은 유지하는 편이 좋습니다. Full Machine이나 Unrestricted 같은 설정을 열면 전체 머신에 대한 읽기/쓰기 범위가 커질 수 있으므로, 자동화의 편의보다 사고 반경을 먼저 고려해야 합니다.

• 처음에는 Default 설정을 유지합니다.
• 터미널 명령은 승인 로그를 남기며 확인합니다.
• Project에는 필요한 폴더만 연결합니다.
• 민감한 저장소는 별도 Project로 분리합니다.
• Unrestricted는 임시 테스트 환경에서만 검토합니다.

6. Voice Transcription: 말로 피드백하는 에이전트 워크플로우

Antigravity 2.0에는 라이브 음성 전사 기능도 포함됩니다. 텍스트 입력창 옆 마이크 버튼으로 시작하고 멈출 수 있으며, 단축키는 Ctrl + M으로 안내되어 있습니다.

흥미로운 부분은 단순 전사가 아니라 정리 기능입니다. 말을 하다 보면 반복, 정정, 군더더기가 생기는데, 문서에서는 녹음 종료 후 이를 더 cohesive prompt로 정리한다고 설명합니다.

사용 위치	활용 방식	주의점
Agent Input	새 작업 지시나 업데이트 전달	최종 실행 전 텍스트 확인
Artifact Comments	계획, diff, 산출물에 인라인 피드백	모호한 지시를 구체 문장으로 수정

7. JSON Hooks와 Browser: 자동화와 검증의 확장점

JSON Hooks는 Antigravity agent 실행 흐름의 특정 지점에서 로컬 shell script를 실행할 수 있게 하는 기능입니다. 도구 호출 전, 모델 응답 후, 루프 정지 조건 같은 시점에 개입할 수 있고, 전역 또는 workspace별 JSON 파일로 구성할 수 있다고 문서에 설명됩니다.

Browser 기능도 Antigravity 2.0에서 다시 작업된 영역입니다. 문서 기준으로는 /browser 명령으로 필요할 때 호출할 수 있고, Chrome DevTools MCP와 통합되며, webm 비디오 녹화도 지원합니다.

JSON Hooks 사용 아이디어
  - 위험한 명령 실행 전 차단 규칙 적용
  - 특정 파일 변경 후 자동 lint 실행
  - 모델 응답 후 사내 정책 문구 검사
  - 루프 종료 시 결과 요약 파일 생성

Browser 사용 아이디어
  - UI 플로우 확인
  - 접근성 오류 재현
  - 성능 병목 진단
  - 테스트 증거용 녹화 확보

마무리: Antigravity 기능은 자율성과 통제의 균형입니다

Antigravity 기능을 하나로 묶으면 "에이전트를 더 오래, 더 넓게, 더 자동으로 일하게 만들되 Project와 권한으로 경계를 정한다"는 방향입니다. Worktree와 Scheduled Tasks는 자율성을 높이고, Scoped Settings와 Interactive Approvals는 위험을 줄입니다.

팀에서 Antigravity 2.0을 쓴다면 기능을 켜는 순서가 중요합니다. Project와 권한부터 정하고, Worktree로 격리하고, 그다음 Scheduled Tasks와 Hooks와 Browser를 단계적으로 확장하는 흐름을 추천합니다.

참고 자료

• Google Antigravity Docs: Features
• Google Antigravity Docs: Getting Started
• Google Antigravity Docs: Build with Google