안티그래비티(Antigravity) 2.0 토큰 낭비 방지 가이드

안티그래비티(Antigravity) 2.0 토큰 낭비 방지 가이드:
/grill-me와 /goal 활용법

범인은 이 안에 있어: 서브에이전트의 '독단적 삽질'

Antigravity 2.0을 사용하면서 토큰이 가장 어이없게 살살 녹아내리는 순간이 언제인지 아십니까? 바로 메인 에이전트의 명령을 전달받은 하위 서브에이전트(Subagents)들이 개발자의 진짜 의도와 어긋난 방향으로 폭주할 때입니다.

에이전트들이 잘못된 방향을 잡은 채로 "코드 수정 -> 컴파일 에러 -> 수정 -> 에러"라는 무한 루프에 빠지면, 순식간에 수십만 토큰이 공중 분해됩니다.

이를 완벽하게 차단하는 핵심 메커니즘은 아주 간단합니다.

• 에이전트가 단 한 줄의 코드를 작성하기 전에 개발자의 의도를 철저히 역검증하도록 만드는 것 (/grill-me)
• 자율 실행을 위임할 때, 탈출 조건과 비용 제어 장치를 매우 촘촘하게 쥐여주는 것 (/goal)

토큰 누수를 최소화하는 3단계 실전 프로세스

실제 작업에 들어가기 전, 이 세 단계를 머릿속에 꼭 입력해 두세요.

• 1.1단계: /grill-me로 설계 정렬 (코드 작성 전 필수)
  에이전트가 코드를 한 줄이라도 직접 손대기 전에 아키텍처적 의도와 제약 조건을 먼저 심층 인터뷰하게 만듭니다. 이 과정에서 오작동을 원천 차단할 수 있습니다.
• 2.2단계: 가드레일 및 종료 증명 설계 (비용 폭탄 방지)
  하위 에이전트 호출 수 제한, 최대 실패 횟수, 그리고 완전한 테스트 통과 기준(Exit Code)을 명확히 정의합니다.
• 3.3단계: /goal 기반 자율 완결 (백그라운드 실행)
  설계된 타이트한 제약 조건 안에서만 에이전트가 스스로 컴파일과 디버깅을 반복하도록 유도하여 최종 목표를 안전하게 달성합니다.

📋 [템플릿 1] 사전 설계 검증용 /grill-me

복잡한 모듈이나 레거시 코드를 대대적으로 리팩토링하기 전에 사용하는 템플릿입니다. 에이전트에게 관련 컨텍스트를 넘겨준 다음, "나를 압박 면접하라"고 강하게 명령하는 방식입니다. 이 필터링 단계를 도입하는 것만으로 요구사항 오해로 발생하는 토큰 낭비를 90% 이상 예방할 수 있습니다.

/grill-me
[목표]: 레거시 모듈({여기에 파일명 또는 폴더 경로 작성})을 {원하는 리팩토링 방향: 예: 비동기 처리 및 구조 분리}로 리팩토링하기 위한 사전 설계 검증.

[현재 컨텍스트]:
- 소스 코드 상태: {예: 하나의 파일에 비즈니스 로직과 DB 쿼리가 얽혀 있는 상태}
- 해결하려는 병목/문제: {예: 동기식 호출로 인한 API 응답 지연}
- 반드시 유지해야 하는 기능: {예: 기존 외부 라이브러리 의존성 및 반환 데이터 포맷}

[그릴링 규칙]:
너는 코드를 단 한 줄도 수정하거나 제안하지 말고, 내 의도를 완벽히 파악하기 위해 다음 항목에 대해 나에게 압박 면접(/grill-me)을 진행해 줘.
1. 내가 놓쳤을 수 있는 에러 핸들링이나 에지 케이스(Edge case)
2. 이 리팩토링으로 인해 발생할 수 있는 타 모듈의 사이드 이펙트 우려 지점
3. 네가 하위 서브에이전트들을 풀기 전에 반드시 확정해야 하는 구조적 의사결정

※ 중요: 질문은 한 번에 최대 2~3개씩만 핵심만 찔러서 던져줘. 내 답변이 끝나고 "설계 완료, 실행 준비"라고 선언하기 전엔 절대로 코드 생성을 시작하지 마.

📋 [템플릿 2] 비용 차단형 자율 실행 /goal

위의 /grill-me를 거치며 구체적인 설계가 명확히 정렬되었다면, 이제 아래 템플릿을 사용하여 에이전트를 자율 완결 모드로 진입시킵니다. 하위 에이전트 수의 명확한 한계와 실행 중단 기준이 선언되어 있어, 루프에 갇히더라도 무한 결제를 예방해 줍니다.

/goal
[최종 목표]: 앞서 합의된 설계안을 바탕으로 {대상 파일/폴더 경로}의 코딩 및 리팩토링을 완벽히 완료한다.

[실행 가드레일 (토큰 낭비 방지)]:
- 동시에 생성 및 호출할 수 있는 다이나믹 서브에이전트(Subagents)의 풀은 최대 3개로 제한한다.
- 동일한 컴파일/테스트 에러로 인해 연속 3회 이상 빌드가 실패하는 경우, 작업을 즉시 중지(Abort)하고 에러 로그와 함께 주도권을 나에게 반환해라.
- 리팩토링 범위 외에 타 모듈의 코드를 건드려야 하는 상황이 감지되면 즉시 실행을 멈추고 컨펌을 요청해라.

[종료 증명 (Definition of Done)]:
하위 에이전트들은 다음 3가지 조건을 터미널에서 스스로 증명하기 전까지는 작업을 완료로 표시할 수 없다.
1. {사용 중인 테스트 프레임워크: 예: pytest / jest}를 실행하여 테스트 커버리지 {목표 수치: 예: 80%} 이상 및 전원 통과(Exit Code 0)를 달성할 것.
2. 정적 분석 및 린터 툴({예: ruff / eslint}) 검사 시 경고(Warning) 및 에러가 0개일 것.
3. 코드 구조가 분리되었으나 기존 public API의 인터페이스와 리턴 타입은 완벽히 유지되었음을 통합 테스트로 증명할 것.

조건이 모두 충족되면 터미널에 최종 성공 로그와 `git diff` 요약을 출력하고 실행을 완전히 종료해줘.

💡 여기서만 드리는 실전 꿀팁

Antigravity 2.0에서 /goal 모드가 도는 도중에 사용자가 조급한 마음에 터미널에 수동으로 개입하거나 채팅창을 건드리면 안 됩니다.

개입하는 순간 에이전트의 컨텍스트 락(Context Lock)이 일시적으로 해제되면서 아까운 내부 캐시가 싹 날아갈 우려가 있습니다.

제약 조건을 충분히 타이트하게 설정했다면, 믿고 맡긴 채 브라우저 탭을 조용히 내려두고 다른 업무를 보시는 것이 정신 건강과 지갑 평화에 압도적으로 유리합니다. 스스로 멈추거나 통과할 때까지 기다려 주세요.