Claude.md to Agents.md Migration Guide (solmaz.io)

Anthropic’s CLAUDE.md convention is being migrated to the open, vendor-neutral AGENTS.md format to standardize agent instructions across repositories and improve interoperability with multiple AI systems. The migration preserves backward compatibility by creating local CLAUDE.md symlinks that point to the canonical AGENTS.md files, so tools expecting CLAUDE.md keep working while projects adopt a future-proof, company-agnostic standard. The guide provides a practical, repeatable workflow: rename CLAUDE.md to AGENTS.md (find + mv), replace Claude-specific wording with agent-agnostic text (sed), add CLAUDE.md patterns to .gitignore, and run a small shell utility (utils/setup-claude-symlinks.sh) that finds AGENTS.md files and creates local CLAUDE.md symlinks. It also covers making the script executable, verification commands (find/ls/grep to list AGENTS.md, check symlink targets and ensure content is agent-agnostic), and troubleshooting (delete broken symlinks, fix permissions). Benefits include backward compatibility, git cleanliness (CLAUDE.md not tracked), automatic sync via symlinks, and simplified maintenance. This approach lets teams standardize agent guidance without breaking existing tooling while easing future transitions away from provider-specific conventions.