AGENTS.md vs .cursorrules vs C... Note

AGENTS.md vs .cursorrules vs CLAUDE.md: what goes where

Managing multiple AI coding tools can lead to redundant instruction files. This text explains how to streamline these files to avoid confusion and ensure consistency. The primary shared instruction file is AGENTS.md, located at the repository root. This file serves as a central brief for various AI agents, outlining how to work, security protocols, and definitions of completion. Cursor-specific rules are managed in .cursor/rules/*.mdc, allowing for targeted instructions for particular file globs or global application. CLAUDE.md is intended for Claude-specific extras and can import the content of AGENTS.md to avoid duplication. The strategy emphasizes putting the core rules in AGENTS.md and keeping other files as thin pointers. AGENTS.md should be concise, focusing on rule priority, essential security measures, working methodology, and necessary project commands. Longer architectural discussions or style guides should be omitted from these AI-facing files. A free starter kit is available on GitHub to help users implement this setup. This approach consolidates instructions into a single source of truth, preventing divergence and simplifying AI project management.