Elephant Goldfish Model: 맥락 없는 에이전트로 설계 문서를 검토하는 플러그인
Elephant Goldfish Model(EGM)은 코딩 에이전트에게 설계 문서를 쓰게 하고, 그 문서를 앞선 대화를 모르는 새 에이전트들이 다시 검토하게 만드는 플러그인이에요. 구현에 들어가기 전에 스펙을 단단하게 다듬고 싶은 팀이라면 한번 살펴볼 만해요. Google 계정에서 공개됐지만, 저장소 설명에 따르면 Google이 공식 지원하는 제품은 아니에요.
무엇을 해 주나요
이름의 코끼리와 금붕어는 역할을 뜻해요. 저장소 설명에 따르면 ‘코끼리(Elephant)’는 프로젝트 맥락을 계속 기억하면서 스펙 초안을 쓰는 에이전트이고, ‘금붕어(Goldfish)’는 이전 대화를 전혀 보지 않은 상태로 초안만 읽고 검토하는 리뷰어예요. 그리고 사람인 사용자가 둘 사이에서 절충을 결정하고 최종 스펙을 승인해요. 초안을 쓴 쪽은 대화 중에 합의된 내용을 당연하게 여기기 쉬운데, 맥락이 없는 리뷰어는 문서에 적힌 것만 보니 빠진 설명이나 모순을 더 잘 드러낼 수 있다는 발상이에요.
이 흐름은 여러 개의 스킬로 나뉘어 있어요.
- Brainstorm: 아이디어를 시험해 보고 개념 요약(
concepts_brief.md)을 남겨요. - Draft: 그 요약이나 메모를 설계 문서 초안(
design_draft.md)으로 바꿔요. - Review: 새로 띄운 에이전트들이 다섯 단계에 걸쳐 설계를 검토해요. 단계 이름은 README 첫 화면에 나오지 않았어요.
- Resolve: 리뷰에서 나온 지적을 하나씩 정리해요.
- Review loop: 사용자가 정한 리뷰어 묶음을 돌려요. 소프트웨어 스펙이 아닌 문서도 이 스킬로 기준을 정해 검토할 수 있다고 해요.
- Bootstrap: 이미 있는 코드베이스에 맞춰 문서를 새로 만들거나 갱신해요.
- Drift report: 저장소에 올라간 문서와 지금의 소스 코드를 비교해서 어긋난 곳을 알려 줘요.
승인된 스펙은 docs/designs/ 아래에 저장된다고 설명돼 있어요. 최상위 폴더에도 skills, agents, docs와 함께 .claude-plugin, .codex-plugin, .cursor-plugin, .gemini, .windsurf, adapters/opencode 같은 에이전트별 설정 폴더가 실제로 있어서, 여러 도구에 같은 스킬을 붙이려는 구조라는 게 보여요.
설치와 사용
README에 필요한 런타임 버전은 따로 적혀 있지 않아요. 대신 브레인스토밍과 리뷰는 새 서브에이전트를 만들 수 있는 세션이 있어야 하고, 그게 안 되면 리뷰가 멈춘다고 해요. Claude Code에서는 마켓플레이스를 추가한 뒤 설치해요.
claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm
Codex CLI와 Antigravity CLI용 명령도 따로 있어요.
codex plugin marketplace add google/elephant-goldfish-model
codex plugin add egm@egm
agy plugin install https://github.com/google/elephant-goldfish-model
ChatGPT·Codex 데스크톱 앱에서는 앱 안의 플러그인 목록에서 설치하고, 설치한 다음에는 새 세션을 열어야 해요. 기본 흐름은 아이디어를 던지고, 초안을 만들고, 리뷰를 돌리는 순서예요.
/egm-brainstorm Add webhook delivery to this project.
/egm-draft
/egm-review design_draft.md
/egm:egm-drift-report docs/designs/
Antigravity와 Claude Code에서는 /egm: 접두사를 붙이는 방식을 권하고, Codex에서는 스킬 선택 화면에서 같은 이름의 스킬을 고르면 된다고 해요.
누구에게 쓸모 있나요
에이전트에게 바로 코드를 짜게 했다가 요구 사항을 잘못 이해한 결과물을 여러 번 받아 본 사람에게 잘 맞아요. 설계 단계에서 문서를 먼저 확정하고, 그 문서를 맥락 없는 시선으로 한 번 더 걸러 내는 과정을 자동으로 돌릴 수 있으니까요. 오래된 코드베이스에 설계 문서가 없거나, 문서가 코드와 따로 놀고 있는 팀이라면 Bootstrap과 Drift report 쪽이 더 바로 쓸모 있을 거예요. 반대로 작은 수정 하나에도 이 과정을 다 돌리면 무거울 수 있어요. 실제로 열린 이슈 중에 작은 변경용 가벼운 절차(EGM Lite)를 제안하는 글이 올라와 있어요.
쓰기 전에 알아 둘 점
- 리뷰는 테스트나 사람의 판단을 대신하지 않는다고 README가 직접 밝혀요.
- 기본 초안·리뷰 흐름은 소프트웨어 스펙을 기준으로 만들어졌고, Bootstrap과 Drift report는 소프트웨어 코드베이스에만 쓸 수 있어요.
- Antigravity CLI는 버전에 따라 접두사 없는 명령 자동 완성이 되지 않는 문제가 이슈로 남아 있어요(1.4.8에서 안 되고 1.4.10에서 된다고 해요).
- 최신 릴리스 노트에서 Cursor, OpenCode, GitHub Copilot 어댑터는 ‘실험적’이라고 표시돼 있고, 배포 파일의 실제 환경 종단 검증은 아직 열린 이슈로 남아 있어요. 최근 커밋에도 Windsurf용 실험 어댑터가 추가됐어요.
- 첫 릴리스가 0.1.0이고 최신도 0.1.1이라 아직 초기 단계예요. 서브에이전트를 여러 번 띄우는 구조라 비용이나 토큰 사용량이 늘 수 있지만, README에 구체적인 수치는 없어서 확인되지 않았어요. 텔레메트리에 대한 언급도 README에서 찾지 못했어요.
저장소 상태
- 별 약 2만 500개, 포크 약 1,500개
- 열린 이슈 77개, 열린 PR 46개(닫힌 PR 258개)
- 언어: Python (GitHub 트렌딩 페이지 표시 기준. 저장소 페이지의 언어 비율 막대는 읽히지 않았어요). 최상위에
pyproject.toml이 있고 대부분은 스킬 문서와 설정 파일로 보여요. - 라이선스: Apache-2.0
- 마지막 커밋: 2026년 11월 15일(코드 블록 속 멘션 처리 수정). 11월 12~14일에도 CI 린트 추가, 의존성 갱신 같은 커밋이 이어졌어요.
- 최신 릴리스: EGM v0.1.1, 11월 6일(페이지에 연도는 표시되지 않았어요). 이전 릴리스는 10월 27일의 v0.1.0이에요.
확인 범위
2026년 11월 17일에 GitHub 웹 페이지로 확인(API 미사용)했어요. 저장소 첫 화면(설명, 별·포크, 라이선스, 최상위 폴더, README), 릴리스, 커밋, 이슈, PR 페이지를 읽었어요. README에서 링크로 이어지는 별도 설정 가이드와 docs 폴더 안 문서는 읽지 않았고, 언어는 저장소 페이지 대신 GitHub 트렌딩 페이지 표시로 확인했어요. 코드 분석과 설치·실행은 하지 않았어요.