제미나이 4 아르곤 × 안티그래비티 실전｜맥 앱 내장, /goal 모드·.agents/skills로 11시간 무인 작업

"코딩 에이전트에게 밤새 일을 맡겨도 될까?" 개발자라면 한 번쯤 해 본 고민입니다. 구글이 2026년 10월 13일 안티그래비티(Antigravity)에서 제미나이 4 아르곤을 쓸 수 있게 하면서, 자사 저장소(google/adk-python)를 11시간 동안 사람 없이 돌린 실험 결과를 함께 공개했습니다.

결론부터 말하면, 아르곤 × 안티그래비티는 Google AI Ultra 구독, Gemini API 유료 등급, Gemini Enterprise로 쓸 수 있고, Gemini macOS 앱 안에도 들어왔습니다. 다만 구글 자체 실험에서도 규칙 없이 돌린 첫 실행은 공개 스키마를 바꿔 버렸고, 최종 제안 6개 중 2개만 반영됐습니다. 오래 맡길수록 규칙(skills)과 사람 리뷰가 핵심이라는 뜻입니다.

✅ 이 글에서 얻을 수 있는 것
1. 아르곤을 안티그래비티에서 쓰는 경로별 조건 (울트라·API·Enterprise·macOS 앱)
2. /goal 모드와 .agents/skills 구성 방법 (구글 ADK 사례 기준)
3. 1차·2차 실행 비교로 보는 장시간 에이전트 작업의 한계

아르곤·안티그래비티 이용 경로

무료 등급 API 키로는 이 경로에 들어가지 못한다는 점을 먼저 확인하세요. 무료 등급 한도는 구글 제미나이 API 무료 사용법에 따로 정리해 두었습니다. 안티그래비티에서 아르곤을 쓸 때 울트라 한도나 과금이 어떻게 계산되는지는 구글 원문에 수치가 없습니다.

📌 아르곤 모델 자체의 출시 내용과 API 가격은 제미나이 4 아르곤 정식 출시｜API 가격·앱 사용 대상·성능 정리를 참고하세요.

Gemini macOS 앱에 들어온 안티그래비티

10월 13일 Gemini 앱 릴리스 노트에 따르면, Gemini macOS 앱 상단에 Antigravity 버튼이 생겼습니다. 흐름은 간단합니다.

1. 앱 상단의 Antigravity를 눌러 코딩 에이전트를 실행합니다.
2. 에이전트가 작업 계획을 제시합니다.
3. 계획을 승인하면 에이전트가 백그라운드에서 빌드·테스트를 진행합니다.
4. 끝나면 결과를 알려 줍니다.

'계획 승인' 단계가 있다는 점이 중요합니다. 에이전트가 무엇을 바꿀지 먼저 보고 승인하는 구조라서, 범위가 넓은 작업은 이 단계에서 계획을 꼼꼼히 읽는 것이 사고를 줄이는 첫 관문입니다. 지금은 영어로만 제공되며, 한국어 지원 일정은 공개되지 않았습니다.

구글 사내 수치 (구글 발표 기준)

구글은 사내에서 쓰는 안티그래비티 수치도 공개했습니다. 모두 구글이 자체 발표한 수치라는 점을 감안해서 보세요.

11시간 무인 실행 사례: 구글 ADK 최적화

구글 개발자 블로그는 아르곤으로 google/adk-python 저장소(약 20만5천 줄, 800개 파일)를 최적화한 과정을 공개했습니다. 구글은 이 작업을 11시간 무인으로 실행해 장기 세션 준비 시간을 약 40%, 패키지 콜드 임포트(처음 불러올 때 걸리는 시간)를 21% 줄였다고 밝혔습니다.

흥미로운 부분은 첫 시도가 실패했다는 점입니다.

규칙이 없을 때 에이전트는 테스트 일부만 돌린 채 공개 스키마까지 건드렸습니다. 규칙을 준 2차에서는 전체 테스트를 돌리고 사람이 검토할 수 있는 형태로 결과를 냈습니다. 그래도 6개 중 4개는 사람이 거절했습니다.

/goal 모드와 .agents/skills 구성법

/goal 모드: 목표를 잃지 않게 하기

긴 작업에서 에이전트가 자주 실패하는 이유는 대화가 길어지면서 처음 목표를 잊는 것입니다. 대화가 길어지면 이전 내용을 줄여 담는 '컨텍스트 압축'이 일어나는데, 이때 세부 지시가 빠질 수 있습니다. 구글 설명에 따르면 /goal 모드는 컨텍스트 압축이 일어나도 목표를 유지해, 작업이 끝날 때까지 에이전트를 계속 실행합니다.

