# google/elephant-goldfish-model

> elephant-goldfish-model is an open-source plugin for AI coding assistants that drafts software specifications and checks design documents with fresh reviewers. Its core idea is to split the work: an Elephant agent holds the project context and drafts the specification, Goldfish reviewers examine the draft and its referenced source material without the earlier conversation, and the developer makes the trade-offs and approves the design before implementation. The project is written mainly in Python, and its website is built with Astro.

Source: https://github.com/google/elephant-goldfish-model
Indexed: commit 70406c4 on 2026-11-20 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Library
- Language: Python
- Stars: 22,014 at index time
- License: Apache-2.0
- Code health: 7.4/10, Good
- Last commit: 2026-11-18
- Contributors: 37

## Install

From the README: https://github.com/google/elephant-goldfish-model#install

Claude Code:

Add the EGM plugin marketplace to Claude Code.
    claude plugin marketplace add google/elephant-goldfish-model

Install the egm plugin.
    claude plugin install egm@egm

## How to use

Run a review of an existing design document.
    /egm:egm-review docs/designs/webhooks.md

## How it works

The plugin is installed into Claude Code, Codex CLI or Antigravity, and its agent definitions live in the .claude-plugin/agents directory, including design_critic.md and bootstrap_orchestrator.md. The file .agents/plugins/marketplace.json registers the plugin so that agents can install it. Reviews run in fresh subagent contexts that receive the document and its referenced source material but not the earlier conversation, and EGM stops the review if the agent cannot create those contexts. The scripts directory builds the Claude and OpenAI runtime ZIP files for a release and writes their SHA-256 checksums and draft release notes into a new folder. The site directory holds the egm.dev website, and the tests directory holds the project checks, including an integration setup under tests/integration/opencode-ci.

- .agents/plugins/marketplace.json: central file
- .claude-plugin/agents/bootstrap_orchestrator.md: central file
- .claude-plugin/agents/codebase_details.md: central file
- .claude-plugin/agents/comprehension.md: central file
- .claude-plugin/agents/design_critic.md: central file
Modules: site, tests, scripts, .github, adapters. 240 files, 7,916 lines, 454 symbols.

## Code health

- Score: 7.4/10 (Good)
- Rank: #116 of 4,000+ indexed repos
- Hotspots: site/src/layouts/Base.astro, site/src/components/Footer.astro
- Lowest file: .github/scripts/review_pr.py
- Dead code: none found

## Maintenance

- Last commit 2026-11-18, first commit 2026-10-21, 192 commits
- 37 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/google/elephant-goldfish-model/security

## More

- Page: https://repowise.dev/repo/google/elephant-goldfish-model
- Ask this codebase: https://repowise.dev/repo/google/elephant-goldfish-model/chat
- Docs: https://repowise.dev/repo/google/elephant-goldfish-model/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/google/elephant-goldfish-model
