AI 코딩 도구에 기능 하나를 맡기고, 다음 날 새 세션을 열어 이어서 시킵니다. 그런데 어제 정한 규칙을 오늘의 AI는 모르고, 그럴듯하지만 엉뚱한 코드를 또 써 내죠. Elephant-Goldfish Model(EGM)은 구글 엔지니어들이 2026년 10월 22일 공개한 Apache 2.0 오픈소스 플러그인으로, AI가 코드를 짜기 전에 설계서를 먼저 쓰게 하고, 앞선 대화를 모르는 AI 검토자가 그 설계서만 읽고 빈틈을 찾게 해 줘요. 클로드 코드, 코덱스, 구글 안티그래비티에 붙여 쓰고 이름처럼 코끼리와 금붕어가 역할을 나눠 맡아요.
코끼리가 쓰고 금붕어가 읽는다
이름이 곧 설명이에요. 코끼리는 프로젝트 맥락을 오래 기억하는 쪽입니다. 지금 대화하고 있는 코딩 에이전트가 이 역할을 맡아 설계서 초안을 써요. 금붕어는 기억이 짧은 쪽이죠. 새로 띄운 검토용 서브에이전트가 앞선 대화 없이 초안과 참조한 소스만 읽고, 글에 드러나지 않은 가정과 사각지대를 짚어 냅니다. 무엇을 포기하고 무엇을 고를지, 설계를 승인할지는 사람이 구현 전에 정해요.
왜 굳이 기억 없는 검토자일까요. 구글 오픈소스 블로그는 AI 덕에 코딩이 빨라진 만큼 엉성한 결과물과 버그, 세션이 바뀔 때 맥락이 날아가는 일도 같이 빨라졌다고 짚어요. 대화를 다 아는 AI는 설계서에 빠진 내용도 머릿속으로 채워 읽습니다. 아무것도 모르는 금붕어가 읽어도 이해되는 문서여야, 내일의 새 세션도 같은 코드를 만든다는 계산이에요. 목표는 AI가 첫 시도에서 의도한 코드를 정확히 만드는 것이라고 블로그는 적었습니다.

EGM 저장소 첫 화면. 오른쪽에 Apache-2.0 라이선스와 공식 사이트 링크가 보여요.
공식 저장소는 2026년 11월 6일 기준 별 12.4천 개, 포크 895개예요. 블로그에 따르면 구글 직원 수천 명이 매일 이 플러그인으로 실제 서비스 코드를 내보낸다고 해요. 다만 저장소에는 「구글이 공식 지원하는 제품이 아니다」라는 문장이 붙어 있습니다. 회사가 책임지는 제품이 아니라, 안에서 쓰던 방식을 공개한 것에 가깝죠. 처음 이 접근법을 내놓은 사람은 블로그 공동 저자인 Dave Rensin이에요.

