Agy review

Antigravity(Gemini) 코드 검수

현재 프로젝트의 코드 변경사항을 Google Gemini 3.1 Pro에게 독립적으로 리뷰 요청한다. Antigravity CLI(agy)의 --print 모드로 비대화형 실행.

Step 1: agy CLI 확인

~/.local/bin/agy --help 2>/dev/null | head -3 || echo "NOT_FOUND"

NOT_FOUND면 중단: "agy CLI 없음. https://antigravity.dev 에서 설치 후 로그인해."

Step 2: 인자 파싱

사용자 입력($ARGUMENTS)에서:

• --base <branch> → base 브랜치 지정 (없으면 자동 감지)
• 나머지 텍스트 → 커스텀 검수 지시사항

base 브랜치 자동 감지 (--base 없을 때):

git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||' || echo "main"

Step 3: 변경사항 확인

_BASE="<감지된 base 브랜치>"
_DIFF_STAT=$(git diff origin/$_BASE --stat 2>/dev/null | tail -5)

변경사항이 없으면 uncommitted 확인:

_DIFF_STAT=$(git diff --stat 2>/dev/null | tail -5)

아무 변경도 없으면 "변경사항 없음. 커밋하거나 수정 후 다시 실행해." 안내.

Step 4: diff 추출 + 리뷰 실행

diff가 너무 크면 agy 컨텍스트를 넘길 수 있으므로 파일 단위로 축약:

_REPO_ROOT=$(git rev-parse --show-toplevel)
cd "$_REPO_ROOT"

# diff 추출 (최대 8000줄 제한)
_DIFF=$(git diff origin/$_BASE 2>/dev/null || git diff 2>/dev/null)
_DIFF_LINES=$(echo "$_DIFF" | wc -l)

if [ "$_DIFF_LINES" -gt 8000 ]; then
  _DIFF=$(git diff origin/$_BASE --stat && echo "---" && git diff origin/$_BASE -- '*.ts' '*.tsx' '*.js' '*.jsx' '*.css' '*.py' | head -8000)
fi

리뷰 요청:

echo "$_DIFF" | ~/.local/bin/agy --print \
  "You are a senior code reviewer. Review the following git diff thoroughly. Focus on:
1. Bugs and logic errors
2. Security vulnerabilities (XSS, injection, auth issues)
3. Performance issues
4. TypeScript type safety
5. React/Next.js best practices (if applicable)
6. Code style and maintainability
<사용자 커스텀 지시사항이 있으면 여기에 추가>

Answer in Korean. Be specific — file names, line numbers, concrete suggestions.
If the code looks good, say so briefly.

Here is the diff:
$(cat)" \
  --print-timeout 300s \
  2>&1

timeout: 300000ms (5분)

커스텀 포커스가 있을 때 (예: "보안 집중", "성능 이슈 찾아줘"): 위 프롬프트의 Focus 섹션에 사용자 지시사항을 우선 배치.

Step 5: 결과 출력

═══════════════════════════════════════════════
GEMINI 3.1 PRO 검수 결과
═══════════════════════════════════════════════
<agy 출력 전문 — 요약하지 말고 그대로 표시>
═══════════════════════════════════════════════

Step 6: Claude 의견 추가

Gemini 결과를 본 후, Claude 자신의 관점에서 간략히 덧붙인다:

• 동의하는 지적사항
• 추가로 발견한 이슈
• 의견이 다른 부분 (있다면)

에러 처리

Error	Message
인증 에러	"Google OAuth 만료. 터미널에서 agy 실행 후 재로그인."
타임아웃	"5분 초과. diff가 너무 큼. --base로 범위 좁혀서 다시 시도."
빈 응답	stderr 내용 표시 후 재시도 안내
NOT_FOUND	"agy CLI 없음. ~/.local/bin/agy 확인."

규칙

• 읽기 전용 — 파일 수정 절대 안 함
• Gemini 출력은 요약/편집 없이 전문 그대로 표시
• Claude 의견은 Gemini 출력 이후에 별도로 추가
• 항상 ~/.local/bin/agy 풀 경로 사용 (IDE 버전 충돌 방지)
• diff가 8000줄 초과 시 코드 파일만 필터링해서 전달