Migrating from CLAUDE.md to AGENTS.md

Why migrate?

AGENTS.md is the emerging standard (60k+ repos). AgentMD parses, validates, and executes it.

Key differences

• CLAUDE.md: Claude-specific, prose-heavy
• AGENTS.md: Tool-agnostic, section-based, executable

Migration steps

1. Copy your CLAUDE.md content
2. Add ## headings for each major section
3. Extract commands into backticks or code blocks
4. Add frontmatter for triggers and guardrails
5. Run agentmd validate to check

Example

Before (CLAUDE.md): "To run tests, use pnpm test"

After (AGENTS.md): ```## Test

pnpm test```