브레인스토밍, 초안, 검토를 거쳐 승인한 뒤에야 구현을 맡기고, 끝나면 설계와 코드가 어긋났는지 확인하는 흐름이에요.
눈여겨볼 점은 EGM이 코드를 직접 짜지 않는다는 거예요. 공식 사이트 egm.dev의 흐름 그림을 보면 설계서를 승인한 다음 「코딩 에이전트에게 만들라고 하라」는 문장이 나와요. EGM은 설계와 검토, 구현 뒤 대조까지만 맡고 짓는 건 평소 쓰던 AI 몫입니다.
EGM은 언제 쓰면 좋을까
README의 기준은 단순해요. 구현 전에 설계 판단이 필요한 기능이면 쓰고, 작고 분명한 버그 수정이면 평소 하던 대로 하라는 것. 이지티켓은 여기에 바이브코더의 상황을 몇 가지 얹어 봤어요.
잘 맞는 경우는 이렇습니다.
- 며칠에 걸쳐 만드는 기능. 결제, 회원 등급, 예약처럼 세션을 여러 번 넘기는 작업이면 설계서가 매번 새로 여는 AI에게 넘겨줄 기억 노릇을 해요. 설계 문서는 프로젝트의
docs/designs/폴더에 쌓이고, 색인 파일도 같이 만들어집니다. - AI가 자꾸 다른 걸 만들어 올 때. 금붕어 검토의 핵심이 「맥락 없이 읽어도 구현할 수 있나」라서, 설명이 흐릿한 곳을 미리 드러내 줘요.
- 이미 굴러가는 프로젝트를 정리하고 싶을 때.
/egm-bootstrap이 기존 코드에서 문서를 만들거나 고쳐 주고,/egm-drift-report가 문서와 지금 코드가 어디서 어긋났는지 비교해 줘요.
반대로 버튼 색 하나, 오타 하나 고치는 일에 붙이면 설계서 쓰고 검토받는 시간이 고치는 시간보다 길어집니다. 시작하기 문서도 간단한 버그 수정은 이 과정을 건너뛰라고 권해요. 하루 만에 만들고 버릴 장난감 웹앱이라면 바로 시키는 쪽이 맞아요. 설계서를 다시 꺼내 볼 내일이 없거든요.
EGM 플러그인은 어떻게 쓰나요
준비물은 새 서브에이전트를 띄울 수 있는 코딩 에이전트 하나예요. 클로드 코드, 코덱스, 안티그래비티 CLI가 여기에 해당하고, 서브에이전트를 못 띄우는 환경이면 EGM은 검토 단계에서 멈춰 버려요. 별도 API 키나 GPU는 요구하지 않습니다.
설치는 README에 적힌 명령 두 줄이에요. 클로드 코드는 이렇습니다.
claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm
코덱스는 이렇게 씁니다.
codex plugin marketplace add google/elephant-goldfish-model
codex plugin add egm@egm
설치한 뒤에는 세션을 새로 열어야 명령이 잡혀요. 기능 일부만 골라 깔면 동작하지 않는다는 점도 문서에 적혀 있어요. 검토자 지침과 문서 기준을 실행 중에 읽어 오기 때문에 플러그인 전체를 깔아야 하죠.

도구별 설치 방법 표. 독립 실행형 안티그래비티 IDE는 지원하지 않는다고 적혀 있어요.
터미널 명령이 낯설면 AI에게 통째로 맡겨도 됩니다. egm.dev가 안내하는 요청 문장은 이 한 줄이에요.
Install https://github.com/google/elephant-goldfish-model
깔고 나면 흐름은 egm.dev 그림 그대로예요. 클로드 코드와 안티그래비티에서는 명령 앞에 egm: 접두어를 붙이고, 코덱스에서는 스킬 목록에서 골라요.
| 순서 | 명령 | 하는 일 |
|---|---|---|
| 1 | /egm:egm-brainstorm | 막연한 아이디어를 질문으로 다듬어 콘셉트 브리프로 정리 |
| 2 | /egm:egm-draft | 브리프를 docs/designs/ 아래 설계서로 |
| 3 | /egm:egm-review <초안 경로> | 기억 없는 검토자들이 설계서를 단계별로 검토 |
| 4 | /egm:egm-resolve | 검토에서 나온 지적을 하나씩 처리 |
| 5 | 승인 뒤 평소처럼 구현 요청 | 코딩 에이전트가 설계서대로 구현 |
| 6 | /egm:egm-drift-report | 설계서와 지금 코드가 어긋난 곳 보고 |
첫 요청은 이 정도면 충분해요. 「/egm:egm-brainstorm 으로 우리 앱에 알림 예약 기능을 넣는 아이디어를 정리해 줘. 아직 코드는 쓰지 마.」 마지막 문장이 중요합니다. 코딩 에이전트는 틈만 나면 바로 짜려 들거든요.
깔기 전에 손으로 먼저 해 보기
바로 설치하기 망설여진다면 시작하기 문서가 다른 길을 알려 줘요. 도구보다 방식부터 이해하라는 거예요. 프롬프트를 순서대로 복사해 붙여 가며 한두 번 손으로 해 보고, 그 반복이 귀찮아질 때 프레임워크를 들이라는 흐름이죠. 문서는 이 수동 방식이 시간 말고는 공짜이고 아무것도 깔 필요가 없다고 적었어요.

