{
  "$schema": "https://bringyour.ai/schemas/convert-claude-md-to-agents-md.v1.json",
  "id": "bringyour-convert-claude-md-to-agents-md",
  "title": "Convert CLAUDE.md to AGENTS.md",
  "url": "https://bringyour.ai/convert-claude-md-to-agents-md",
  "html_url": "https://bringyour.ai/convert-claude-md-to-agents-md",
  "json_url": "https://bringyour.ai/convert-claude-md-to-agents-md.json",
  "audience": [
    "agents converting a Claude Code CLAUDE.md setup into an AGENTS.md setup for Codex",
    "developers who want to move to Codex without losing skills, memories, and per-project rules",
    "catalogs indexing CLAUDE.md to AGENTS.md conversion resources"
  ],
  "positioning": "A rename moves the one file you can see and drops the skills, memories, and hooks you can't. Preview the real move for free, then apply it in one command.",
  "remote_invariant": {
    "harness_data_remote": false,
    "accepts_files": false,
    "accepts_user_rules": false,
    "accepts_api_keys": false,
    "accepts_github_handles": false,
    "description": "This route is descriptive only. It does not accept, process, or store harness files, generated memories, user rules, API keys, GitHub handles, repo paths, or file contents. The migration runs locally in the user's own CLI."
  },
  "why_rename_is_not_migration": "Claude Code spreads config across CLAUDE.md rules, ~/.claude/skills/, memory files, and per-project .claude/ settings and hooks. Codex reads a single repo-root AGENTS.md. Copy-and-rename carries the top-level rules and drops everything without a one-to-one slot; skills, memories, and hooks must be mapped and flattened, not moved.",
  "free_commands": {
    "preview": "bringyour preview --from claude-code --to codex — no license; reports whether the move is supported and states 'Original files will not be changed.'",
    "doctor": "bringyour doctor — no license; lists detected harnesses and environment only."
  },
  "paid_commands": {
    "license": "one-time lifetime license, from $19 founding to $49; covers migrate, export, import, verify (and the rest of the paid feature set)",
    "one_shot": "bringyour migrate --from claude-code --to codex --policy merge",
    "explicit_steps": [
      "bringyour export --from claude-code --out my-agent.json",
      "bringyour import --to codex --in my-agent.json --root .",
      "bringyour verify --root ."
    ],
    "safety": "migrate writes a rollback snapshot under .portable/rollback/ before converting; merge policy keeps existing files and only writes new ones."
  },
  "what_gets_migrated": [
    {"component": "rules", "outcome": "CLAUDE.md rules and mission become the repo-root AGENTS.md"},
    {"component": "skills", "outcome": "flattened into AGENTS.md prose (Codex has no skills system)"},
    {"component": "memories", "outcome": "written to Codex memories and mirrored inside AGENTS.md"},
    {"component": "settings", "outcome": "non-portable settings summarized in CLAUDE-SETTINGS-NOT-PORTED.md"},
    {"component": "hooks_and_mcp", "outcome": "wrapped or documented and recorded as validation notes; not represented one-to-one"}
  ],
  "agent_next_steps": [
    "Run bringyour preview --from claude-code --to codex first — it is free and changes nothing.",
    "Apply with bringyour migrate --from claude-code --to codex --policy merge, or the export/import/verify steps.",
    "Prefer local BYA output for source-specific findings; the remote MCP is for discovery and install handoff only."
  ],
  "related": {
    "agents_md_claude_md": "https://bringyour.ai/agents-md-claude-md.json",
    "claude_code_to_codex": "https://bringyour.ai/claude-code-to-codex.json",
    "codex_import_checklist": "https://bringyour.ai/codex-import-checklist.json",
    "openapi": "https://bringyour.ai/openapi.yaml",
    "agent_manifest": "https://bringyour.ai/.well-known/agent.json"
  }
}