Design Drift Report
Compares design docs and READMEs against source code and writes a report of mismatches.
- Repository
- google/elephant-goldfish-model
- Stars
- 9,965
- Licence
- Apache-2.0
- Files
- 2 files
What it does
When you ask, the agent reads every design document or README in a folder, finds the code those documents describe, and checks whether the code has drifted away from the written spec. It looks for missing features, missing fields, hardcoded values where logic was planned, and different libraries or patterns than proposed. It then saves a dated markdown report listing only the differences, or 'No drift detected' for each document.
Great for
- Engineering teams who keep design docs or READMEs alongside code and want to catch stale specs
- Reviewers preparing for a release who want a quick consistency check across many docs
Skip it if
- Projects with no written design docs, since there is nothing to compare against
- Situations needing a verified audit: the agent's judgement can miss or invent differences, so results need human review
Try asking
- “Check all design docs in docs/designs for drift against the current source code”
- “Detect drift between the READMEs in this monorepo and their implementations”
- “Write a drift report for the design documents in ./specs and tell me which ones have no drift”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 2 original files, the Apache-2.0 licence and an attribution note.
egm-drift-report.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip egm-drift-report.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip egm-drift-report.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- Point the agent at a specific design directory and say which source tree to compare against
- Add links from each design doc to its source files so future checks are faster and more accurate
- Review the generated DRIFT_REPORT.md yourself before acting on it, since findings are model-generated
What's inside
- agents/openai.yaml
- SKILL.md
Redistributed unmodified from google/elephant-goldfish-model under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-11-02. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.