Unify Agent Docs
- Updated June 14, 2026
- shanemhamilton/unify-agent-docs
unify-agent-docs is a Claude Code plugin that consolidates CLAUDE.md, AGENTS.md, and GEMINI.md behind one canonical source per directory so developers can keep multi-agent instruction files synchronized without manual co
About
unify-agent-docs is a Claude Code marketplace plugin that keeps AI-agent instruction files from drifting across Claude Code, Codex, Cursor, and Gemini. It merges CLAUDE.md, AGENTS.md, and GEMINI.md into one canonical file per directory, replaces the others with symlinks, and installs a pre-commit guard that blocks commits when files diverge. Reach for it when your repo accumulates duplicate agent docs that disagree on build commands, conventions, or shared facts. The workflow can be invoked as a skill or run via a dependency-free shell script in any agent environment.
- One canonical AGENTS.md per directory with CLAUDE.md and GEMINI.md symlinks
- Embeds shared invariants from docs/agents/shared-core.md with hash-stamped sentinels
- Pre-commit --check fails if symlinks are replaced or shared blocks drift
- Works across Claude Code, Codex, Cursor, and Gemini CLI
- Standalone Bash script needs no Claude runtime
Unify Agent Docs by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
/plugin marketplace add shanemhamilton/unify-agent-docsAdd your badge
Show developers this marketplace is listed on Skillselion. Paste this into your README.
| Last updated | June 14, 2026 |
|---|---|
| Repository | shanemhamilton/unify-agent-docs ↗ |
How do I stop CLAUDE.md, AGENTS.md, and GEMINI.md from drifting apart across directories and coding agents?
Unify CLAUDE.md, AGENTS.md, and GEMINI.md into one canonical file per directory with symlinks and a pre-commit drift guard.
Who is it for?
Developers running multiple AI coding agents on the same monorepo who need one source of truth for project instructions.
Skip if: Teams that only use a single agent with one instruction file and no cross-tool sync requirements.
What you get
Canonical AGENTS.md files, symlinks for other agent names, optional shared-core embedding, and a pre-commit guard that rejects drift on commit.
Plugins in this marketplace
1 plugin - install individually after you add the marketplace.
Recommended Marketplaces
FAQ
Which file becomes canonical?
AGENTS.md holds the real content; CLAUDE.md and GEMINI.md become symlinks to it in each directory.
Does it work outside Claude Code?
Yes—the agent-docs.sh Bash script and pre-commit hook are agent-agnostic and can be dropped into any repo.
How is drift detected?
A pre-commit --check fails if a symlink was replaced by a real file or if embedded shared-core blocks no longer match their source.