rules-migratelisted

# Rules migration Teams do not use one agent. They use Cursor and Claude Code, or Copilot at work and Claude Code at home, and the instructions drift into three files that disagree. "Support AGENTS.md" is the most reacted issue in the Claude Code tracker, which is the size of this problem stated plainly. This skill converts between the formats and, more importantly, keeps one source of truth instead of three copies. ## The formats | Tool | File | Notes | | --- | --- | --- | | Claude Code | `CLAUDE.md`, `.claude/rules/*.md` | also reads `AGENTS.md` in recent versions | | Cursor (new) | `.cursor/rules/*.mdc` | MDC frontmatter: `description`, `globs`, `alwaysApply` | | Cursor (old) | `.cursorrules` | single file, deprecated but everywhere | | GitHub Copilot | `.github/copilot-instructions.md` | single file | | Windsurf | `.windsurfrules` | single file | | Cline | `.clinerules` | single file or directory | | Aider | `CONVENTIONS.md` | referenced from config, not auto-loaded | | Codex and others | `AGENTS.md` | the closest thing to a shared standard | ## Convert ```bash node "${CLAUDE_PLUGIN_ROOT}/skills/rules-migrate/scripts/rules-convert.mjs" . --to=claude ``` `--to` accepts `claude`, `agents`, `cursor`, `copilot`, `windsurf`, `cline`. Add `--write` to write files, otherwise it prints what it would do. `--list` shows every rules file it can find and whether they have drifted. Read `references/formats.md` for the details of each format, including the MDC frontmatter field