목표는 "무엇을 바꾸고, 무엇은 건드리지 말고, 무엇으로 성공을 판단하는지"가 드러나게 쓰는 것이 좋습니다. 아래는 구글 사례를 참고해 필자가 정리한 목표 문장 예시입니다. 실제 입력 방법은 안티그래비티 화면 안내를 따르세요.

목표: 패키지 콜드 임포트 시간을 줄인다.
지켜야 할 것: 공개 API와 공개 JSON 스키마는 바꾸지 않는다.
완료 조건: 전체 단위 테스트를 통과하고, 변경 이유를 적은 PR을 연다.

.agents/skills: 규칙은 짧은 색인 + 필요할 때만 읽는 참고 파일

구글 팀은 저장소의 .agents/skills 폴더에 유지보수 규칙을 넣었습니다. 각 스킬은 짧은 SKILL.md 색인을 두고, 자세한 내용은 references 파일로 나눠 필요할 때만 불러오게 했습니다. 처음부터 모든 규칙을 읽히지 않으니 긴 작업에서도 컨텍스트를 아낄 수 있습니다.

아래는 이 구조를 단순화한 예시 구성입니다. 폴더·파일 이름과 내용은 설명을 위해 필자가 만든 것입니다.

my-repo/
└── .agents/
    └── skills/
        └── api-compat/
            ├── SKILL.md            # 짧은 색인: 언제 쓰고, 어떤 참고 파일이 있는지
            └── references/
                ├── public-schema.md    # 공개 스키마 변경 금지 규칙
                └── test-policy.md      # 전체 테스트 실행 규칙

---
name: api-compat
description: 공개 API·스키마에 영향을 줄 수 있는 변경을 할 때 사용
---
# 공개 호환성 규칙 (색인)
- 공개 JSON 스키마를 바꾸는 변경 전에는 references/public-schema.md 를 읽는다.
- 커밋 전에는 references/test-policy.md 에 따라 전체 단위 테스트를 실행한다.

1차 실패 원인(테스트 일부만 실행, 공개 스키마 변경)을 그대로 규칙으로 바꾼 셈입니다. 내 저장소에서도 과거에 사람이 리뷰에서 자주 지적한 내용부터 스킬로 옮기면 효과를 보기 쉽습니다.

장시간 에이전트 작업, 이렇게 시작하세요

1. 경로 확인: 울트라·API 유료 등급·Enterprise 중 어디로 쓸지 먼저 정합니다. 무료 등급은 대상이 아닙니다.
2. 규칙부터: 바꾸면 안 되는 것(공개 API, 스키마)과 꼭 돌려야 할 테스트를 .agents/skills에 적습니다.
3. 목표를 구체적으로: /goal에 성공 조건(전체 테스트 통과, PR 생성)을 넣습니다.
4. 결과는 PR로 받고 사람이 리뷰: 구글 사례처럼 제안의 일부만 반영될 수 있다고 생각하고 검토 시간을 따로 잡습니다.

⚠️ 11시간 무인 실행은 구글이 자기 저장소에서 한 실험입니다. 사용량 한도와 비용이 어떻게 계산되는지는 원문에 없으므로, 처음에는 짧은 작업으로 소모량을 확인한 뒤 길게 맡기는 것이 안전합니다.

💡 Gemini API 모델 교체 일정도 함께 확인해 두세요: Gemini API 10월 모델 종료｜대체 모델 정리

맺음말

1. 10월 13일부터 울트라 구독자는 안티그래비티 앱·CLI에서 아르곤을 쓰고, API 유료 등급·Enterprise로도 이용할 수 있습니다. Gemini macOS 앱에도 영어로 들어왔습니다.
2. /goal 모드는 컨텍스트 압축 뒤에도 목표를 유지하고, .agents/skills는 짧은 SKILL.md + references 구조로 규칙을 줍니다.
3. 구글 실험에서도 규칙 없는 1차는 공개 스키마를 바꿨고, 2차 제안도 6개 중 2개만 반영됐습니다. 규칙과 사람 리뷰가 전제입니다.

공식 자료

• 구글 안티그래비티의 제미나이 4 아르곤 발표 (Google 코리아 블로그, 2026-10-13)
• 제미나이 4 아르곤 개발자 이용 안내 (Google 블로그, 2026-10-13)
• 아르곤으로 20만 줄 파이썬 코드 최적화 사례 (Google Developers Blog, 2026-10-13)
• Gemini 앱 릴리스 노트 (2026-10-13)

👉 다음에 읽을 글
- 구글 제미나이 API 무료 사용법｜AI 스튜디오 무료 등급 모델별 한도 — 유료 등급으로 넘어가기 전에 무료 등급 한도를 먼저 확인하세요.
- Gemini API 10월 모델 종료｜대체 모델 정리 — 코드 속 모델 이름을 점검할 때 함께 보세요.