Insane Review

insane-review (Codex 판)

왜 존재하나: GPT Pro(최신 플래그십 모델의 Pro 추론)는 웹(구독)에서만 쓸 수 있고 API가 없다. 그래서 omc ask·agent-council의 기존 API provider로는 못 부른다. 이 스킬은 구독 ChatGPT 웹을 자동화해 Pro를 Codex CLI 안으로 끌어오는 유일한 경로다. API 비용 0, 사용자의 요금제로 동작.

핵심 가치는 "통째 패킹"이 아니라 "의도 파악 → 관련 타겟만 정밀 선별 → 그것만 패킹" 이다. 이 선별을 Codex(너)가 수행하는 것이 이 도구의 차별점이다.

엔진은 $PLUGIN_ROOT/bin/pack_and_ask.py 하나(순수 Python)다. 이 문서가 실행 지시서다 — 아래 순서대로 네가 직접 실행한다.

원칙: 사용자에게 CLI 타이핑을 시키지 않는다. 환경이 안 갖춰졌으면 네가 --ensure-env로 감지하고, 필요한 결정은 $PLUGIN_ROOT/shared/questioning-policy.md §A 방식(채팅에 번호형 선택지 블록을 출력하고 자유 텍스트 답변을 읽음)으로 물어본 뒤 네가 대신 실행한다. 초보자도 번호만 골라 따라올 수 있어야 한다. 이미 결정 가능하면(§2c) 묻지 말고 즉시 진행한다.

Step 0 — 첫 실행 셋업 (1회, 수동)

Codex에는 설치 훅이 없다. 그래서 pip 의존성(playwright·pyperclip)은 1회 직접 설치한다 — Step 0.5의 deps=missing 분기에서 --check-env --install로 채운다. repomix는 npx -y로 실행되어 사전설치 불필요(Node.js만 있으면 된다).

Step 0.5 — 환경 온보딩 (브라우저·로그인; 선택지 기반, 막힌 단계만)

먼저 네가 직접 실행한다(사용자에게 시키지 말 것):

python3 "$PLUGIN_ROOT/bin/pack_and_ask.py" --ensure-env

--ensure-env는 저장된 브라우저가 있고 CDP가 닫혀 있으면 조용히 1회 자동 기동한 뒤 상태를 보고한다 (저장값-only·첫감지 폴백 없음, browser=wrong이면 자동기동 안 함). 즉 최초 1회 온보딩 이후엔 브라우저를 다시 묻지 않고 알아서 뜬다. 마지막 줄 STATUS node=… deps=… browser=… login=… cookie=… cookie_exp=… saved_browser=… os=… launch_mode=… mode=…을 파싱한다. 전부 ok가 아니면, 막힌 첫 단계를 아래처럼 §A 번호 선택지로 물어보고 → 선택대로 네가 실행 → --ensure-env를 다시 돌려 재확인한다(최대 3~4회 반복).

• deps=missing → 선택지(의존성):

  1. 지금 자동 설치 (추천) → 네가 --check-env --install 실행
  2. 직접 설치할게요 → pip install playwright pyperclip 안내만
  3. 취소

• browser=down — --ensure-env가 저장값 자동기동을 이미 시도한 뒤의 상태다. saved_browser로 분기한다:

  • saved_browser=<이름>인데도 down (저장 브라우저 자동기동 실패 — 보통 프로필 락/앱 이동) → 선택지(브라우저):
    1. 다시 시도 (→ --ensure-env 재호출) 2. 다른 브라우저로 변경 (→ 아래 감지 분기) 3. 취소. 이때만 묻는다 — 저장값이 있으면 자동기동이 기본이며 매번 새로 묻지 않는다.
  • saved_browser=none (최초 1회 — 아직 기본 미설정) → 아래 감지 분기로 한 번 묻고 --launch-browser "<이름>"로 띄운다(선택 자동 저장 → 다음 실행부터 무질문 자동기동).

  사용자에게 물어 직접 띄울 때는 open -a가 아니라 python3 "$PLUGIN_ROOT/bin/pack_and_ask.py" --launch-browser "<이름>" (크로스플랫폼 mac/win/linux·전용 프로필·선택 자동 저장)로 한다. 항상 전용(격리) 프로필로 실행되므로 사용자 주 브라우저 세션은 건드리지 않는다(Chrome 136+는 전용 프로필 없이는 CDP가 안 열린다). BROWSERS … 라인(설치된 크로미움 목록)으로 분기:

  • 2개 이상 감지 → 선택지(브라우저): BROWSERS의 각 브라우저를 번호로 준다. 사용자 주 브라우저로 추정되는 것(현재 실행 중일 가능성)엔 "메인 추정 — 가급적 다른 것" 주석. 선택 → --launch-browser "<이름>" → 재점검.
  • 정확히 1개 감지(그게 사용자 메인일 가능성↑) → 선택지(브라우저):
    1. 전용 브라우저 하나 설치 (추천) → 가벼운 크로미움(Chrome/Brave 등)을 자동화 전용으로 따로 설치하도록 안내 (ChatGPT Pro 로그인해두고 그 창은 안 건드림). 설치 후 --launch-browser "<이름>". (왜: 메인과 같은 앱을 2창으로 띄우면 빈 프로필·오조작·일부 앱의 멀티인스턴스 불안정으로 혼란이 생긴다.)
    2. 지금 이 브라우저의 격리 프로필로 진행 → --launch-browser "<그 이름>". 전용 프로필이라 메인과 분리되지만, 같은 앱 2창이라 자동화 창은 실수로 건드리지 말 것을 한 줄 고지.
    3. 취소
  • 0개 감지 → 선택지(브라우저): "크로미움 계열 브라우저가 없습니다 — 설치할까요?" → 1. Chrome 설치 안내 2. 취소