시작하기 문서는 도구를 깔기 전에 방식부터 손으로 따라 해 보라고 권해요.
이지티켓은 바이브코더에게 이 순서를 권해요. 이번에 설치하거나 돌려 보지는 않았고 저장소와 공식 사이트, 문서를 읽어 본 게 전부인데, 거기서도 아쉬운 점이 보였거든요. 데모나 체험판이 없어서 검토 결과가 어떻게 나오는지 화면으로 볼 방법이 없어요. 공식 사이트와 문서는 영어뿐이고요. 내 프로젝트에 맞는지 모르는 채로 깔기보다는, 새 대화창 하나를 금붕어 삼아 설계서만 붙여 넣고 「이것만 보고 구현할 수 있는지, 모호한 곳은 어디인지」 물어보는 걸로 맛을 보는 편이 덜 헤매요. 문서 분량도 시작하기 문서가 152줄이라 부담스럽지 않아요.
Superpowers, Spec Kit과 무엇이 다른가
설계부터 하고 짜자는 도구는 EGM이 처음이 아니에요. 바이브코더가 가장 많이 비교할 두 도구와 나란히 놓으면 이렇습니다(별 수는 2026년 11월 6일 기준).
| EGM | Superpowers | GitHub Spec Kit | |
|---|---|---|---|
| 만든 곳 | 구글 엔지니어들(공식 지원 제품 아님) | 개인 개발자 저장소(obra) | GitHub |
| 라이선스 | Apache 2.0 | MIT | MIT |
| 중심 | 설계서 검토, 기억 없는 검토자 | 계획 뒤 작업마다 새 서브에이전트로 실행, 2단계 코드 리뷰 | 명세, 계획, 작업, 구현으로 이어지는 명세 주도 개발 |
| 구현까지 하나 | 하지 않음(평소 에이전트에 맡김) | 함 | 함(/speckit-implement) |
| 설치 | 플러그인 명령 두 줄 | /plugin install superpowers@claude-plugins-official | uv tool install specify-cli(파이썬 3.11 이상, uv 필요) |
| GitHub 별 | 12.4천 | 313천 | 147.9천 |

2026년 11월 6일 기준 세 도구의 GitHub 별 수 비교
그래프로 보면 EGM은 공개 2주 남짓 된 도구라 별이 Superpowers의 25분의 1 수준이에요. 쓰는 사람이 적다는 건 막혔을 때 물어볼 사례도 적다는 뜻입니다. 차이는 검토의 무게에 있어요. Superpowers와 Spec Kit은 계획부터 구현까지 한 흐름으로 끌고 가고, EGM은 구현 전 설계서 검증에 힘을 몰아줘요. 이미 Superpowers로 잘 굴러가고 있다면 갈아탈 이유는 크지 않아요. 반대로 AI가 매번 의도와 다른 걸 만들어 와서 고생하고 있다면, 설계서 자체를 검사하는 EGM 쪽이 문제의 뿌리에 더 가까워요.
아직 0.1 버전, 알고 쓸 것들
첫 공식 릴리스 v0.1.0은 2026년 10월 27일에 나왔고, 릴리스 노트 스스로 「안정 버전이라 말할 단계가 아니다」라고 적었어요. 저장소는 하루에도 여러 번 바뀌는 중이라 이 글에 적은 명령이나 단계가 금세 달라질 수 있어요.

