AI의 활용으로 코드 작성은 빨라졌지만, 무엇을 만드는지 설명하는 일까지 빨라진 것은 아니다.
뭘 만들지 결정한 후 몇 분만에 AI코딩 에이전트가 코드를 작성한다. 파일이 생성되고, 테스트가 통과되었다는 메시지가 나온다.
"장애가 나면 어떻게 복구하죠?"
"기존 인증 정책과 충돌하지는 않을까요?"
"같은 요청이 두 번 들어오면 어떻게 되죠?"
코드는 빨리 만들어졌지만, 위 질문을 받는다면 답변할 수 있을까?
돌이켜보면, AI가 변화시킨 소프트웨어 개발은 타이핑 속도가 아니다. 불완전한 지시를 그럴듯한 구현으로 바꾸는데 필요한 시간이 많이 줄었다는 점이다. 즉, 설계 결함이 더 많이 쌓일 위험이 생긴 것이다.
구글은 이런 상황에서의 문제를 해결하기 위해 Elephant-Goldfish Model(EGM)을 소개했다. AI와 사람이 코드를 작성하기 전에 무엇을 만들지 충분히 합의하고, 그 합의를 3자가 이해할 수 있는지에 대해 검증하도록 만드는 작업 방식이다.
코끼리와 금붕어
이름이 참 재밌다. 코끼리는 긴 기억을 가진 존재라는 의미이고, 금붕어는 앞서 나눈 대화가 없는 새로운 관찰자를 의미한다.
AI 에이전트가 받아야 할 정보의 범위와 한계를 구분하기 위한 이름이다.
코끼리는 맥락이 풍부한 설계 파트너다. 기존 시스템의 구조, 사용자 흐름, 제약 조건, 과거의 의사결정, 기능의 목적을 기억한다. 물론 무제한 기억을 의미하지는 않는다. 중요한 맥락을 문서와 코드베이스에 참조로 남겨 다시 찾아볼 수 있게 한다는 의미이다.
즉, 코끼리의 임무는 구현이 아니라 질문과 설계다.
금붕어는 코끼리와 진행했던 토론에 참여하지 않은 검토자다. 새롭게 생성된 에이전트 세션에서 설계 문서와 참조된 자료를 읽고, 요구사항이 충분한지 검토한다. 설계자가 당연하다고 여기는 전제를 모르는 상태이기에 아래처럼 다양한 질문을 던질 수 있다.
"이 용어는 무엇을 뜻하나?", "실패했을 때 상태가 어떻게 바뀌나?"
여기서 우리가 이해해야 할 부분은 "정보의 비대칭"이다. AI와 긴 대화를 통해 설계하고, 같은 대화내에서 자기 설계를 검토하면, 누락을 눈치채지 못할 수 있다. 금붕어는 의도적으로 맥락을 받지 않기에, 문서만으로 이해가 되지 않는다면, 설계가 아직 충분하지 않다는 신호로 봐도 된다.
마지막은 결국 사람이 봐야 한다. EGM에서는 AI가 대한을 제시하고 비판할 수는 있어도 아키텍처 선택, 위험 요소 수용, 최종 승인과 결과에 대한 책임은 사람에게 있다고 명시하고 있다.
명세 중심 개발
EGM을 언어 모델이나 개발 플랫폼으로 오해할 수 있다. 그러나 본질은 Spec-Driven-Deplopment(SDD)이다. 검증 가능한 설계 명세를 만들고, 그 명세를 기준으로 구현한다.
이 발상의 배경은 구글 엔지니어 Dave Rensin이 2026년 4월에 발표한 "Elephants, Goldfish and the New Golden Age of Software Engineering"에 있다. 그는 AI가 코드를 작성하는 시대일수록 코드 속의 작은 판단들, "왜 이 조건문을 넣었는가?"와 같은 결정이 설계 문서에 표현되어야 한다고 주장했다. 그의 명제는 "Design is the new code", 설계가 새로운 코드라는 것이다.
구글은 이 방법론이 사내에서 시작되었고, 수천 명의 직원이 프로덕션 코드 개발에 활용한다고 밝혔다. 물론, 이 수치는 구글의 발표이며 성과를 입증할 수는 없다.
실제 개발 흐름: 먼저 논쟁하고 이후에 코딩한다.
EGM의 기본 흐름은 아이디어 탐색 --> 명세 작성 --> 독립 검토 --> 사람 승인 --> 구현이다.
핵심은 구현을 시작하기 전, 요구사항과 설계 결정이 검토 가능한 문서로 만들어지는가에 있다.
첫 번째는 egm-brainstorm이다.
개발자는 새 기능을 이야기한다. 그러나 코드를 요청하지는 않는다.
"이 시스템에 알림 기능을 추가하자."고 하면, 코끼리는 누가 이벤트를 발행하는지, 전달 실패 시 재시도해야 하는지, 중복 수신을 어떻게 처리할지, 순서가 보장되어야 하는지부터 묻는다. 이런 논쟁을 거친 후, markdown file로 개념 요약 문서를 남기게 된다.
두 번째는 egm-draft이다.
앞서서 토론한 내용을 정식 설계 명세로 옮긴다. 문제 정의, 기술적 접근, 고려했다가 제외한 대안, 상세 구현 계획을 한꺼번에 길게 생성하기보다는 섹션별로 작성하고 사람의 확인을 받는다. 특히, 어떤 파일을 추가/수정하는지, API와 데이터 구조가 무엇인지, 어떻게 검증할지까지 명시하도록 유도한다.
세 번째가 EGM의 특징인 emg-review이다.
구글은 이해도 점검, 적대적 검토, 구현 준비 확인이라는 세 가지의 활동으로 설명한다. 현재 공개된 버전에서는 다섯 단계로 운영된다.
- 상위 관점에서 잘못 설정한 문제와 불필요한 복잡성을 살핀다.
- 사전 대화가 없는 검토자가 문서를 이해할 수 있는지 확인한다.
- 설계 결함, 장애 지점, 확장성, 예외 상황을 공격적으로 검토한다.
- 앞선 지적을 반영하면서 오히려 과도한 설계가 생기지 않았는지 살펴본다.
- 실제 수정 대상 파일, 인터페이스, 테스트 계획이 충분히 구체적인지 확인한다.
또한, 검토 과정에서 다양한 역할의 에이전트가 사용된다. 최근 프로토콜에는 기술적 모순을 새로운 방식으로 풀어보도록 유도하는 TRIZ 기반 검토 역할도 포함되어 있다. 물론 에이전트를 다수 동원했다고 해서 객관적으로 되는 것은 아닐 수 있다. 그럼에도 사람이 확인할 가설과 지적 사항은 객관적으로 나올 수 있다.
네 번째는 egm-resolve다. 금붕어가 제시한 문제를 코끼리와 사람이 하나씩 판정한다. 의견이 타당하면 수용하고, 문서에 근거가 있으면 반박하고, 검토 자료 밖의 내용이라면 사람이 결정한다. 그리고 이것들은 기록이 된다.
이런 과정이 끝나면, 설계 문서를 동료에게 리뷰 받고 AI또는 개발자가 구현하게 된다. EGM은 실제 코드 작성 도구와 테스트 체계 전체를 맡지는 않는다. 구현 단계에서는 이미 사용하고 있는 코딩 에이전트, 코드 리뷰 도구, 테스트 도구, 배포 도구를 활용하면 된다.
즉, 승인된 명세를 저장소에 남겨 구현에 연결하는 행위를 지원한다.
웹훅 기능 하나가 보여주는 차이
"주문 완료 시 외부 시스템에 웹훅을 보내줘." 라는 지시만으로도 AI 코드를 만들 수 있다. 그러나 프로덕션에서 중요한 것들은 이후에 등장하게 된다.
EGM 방식에서는 설계 단계부터 문제를 세분화한다. 전달 실패 후 재시도 횟수와 간격은 얼마인지, 외부 서버가 응답하지 않을 때 큐에 얼마동안 보관해야 하는지, 주문의 이벤트가 두 번 전달되면 수신자는 어떤 키로 중복을 식별해야 하는지, 재시도를 포함해서 작업이 실패하면 누가 어떤 경보를 받아야 하는지, 이벤트 발생 시점과 전송 시점의 순서가 달려도 되는지...
코끼리는 팀과 논의해 각 항목의 선택과 이유를 문서에 적는다. 예를 들어 "전달은 최소 한번 시도한다. 따라서 수신자는 중복 처리를 고려해야 한다."는 식의 명세를 정할 수 있다.
금붕어는 이 문서를 보고 "중복 방지 키의 보존 기간이 빠졌다.", "재시도 종료 후 장애 처리 책임이 없다."와 같이 지적할 수 있다.
이 방식의 장점은 AI가 정답을 알아서 찾아낸다는 것이 아니다. 코드를 만든 후에 드러날 문제를 코드 생성전에 질문하도록 만드는 것이다. 명세가 충실하다면 다른 개발자나 에이전트가 프로젝트에 참여해도 긴 대화 맥락을 이해할 필요가 줄어든다.
반대로 요구사항이 잘못되었다면, 아무리 명세를 잘 썼어도 좋은 제품을 만들진 못한다.
레거시 시스템에도 코끼리를 적용할 수 있을까?
신규 프로젝트보다 더 어려운 것은 레거시 시스템이다. 방대한 소스코드를 대화창에 통째로 넣으면 토큰 비용이 커지고 중요한 맥락을 찾기도 어렵다.
EGM의 egm-bootstrap은 이런 작업을 위해 코드베이스에 설명의 계층을 만드는 방식을 제안한다.
하위 디렉토리에 각 파일의 목적과 관계를 정리한 README.md를 만들고, 상위 디렉토리에서는 하위 문서들을 요약하여 더 큰 구조를 설명한다. 그리고 프로젝트의 전체 지도도 제공한다. 이는 소스코드를 기억에 통으로 넣는 대신, 필요할 때 찾아 읽을 수 있도록 맥락의 목차를 만드는 작업이다.
주의할 점은 AI가 작성한 README를 사실로 받아들여서는 안된다는 점이다. 코드만 읽으면 사업적 이유나 과거의 히스토리를 알기 어렵다. 그래서 담당자의 검토와 수정이 필요하다.
이후 egm-drift-report를 이용하면 저장소에 남긴 설계 문서와 실제 코드 사이의 차이를 조사할 수 있다. 문서가 틀렸는지 코드가 잘못되었는지 사람이 결정해야 한다.
제공되는 도구
EGM의 Git repo의 핵심은 3가지 요소다.
- skills/ 에는 브레인스토밍, 설계 초안, 검토, 지적 해소, 문서 초기화, 반복 검토, 드리프트 보고를 위한 스킬이 있다.
- agents/ 에는 검토자의 역할 지침이 있다.
- resources/ 에는 문서 평가 기준과 공유 규칙이 있다.
기능을 복사해 붙인 거대한 단일 에이전트가 아니라, 공유된 규칙을 서로 다른 AI 실행 환경에서 재사용하는 플러그인에 가깝다.
공식 문서에는 Antigravity CLI, Claude Code, Codex CLI 등에서의 설치 방법을 제공한다고 언급하고 있다.
추가로, 금붕어 리뷰에서는 새로운 컨텍스트를 가진 서브 에이전트를 생성하는 기능이 필요하다. 실행하는 환경에서 이를 제공하지 않으면 EGM은 동일한 대화 맥락에서 흉내만 내며 검토하지 않고 해당 리뷰를 중단하도록 설계되어 있다.
실제 효용 가치와 미해결 문제
EGM을 사용할 때 효용 가치는 3가지이다.
첫째, AI가 빠르게 생성한 코드를 신뢰하지 않고, 설계의 빈틈을 먼저 찾는다.
둘째, 코끼리가 축적한 맥락을 문서로 외부화하고 특정 대화 세션이나 특정 개발자/에이전트의 머릿속에 지식이 갇힐 위험을 낮춘다.
셋째, 금붕어가 무조건 기능을 더 넣는 방향으로 움직이지 않도록 "정말 필요한가?"라는 간순성 검토를 반복한다.
위에서 언급한 맥락 분리만으로는 독립적인 판단을 보장하지는 않는다. 새로운 서브 에이전트가 대화 기록을 받지 않도록 구성되지만, 실행 도구가 공통 프로젝트 지침 파일을 주입할 수 도 있다. 그리고 이 문제는 별개라고 봐야 한다. 예를 들어 저장소내에 AGENTS.md 같은 호스트 지침이 전달될 수 있다. 따라서 EGM의 격리는 모든 플랫폼에서 증명된 절대적인 단절은 아니다. 환경에 따라 달라질 수 있다.
또한 여러 검토자를 반복 호출하게 되면 토큰 사용량과 검토 시간이 증가한다. 사람이 해결해야 하는 결정 부분도 쌓이게 된다. 즉, 초반 생산성 향상은 어려울 수 있다.
설계의 일관성은 확인할 수 있지만 구현의 동시성 오류, 실 운영 환경의 성능, 보안 취약점, 외부 시스템과의 호환성은 코드와 실행 결과로 확인해야 한다. EGM을 통해 검토했다고 해서 모든 조건을 충족하는 것은 아니기 때문이다.
즉, EGM은 품질 보증을 해준다기 보다는 설계 단계에서의 방어선이라고 인지해야 한다.
시사점
복잡한 엔터프라이즈 시스템에서는 시사점이 크다. EGM은 암묵지를 명세로 옮기고 외부 관점으로 확인하는 반복 가능한 절차를 제공한다.
EGM도입은 거창하게 할 필요가 없다. 변경 영향이 큰 한 가지 기능을 선정해서 기존 방식과 비교해보면 된다. 예를 들어서 변경 전후의 설계 누락 건수, 구현 이후 재작업 시간, 리뷰에서 발견된 중대 결함, 새로운 담당자의 이해 시간, AI 사용 비용을 기록할 수 있다. 같은 유형의 업무를 대상으로 비교해야 숫자가 의미를 갖는다. 개발 속도외에 의사 결정의 추적 가능성과 운영 이후의 설명 가능성을 측정하는 것도 매우 중요하다.
AI 에이전트의 숫자를 늘리는 것보다 설계 책임과 변경 관리의 경계를 선명하게 하는 일이 먼저다. EGM은 이런 거버넌스를 자동으로 제공하지는 않지만, 이런 부분들을 논의할 공통 문법을 제공한다고 이해해야 한다.
더 많이 만드는 AI에서 더 잘 이해하는 팀으로
EGM은 이미 알려진 문서화, 설계 검토, 동료 리뷰의 원칙을 AI 시대에 맞게 재배열한다. 충분히 알고 있는 코끼리와 의심하는 금붕어의 관점이 충돌할 때 설계의 빈틈이 드러난다.
AI 코딩 시대의 경쟁력은 한 번의 프롬프트로 수천 줄을 만드는 능력만으로는 설명하기 어렵다. 오히려 좋은 질문을 만들고, 대안을 비교하고, 책임질 수 있는 결정을 문서로 남기며, 구현을 그 결정에 맞춰 검증하는 능력이 중요해진다. 개발자의 일이 사라진다기보다는, 개발자의 판단이 놓이는 위치가 코드 작성 이전으로 이동하는 셈이다.
"AI가 이 코드를 만들 수 있는가?"가 아니라, "우리는 왜 이 코드를 만들어야 하는지, 다른 사람에게 설명할 수 있는지?"에 대한 답이 더 중요하다.
속도가 모든것을 압도하는 듯한 시대에, 기억하는 코끼리와 의삼하는 금붕어는 오히려 오래된 엔지니어링의 미덕을 되살린다. 더 빨리 타이핑하기 전에, 정확히 이해하고 있는지 확인하라는 것이다.
Sources:

0 Comments:
댓글 쓰기