# AI coding agent instruction file compatibility planner

Canonical tool: https://repoagentkit.com/ai-agent-instruction-files

Choose any combination of OpenAI Codex, Claude Code, Cursor, GitHub Copilot, Gemini CLI, and Windsurf. The planner returns the smallest practical repository file set, with a root `AGENTS.md` as the shared source of truth and short tool-specific bridge files only where documented support differs.

## What the plan explains

- which tools read `AGENTS.md` directly;
- when `CLAUDE.md`, `GEMINI.md`, or `.github/copilot-instructions.md` is still useful;
- when native scoped rules such as Cursor `.mdc` or Windsurf `.windsurf/rules/*.md` add behavior a root file cannot express;
- how to keep bridge files short so shared instructions do not drift; and
- how to verify which instructions each tool actually loaded.

The planner runs locally in the browser. Tool selections and generated plans are not uploaded.