공개 때 3단계였던 금붕어 검토가 지금 문서에선 5단계로 늘었어요
실제로 공개 당일 블로그는 검토를 이해도 확인, 적대적 검토, 구현 준비 확인의 3단계로 설명했는데, 지금 README는 5단계라고 해요. 보름 사이에 검토 절차부터 바뀐 셈이죠.
그 밖에 알아 둘 점은 이렇습니다.
- 금붕어가 완전한 백지가 아닐 수 있어요. 클로드 코드는 검토자에게 프로젝트 설정 파일(CLAUDE.md)을 빼고 넘기도록 막아 두었지만, 코덱스 CLI 0.166.0에서는 검토자 맥락에 AGENTS.md가 들어갔다는 보고가 있고 이를 확실히 빼는 방법은 아직 확인되지 않았어요.
- 지적이 일부러 많이 나와요. 시작하기 문서는 금붕어 리뷰가 피드백을 넉넉히 쏟아 내도록 만들어졌으니 사람이 걸러야 한다고 해요. bootstrap으로 만든 문서도 사람이 다시 읽어야 하고요. 검토가 테스트나 사람의 판단을 대신하지 않는다고 README도 못 박아 둡니다.
- 사용량은 내 요금제에서 나가요. 플러그인은 무료지만 검토자 서브에이전트를 여러 개 띄우니, 클로드나 코덱스 요금제의 사용량을 그만큼 써요. 토큰이 얼마나 드는지는 공식 문서에 숫자가 없어요.
- 클로드 코드에선 무해한 경고가 하나 떠요.
/plugin오류 목록에 「default agents folder ignored」가 보여도 정상이라고 문서에 적혀 있어요.
자주 묻는 질문
EGM은 무료인가요?
플러그인 자체는 Apache 2.0 오픈소스라 무료이고, 상업 프로젝트에도 쓸 수 있어요. 다만 검토할 때 서브에이전트를 여러 개 띄우기 때문에 클로드 코드나 코덱스 같은 호스트 도구의 사용량은 따로 들어요.
커서나 깃허브 코파일럿에서도 되나요?
저장소 문서 폴더에 커서, 코파일럿, OpenCode용 안내 파일이 있지만, README가 설치 명령을 적어 둔 건 안티그래비티, 클로드 코드, 코덱스예요. 코파일럿은 실험 단계 지원으로 적혀 있으니 지원 수준은 각 안내 파일에서 확인하는 게 안전해요.
코드를 잘 몰라도 쓸 수 있나요?
오히려 그런 사람에게 맞는 구조예요. EGM이 다루는 건 코드가 아니라 설계서라서, 사람이 할 일은 검토자의 지적을 읽고 무엇을 고를지 정하는 쪽이거든요. 다만 문서와 출력이 영어로 나올 수 있으니, 에이전트에게 설계서를 한국어로 써 달라고 따로 부탁해 두면 읽기 편해요.
공식 블로그에서 안티그래비티 전용이라던데요?
공개 당시에는 안티그래비티용으로 만들어졌고 다른 환경은 곧 지원한다고 했어요. 2026년 11월 6일 기준으로는 클로드 코드, 클로드 코워크, 코덱스까지 설치 방법이 나와 있어요. 다음 기능을 시키기 전에 「/egm:egm-brainstorm 으로 정리하고, 아직 코드는 쓰지 마」 한 줄부터 붙여 보면 이 방식이 내 작업에 맞는지 금방 드러나요.
참고한 자료 8
- GitHub - google/elephant-goldfish-model
- Introducing the Elephant-Goldfish Model plugin (Google Open Source Blog)
- Elephant-Goldfish Model (egm.dev)
- getting_started.md · google/elephant-goldfish-model
- harnesses.md · google/elephant-goldfish-model
- Releases · google/elephant-goldfish-model
- GitHub - github/spec-kit
- GitHub - obra/superpowers
이 글은 AI가 자료 조사와 초안 작성을 돕고, 운영자가 직접 써 보고 확인해 고친 뒤 발행했어요. 틀린 내용을 발견하면 알려 주세요.