A set of production-grade engineering workflow skills, packaged as Markdown, that guide AI coding agents through spec, plan, build, test, review, and ship.
google/elephant-goldfish-model
An open-source agent plugin for designing software: an agent drafts specs, then fresh zero-context subagents review them before any code is written.
- Stars
- 13,669
- Forks
- 1,013
- Open issues
- 51
- Last commit
- yesterday
What is it?
EGM (Elephant-Goldfish Model) is a plugin for coding agents such as Claude Code, Codex and Antigravity that adds a structured workflow for designing features before implementation. A deep-context "elephant" agent, which holds the project's background and earlier decisions, explores the problem and drafts a specification. Then "goldfish" reviewers, which start with fresh context and see only the document and its referenced source material, look for unstated assumptions, unclear requirements and implementation risks.
The human stays in charge of trade-offs: the developer resolves the findings, approves the design, and then asks the agent to implement it. The project provides skills for brainstorming, drafting, reviewing, resolving review findings, bootstrapping documentation for an existing codebase, and reporting drift between documents and source code. Reviews require a session that can create fresh subagents; otherwise the review stops.
Key features
- 01Drafts design specifications with a context-rich agent, pausing for feedback after each section.
- 02Runs reviews with fresh subagents that see only the document and referenced source material.
- 03Covers five review stages, checking design, clarity, code fit and implementation plan.
- 04Includes a drift report that compares checked-in documents with current source code.
- 05Works with Antigravity, Claude Code and Codex through their plugin systems.
Use cases
- Designing a feature that needs architectural decisions before any code is written.
- Stress-testing a spec for hidden assumptions before handing it to a coding agent.
- Writing documentation for an existing codebase and checking it for drift over time.
Quick start
- 1
Add the plugin marketplace in Claude Code
claude plugin marketplace add google/elephant-goldfish-model - 2
Install the EGM plugin
claude plugin install egm@egm - 3
Start a new session, then run the brainstorm skill on a feature that needs design decisions
/egm:egm-brainstorm
Things to know
- Goldfish reviews require an agent that can create fresh subagent contexts; otherwise EGM stops the review.
- A review does not replace tests or human judgment, and EGM is not an officially supported Google product.
In collections
Topics
FAQ
- What is elephant-goldfish-model?
- An open-source agent plugin for designing software: an agent drafts specs, then fresh zero-context subagents review them before any code is written. EGM (Elephant-Goldfish Model) is a plugin for coding agents such as Claude Code, Codex and Antigravity that adds a structured workflow for designing features before implementation. A deep-context "elephant" agent, which holds the project's background and earlier decisions, explores the problem and drafts a specification. Then "goldfish" reviewers, which start with fresh context and see only the document and its referenced source material, look for unstated assumptions, unclear requirements and implementation risks.
- Is elephant-goldfish-model free to use? What license does it have?
- elephant-goldfish-model is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is elephant-goldfish-model still maintained?
- Actively maintained. The last commit to elephant-goldfish-model was on Nov 7, 2026.
- What can I use elephant-goldfish-model for?
- Designing a feature that needs architectural decisions before any code is written. Stress-testing a spec for hidden assumptions before handing it to a coding agent. Writing documentation for an existing codebase and checking it for drift over time.
- How do I install elephant-goldfish-model?
- Add the plugin marketplace in Claude Code: claude plugin marketplace add google/elephant-goldfish-model Install the EGM plugin: claude plugin install egm@egm Start a new session, then run the brainstorm skill on a feature that needs design decisions: /egm:egm-brainstorm
- Where can I get elephant-goldfish-model?
- The source code and installation instructions are on GitHub: https://github.com/google/elephant-goldfish-model
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A set of Docker-authored skill files that teach AI coding agents how to build, test, debug and optimize containerized apps.
Plain-language agent skills for Claude Code, Codex CLI, Cursor CLI and Gemini CLI that turn session reports into a one-screen verdict anyone can follow.
A prompt-based skill that makes AI coding agents write only the code a task needs, favoring reuse and minimal solutions over large implementations.
Claude Code plugins that run planned, approved workflows for implementing, designing, reviewing and verifying code changes.
Configures AI coding agents like Claude Code, Cursor, OpenCode and Codex with persistent memory, shared workflows, skills and MCP servers.