Elephant-Goldfish Model là gì: Google dạy AI review thiết kế

Thử hình dung thế này. Anh chị nhờ AI viết bản thiết kế cho một tính năng mới, ngồi trò chuyện với nó cả buổi sáng. Đến chiều, anh chị nhờ chính AI đó đọc lại bản thiết kế và báo lỗi. Nó khen nhiều hơn chê, vì nó nhớ rõ từng lý do mà hai bên đã bàn, nên mọi chỗ mơ hồ đều "hợp lý" trong đầu nó.

Người ngoài đọc bản đó thì khác: họ thấy ngay chỗ thiếu. Elephant-Goldfish Model là gì? Elephant-Goldfish Model (viết tắt EGM) là plugin mã nguồn mở của Google cho các agent lập trình như Claude Code, Codex và Antigravity, dùng để soạn bản thiết kế phần mềm bằng một agent nhớ hết ngữ cảnh rồi giao cho các reviewer không biết gì về cuộc trò chuyện trước đó soát lại.

Đọc nhanh trong 30 giây

• Là repo google/elephant-goldfish-model, giấy phép Apache 2.0, ghi rõ "không phải sản phẩm được Google hỗ trợ chính thức".
• Chia việc làm ba vai: Elephant nhớ ngữ cảnh và viết đặc tả, Goldfish review với ngữ cảnh trống, con người duyệt rồi mới cho code.
• Cài cho Claude Code bằng hai lệnh claude plugin marketplace add và claude plugin install.
• Hợp với đội đã dùng agent lập trình và muốn có tài liệu thiết kế được soát trước khi viết code.
• Đánh giá nhanh: ý tưởng gọn, nhiều agent được hỗ trợ, có bản phát hành; nhưng repo mới hơn hai tháng tuổi, phiên bản 0.1.x và còn 35 pull request đang chờ.

Elephant-Goldfish Model là gì, dùng vào việc gì?

EGM dùng để biến việc viết đặc tả thiết kế thành một quy trình có người soát độc lập, ngay trong agent lập trình anh chị đang dùng. README mô tả ba vai: Elephant giữ ngữ cảnh dự án và viết bản nháp, Goldfish là các reviewer chỉ nhận tài liệu cùng mã nguồn được dẫn tới, còn con người quyết định đánh đổi và duyệt đặc tả trước khi triển khai.

Tên gọi xuất phát từ hai con vật: voi nhớ mọi thứ, cá vàng thì "quên" hết mỗi lần nhìn lại. Ở đây cái quên là lợi thế. Hình dung một kiến trúc sư trưởng và một đoàn thẩm định bên ngoài: kiến trúc sư đã sống cùng dự án ba tháng nên khó thấy lỗ hổng của chính mình, còn đoàn thẩm định cầm bản vẽ và hiện trạng lên đọc như người lạ.

Vai trò lấy từ bảng "How it works" trong README của google/elephant-goldfish-model.

README nói rõ quy trình dựng sẵn nhắm vào đặc tả phần mềm. Với tài liệu loại khác, anh chị tự chọn reviewer và tiêu chuẩn qua lệnh /egm-review-loop. Phần bootstrap và báo cáo lệch (drift) chỉ áp dụng cho codebase.

Repo đi kèm bảy skill, dùng lẻ hay nối tiếp đều được:

Quy trình thiết kế của EGM gồm những bước nào?

Quy trình mẫu trong README gồm bốn bước: brainstorm, draft, review rồi duyệt. Ví dụ trong README là thêm tính năng gửi webhook cho một dự án, với câu hỏi khó như "nếu lần gửi thất bại, hoặc cùng một sự kiện đến hai lần thì sao".

Quy trình và tên file lấy từ README.

1. Brainstorm: bàn yêu cầu và đánh đổi với agent, reviewer mới phản biện đề xuất, hướng đã chốt được lưu vào concepts_brief.md.
2. Draft: agent viết design_draft.md, dừng sau từng phần để anh chị góp ý ngay trong chat.
3. Review: reviewer mới soát thiết kế, độ rõ ràng, độ khớp với code và kế hoạch triển khai. Anh chị chọn phát hiện nào cần sửa.
4. Duyệt: khi đồng ý với thiết kế, anh chị nhờ agent triển khai. Đặc tả đã duyệt nên lưu trong docs/designs/.

Cài Elephant-Goldfish Model cho Claude Code

Cài EGM cho Claude Code cần hai lệnh, chép đúng từ README, rồi mở phiên mới:

Minh họa dựng lại theo README.

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

Với Codex CLI, README dùng codex plugin marketplace add google/elephant-goldfish-model rồi codex plugin add egm@egm. Với Antigravity CLI là agy plugin install https://github.com/google/elephant-goldfish-model. Bản Codex và ChatGPT trên máy tính có trang plugin riêng, Claude Cowork và ChatGPT Work thì xem hướng dẫn trong docs/harnesses.md.

Mẹo

Chưa có đặc tả nào để thử? Dùng bài kiểm tra 60 giây trong README: đưa một tài liệu thiết kế hoặc kế hoạch PR có sẵn cho /egm:egm-review docs/designs/webhooks.md, hoặc chạy /egm:egm-drift-report docs/designs/ để xem tài liệu nào đã lệch khỏi code. Không phải viết gì mới.

Lưu ý

Với Claude Code và Antigravity, lệnh phải có tiền tố /egm:. README ghi một lỗi đã biết: trên agy CLI 1.4.8 tên không tiền tố không tự hoàn thành, nên cứ gõ đủ tiền tố. Phiên làm việc còn phải tạo được agent con mới; không tạo được thì EGM dừng review thay vì review qua loa.

