AI 칼럼

코딩@donghyeok99운영진

EGM: 설계 문서를 기억 없는 에이전트가 먼저 뜯어보게 하는 Google 플러그인

Google 엔지니어 수천 명이 매일 쓴다는 설계 리뷰 플러그인이 공개됐어요. 대화 기록 없는 ‘금붕어’가 설계 문서를 처음 보는 사람처럼 뜯어봐요

코끼리가 design_draft.md를 쓰면 새 컨텍스트의 금붕어들이 헤엄쳐 와 차단·중요·사소 등급의 지적을 문서에 붙이고, critic_report.md가 나와요
코끼리가 design_draft.md를 쓰면 새 컨텍스트의 금붕어들이 헤엄쳐 와 차단·중요·사소 등급의 지적을 문서에 붙이고, critic_report.md가 나와요
누가
Google이 Apache 2.0으로 공개한 오픈소스 플러그인이에요. README 기준 Google 엔지니어 수천 명이 쓰고, 공식 지원 제품은 아니에요.
언제
저장소는 2026년 9월 13일에 생겼고, 10월 22일 Google 오픈소스 블로그에서 공개됐어요. 첫 태그 릴리스 v0.1.0은 10월 27일이에요.
어디서
Antigravity CLI, Claude Code, Codex에 플러그인으로 설치해요. 문서에는 Claude Cowork, ChatGPT Work, omp, Muse도 있어요. 내 에이전트 안에서 돌고 서브에이전트가 필요해요.

이게 불편했어요

코딩 에이전트에게 기능 하나를 맡기면 처음엔 술술 나가다가, 며칠 뒤엔 버그 하나 고치면 다른 둘이 터지는 긴 스레드에 갇히곤 했어요. 설계를 먼저 적어 두어도 그 문서를 쓴 세션이 그대로 검토하니, 빠진 가정을 같이 믿어 버렸어요.

그래서 이렇게 풀어요

EGM은 역할을 둘로 가르는 게 핵심이에요. 프로젝트 맥락을 다 쥔 ‘코끼리’ 세션이 설계 문서를 쓰고, 코드는 한 줄도 쓰지 않아요. 그 문서를 대화 기록이 전혀 없는 ‘금붕어’ 서브에이전트들이 처음 읽는 사람처럼 검토해 숨은 가정과 비어 있는 설명을 지적해요. 트레이드오프를 고르고 설계를 승인하는 건 사람이고, 승인한 뒤에 에이전트에게 구현을 시켜요.

이걸로 만든 사람들

Redditu/headpiece7472026-10-31

Antigravity에서 EGM을 켜고 자기 프로젝트들을 보게 했더니 감사에서 고칠 게 많이 나왔다는 짧은 후기예요. 제작자와 무관하다고 밝혔어요.

so i told it to look at my projects and it found a lot to fix with its audit

안에서는 이렇게 돌아가요

  1. 1

    나 → 코끼리 (Claude Code 세션)

    /egm-brainstorm 기능 한 줄코끼리가 열린 질문으로 문제를 파고든 뒤 금붕어 렌즈 6개로 검증하고 concepts_brief.md를 써요skills/egm-brainstorm/SKILL.md
  2. 2

    코끼리 (Claude Code 세션) → egm-draft

    concepts_brief.md브리프를 design_draft.md로 섹션씩 쓰고, 섹션마다 승인 질문을 하나만 던져요skills/egm-draft/SKILL.md
  3. 3

    나 → egm-review

    /egm-review design_draft.md리뷰 모드를 고르고 '## Detailed Implementation Plan' 제목을 경계로 기능 범위와 구현 범위를 나눠요skills/egm-review/SKILL.md
  4. 4

    egm-review → 금붕어 서브에이전트

    페르소나 파일 + 문서 경로, 대화 기록 없음단계마다 새 서브에이전트를 띄워요. 설계 비평가는 근거 없는 가정과 다루지 않은 위험을 찾고, 파일은 못 고쳐요agents/design_critic.md
  5. 5

    금붕어 서브에이전트 → egm-review

    Blocker / Major / Nit 지적이해 리뷰어는 먼저 문서를 제 말로 요약해야 하고, 요약 못 하는 섹션은 Blocker예요. 단계별 보고서를 .md로 써요agents/comprehension.md
  6. 6

    egm-review → 코끼리 (Claude Code 세션)

    egm-resolve: 반박·수정·보류코끼리가 지적마다 CONTEST, PROPOSE FIX, ESCALATE, DECLINE 중 하나를 고르고 승인된 수정만 design_draft.md에 적용해요skills/egm-resolve/SKILL.md
  7. 7

    코끼리 (Claude Code 세션) → 승인된 설계 문서

    docs/designs/ 아래 승인된 설계사람이 승인한 문서로 에이전트가 구현하고, 나중에 /egm-drift-report로 문서와 코드의 차이를 봐요docs/getting_started.md

넣으면 이렇게 나와요

/egm-brainstorm Add webhook delivery to this project.실패한 전송과 중복 이벤트를 어떻게 다룰지 정리한 concepts_brief.md
/egm-review design_draft.mdzoom_out_report.md, comprehension_report.md, critic_report.md 같은 단계별 보고서
금붕어 리뷰어가 제 말로 요약하지 못한 섹션Blocker 등급 지적 (comprehension 리뷰어의 규칙)

나한테 맞을까요

이럴 때 좋아요

  • 설계 결정이 필요한 기능을 코딩 에이전트로 만들 때
  • 혼자 일해서 설계를 봐 줄 동료가 없을 때
  • Claude Code, Codex, Antigravity CLI에서 서브에이전트를 쓸 수 있을 때
  • 에이전트 세션이 길어지며 가정이 쌓이는 게 걱정될 때

이건 안 돼요

  • README는 작고 분명한 버그 수정에는 평소 코딩 흐름을 쓰라고 해요
  • 금붕어 리뷰는 새 컨텍스트의 서브에이전트가 필요해요. 만들 수 없는 환경이면 리뷰를 멈춰요
  • 리뷰가 테스트나 사람의 판단을 대신하지 않아요
  • v0.1.0은 첫 태그 릴리스예요. 릴리스 노트에 안정 버전으로 보지 말라고 적혀 있어요

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기