• browser=wrong(포트 점유) → 선택지(포트충돌): "9222를 다른 프로세스가 쓰고 있어요. 종료하고 전용 브라우저를 다시 띄울까요?" → 1. 다시 띄우기(점유 프로세스 종료 안내 후 --launch-browser) 2. 취소

• launch_mode=unset(최초 1회) → 선택지(실행 방식)로 한 번 물어 --set-launch-mode <값>으로 저장한다(이후 재질문 없음):

  1. background (권장·기본) — 창을 숨긴 채 실행, 포커스를 안 뺏어 작업 흐름이 안 끊긴다
  2. foreground — 창이 뜨고 앞으로 나온다. 진행 상황을 눈으로 보고 싶을 때만
  3. headless — 권장 안 함(아래 참고)

  사용자가 답을 안 주거나 넘기면 background로 진행한다(미설정 기본값도 background라 그대로 동작). 값이 이미 있으면 묻지 말 것. 나중에 바꾸려면 --set-launch-mode <값>(env INSANE_REVIEW_LAUNCH_MODE가 config보다 우선). 세 모드의 실측(2026-08-26, macOS):

  • background (기본): open -g로 띄우고, playwright가 새 탭을 만들 때 앱이 앞으로 나오므로 탭 생성 직후 다시 숨긴다. ChatGPT는 정상 브라우저로 인식 → 왕복 성공.
  • foreground: 왕복은 되지만 하던 일이 끊긴다.
  • headless(--headless=new): 창이 아예 없다. 하지만 ChatGPT가 컴포저를 안 내줘 전송이 실패한다(쿠키가 유효해도 ChatGPT 컴포저 미확인으로 재시도 소진 — CF 챌린지 추정). 굳이 쓰려면 --check-env로 login=ok를 확인하고, 실패하면 즉시 background로 되돌릴 것.

• login=no (로그인 벽이 실제로 확인된 경우에만 나온다) → 선택지(로그인): "방금 띄운 전용 브라우저 창에서 chatgpt.com 로그인 + Pro 추론(최신 플래그십 모델) 선택을 끝낸 뒤 계속하세요. (전용 프로필이라 이 로그인은 계속 유지됩니다.)"

  1. 로그인 완료 — 계속 → --ensure-env 재확인
  2. 취소

  로그인은 자동 불가 → 반드시 사용자에게 요청(에러로 끝내지 말 것). background 모드면 창이 숨어 있으니 사용자가 창을 못 찾으면 --set-launch-mode foreground로 잠시 바꿔 띄워 준다.

• login=unknown (컴포저·로그인 벽 모두 미확인 — 로딩 지연/CF 챌린지 가능. 로그인을 요구하지 말 것):

  • cookie=ok면 세션은 살아있는 것 → --ensure-env를 1~2회 재실행해 재점검. 계속 unknown이면 사용자에게 "전용 브라우저 창에 챌린지/오류 화면이 떠 있는지 확인" 요청 (재로그인 아님).
  • cookie=missing|expired면 그때만 위 login=no 분기와 동일하게 로그인 안내.

• mode=work → ChatGPT의 Chat/Work 토글이 Work에 놓여 있다. Work 모드엔 Pro 추론단계가 아예 없다(슬라이더에 Pro 눈금 부재). 본 실행 시 스크립트가 모델 스위처를 열기 전에 ensure_chat_mode()로 Chat으로 자동 전환하고, 전환에 실패하면 --model pro 전송을 fail-closed로 중단한다. 자동 전환이 반복 실패하면 사용자에게 전용 창에서 토글을 Chat으로 바꿔 달라고 한 줄 요청한다. (mode=chat·mode=unknown은 통과 — 토글이 없는 구 UI/개인 계정은 애초에 분기가 없다.)

• node=missing → 선택지(Node): "Node.js가 필요합니다(repomix 자동설치에 사용). 설치를 도와드릴까요?" → 1. brew로 설치(brew install node) 2. 직접 설치할게요 3. 취소

STATUS … login=ok까지 가면 Step 1로. 사용자가 "취소"하면 멈추고 무엇이 남았는지 한 줄로 알려준다.