Ví dụ dùng thực tế

Việc 1: soát kế hoạch trước khi giao cho agent code. Một đội nội bộ sắp nhờ agent viết chức năng nhắc việc tự động. Trưởng nhóm chạy /egm:egm-brainstorm với mô tả ngắn, trả lời các câu hỏi về ràng buộc, rồi /egm:egm-draft. Trước khi cho code, bước /egm:egm-review giúp phát hiện những điều chưa ai nói ra, ví dụ chuyện gì xảy ra khi người dùng nhận hai thông báo trùng. Đây là cách dùng minh họa theo quy trình README, không phải số liệu thực tế của dự án nào.

Việc 2: kiểm tra tài liệu có còn đúng không. Dự án đã chạy một năm, thư mục docs/designs/ chưa ai đụng. Chạy /egm:egm-drift-report docs/designs/ để agent so từng tài liệu với mã nguồn hiện tại, rồi anh chị quyết định sửa tài liệu hay sửa code.

Muốn tìm hiểu cách chia việc cho nhiều agent chạy song song, đọc thêm bài Worktrunk là gì. Nếu quan tâm khía cạnh soát lỗi bảo mật bằng agent độc lập, có bài Security Audit Skill.

Elephant-Goldfish Model có đáng tin không? Soi nhanh trên GitHub

EGM có 19,2 nghìn sao sau chưa đầy hai tháng, nhưng số sao chỉ cho biết repo đang được chú ý. Giống một quán mới mở có hàng dài người xếp hàng: xếp hàng đông cho biết quán nổi, chưa cho biết bếp có giữ được chất lượng mỗi ngày.

Trang repo trên GitHub, chụp ngày 15/11/2026.

Số liệu tra bằng GitHub API và ảnh chụp ngày 15/11/2026.

Góc nhìn phản biện

Cảnh báo

• Repo còn non. Phiên bản 0.1.x, mới hơn hai tháng tuổi, README còn ghi các lỗi tương thích theo từng bản agy CLI. Cố định một bản phát hành khi dùng cho đội, không cập nhật liên tục.
• Không phải sản phẩm chính thức của Google. README ghi rõ điều này. Đừng coi nó là cam kết hỗ trợ, và đừng đưa vào quy trình bắt buộc khi chưa có người nắm.
• Review không thay thế test hay người. README viết rằng một lần review không thay cho kiểm thử và phán đoán của con người. Giữ bước người duyệt trước khi cho agent code.
• Tốn lượt dùng. Mỗi lần review mở nhiều agent con với ngữ cảnh mới; README không nêu chi phí. Thử trên một tài liệu ngắn để ước lượng gói AI của đội.
• Tài liệu gửi cho reviewer là dữ liệu thật. Bản thiết kế và mã nguồn được đưa cho agent con, nên đừng để lộ khóa API hay dữ liệu khách hàng trong tài liệu.

Dùng EGM giống thuê một đoàn thẩm định bên ngoài: họ giúp phát hiện điều anh chị đã quen mắt, nhưng chữ ký duyệt bản vẽ vẫn là của anh chị.

Câu hỏi thường gặp

Elephant-Goldfish Model có miễn phí không?

EGM là mã nguồn mở, giấy phép Apache 2.0. Chi phí phát sinh là lượt dùng model của agent lập trình chạy plugin; README không nêu con số.

EGM dùng được với agent nào?

README có hướng dẫn cài cho Claude Code, Codex CLI, Antigravity (CLI, ứng dụng và tiện ích cho IDE), ứng dụng Codex và ChatGPT trên máy tính, cùng Claude Cowork và ChatGPT Work. Điều kiện chung là phiên làm việc tạo được agent con mới.

EGM có tự viết code không?

Không. EGM dừng ở bản đặc tả đã duyệt. Việc triển khai do anh chị nhờ agent lập trình làm sau đó, theo đúng README.

Tại sao reviewer phải "quên" cuộc trò chuyện?

Vì reviewer chỉ đọc tài liệu và mã nguồn được dẫn tới nên không bị cuốn theo lý do hai bên đã bàn. Theo README, cách này giúp lộ ra giả định ngầm và điểm mù.

Nhận xét của chuyên gia

Khi đào tạo AI cho đội kỹ thuật doanh nghiệp, lỗi tôi gặp nhiều nhất không phải AI viết code sai, mà là yêu cầu chưa rõ đã được giao cho AI làm. EGM đánh đúng chỗ đó: đưa tài liệu thiết kế qua một bước soát độc lập trước khi tốn công viết code.

Hợp với ai: đội phần mềm đã dùng Claude Code, Codex hoặc Antigravity; người làm sản phẩm hay giao việc cho agent và muốn có bản đặc tả rõ ràng; đội có thư mục tài liệu thiết kế dễ bị lỗi thời.

Chưa hợp với ai: người chỉ chat AI trên web; dự án nhỏ làm một lần rồi bỏ; đội cần công cụ có hỗ trợ chính thức và cam kết bảo trì.

Cách bắt đầu của tôi: cài plugin, chạy bài thử 60 giây của README trên một tài liệu thiết kế có sẵn, đọc các góp ý của reviewer rồi so với hiểu biết của đội. Có ích thì mới dùng trọn quy trình cho một tính năng thật.

Một câu để nhớ: người viết bản thiết kế là người khó thấy lỗi của nó nhất, nên cần một người đọc chưa từng nghe câu chuyện.

Nguồn: Google, elephant-goldfish-model README, 15/11/2026. Bài gốc của ý tưởng: Dave Rensin, Elephants, Goldfish, and the New Golden Age of Software Engineering. Ngày tra nguồn: 15/11/2026.