# Elephant-Goldfish Model: spec-first workflow pro Claude Code

> Elephant-Goldfish Model (EGM) od Googlu: nejdřív spec, pak revize čerstvými subagenty, až potom kód. Instalace pro Claude Code a Codex a kdy se vyplatí.

Canonical: https://aicko.cz/content/elephant-goldfish-model-spec-first-workflow-pro-claude-code
Last updated: 2026-11-18
Kategorie: Claude Code

Elephant-Goldfish Model (EGM) je open-source plugin od Googlu, který staví vývoj s AI agentem na jednoduchém pravidle: nejdřív napiš specifikaci, nech ji zkontrolovat agenty, kteří o tvém projektu nic nevědí, a teprve potom generuj kód. Funguje v [Claude Code](https://aicko.cz/content/t3-code-claude-code-a-codex-v-jedne-aplikaci-navod-2026) i v Codexu. V článku ukazuji, jak princip funguje, jak EGM nainstaluješ a kdy se ti spec-first postup vyplatí a kdy je zbytečně těžký.

## Co je Elephant-Goldfish Model

Když necháš jednoho agenta navrhnout řešení a pak ho požádáš, ať si vlastní návrh zkontroluje, najde málo. Má v kontextu všechna tvoje vysvětlení, takže si domýšlí, co jsi měl na mysli, a nevidí díry, které by si všiml každý nový člověk. EGM tenhle problém řeší rozdělením rolí. Podle [README repozitáře google/elephant-goldfish-model](https://github.com/google/elephant-goldfish-model) (stav k 9. 11. 2026) jsou role tři:

- **Elephant (slon)** drží kontext projektu, vede s tebou rozhovor a píše specifikaci. Slon nezapomíná.
- **Goldfish (zlatá rybka)** je čerstvý subagent bez paměti. Dostane jen dokument a zdrojové materiály, na které odkazuje, a hledá chybějící předpoklady, nejasné požadavky a rizika implementace.
- **Ty** rozhoduješ architektonické kompromisy a schvaluješ specifikaci, než se začne implementovat.

Hlavní myšlenka: kdo ví nejméně, ten nejlépe odhalí, co v dokumentu chybí. Repozitář vznikl 13. 9. 2026 pod licencí Apache 2.0 a README výslovně uvádí, že nejde o oficiálně podporovaný produkt Googlu. Vychází z eseje Davea Rensina, na který dokumentace odkazuje. Jde o ranou verzi: první tagovaný release v0.1.0 (27. 10. 2026) podle autorů ještě není připravený na označení „stabilní“ a [v0.1.1](https://github.com/google/elephant-goldfish-model/releases) ze 6. 11. 2026 přidala experimentální adaptéry pro Cursor, OpenCode a [GitHub Copilot](https://aicko.cz/content/github-copilot-v-jetbrains-air-lokalne-i-v-cloudu).

## Spec-first workflow v praxi: pět kroků

EGM nenutí jednu cestu, jednotlivé skilly můžeš používat mimo pořadí. Základní smyčka podle [dokumentace](https://github.com/google/elephant-goldfish-model/blob/main/docs/getting_started.md) vypadá takhle.

### 1. Brainstorm: /egm-brainstorm

Zadáš nápad, třeba „Přidej do projektu doručování webhooků“. Agent s tebou probere požadavky a kompromisy, čerstvé revizní subagenty jeho návrh zpochybní a dohodnutý směr se uloží do souboru `concepts_brief.md`. Typické otázky: co se stane při selhání doručení, nebo když stejná událost dorazí dvakrát?

### 2. Draft: /egm-draft

Skill převede brief na návrhový dokument `design_draft.md` po sekcích. Po každé sekci se zastaví a čeká na tvoji zpětnou vazbu v chatu. Schválené specifikace se doporučuje ukládat do `docs/designs/`.

### 3. Review: /egm-review

Tohle je jádro celého modelu. Review projde návrh ve více fázích v nulovém kontextu a kontroluje úplnost, srozumitelnost, soběstačnost dokumentu, soulad s kódem a implementační plán. Mezi fázemi jsou kontrolní body, kde sám rozhoduješ, co z nálezů opravit. Dokumentace upozorňuje, že zpětné vazby bude záměrně hodně: vezmi si, co dává smysl, zbytek ignoruj.

### 4. Lidská revize

EGM nenahrazuje lidský dohled. Doporučený krok je poslat návrh jako [pull request](https://aicko.cz/content/pull-request-ktery-se-vysvetli-sam-diagram-video-plan) kolegovi. Rybky zkontrolují dokument, ale neznají priority tvého produktu.

### 5. Implementace

Teprve teď řekneš agentovi, ať staví podle plánu. Instrukce k implementaci jsou součástí designového dokumentu. Když se agent splete jen v drobnosti, opravíš ji ručně nebo přes bodovou opravu. Když je výsledek úplně vedle, upravíš dokument a zkusíš to znovu. Spec je tedy zdroj pravdy, ne kód.

K tomu existují další skilly: `/egm-resolve` pro vyřešení nálezů, `/egm-bootstrap` pro vytvoření dokumentace existujícího kódu a `/egm-drift-report`, který porovná dokumenty s aktuálním kódem. Dokumentace doporučuje spouštět drift report jednou týdně.

## Instalace EGM v Claude Code a Codexu

Podle README se instalace dělá takto. V Claude Code:

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

V Codex CLI:

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

Po instalaci začni novou session. Instaluj celý plugin, ne jen složku `skills/`: skilly za běhu čtou persony revizorů a standardy dokumentů, takže samotné zkopírování skillů plugin rozbije.

Příkazy se liší podle hostitele. V Claude Code mají prefix `/egm:`, tedy `/egm:egm-brainstorm`, `/egm:egm-draft` a `/egm:egm-review`. V Codexu skill vybereš ze seznamu skillů. Plugin podporuje také Antigravity, [Claude Cowork](https://aicko.cz/content/claude-cowork-v-cloudu-co-se-meni-a-co-s-lokalnimi-soubory) a [ChatGPT Work](https://aicko.cz/content/chatgpt-work-navod-2026).

**Pozor:** brainstorm i review vyžadují session, která umí vytvořit čerstvé subagenty. Pokud je agent vytvořit neumí, EGM review zastaví a nespustí ho ve stejném kontextu. Pro ověřenou izolaci v Claude Code dokumentace uvádí verzi 2.1.271 nebo novější. Starší verze nepovažuje za ověřené prostředí pro goldfish revize.

## Jak EGM drží rybky opravdu bez paměti

Čerstvý kontext není totéž co žádné instrukce. Dokumentace to přiznává otevřeně. V Claude Code mají revizní adaptéry nastaveno `omitClaudeMd: true` a pouze čtecí nástroje (Read, Grep, Glob), takže rybka nedostane tvůj `CLAUDE.md`. U Codexu a Antigravity je situace horší: otevřený [issue č. 237](https://github.com/google/elephant-goldfish-model/issues/237) hlásí, že Codex revizorům předává projektový i uživatelský `AGENTS.md` (i s nastavením `fork_turns: "none"`) a Antigravity `AGENTS.md` a `GEMINI.md`. Izolace konverzace tedy funguje, izolace instrukčních souborů ne vždy.

Praktický důsledek: pravidla, která mají rybky zpochybnit, nepiš jen do `CLAUDE.md` nebo `AGENTS.md`. Napiš je jako explicitní kritéria revize. Víc o tom, co do těchto souborů patří, najdeš v článku [AGENTS.md: jak naučit AI coding agenta tvým pravidlům](https://aicko.cz/content/agents-md-jak-nastavit-ai-coding-agenta). Izolace je navíc jen kontextová a nástrojová, ne souborová: revizoři mohou číst soubory v repozitáři.

## Čím se EGM liší od jiných spec-driven nástrojů

Specifikaci před kódem prosazují i další nástroje. [Kiro od AWS](https://aicko.cz/content/kiro-spec-driven-vyvoj-aws) vede specifikaci jako součást IDE a [GitHub Spec Kit](https://aicko.cz/content/spec-driven-development-github-spec-kit-navod) dává šablony a příkazy pro tvorbu specifikace a úkolů. EGM se od nich liší tím, že těžiště leží v nezávislé revizi. Specifikaci nekontroluje ten, kdo ji psal, ale agenti bez kontextu, a tebe nechává u rozhodnutí.

Pokud znáš [subagenty v Claude Code](https://aicko.cz/content/claude-code-subagenti), je EGM v podstatě jejich organizovaná aplikace: subagent s čistým kontextem je přesně to, co goldfish potřebuje. Rozdíl je v tom, že hotové persony, fáze a kontrolní body dostaneš v balíčku místo vlastního sestavování.

## Kdy se spec-first s EGM vyplatí a kdy ne

Dokumentace sama říká, že design-first proces nemáš používat násilím. Z toho, co jsem v ní četl, vychází tohle rozlišení:

- **Vyplatí se:** nová funkce s rozhodnutími (chyby, duplicity, migrace), změna napříč více moduly, práce ve více lidech, kde spec slouží jako podklad pro pull request.
- **Nevyplatí se:** jednořádková oprava, kosmetika, zřejmý bug. Tam stačí agentovi říct, co má změnit.
- **Cena:** každé review spouští několik subagentů, takže spotřebuje kvótu hostitelského modelu. U malých úkolů se ti to nevrátí.
- **Limit:** review nenahrazuje testy ani lidský úsudek. Kritika od agentů bez kontextu je vodítko, ne verdikt.

Obecné nevýhody psaní specifikací před kódem rozebírá článek [Spec-driven development: nevýhody a co dělat místo toho](https://aicko.cz/content/spec-driven-development-nevyhody-co-delat-misto-toho). Přečti si ho dřív, než EGM nasadíš na celý tým.

Upřímně: tento článek vychází z četby README a dokumentace repozitáře, EGM jsem na vlastním projektu neprojel celý. Čísla o spotřebě kvóty ani kvalitě nálezů proto neuvádím. Vyzkoušej ho na jedné funkci, u které víš, že se v ní skrývá několik nejasných rozhodnutí, a porovnej nálezy rybek se svým vlastním přehledem.

## Jak začít na jedné funkci

1. Nainstaluj plugin a ověř, že máš Claude Code 2.1.271 nebo novější (nebo Codex se subagenty).
2. Vyber funkci s nejasnými hranicemi, ne triviální změnu.
3. Spusť `/egm:egm-brainstorm` s jednou větou zadání a odpověz na doplňující otázky.
4. Nech vzniknout `design_draft.md`, každou sekci přečti a oprav.
5. Spusť `/egm:egm-review`, projdi nálezy a u každého rozhodni: opravit, ignorovat, probrat s kolegou.
6. Až potom zadej implementaci a sleduj, o kolik méně oprav přijde po kódu.

## Příklad: co by rybka našla ve specifikaci webhooků

Ilustrační příklad, ne výstup z mého testu. Slon napíše specifikaci „při selhání doručení opakuj s odstupem“. Rybka bez konverzace si přečte jen dokument a zeptá se: kolikrát se opakuje a s jakým odstupem? Co se stane s událostmi, které selhaly pokaždé? Jak příjemce pozná duplicitu? Slon tyhle odpovědi „věděl“ z rozhovoru, ale do dokumentu je nenapsal. Přesně takové mezery rybka odhalí dřív, než z nich agent při implementaci udělá nechtěné chování.

Z toho plyne i pravidlo pro tvoje vlastní specifikace: dokument musí být soběstačný. Pokud mu rozumí jen ten, kdo byl u rozhovoru, nepřežije ani předání kolegovi, ani další session agenta za měsíc.

## Časté otázky

### Co je Elephant-Goldfish Model?

Open-source plugin od Googlu pro AI coding agenty. Slon (agent s kontextem) píše specifikaci, goldfish revizoři (čerstvé subagenty bez konverzace) ji kontrolují a ty ji schvaluješ před implementací. Podle README nejde o oficiálně podporovaný produkt Googlu.

### Funguje EGM v Claude Code i v Codexu?

Ano. Pro Claude Code použiješ `claude plugin marketplace add google/elephant-goldfish-model` a `claude plugin install egm@egm`, pro Codex CLI `codex plugin marketplace add google/elephant-goldfish-model` a `codex plugin add egm@egm`. Podporované jsou i Antigravity, Claude Cowork a ChatGPT Work.

### Musím použít celý postup brainstorm, draft, review?

Ne. Skilly můžeš volat samostatně a v libovolném pořadí. Dokumentace dokonce doporučuje jednoduché opravy nechat agentovi bez návrhového procesu.

### Proč review nefunguje v mém prostředí?

Review vyžaduje hostitele, který umí vytvořit subagenty s čerstvým kontextem. Když to nejde, EGM review zastaví. V Claude Code ověřuj verzi 2.1.271 a novější, v Codexu zkontroluj, jestli session nabízí nástroje pro spuštění subagentů.

### Nahradí EGM testy a code review?

Ne. Dokumentace výslovně říká, že review specifikace nenahrazuje testy ani lidský úsudek a doporučuje poslat návrh ke kontrole kolegovi.

## Related

- [Obsah: Claude Code](https://aicko.cz/obsah/claude-code)
- [ChatGPT](https://aicko.cz/ai-tools/chatgpt)
- [Claude AI](https://aicko.cz/ai-tools/claude)
- [GitHub Copilot](https://aicko.cz/ai-tools/github-copilot)
- [OpenCode](https://aicko.cz/ai-tools/opencode)
- [Cursor](https://aicko.cz/ai-tools/cursor)

---
Zdroj: AIčko.cz. Při citaci uveďte název webu a odkaz na https://aicko.cz/content/elephant-goldfish-model-spec-first-workflow-pro-claude-code
