EGM 사용법: 설계는 코끼리가, 검토는 금붕어가

핵심 요약
대화를 모르는 새 AI가 설계 문서를 읽고 빈틈을 짚는 EGM. 설치는 두 줄, 검토자 8명은 읽기 전용이다. 저장소 283개 파일을 읽어 확인했고 실행은 안 했다.
AI에게 새 기능의 설계를 시켜 놓고 “이 설계 괜찮아?“라고 같은 대화에서 물으면, 대개 괜찮다는 답이 돌아온다. 설계를 쓴 쪽이 이미 모든 배경을 알고 있기 때문이다. 문서에 적히지 않은 전제, 정의 없이 쓴 말, 한 번도 설명하지 않은 규칙은 쓴 쪽의 눈에는 빈칸으로 보이지 않는다. 사람 사이에서도 같은 일이 생긴다. 자기가 쓴 글의 오타는 자기 눈에만 안 보인다.
EGM(Elephant-Goldfish Model) 은 이 문제를 구조로 푸는 플러그인이다. 프로젝트 맥락을 다 아는 에이전트(코끼리)가 설계 초안을 쓰고, 그 대화를 전혀 모르는 새 에이전트들(금붕어)이 문서만 읽고 빈틈을 찾는다. 이 글은 Claude Code로 코딩을 시작했지만 “설계 문서를 먼저 쓰고 검토받는 흐름”은 써 본 적 없는 사람을 위해 썼다.
결론부터 적는다. 설치는 명령 두 줄이다. 저장소를 읽어 보니 Claude Code 쪽에는 훅(hook) 파일이 없고, 검토를 맡은 에이전트 8개는 파일을 읽고 찾는 도구만 쓴다. 다만 저장소 README가 스스로 “공식 지원 제품은 아니다” 라고 밝히는 구글 조직의 오픈소스이고, 이 글은 플러그인을 설치하거나 실행해 보지 않았다. 저장소를 빈 폴더에 내려받아 파일과 문서를 읽고, 문서가 한 말과 설정 파일이 맞는지 대조했다. 이 구분은 글 끝까지 유지한다.
먼저 말 몇 개를 풀어 둔다. 플러그인은 코딩 에이전트에 붙여 쓰는 확장 묶음이고, 스킬은 그 안에서 에이전트가 읽는 사용 설명서 파일(SKILL.md)이다. 서브에이전트는 메인 에이전트가 일을 나눠 맡기려고 새로 띄우는 보조 에이전트다. 새로 띄우면 이전 대화를 모른 채 시작한다는 점이 이 글의 핵심이다. 훅은 에이전트가 세션을 열거나 도구를 쓸 때마다 자동으로 코드를 실행하게 만드는 장치라서 악성 확장이 숨기 좋은 자리로 꼽힌다. 설계 문서(스펙) 는 코드를 쓰기 전에 “무엇을 어떻게 만들 것인가”를 적어 두는 글이다.
숫자 한 장: 별 19,933개, 포크 1,482개, 아파치 2.0
| 항목 | 내용 |
|---|---|
| 이름·저장소 | Elephant-Goldfish Model, google/elephant-goldfish-model (GitHub의 google 조직) |
| 라이선스 | Apache-2.0 |
| 버전 | v0.1.1 (2026년 11월 6일 릴리스). 첫 릴리스 v0.1.0은 10월 27일 |
| 저장소 생성 | 2026년 9월 13일. 마지막 커밋은 11월 15일 |
| GitHub | 별 19,933개, 포크 1,482개, 열린 이슈 114개 (11월 16일 오후 API로 확인) |
| 이번 주 증가 | GitHub 주간 트렌딩 목록에서 “이번 주 별 5,060개”로 표시 (11월 16일 확인) |
| 요구 사양 | Claude Code 2.1.271 이상 (검토자가 CLAUDE.md를 읽지 않게 하는 omitClaudeMd 설정 때문) |
| 지원 환경 | Claude Code, Codex, Antigravity CLI, Claude Cowork, ChatGPT Work 등 |
| 내가 한 것 | 저장소 내려받아 파일 283개 중 플러그인 정의·에이전트·스킬·문서 읽기. 설치·실행은 안 함 |
별이 이만 개에 가깝다는 것은 관심이 크다는 신호이지 품질 보증이 아니다. 저장소가 생긴 지 두 달이 안 됐고 버전도 0.1.1이라, 명령과 동작이 바뀔 수 있다고 읽는 편이 안전하다. 별 숫자는 그날의 스냅숏이다.
코끼리와 금붕어: 쓰는 쪽은 배경을 알고, 읽는 쪽은 모른다
README 맨 위 문장이 구조를 요약한다. “Design with an elephant. Review with a goldfish.” 코끼리는 기억이 좋다는 속설에서, 금붕어는 기억이 짧다는 속설에서 따온 비유다. 세 역할의 분담은 README 표에 이렇게 적혀 있다.
- 코끼리(Elephant): 내 프로젝트, 요구 사항, 이전 결정을 아는 에이전트. 문제를 탐색하고 설계 초안을 쓴다.
- 금붕어(Goldfish): 문서와 문서가 참조하는 소스만 본다. 이전 대화는 보지 못한다. 빠진 가정, 불분명한 요구, 구현 위험을 찾는다.
- 나(You): 목표와 제약을 아는 사람. 트레이드오프를 정하고, 설계를 승인하고, 무엇을 만들지 결정한다.
공식 사이트(egm.dev)의 예시가 가장 쉽게 이해된다. 자습 공간 개관 계획이라는 짧은 글이다. “3월 3일에 연다. 자원봉사자가 운영 시간에 데스크를 본다. 학생은 늘 쓰던 양식으로 방을 예약한다. 우리는 금요일 규칙을 유지한다.” 글을 쓴 사람에게는 모든 문장이 분명하다. 그런데 대화를 모르는 검토자는 세 가지를 묻는다. 데스크는 누가 보는가(계획에 사람도 당번표도 없다), 언제 여는가(운영 시간이라고만 하고 시간이 없다), 금요일 규칙이 무엇인가(독자가 볼 수 없는 결정에 기대고 있다). 코드 설계 문서도 똑같다. 쓴 사람의 머릿속에만 있는 결정이 문서에 빠져 있으면, 구현을 맡는 에이전트도 그 빈칸을 제멋대로 채운다.
그래서 이 도구가 지키는 핵심 규칙이 하나 있다. README는 “금붕어 검토에는 새 서브에이전트 맥락이 필요하다. 에이전트가 만들 수 없으면 EGM은 검토를 멈춘다”고 적는다. 스킬 파일에는 한 줄이 더 있다. 서브에이전트를 못 쓰는 환경이라면 사용자에게 알리고 멈출 것, 같은 맥락 안에서 하는 검토는 금붕어 검토가 아니라는 것이다. 검토 흉내를 내서 안심시키는 일을 규칙으로 막아 둔 셈이다.
스킬 일곱 개: 처음 쓸 것은 검토 하나
README의 “Choose a skill” 표에는 일곱 개가 있다. 순서대로 쓸 필요는 없고, 지금 막힌 곳에 맞는 것을 하나만 골라도 된다고 문서가 직접 말한다.
| 스킬 | 하는 일 (README 설명을 옮김) | 남기는 파일 |
|---|---|---|
egm-brainstorm |
아이디어를 시험하고 개념 요약서를 쓴다 | concepts_brief.md |
egm-draft |
요약서나 메모를 설계 문서로 바꾼다. 절마다 멈추고 내 의견을 받는다 | design_draft.md |
egm-review |
새 에이전트들이 다섯 단계로 설계를 검토한다 | 단계별 검토 보고서 |
egm-resolve |
검토에서 나온 지적을 하나씩 짚으며 어떻게 고칠지 합의한다 | 고친 문서 |
egm-review-loop |
정해 둔 검토자 묶음으로 특정 문서를 검토한다 (설계 문서 말고 다른 글도) | 보고서 |
egm-drift-report |
저장소에 있는 문서와 현재 소스 코드를 비교한다 | 차이 보고서 |
egm-bootstrap |
기존 코드베이스의 폴더마다 README.md를 만들거나 고친다 |
폴더별 README |
일곱 스킬 모두 머리말에 disable-model-invocation: true가 있다. 에이전트가 알아서 이 스킬을 불러 쓰지 않고, 내가 /egm:egm-review ...처럼 직접 불러야 돈다는 뜻이다. 쓰지 않을 때는 존재감이 없고, 쓸 때는 내가 분명히 시작한다.
또 하나 눈에 띄는 규칙은 결과물을 대화창에 길게 붙여 넣지 않고 파일로 쓴다는 것이다. 스킬 파일의 “Artifact-First Delivery”에 따르면 개념 요약, 초안, 검토 보고서는 작업 폴더의 파일로 쓰고 채팅에는 경로만 알린다. 검토 결과가 스크롤 속에 묻히지 않고, 나중에 다시 열어 볼 수 있다.
검토는 다섯 단계로 돈다
egm-review 스킬이 설명하는 단계는 번호가 5부터 9까지다(앞쪽 번호는 다른 스킬의 몫이다). 이름은 다음과 같다.
- 5단계 Initial Zoom Out Review — 한 발 물러서서 설계가 너무 복잡하지 않은지 본다. 결과는
zoom_out_report.md에 쓴다. - 6단계 Comprehension Test — 배경 지식이 없는 독자로서 정의 없이 쓴 용어와 약어를 찾는다.
- 7단계 Critic Review — 구조, 확장성, 비용, 막지 못한 위험을 비판한다.
- 8단계 Intermediate Zoom Out Review — 고친 뒤 다시 한 발 물러서서 본다. 결과는
intermediate_zoom_out_report.md에 쓴다. - 9단계 Implementation Readiness Test — 구현 계획이 모호하지 않아서 구현자가 설계 결정을 떠안지 않아도 되는지 본다.
시작하면 모드를 고르라는 질문이 나온다. 스킬 파일에 적힌 선택지는 네 개다. 단계마다 멈춰서 확인하는 대화식 전체 검토, 멈추지 않고 끝까지 돌려 consolidated_review_report.md 한 장으로 합치는 통합 보고서, 구현 계획은 빼고 5~8단계만 도는 기능 명세만, 9단계만 도는 구현 계획만이다. 처음에는 기능 명세만 고르는 쪽이 부담이 적을 것이다. 다섯 단계는 순서가 있어서 병렬로 돌리지 않고, 한 단계 안의 검토자들만 동시에 돈다고 문서가 못 박는다.
문서가 미리 경고하는 점도 적어 둔다. getting started 문서는 이 검토가 “의도적으로 지적이 아주 많이 나온다”며 “맞다고 생각하는 것만 받고 나머지는 무시하라”고 적는다. 스킬 파일의 실행 규칙에는 “기본값은 반박하는 것”, “칭찬 먼저 하지 말고 틀렸거나 빠진 것부터 말할 것”, “훌륭하다·완벽하다 같은 칭찬 금지”가 들어 있다. 맞장구를 잘 치는 AI에게 질린 사람에게는 반가운 규칙이고, 지적이 쏟아지는 것이 부담스러운 사람에게는 알아 두어야 할 성격이다.
검토자 여덟 명은 어떤 성격인가
Claude Code용 정의 파일(.claude-plugin/agents/)에는 검토자 8명이 있다. 각 파일 머리말의 설명을 옮긴다.
- Zoom Out — 높은 곳에서 단순함과 최소주의(YAGNI, 당장 필요 없는 것은 만들지 않기), 기존 코드 재사용을 따지는 회의적인 설계자
- Comprehension — 조직 내부 지식이 없다고 가정하고 읽는 순진한 독자. 정의 없는 용어와 약어를 짚는다
- Design Critic — 시스템 구조, 확장성, 인프라 비용, 대비하지 않은 위험에 집중하는 적대적 비평가
- Implementation Readiness — 구현 계획이 그대로 실행 가능한 지시인지 보는 실용적인 테크 리드
- Structural — 소제목 계층, 서식, 템플릿 준수를 보는 구조 검증자
- Style — 명확성, 간결함, 군더더기 제거를 보는 교정자
- Codebase Details — 문서가 실제 코드와 정확히 맞는지, 이미 있는 라이브러리를 놔두고 새로 만들려는 건 아닌지 따지는 깐깐한 감사자
- Inventive Catalyst — TRIZ(발명적 문제 해결 이론) 원리로 시스템 안의 모순을 찾는 발상 담당
여기에 검토자들이 낸 지적을 합쳐 중복을 줄이고 보고서로 묶는 Synthesizer(종합자) 가 있고, 기존 코드베이스에 폴더별 README를 만드는 Bootstrap Orchestrator가 따로 있다. 단계별로 어느 검토자가 도는지는 스킬 파일에 길게 적혀 있는데, 이 글은 그 대응표까지는 옮기지 않았다.
설치 두 줄과 첫 명령
Claude Code에서는 터미널에 아래 두 줄을 차례로 입력한다. README와 docs/claude.md, 공식 사이트에 같은 명령이 적혀 있다(사이트는 &&로 한 줄에 이은 형태다).
claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm
첫 줄은 이 저장소를 플러그인 목록(마켓플레이스)으로 등록하는 명령이고, 둘째 줄이 그 목록에서 egm을 설치하는 명령이다. 설치 뒤 새 세션을 열어야 한다. 문서는 Claude Code 2.1.271 이상을 요구한다. 더 오래된 버전은 검토자가 프로젝트의 CLAUDE.md를 읽지 않게 하는 설정을 지원하지 않아서, 금붕어 격리가 검증되지 않은 환경으로 취급해야 한다고 적는다. Codex CLI는 codex plugin marketplace add google/elephant-goldfish-model과 codex plugin add egm@egm을 쓰고, Antigravity CLI는 agy plugin install https://github.com/google/elephant-goldfish-model 한 줄이다.
명령 앞에는 /egm: 접두사를 붙인다. Claude Code에서 첫 설계를 해 보는 순서는 README가 이렇게 안내한다.
/egm:egm-brainstorm 이 프로젝트에 웹훅 전송을 추가하고 싶다— 요구와 트레이드오프를 대화하고, 합의한 방향이concepts_brief.md로 저장된다./egm:egm-draft— 요약서를design_draft.md로 바꾼다. 절마다 멈추고 채팅으로 의견을 받는다./egm:egm-review design_draft.md— 새 검토자들이 설계, 명확성, 코드와의 정합성, 구현 계획을 본다. 어떤 지적을 반영할지는 내가 고른다.
이미 설계 문서가 있다면 README의 “60초 검토”가 더 빠르다. /egm:egm-review docs/designs/webhooks.md처럼 문서 경로만 붙이면 된다. 새 명세를 쓰지 않아도 되고, README나 PR 계획서를 살아 있는 코드와 대조해 검토할 수 있다고 문서가 설명한다. 폴더 전체의 문서와 코드가 어긋난 곳을 찾으려면 /egm:egm-drift-report docs/designs/를 쓴다. getting started 문서는 이 차이 점검을 주 1회 하라고 권한다.
Windows에서 쓰는 사람이 알아 둘 점이 하나 있다. 검토자의 성격 정의와 문서 기준은 플러그인 설치 폴더(.claude/plugins/cache/...)에 있어서, 프로젝트 밖의 파일 읽기가 된다. 평소에는 Claude Code의 권한 확인창이 뜨는 대로 승인하면 된다. 화면 없이 도는 환경에서는 그 폴더 읽기 규칙을 미리 적어 두어야 하는데, 문서는 Windows 경로를 //c/Users/...처럼 쓰거나 C:\Users\... 원래 형식으로 쓰라고 하며, //C:/Users/... 형태는 적용되지 않는다고 못 박는다.
저장소를 열어서 직접 확인한 것
문서는 “격리되어 있고 읽기 전용”이라고 말한다. 그 말이 설정 파일과 맞는지 확인하려고 저장소(커밋 72d06f5, 2026년 11월 15일)를 빈 폴더에 내려받았다. 파일은 283개였다. 아래는 읽기만 한 결과이고, 어떤 파일도 실행하지 않았다.
Claude Code 쪽 플러그인 파일에 스크립트가 없었다. 스킬(skills/), 에이전트(agents/, .claude-plugin/), 기준 문서(resources/) 폴더의 파일을 확장자별로 세어 보니 마크다운 43개, YAML 14개, JSON 3개, SVG 7개, PNG 1개였다. 실행 파일 형식(.sh, .js, .py)은 하나도 없었다. 파이썬·자바스크립트 파일은 사이트 제작(site/), 배포 준비(scripts/), 테스트(tests/), OpenCode용 설치 보조(adapters/opencode/install.py)에만 있다. 플러그인이 하는 일의 대부분이 “에이전트가 읽을 지시문”이라는 뜻이다.
훅은 없었다. 플러그인 정의(.claude-plugin/plugin.json)에는 이름, 버전, 작성자 Google, 라이선스, 에이전트 열 개의 경로만 있고 훅 항목이 없다. hooks나 PreToolUse, SessionStart 같은 글자를 스킬·에이전트·플러그인 정의 파일에서 검색했지만 나오지 않았다. 문서도 “EGM은 권한 승인 훅을 설치하지 않는다”고 적는다. 권한 확인은 Claude Code의 평소 확인창을 따른다.
검토자 8명의 도구는 읽기·검색뿐이다. 에이전트 정의 열 개의 tools: 줄을 모두 열었다. 검토자 여덟 명은 전부 [Read, Grep, Glob]이다. 파일 읽기, 글자 검색, 파일 이름 찾기만 하고 수정이나 셸 명령은 못 한다는 뜻이고, docs/claude.md가 그렇게 설명한다. 종합자는 [Agent, Read, Grep, Glob, Write]로 보고서를 쓸 수 있지만 셸과 MCP 연결은 못 쓴다. 다만 같은 문서는 한계를 하나 인정한다. 플러그인 서브에이전트의 tools 항목으로는 쓰기 경로를 제한할 수 없어서, “요청받은 보고서만 쓴다”는 규칙은 지시문일 뿐 호스트가 강제하는 한계가 아니라고 한다. 쓰기는 평소처럼 세션의 권한 규칙을 따른다.
예외가 하나 있다: 부트스트랩 에이전트. bootstrap_orchestrator만 [Agent, Bash, Read, Grep, Glob, Write, Edit]을 가진다. 폴더별 README를 쓰고 고치는 기능이라 셸과 편집이 필요하다. 정의 파일은 “셸 명령은 사용자의 평소 권한 규칙을 따르고, MCP와 웹 도구는 켜지 않으며, Bash는 파일이나 네트워크를 가두는 샌드박스가 아니다“라고 직접 적는다. 이 스킬을 쓸 때는 권한 확인창을 꼼꼼히 읽어야 한다.
스킬 일곱 개는 수동 호출 전용이다. 일곱 개 모두 disable-model-invocation: true다. 에이전트가 맥락에서 슬쩍 불러 쓰지 않는다. 문서는 Claude Code의 Skill 도구가 이 스킬을 거부하는 것이 정상이며, 한 스킬이 다른 스킬을 쓸 때는 그 SKILL.md를 읽고 같은 흐름에서 따라 하라고 안내한다.
스킬과 에이전트 파일에서 curl, wget, npm install, pip install, 웹 검색 도구 호출을 검색했지만 나오지 않았다. 다만 이 검색은 글자 일치이므로, 에이전트가 허가된 도구로 스스로 무엇을 할지까지 보증하지는 않는다.
내 파일은 어디로 가나
검토자는 문서와 그 문서가 참조하는 소스를 읽는다. 스킬 파일에 따르면 작업 폴더 안에서 링크된 파일은 자동으로 검토 맥락에 들어가고, 그 밖의 링크와 URL은 승인을 받는다. 결과물 파일은 작업 폴더에 쓰고, 사용자가 EGM artifact directory: <경로> 한 줄을 프롬프트나 CLAUDE.md에 적으면 그 폴더에 쓴다. 그 경로가 작업 폴더 밖이면 폴더를 만들기 전에 확인을 받으라고 문서가 정해 두었다.
여기서 이 글이 확인한 사실과 확인하지 못한 사실을 가른다. 확인한 것: 플러그인 파일에 따로 외부로 보내는 코드가 없다. 확인하지 못한 것: 검토자가 읽은 내용은 내가 쓰는 Claude 세션의 모델에 전달된다. 플러그인이 아니라 에이전트가 원래 하는 일이다. 회사 코드나 비밀값이 든 .env, 고객 데이터를 검토 맥락에 넣어도 되는지는 이 플러그인이 아니라 내 회사의 에이전트 사용 규칙이 정한다.
공식 지원 제품은 아니다: 문서가 스스로 밝힌 한계
README 마지막 줄은 “Apache 2.0. 이것은 구글이 공식 지원하는 제품이 아니다”이다. 구글 조직의 저장소라는 사실과 구글의 지원을 받는다는 말은 다르다. 질문과 버그는 GitHub 이슈로 받는다.
문서에서 읽은 한계를 정리한다.
- 검토가 테스트와 사람의 판단을 대신하지 않는다. README가 직접 쓴 문장이다. 설계 검토는 구현 전에 빈틈을 줄이는 도구이고, 결과가 맞는지는 테스트와 사람이 정한다.
- 서브에이전트를 못 만드는 환경에서는 검토를 못 한다. 브레인스토밍과 검토가 해당된다. Antigravity 독립 IDE는 현재 지원하지 않는다고
docs/harnesses.md가 적는다. - 환경마다 검증 수준이 다르다. 문서에 따르면 Claude Code, Codex, Antigravity CLI는 설치와 종단 흐름 시험을 통과했다. Claude Cowork와 ChatGPT Work는 설치 경로는 있지만 클라우드 추적 검증이 열려 있다.
- 검토자 격리 증거가 좁다. 문서는 Codex CLI 0.166.0이
fork_turns: "none"설정에도 프로젝트와 사용자AGENTS.md를 검토자에게 넘겼다는 이슈(#237)를 인용하고, Antigravity CLI도 같은 보고가 있다고 적는다. 이것은 “이전 대화가 샜다”는 증거가 아니라 “지침 파일이 샜다”는 보고다. Claude 쪽은omitClaudeMd: true로 이 문제를 막으려 한다. - 열린 이슈가 114개다. 인기 있는 초기 버전의 정상적인 모습이기도 하지만, 같은 이유로 동작이 자주 바뀐다는 신호이기도 하다.
처음 30분은 이렇게 써 보자
- 작은 문서 하나를 고른다. 이미 쓴 짧은 설계 문서나 PR 계획서가 좋다. 회사 기밀이 없는 개인 프로젝트에서 시작한다.
- 버전부터 본다.
claude --version으로 2.1.271 이상인지 확인한다. - 두 줄을 설치하고 새 세션을 연다. 설치 중 나오는 에이전트 폴더 무시 경고는 문서가 “예상된 것이고 해롭지 않다”고 설명한다.
/egm:egm-review 문서경로를 실행하고 모드는 “기능 명세만”을 고른다. 구현 계획 검토를 빼면 지적이 줄어든다.- 권한 확인창을 읽는다. 플러그인 폴더의
agents/,docs/,resources/,skills/읽기를 묻는 것은 정상이다. 그 밖의 경로를 묻거나 쓰기를 요구하면 이유를 확인한다. - 보고서 파일을 연다. 지적이 많이 나온다. 맞다고 생각하는 두세 개만 반영하고 나머지는 무시해도 된다고 문서가 권한다.
- 반영한 뒤 다시 한 번 돌려 본다. 같은 문서를 새 금붕어에게 보여 주면 이전에 지적한 곳이 해결됐는지 새 눈으로 확인할 수 있다.
시험이 만족스러우면 같은 설계 문서를 두고 구현을 에이전트에게 맡기는 흐름으로 넘어간다. README의 순서가 그렇다. 승인한 설계를 docs/designs/에 저장해 두고, 구현이 끝난 뒤에는 차이 점검으로 문서와 코드가 어긋나지 않았는지 주 1회 본다.
이 흐름과 비슷한 도구를 이 블로그에서 이미 다룬 적이 있다. 앱 구조를 지도로 보여 주는 Floorplan은 코드를 읽고 설명하는 쪽이고, EGM은 사람이 쓴 설계를 비판하는 쪽이다. 브라우저를 직접 열어 화면을 눌러 보는 Playwright CLI와 함께 쓰면 “설계를 검토받고, 구현하고, 눌러서 확인하는” 순서가 이어진다.
맞지 않는 경우
- 작은 버그 하나를 고칠 때. getting started 문서도 한 번에 끝낼 수 있는 단순한 수정에서는 억지로 설계부터 하지 말라고 적는다.
- 서브에이전트가 없는 환경. 금붕어를 만들 수 없으면 도구가 멈춘다. 쓰는 에이전트가 새 서브에이전트를 지원하는지 먼저 본다.
- 검토 맥락에 넣을 수 없는 코드. 검토자가 읽은 내용은 에이전트의 모델 서비스로 간다. 외부 전송이 금지된 코드라면 쓰지 않는다.
- 확장 설치 자체가 불안할 때. 지난달 Claude Code 확장 마켓플레이스 백도어 사례처럼 확장은 설치만으로도 위험이 될 수 있다. 훅이 없는 구조는 그 위험을 줄이는 설계이지 0으로 만드는 보증이 아니다. 스킬 형식이 표준으로 자리 잡는 흐름은 에이전트 스킬 표준 재단 이관 소식에서 정리했다.
- 검토가 곧 승인인 줄 아는 조직. 문서도 사람의 검토를 대체하지 않는다고 적는다.
읽기만 했고 확인하지 못한 것
- 설치도 실행도 안 했다. 검토가 얼마나 걸리는지, 지적이 몇 개 나오는지, 요금제 사용량을 얼마나 쓰는지는 모른다. 검토자 여러 명을 새로 띄우는 구조라는 것만 문서로 확인했다.
- 지적의 질. 다섯 단계가 실제로 쓸모 있는 지적을 내는지, 비슷한 도구를 쓸 때보다 나은지 비교하지 못했다.
- 격리의 실제 동작.
omitClaudeMd가 검토자에게 지침 파일을 정말 가리는지, 종합자가 보고서만 쓰는지는 문서와 정의 파일로만 읽었다. - 설계 방식의 근거 에세이. 문서가 개념의 출처로 연결한 Dave Rensin의 Medium 글은 읽지 않았다.
- 테스트 통과 여부. 저장소의
TESTING.md에 하네스별 시험 기록이 있다고 문서가 말하지만, 시험을 돌려 보지 않았다. - 별 19,933개의 질. 별과 포크는 관심의 숫자다. 독립 후기나 비교 평가는 찾지 못했다.
그래도 판단은 단순하다. 이 도구가 실행하는 코드는 거의 없고, 검토자는 읽기 전용이며, 구글 조직의 오픈소스이지만 공식 지원은 아니라고 스스로 밝힌다. 그러니 기본 태도는 “작은 개인 프로젝트의 설계 문서 하나로 시험해 보기”가 맞다. 검토자 8명이 같은 문서를 서로 다른 성격으로 읽는다는 발상이 마음에 들면 두 줄을 깔아 보고, 마음에 안 들면 claude plugin uninstall egm@egm으로 지우면 된다(삭제 명령은 Claude Code의 일반 플러그인 관리 명령이고, 이 저장소 문서에서 확인한 것은 아니다).
읽은 페이지 목록
모두 2026년 11월 16일에 열어 본 페이지다.
- google/elephant-goldfish-model 저장소와 README: 설치 명령, 스킬 표, 역할 표, 라이선스, 별·포크·이슈 수, 공식 지원 제품이 아니라는 문장
- docs/claude.md: Claude Code 2.1.271 요구, 검토자 격리와 도구 목록, 쓰기 경로 한계, 권한 규칙과 Windows 경로
- docs/harnesses.md: 환경별 지원 수준, 검토자 격리 증거의 범위, 이슈 #237
- docs/getting_started.md: 핵심 순서, 검토 분량 경고, 차이 점검 권장 주기, 부트스트랩 설명
- egm-review SKILL.md: 다섯 단계 이름, 모드 네 개, 파일로 쓰는 규칙, 반박 우선 규칙
- 검토자 정의 예시 design_critic.md:
tools: [Read, Grep, Glob] - EGM 공식 사이트: 설명, 자습 공간 개관 계획 예시, 설치 안내
- GitHub 주간 트렌딩: “이번 주 별” 숫자 (시시각각 바뀌는 페이지라 확인 시각의 값이다)