• 모델 Pro 티어: 스크립트 --model pro가 추론단계 Pro를 자동선택·검증한다. Pro 티어는 플래그십 모델에만 존재하므로, 모델명을 못박지 않아도 "현 최신 플래그십 + 최대 추론"이 보장된다(GPT 버전이 올라가도 자동 추종). 안 되면 사용자가 1회 수동 설정하면 새 채팅이 상속. 특정 모델명으로 고정하려면 --require-model "<이름>"을 추가(부분 일치; 플래그십이 바뀌면 fail-closed로 전 실행이 차단되니 갱신 필수 — 자동 추종을 원하면 빼라).

핵심 절차 (검토/수정/리뷰 요청을 받았을 때)

1) 의도 파악

사용자의 요청(또는 직전 대화 맥락)에서 GPT Pro에게 물을 핵심 질문을 한 문장으로 정한다. (버그 원인? 설계 리뷰? 리팩터 방향? 특정 함수 검증?) 타겟/범위가 애매하면 §A 번호 선택지를 줘서 고르게 한다(타이핑 요구 금지). 예) 리뷰 대상: 후보 디렉토리들 + "프로젝트 전체" + "질문만(코드 없이)".

2) 타겟 선별 — 완전한 관련 집합을 네가(Codex) 판단 (사용자가 누락을 잡아주는 구조면 안 된다)

"repomix로 무엇을 넣을지 = 무엇이 완전한 관련 집합인지", "repomix만으로 충분한지 vs 관련 파일을 다 넣어야 하는지"의 판단은 네 책임이다. 기본은 "넓게, 빠짐없이":

• 단일 모듈/플러그인/기능 리뷰면 그 디렉토리를 통째로 넣어라(--target <dir>, --include 생략 또는 광범위). 코드 한 파일만 넣으면 실행지시서·설정·통합 맥락이 빠진다(실측: bin/**만 넣어 3파일 → README/SKILL/config 누락).
• 더 넓은 범위면 지목 파일에서 import/require·호출자·피호출자(grep/LSP)·테스트·타입·설정까지 추적해 집합을 닫는다.
• 패킹 후 📦 패킹 포함 N개 파일 감사 목록이 네가 의도한 완전한 집합을 담았는지 직접 확인한다(§3.5). 사용자가 지적하기 전에 네가 잡아라.
• 결과를 글롭(→ --include "src/auth/**,*.test.ts")으로 만든다.
• 코드 리뷰/원인분석은 풀 코드로 보내라 — --compress 쓰지 마라. 압축은 함수 본문(조건·early return·예외·루프 = 버그 판단 근거)을 제거해 리뷰 AI가 구현을 상상하게 만든다(실측: 본문 58% 손실 → false-positive·fail-open 폭증). 멀티 AI 합의로 확정.
• 타겟이 너무 커서 컨텍스트를 넘기면 압축하지 말고 --include로 관련 파일만 좁혀 풀로 보낸다. --compress는 오직 "큰 레포 개요"(정확성 리뷰 아님)용.

3) 패킹 + 투입 + 회수 — 스크립트 실행

python3 "$PLUGIN_ROOT/bin/pack_and_ask.py" \
  --target <repo_root> --include "<관련 파일 글롭 또는 생략=전체>" \
  --model pro \
  --prompt "<의도를 담은 정확한 질문 — '판정마다 파일/라인/코드조각을 인용하라'를 반드시 포함>"

• 응답이 오래 걸려도 되면 그대로(완전추론; --model pro 검증 시 최대 대기가 자동 3600s로 상향). 시간을 bound하고 싶으면 --force-answer-after <초>로 "거기까지 추론한 내용으로" 답을 받는다. 단독 리뷰는 보통 끄고(완전추론), council은 켜서 cap.

레포 없이 순수 질문(의견)만: --target 생략 → 프롬프트만 전송.

python3 "$PLUGIN_ROOT/bin/pack_and_ask.py" --model pro --force-answer-after 90 \
  --prompt "<질문>"

3.5) 누락 검증 — 빠진 파일 없는지 감사

패킹 직후 출력의 📦 패킹 포함 N개 파일: ... 목록이 의도한 관련 파일을 전부 담았는지 확인한다. 빠진 게 있으면 repomix가 떨어뜨린 것 — 원인별 대응:

• 🔒 secretlint: 의심 파일 N개 제외 → 시크릿 든 파일이 통째 빠짐(숨은 누락). 그 파일이 리뷰 대상이면 시크릿을 가린 사본을 따로 넣거나 --no-security-check(외부 유출 주의).
• 기본 ignore/.gitignore가 떨어뜨림 → --no-default-patterns/--no-gitignore.
• 서브모듈 파일이 빠짐(부모서 패킹) → 서브모듈 안에서 --target.
• ⚠️ pack이 큼(truncation) 경고 → ChatGPT가 잘라먹을 수 있으니 --include로 더 좁히거나 여러 번 나눠 보낸다.
• 손실 플래그 금지: --compress/--remove-comments/--remove-empty-lines는 내용을 누락시키니 리뷰엔 쓰지 않는다. 라인번호는 기본 ON(인용용).