{
  "verifiedAt": "2026-07-14",
  "records": [
    {
      "id": "codex-agents-md",
      "toolId": "openai-codex",
      "toolName": "OpenAI Codex",
      "path": "AGENTS.override.md → AGENTS.md → configured fallback filename",
      "status": "documented",
      "scopes": [
        "user",
        "repository",
        "nested-directory"
      ],
      "surfaces": [
        "Codex app",
        "Codex CLI",
        "Codex IDE extension",
        "Codex web"
      ],
      "priority": "At startup, Codex reads the first non-empty global file from AGENTS.override.md then AGENTS.md. From the project root to the initial working directory, each directory contributes at most one non-empty file selected in this order: AGENTS.override.md, AGENTS.md, then configured project_doc_fallback_filenames.",
      "nesting": "Codex concatenates the selected project files from root toward the initial working directory. Closer files appear later and override earlier guidance; discovery stops at that initial working directory rather than expanding dynamically into other directories.",
      "recommendation": "Keep shared rules in root AGENTS.md, use AGENTS.override.md only where it should win within one directory, and reserve configured fallback filenames for repositories that require another recognized name.",
      "sourceUrl": "https://learn.chatgpt.com/docs/agent-configuration/agents-md",
      "publisher": "OpenAI",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "claude-code-claude-md",
      "toolId": "claude-code",
      "toolName": "Claude Code",
      "path": "CLAUDE.md",
      "status": "documented",
      "scopes": [
        "user",
        "repository",
        "nested-directory",
        "path-specific"
      ],
      "surfaces": [
        "Claude Code"
      ],
      "priority": "CLAUDE.md files above the working directory load at launch; files in child directories load when Claude works with files there.",
      "nesting": "Use nested CLAUDE.md files or path-scoped rules for instructions that should not apply repository-wide.",
      "recommendation": "Put stable repository commands in root CLAUDE.md and move specialized guidance into scoped files.",
      "sourceUrl": "https://code.claude.com/docs/en/memory",
      "publisher": "Anthropic",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "claude-code-agents-md-import",
      "toolId": "claude-code",
      "toolName": "Claude Code",
      "path": "CLAUDE.md containing @AGENTS.md",
      "status": "documented",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "Claude Code"
      ],
      "priority": "Claude Code does not read AGENTS.md directly. Its documented bridge is a CLAUDE.md file that imports @AGENTS.md, followed by any Claude-specific guidance.",
      "nesting": "The imported path resolves relative to the CLAUDE.md file. Imports can recurse to a maximum depth of four hops; a symlink is another documented option where supported.",
      "recommendation": "Use @AGENTS.md from CLAUDE.md when Codex, Copilot, and Claude Code should share a single shared baseline without duplicating repository rules.",
      "sourceUrl": "https://code.claude.com/docs/en/memory",
      "publisher": "Anthropic",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "copilot-repository-instructions",
      "toolId": "github-copilot",
      "toolName": "GitHub Copilot",
      "path": ".github/copilot-instructions.md",
      "status": "documented",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "GitHub.com Copilot Chat",
        "GitHub.com Copilot cloud agent",
        "GitHub.com Copilot code review",
        "VS Code Copilot Chat",
        "VS Code Copilot cloud agent",
        "VS Code Copilot code review",
        "Visual Studio Copilot Chat",
        "Visual Studio Copilot code review",
        "JetBrains Copilot Chat",
        "JetBrains Copilot cloud agent",
        "JetBrains Copilot code review",
        "Eclipse Copilot Chat",
        "Eclipse Copilot cloud agent",
        "Xcode Copilot Chat",
        "Xcode Copilot cloud agent",
        "Xcode Copilot code review",
        "Copilot CLI"
      ],
      "priority": "Repository-wide instructions are combined with applicable path-specific instructions where supported.",
      "nesting": "This file has one fixed repository-wide location; use .github/instructions/*.instructions.md for paths.",
      "recommendation": "Use .github/copilot-instructions.md as the most portable Copilot baseline, even when AGENTS.md or CLAUDE.md also exists for agent-specific surfaces.",
      "sourceUrl": "https://docs.github.com/en/copilot/reference/custom-instructions-support",
      "publisher": "GitHub",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "copilot-path-specific-instructions",
      "toolId": "github-copilot",
      "toolName": "GitHub Copilot",
      "path": ".github/instructions/**/*.instructions.md",
      "status": "documented",
      "scopes": [
        "path-specific"
      ],
      "surfaces": [
        "GitHub.com Copilot cloud agent",
        "GitHub.com Copilot code review",
        "VS Code Copilot Chat",
        "VS Code Copilot cloud agent",
        "Visual Studio Copilot Chat",
        "JetBrains Copilot Chat",
        "JetBrains Copilot cloud agent",
        "JetBrains Copilot code review",
        "Eclipse Copilot cloud agent",
        "Xcode Copilot Chat",
        "Xcode Copilot cloud agent",
        "Xcode Copilot code review",
        "Copilot CLI"
      ],
      "priority": "When a file path matches and repository-wide instructions also exist, GitHub documents that both instruction sets are used.",
      "nesting": "Path-specific files live under .github/instructions and are combined with .github/copilot-instructions.md where the selected surface supports them.",
      "recommendation": "Use path-specific files for language, package, or directory rules, but keep cross-repository commands and guardrails in the repository-wide Copilot file.",
      "sourceUrl": "https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions",
      "publisher": "GitHub",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "copilot-agents-md",
      "toolId": "github-copilot",
      "toolName": "GitHub Copilot",
      "path": "AGENTS.md",
      "status": "documented",
      "scopes": [
        "repository",
        "nested-directory"
      ],
      "surfaces": [
        "GitHub.com Copilot cloud agent",
        "GitHub.com Copilot code review",
        "VS Code Copilot Chat",
        "VS Code Copilot cloud agent",
        "JetBrains Copilot cloud agent",
        "Eclipse Copilot cloud agent",
        "Xcode Copilot cloud agent",
        "Copilot CLI"
      ],
      "priority": "GitHub documents that the nearest AGENTS.md file in the directory tree takes precedence when Copilot is working.",
      "nesting": "One or more AGENTS.md files may be stored throughout the repository; surface support still varies according to GitHub's current matrix.",
      "recommendation": "Use AGENTS.md for nested agent guidance shared with Codex and supported Copilot surfaces, plus .github/copilot-instructions.md when broad Copilot coverage matters.",
      "sourceUrl": "https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/add-custom-instructions/add-repository-instructions",
      "publisher": "GitHub",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "copilot-claude-md-documented-surfaces",
      "toolId": "github-copilot",
      "toolName": "GitHub Copilot",
      "path": "CLAUDE.md",
      "status": "documented",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "GitHub.com Copilot cloud agent",
        "VS Code Copilot cloud agent",
        "JetBrains Copilot cloud agent",
        "Eclipse Copilot cloud agent",
        "Xcode Copilot cloud agent",
        "Copilot CLI"
      ],
      "priority": "GitHub's support matrix lists CLAUDE.md as agent instructions on these cloud-agent surfaces and in Copilot CLI.",
      "nesting": "The support matrix establishes file-type support by surface; no broader CLAUDE.md scope behavior is inferred here.",
      "recommendation": "Keep CLAUDE.md when Claude Code is part of the workflow or Copilot CLI should reuse it, but add .github/copilot-instructions.md for Copilot surfaces beyond agent instructions.",
      "sourceUrl": "https://docs.github.com/en/copilot/reference/custom-instructions-support",
      "publisher": "GitHub",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "copilot-claude-md-unlisted-surfaces",
      "toolId": "github-copilot",
      "toolName": "GitHub Copilot",
      "path": "CLAUDE.md",
      "status": "unsupported",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "GitHub.com Copilot Chat",
        "GitHub.com Copilot code review",
        "VS Code Copilot Chat",
        "VS Code Copilot code review",
        "Visual Studio Copilot Chat",
        "Visual Studio Copilot code review",
        "JetBrains Copilot Chat",
        "JetBrains Copilot code review",
        "Eclipse Copilot Chat",
        "Eclipse Copilot code review",
        "Xcode Copilot Chat",
        "Xcode Copilot code review"
      ],
      "priority": "GitHub's current support matrix does not list CLAUDE.md agent instructions for these surfaces.",
      "nesting": "Do not rely on CLAUDE.md to provide Copilot instructions on a surface where the matrix does not list it.",
      "recommendation": "Mirror shared guidance in .github/copilot-instructions.md and use AGENTS.md only where its surface is documented.",
      "sourceUrl": "https://docs.github.com/en/copilot/reference/custom-instructions-support",
      "publisher": "GitHub",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "cursor-project-rules",
      "toolId": "cursor",
      "toolName": "Cursor",
      "path": ".cursor/rules/*.mdc",
      "status": "documented",
      "scopes": [
        "repository",
        "path-specific"
      ],
      "surfaces": [
        "Cursor IDE",
        "Cursor CLI"
      ],
      "priority": "Rule metadata controls whether a rule is always applied, matched to files, requested, or selected manually.",
      "nesting": "Store focused project rules under .cursor/rules and use matching metadata to limit their scope.",
      "recommendation": "Prefer small .mdc rules with explicit descriptions and globs over one large repository prompt.",
      "sourceUrl": "https://docs.cursor.com/context/rules-for-ai",
      "publisher": "Cursor",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "cursor-agents-md-ide",
      "toolId": "cursor",
      "toolName": "Cursor",
      "path": "AGENTS.md (project root)",
      "status": "documented",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "Cursor IDE"
      ],
      "priority": "Cursor documents root-level AGENTS.md as a plain Markdown alternative to .cursor/rules for straightforward project-wide instructions.",
      "nesting": "The cited Cursor IDE documentation limits AGENTS.md to the project root and global scope; it does not document nested AGENTS.md support on this surface.",
      "recommendation": "Use root AGENTS.md when one readable project-wide file is sufficient; use .cursor/rules when metadata, path scoping, or multiple focused rules are needed.",
      "sourceUrl": "https://docs.cursor.com/context/rules-for-ai",
      "publisher": "Cursor",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "cursor-agents-md-cli",
      "toolId": "cursor",
      "toolName": "Cursor",
      "path": "AGENTS.md (project root)",
      "status": "documented",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "Cursor CLI"
      ],
      "priority": "Cursor CLI reads AGENTS.md at the project root and applies it alongside .cursor/rules.",
      "nesting": "The cited CLI page documents the project-root file and does not establish nested AGENTS.md discovery.",
      "recommendation": "Use AGENTS.md to share a simple root policy with Codex and Cursor CLI; keep Cursor-specific scoped rules in .cursor/rules.",
      "sourceUrl": "https://docs.cursor.com/en/cli/using",
      "publisher": "Cursor",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "cursor-claude-md-cli",
      "toolId": "cursor",
      "toolName": "Cursor",
      "path": "CLAUDE.md (project root)",
      "status": "documented",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "Cursor CLI"
      ],
      "priority": "Cursor CLI reads CLAUDE.md at the project root and applies it alongside .cursor/rules.",
      "nesting": "The cited CLI page documents the project-root file and does not establish Claude Code's broader memory precedence inside Cursor.",
      "recommendation": "Reuse CLAUDE.md in Cursor CLI when the shared root policy is intentional; use .cursor/rules for Cursor-specific scope and metadata.",
      "sourceUrl": "https://docs.cursor.com/en/cli/using",
      "publisher": "Cursor",
      "verifiedAt": "2026-07-14"
    },
    {
      "id": "cursor-cursorrules-legacy",
      "toolId": "cursor",
      "toolName": "Cursor",
      "path": ".cursorrules",
      "status": "legacy",
      "scopes": [
        "repository"
      ],
      "surfaces": [
        "Cursor IDE"
      ],
      "priority": "Cursor documents .cursorrules as a legacy root file that remains supported but is deprecated in favor of Project Rules.",
      "nesting": "The legacy file is repository-wide and does not provide the metadata or nested rule organization available under .cursor/rules.",
      "recommendation": "Migrate this deprecated legacy format to .cursor/rules, compare behavior before removal, and keep the old file only while an older workflow still depends on it.",
      "sourceUrl": "https://docs.cursor.com/context/rules-for-ai",
      "publisher": "Cursor",
      "verifiedAt": "2026-07-14"
    }
  ]
}