Skip to content
Back to search

egm

MarketplaceWorks with Claude CodeOfficial: GoogleGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/google--elephant-goldfish-model/badge.svg)](/listings/google--elephant-goldfish-model)

HTML

<a href="/listings/google--elephant-goldfish-model"><img src="/api/listings/google--elephant-goldfish-model/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Choose your coding agent. Install the complete plugin so its skills can read the reviewer prompts and document standards.

ChatGPT and Codex desktop

Open the [published EGM plugin](https://chatgpt.com/plugins/plugins_6aeb90f47ec88191a3c107e01d3eb357) in the desktop app and install it. This listing is desktop-only. For Codex CLI, use the commands below.

Antigravity CLI

agy plugin install https://github.com/google/elephant-goldfish-model

For the **Antigravity App** and **Antigravity for IDEs** (Visual Studio Code extension), run `/plugin` or see the [installation instructions](docs/harnesses.md#antigravity-app-and-antigravity-for-ides).

Claude Code

claude plugin marketplace add google/elephant-goldfish-model
claude plugin install egm@egm

Codex CLI

codex plugin marketplace add google/elephant-goldfish-model
codex plugin add egm@egm

Start a new session after installation. For **Claude Cowork** and **ChatGPT Work**, see the [setup guide](docs/harnesses.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 18 lines
  1. {
  2. "name": "egm",
  3. "owner": {
  4. "name": "Google LLC"
  5. },
  6. "plugins": [
  7. {
  8. "name": "egm",
  9. "source": "./",
  10. "description": "Develop ideas with context and review documents with fresh eyes.",
  11. "author": {
  12. "name": "Google LLC"
  13. },
  14. "category": "development",
  15. "homepage": "https://egm.dev"
  16. }
  17. ]
  18. }
README.md · README · 158 lines
  1. <p align="center">
  2. <a href="https://egm.dev"><img src="docs/assets/readme-header.svg" width="480" height="116" alt="Elephant-Goldfish Model"></a>
  3. </p>
  4. <p align="center">Design with an elephant. Review with a goldfish.</p>
  5. <p align="center">
  6. <a href="#install">Install</a> &ensp;·&ensp;
  7. <a href="#try-your-first-design">Quickstart</a> &ensp;·&ensp;
  8. <a href="docs/getting_started.md">Documentation</a> &ensp;·&ensp;
  9. <a href="https://egm.dev">Website</a>
  10. </p>
  11. <br>
  12. Develop ideas with context and review documents with fresh eyes. EGM is an open-source plugin for AI assistants.
  13. **Elephant** holds your project context and drafts the specification. **Goldfish** reviewers examine the draft and referenced source material without the earlier conversation, helping expose unstated assumptions and blind spots. **You** make the architectural trade-offs and approve the specification before implementing.
  14. The built-in draft and design-review workflow targets software specifications. For other documents, choose reviewers and standards with `/egm-review-loop`. Bootstrap and drift reporting apply to software codebases.
  15. https://github.com/user-attachments/assets/93c799a2-10a3-4266-af02-eb79dd33a9a2
  16. ## Install
  17. Choose your coding agent. Install the complete plugin so its skills can read the reviewer prompts and document standards.
  18. ### ChatGPT and Codex desktop
  19. Open the [published EGM plugin](https://chatgpt.com/plugins/plugins_6aeb90f47ec88191a3c107e01d3eb357) in the desktop app and install it. This listing is desktop-only. For Codex CLI, use the commands below.
  20. ### Antigravity CLI
  21. ```sh
  22. agy plugin install https://github.com/google/elephant-goldfish-model
  23. ```
  24. For the **Antigravity App** and **Antigravity for IDEs** (Visual Studio Code extension), run `/plugin` or see the [installation instructions](docs/harnesses.md#antigravity-app-and-antigravity-for-ides).
  25. ### Claude Code
  26. ```sh
  27. claude plugin marketplace add google/elephant-goldfish-model
  28. claude plugin install egm@egm
  29. ```
  30. ### Codex CLI
  31. ```sh
  32. codex plugin marketplace add google/elephant-goldfish-model
  33. codex plugin add egm@egm
  34. ```
  35. Start a new session after installation. For **Claude Cowork** and **ChatGPT Work**, see the [setup guide](docs/harnesses.md).
  36. ## Try a 60-second review on existing code
  37. Review an existing design document, README, or PR plan against the live code. You do not need to write a new specification. The commands below use the `/egm:` prefix for Antigravity (agy CLI) and Claude Code. In Codex, select the corresponding EGM skill from the skill picker.
  38. <img src="skills/egm-review/assets/icon.svg" width="20" height="20" align="top" alt=""> **Review an existing document**
  39. ```text
  40. /egm:egm-review docs/designs/webhooks.md
  41. ```
  42. Use the path to your design doc, or to a PR plan saved as Markdown. Fresh reviewers check the design, its clarity, its fit with the code, and its implementation plan.
  43. <img src="skills/egm-drift-report/assets/icon.svg" width="20" height="20" align="top" alt=""> **Check for drift**
  44. ```text
  45. /egm:egm-drift-report docs/designs/
  46. ```
  47. The agent compares each document in the folder with the current source code and reports where they diverge. You decide whether to update the document or the code.
  48. ## Try your first design
  49. Open your project in your coding agent and choose a feature that needs design decisions. This example adds webhook delivery: what should happen when a delivery fails, or the same event arrives twice?
  50. The commands below are shown without a prefix. In Antigravity (agy CLI) and Claude Code, add the `/egm:` prefix, for example `/egm:egm-brainstorm`. On agy CLI 1.4.10 an unprefixed name is completed to the prefixed command ([#220](https://github.com/google/elephant-goldfish-model/issues/220)), but 1.4.8 does not ([#196](https://github.com/google/elephant-goldfish-model/issues/196)), so keep the prefix. In Codex, select the corresponding EGM skill from the skill picker. Brainstorming and review require a session that can create fresh subagents.
  51. <img src="skills/egm-brainstorm/assets/icon.svg" width="20" height="20" align="top" alt=""> **Explore the idea**
  52. ```text
  53. /egm-brainstorm Add webhook delivery to this project.
  54. ```
  55. Discuss requirements and trade-offs with the agent. Fresh reviewers challenge the proposal, and the agent saves the agreed direction in `concepts_brief.md`.
  56. <img src="skills/egm-draft/assets/icon.svg" width="20" height="20" align="top" alt=""> **Draft the specification**
  57. ```text
  58. /egm-draft
  59. ```
  60. The agent turns the brief into `design_draft.md`, pausing after each section for your feedback in chat.
  61. <img src="skills/egm-review/assets/icon.svg" width="20" height="20" align="top" alt=""> **Review the draft**
  62. ```text
  63. /egm-review design_draft.md
  64. ```
  65. Use the draft path returned by the agent.
  66. Fresh reviewers check the design, its clarity, its fit with the code, and its implementation plan. Choose which findings to address. When you approve the design, ask your coding agent to implement it.
  67. See the [workflow guide](docs/getting_started.md) for the full process, including saving approved specifications under `docs/designs/`.
  68. ## How it works
  69. <table>
  70. <thead><tr><th align="left">Role</th><th align="left">Context</th><th align="left">Responsibility</th></tr></thead>
  71. <tbody>
  72. <tr valign="top"><td><strong>Elephant</strong></td><td>Your project, requirements, and earlier decisions</td><td>Explore the problem and draft the specification.</td></tr>
  73. <tr valign="top"><td><strong>Goldfish</strong></td><td>The document and its referenced source material, without the earlier conversation</td><td>Find missing assumptions, unclear requirements, and implementation risks.</td></tr>
  74. <tr valign="top"><td><strong>You</strong></td><td>The goals and constraints that matter</td><td>Resolve trade-offs, approve the design, and decide what to build.</td></tr>
  75. </tbody>
  76. </table>
  77. Goldfish reviews require fresh subagent contexts. If your agent cannot create them, EGM stops the review. A review does not replace tests or human judgment. See [supported environments and verification limits](docs/harnesses.md#support-status--contributing-other-harnesses).
  78. ## Choose a skill
  79. You can use each skill when you need it. You do not have to follow the full sequence.
  80. <table>
  81. <thead><tr><th align="left">Skill</th><th align="left">Use it to…</th></tr></thead>
  82. <tbody>
  83. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-brainstorm/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-brainstorm/SKILL.md">Brainstorm</a></td><td>Test an idea and write a concept brief.</td></tr>
  84. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-draft/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-draft/SKILL.md">Draft</a></td><td>Turn a brief or existing notes into a design document.</td></tr>
  85. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-resolve/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-resolve/SKILL.md">Resolve</a></td><td>Work through review findings and agree on changes.</td></tr>
  86. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-bootstrap/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-bootstrap/SKILL.md">Bootstrap</a></td><td>Create or update documentation for an existing codebase.</td></tr>
  87. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-lite/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-lite/SKILL.md">Lite</a></td><td>Fast-track small iterations, spec revisions, refactors, and bug fixes.</td></tr>
  88. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-review/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-review/SKILL.md">Review</a></td><td>Review a design with fresh agents across five stages.</td></tr>
  89. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-review-loop/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-review-loop/SKILL.md">Review&nbsp;loop</a></td><td>Run a configured group of reviewers for a specific review task.</td></tr>
  90. <tr valign="top"><td width="160" valign="top"><img src="skills/egm-drift-report/assets/icon.svg" width="20" height="20" alt="" align="top">&nbsp;<a href="skills/egm-drift-report/SKILL.md">Drift&nbsp;report</a></td><td>Compare checked-in documents with the current source code.</td></tr>
  91. </tbody>
  92. </table>
  93. ## Learn more
  94. - [Getting started](docs/getting_started.md): the workflow and project layout.
  95. - [Setup](docs/harnesses.md): installation, agent capabilities, and known limits.
  96. - [Architecture](https://github.com/google/elephant-goldfish-model/blob/main/docs/designs/architecture.md): how skills and reviewers fit together.
  97. - [Testing](https://github.com/google/elephant-goldfish-model/blob/main/TESTING.md): checks, execution records, and verification limits.
  98. - [Dave Rensin’s original essay](https://medium.com/@drensin/elephants-goldfish-and-the-new-golden-age-of-software-engineering-c33641a48874): the ideas behind EGM.
  99. ## Contribute
  100. See the [accessibility statement](https://github.com/google/elephant-goldfish-model/blob/main/ACCESSIBILITY.md)
  101. for accessibility goals, known limits, and how to report barriers.
  102. Read [contributing](https://github.com/google/elephant-goldfish-model/blob/main/CONTRIBUTING.md) for PRs, [issues](https://github.com/google/elephant-goldfish-model/issues) for bugs, and [discussions](https://github.com/google/elephant-goldfish-model/discussions) for questions.
  103. ## License
  104. [Apache 2.0](LICENSE). This is not an officially supported Google product.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.