설계 문서부터 검토하는 Google EGM — 코드 쓰기 전 3단계 검증을 거치는 AI 코딩 플러그인

Google 오픈소스 블로그 · X @awe0_io · ax-trend 이슈 #3550 · 2026-10-26 보도

설계 문서부터 검토하는 AI 코딩 플러그인 — Google Elephant-Goldfish Model 오픈소스 공개
개요 — 코드를 바로 생성하지 않고 설계 문서를 먼저 만들고 검토한 뒤 구현에 들어가는 플러그인입니다

코드를 바로 짜지 않고 설계부터 만듭니다

Google이 AI 코딩 플러그인 Elephant-Goldfish Model(EGM)을 오픈소스로 공개했습니다. 저장소는 google/elephant-goldfish-model이며, 생성일은 2026-09-13, 주 언어는 Python, 라이선스는 Apache-2.0입니다. 10월 27일 확인 시점의 실측 스타 수는 2,014개입니다.

EGM의 순서는 원샷 코드 생성과 정반대입니다. 모델을 코드 생성에 바로 투입하지 않고 설계 문서를 먼저 만든 뒤 검토를 거쳐 구현에 들어갑니다. 원샷 생성이 늘면서 모델의 과신 섞인 출력물을 그대로 구현하는 일이 흔해진 데 대한 대응으로 읽힙니다. 결함을 코드가 아니라 설계 문서 단계에서 잡자는 발상입니다.

이 방법은 Dave Rensin의 에세이에서 유래했습니다. Google이 공식 블로그로 플러그인을 소개한 뒤 10월 26일에 여러 매체가 보도했습니다.

Elephant와 Goldfish, 두 역할이 갈립니다

Elephant는 프로젝트의 장기 기억을 맡습니다. 아키텍처와 트레이드오프에 대한 논의를 정리해 Markdown 설계 문서로 만듭니다. Goldfish는 설계 대화에 참여하지 않은 무상태 검토자입니다. 문서를 처음 보는 상태로 읽어 모호함, 누락된 가정, 엣지 케이스를 찾습니다.

핵심 논리는 단순합니다. 설계 대화에 없었던 검토자는 그 대화의 blind spot을 물려받지 않습니다. 같은 대화를 오래 나눈 검토자라면 넘어갈 만한 전제를, 처음 보는 눈이 붙잡을 수 있습니다.

EGM 설계 우선 워크플로: Elephant 설계 문서 작성, 이해 검사, 대항 검토, 구현 검사, 인간 승인 후 구현 시작
EGM 설계 우선 워크플로 — 설계 문서를 만든 뒤 3단계 검토를 거치고 인간이 승인해야 구현이 시작됩니다

검토는 3단계로 진행됩니다

첫 단계는 이해 검사입니다. Goldfish가 설계를 되설명하지 못하면 문서가 모호한 것으로 보고 다시 씁니다. 두 번째 단계는 대항 검토입니다. 여러 Goldfish가 엣지 케이스, 숨은 의존성, 논리 빈틈을 공격합니다. 세 번째 단계는 구현 가능성 검사입니다. 파일 경로, 자료구조, 함수 시그니처가 모두 있고 모호하지 않은지를 따져 go/no-go를 판정합니다.

설계가 검토를 통과하고 인간이 승인해야 구현이 시작됩니다. 다만 검토 통과가 설계의 정확성을 보장하지는 않는다는 단서가 붙어 있습니다. 통과는 구현에 들어갈 자격이지, 설계가 맞다는 증명이 아닙니다.

검토를 통과했다는 말은 설계가 옳다는 뜻이 아닙니다. 구현에 들어갈 자격을 얻었다는 뜻에 가깝습니다. 최종 판단과 테스트는 사람이 쥐어야 합니다.

설치 위치

설치는 세 환경에서 안내됩니다. Antigravity는 agy plugin install 명령을 쓰고, Claude Code는 marketplace 추가와 install egm@egm 형태의 플러그인 설치를 쓰며, Codex도 같은 형태의 플러그인 설치를 씁니다. 자세한 설치 순서는 저장소의 설치 안내를 따르는 것이 안전합니다.

Google은 수천 명의 자사 엔지니어가 매일 프로덕션 코드 작성에 EGM을 사용한다고 밝힙니다. 다만 이 주장은 Google 자체 발표이며 외부 검증이 없습니다. 도입을 검토할 때는 내부 사용 규모가 아니라, 우리 팀의 설계 문서가 이 검토를 견디는지를 먼저 보는 것이 순서입니다.

아직 확인되지 않은 점

속도, 코드 품질, 버그율에 대한 공개 벤치마크가 없습니다. 기본 검토 목록에 보안 위협 모델링이 들어 있지 않으므로, 보안 관점 검토를 원하면 팀이 직접 페르소나를 추가해야 합니다. 검토 피드백이 의도적으로 방대해, 관련 있는 것만 골라 쓰고 나머지는 버리는 선별 비용이 생깁니다. Google도 단순한 버그 수정에는 설계 우선 과정을 억지로 쓰지 말라고 안내합니다.

실무 판단: 설계 문서를 먼저 쓰고, 대화에 없던 검토자에게 읽히게 합니다

실무 판단은 이렇게 정리됩니다. 코딩 에이전트 실무에서 “설계 문서를 먼저 쓰고, 대화에 없던 검토자에게 차갑게 읽히는” 패턴을 팀 프로세스로 가져갈 수 있습니다. 오픈소스에 Apache 2.0이라 규칙과 검토자 페르소나를 팀에 맞게 바꿀 수 있는 점도 실무적입니다. 다만 검토 통과를 정확성 보증으로 오해하지 말고, 최종 판단과 테스트는 사람이 쥐어야 합니다.

원문 이슈

AX TrendAI 코딩오픈 모델