elephant-goldfish-model

코끼리와 함께 설계하고, 금붕어와 함께 검토하세요.

설치 ·
빠른 시작 ·
문서 ·
웹사이트

수천 명의 Google 엔지니어가 오픈소스 플러그인인 EGM을 사용해, 깊은 컨텍스트를 가진 에이전트로 명세를 작성하고 코드를 작성하기 전에 제로 컨텍스트 서브에이전트로 이를 스트레스 테스트합니다.

코끼리는 프로젝트 컨텍스트를 보유하고 명세 초안을 작성합니다. 금붕어 리뷰어는 이전 대화 없이 초안과 참조된 소스 자료를 검토하여, 명시되지 않은 가정과 사각지대를 드러내는 데 도움을 줍니다. 아키텍처 트레이드오프는 여러분이 결정하고, 구현 전에 명세를 승인합니다.

기능이 구현 전에 설계 결정을 필요로 할 때 사용하세요. 작고 명확한 버그 수정에는 평소의 코딩 워크플로를 사용하세요.

설치
코딩 에이전트를 선택하세요. 스킬이 리뷰어 프롬프트와 문서 표준을 읽을 수 있도록 전체 플러그인을 설치하세요.

Antigravity CLI
agy plugin install https://github.com/google/elephant-goldfish-model
Antigravity App 및 Antigravity for IDEs(Visual Studio Code 확장)의 경우 /plugin을 실행하거나 설치 안내를 참조하세요.

Claude Code
claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm
Codex
codex plugin marketplace add google/elephant-goldfish-model
codex plugin add egm@egm
설치 후 새 세션을 시작하세요. Claude Cowork 및 ChatGPT Work의 경우 설정 가이드를 참조하세요.

첫 번째 설계를 시도해 보세요
코딩 에이전트에서 프로젝트를 열고 설계 결정이 필요한 기능을 선택하세요. 이 예제는 웹훅 전달을 추가합니다. 전달이 실패하면 어떻게 해야 할까요? 같은 이벤트가 두 번 도착하면 어떻게 해야 할까요?

아래 명령은 접두사 없이 표시됩니다. Antigravity(agy CLI)와 Claude Code에서는 /egm: 접두사를 추가하세요. 예를 들어 /egm:egm-brainstorm입니다. agy CLI 1.4.10에서는 접두사 없는 이름이 접두사가 붙은 명령으로 완성되지만(#220), 1.4.8에서는 그렇지 않으므로(#196) 접두사를 유지하세요. Codex에서는 스킬 선택기에서 해당 EGM 스킬을 선택하세요. 브레인스토밍과 리뷰에는 새 서브에이전트를 생성할 수 있는 세션이 필요합니다.

아이디어 탐색하기

/egm-brainstorm 이 프로젝트에 웹훅 전달을 추가하세요.

에이전트와 요구사항 및 트레이드오프를 논의하세요. 새 리뷰어가 제안에 도전하고, 에이전트는 합의된 방향을 concepts_brief.md에 저장합니다.

명세 초안 작성하기

/egm-draft

에이전트는 브리프를 design_draft.md로 전환하며, 각 섹션 후에 채팅에서 여러분의 피드백을 위해 잠시 멈춥니다.

초안 검토하기

/egm-review design_draft.md

에이전트가 반환한 초안 경로를 사용하세요.

새 리뷰어가 설계, 설계의 명확성, 코드와의 적합성, 구현 계획을 검토합니다. 어떤 발견 사항을 다룰지 선택하세요. 설계를 승인하면 코딩 에이전트에게 구현을 요청하세요.

승인된 명세를 docs/designs/ 아래에 저장하는 것을 포함한 전체 프로세스는 워크플로 가이드를 참조하세요.

작동 방식

역할 컨텍스트 책임

코끼리 프로젝트, 요구사항, 이전 결정 사항 문제를 탐색하고 명세 초안을 작성합니다.
금붕어 이전 대화 없이 문서와 참조된 소스 자료 누락된 가정, 불명확한 요구사항, 구현 위험을 찾습니다.
여러분 중요한 목표와 제약 사항 트레이드오프를 해결하고, 설계를 승인하며, 무엇을 만들지 결정합니다.

금붕어 리뷰에는 새 서브에이전트 컨텍스트가 필요합니다. 에이전트가 이를 생성할 수 없으면 EGM은 리뷰를 중단합니다. 리뷰는 테스트나 인간의 판단을 대체하지 않습니다. 지원되는 환경과 검증 한계를 참조하세요.

스킬 선택하기
필요할 때 각 스킬을 사용할 수 있습니다. 전체 순서를 따를 필요는 없습니다.

스킬 사용 목적…

Brainstorm 아이디어를 테스트하고 컨셉 브리프를 작성합니다.
Draft 브리프나 기존 노트를 설계 문서로 전환합니다.
Resolve 리뷰 발견 사항을 검토하고 변경 사항에 합의합니다.
Bootstrap 기존 코드베이스에 대한 문서를 생성하거나 업데이트합니다.
Review 다섯 단계에 걸쳐 새 에이전트로 설계를 검토합니다.
Review loop 특정 리뷰 작업을 위해 구성된 리뷰어 그룹을 실행합니다.
Drift report 체크인된 문서를 현재 소스 코드와 비교합니다.

더 알아보기

시작하기 : 워크플로와 프로젝트 레이아웃.
설정 : 설치, 에이전트 기능, 알려진 한계.
아키텍처 : 스킬과 리뷰어가 어떻게 결합되는지.
테스트 : 검사, 실행 기록, 검증 한계.
Dave Rensin의 원문 에세이 : EGM 뒤에 있는 아이디어.

기여하기
PR은 기여 안내를, 버그는 이슈를, 질문은 토론을 참조하세요.

라이선스
Apache 2.0 . 이는 공식적으로 지원되는 Google 제품이 아닙니다.