Today's AI open source · 2026-11-15
google/elephant-goldfish-model
EGM is a plugin in which an agent that knows the context writes the design and an agent without that context reviews it.
| Repository | github.com/google/elephant-goldfish-model ↗ |
|---|---|
| Main language | Python |
| License | Apache-2.0 |
| GitHub stars · forks | ★ 19,162 · 1,420 forks (as of 2026-11-15) |
| Created · last update | 2026-09-13 · 2026-11-14 |
| GitHub topics | agent-skills, ai-agents, antigravity, claude-code, claude-code-plugin, claude-skills, codex, codex-plugin |
Overview
Elephant-Goldfish Model (EGM) is an open-source plugin for writing and reviewing software design documents with an AI assistant. It can be installed in several coding agents, including Claude Code, Codex and Antigravity.
Elephant, which knows the project context and previous conversations, writes the draft spec. Goldfish, a new subagent reviewer that has not seen previous conversations, reviews it by reading only the document and the referenced source code. This surfaces assumptions not written in the document and gaps that were missed. Judging architecture trade-offs and approving the spec remain the user's job.
It suits developers who want to settle the design before implementing features with a coding agent. According to the README, it can also be used to review existing design documents or PR plans against the current code, or to find places where documents and code have diverged.
Why it is worth a look
To find context that lives only in the author's head and is missing from the document, it deliberately withholds previous conversations from the reviewer. It is worth noting as a context engineering approach that improves review quality by removing context, the opposite of giving agents more context. Being able to use one plugin across multiple coding agents is also helpful in practice.
Key features
- Use egm-brainstorm to discuss requirements and trade-offs, then save the agreed direction to concepts_brief.md.
- egm-draft turns the brief into design_draft.md, pausing after each section to get user feedback.
- egm-review has new reviewers check the design, clarity, consistency with the code and the implementation plan.
- egm-drift-report compares each document in a folder with the current source code and reports where they diverge.
- With egm-review-loop, you can also review documents other than software specs by choosing reviewers and criteria.
What it is used for
- Write a spec before implementation for features that need design decisions, such as failure handling and duplicate handling in webhook delivery.
- Review existing design documents or PR plans saved as Markdown against the current code.
- Periodically check how far a folder of design documents has drifted from the actual code.
Getting started
- In Claude Code, run claude plugin marketplace add google/elephant-goldfish-model and then claude plugin install egm@egm .
- In Codex CLI, run codex plugin marketplace add google/elephant-goldfish-model and then codex plugin add egm@egm . In Antigravity CLI, run agy plugin install https://github.com/google/elephant-goldfish-model .
- Start a new session after installation.
- Try a first review by passing an existing document path, as in /egm:egm-review docs/designs/webhooks.md . In Codex, choose the relevant EGM skill from the skill picker.
What to weigh
- It is licensed under Apache-2.0.
- The project was created in September 2026, so command formats and settings may change. The README also notes that command prefix handling differs depending on the agy CLI version.
- Brainstorming and review require a session that can create new subagents, and review support varies by app.
- Initial setup (bootstrap) and document-code mismatch reports (drift report) apply only to software codebases.
Related terms and companies
Sources
Written with AI assistance from the repository README and GitHub data. Star counts and other numbers are GitHub values as of the date shown; features and licensing can change, so check the repository.