meta: Migrate AI agent rules to AGENTS.md format #3078
Draft
+22
−163
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Replace Cursor-specific rules with AGENTS.md format for broader tool compatibility. AGENTS.md is supported by 60+ AI coding tools including Cursor, Claude Code, GitHub Copilot, and others. Changes: - Create root AGENTS.md with project guidelines - Create directory-scoped AGENTS.md files (src/, lib/, .github/workflows/) - Convert CLAUDE.md to symlink for Claude Code compatibility - Use symlinks for shared rules (apple-catalog-parsing/, scripts/) - Remove .cursor/rules/ directory - Condense rule-management guidelines to reduce token usage The directory-proximity model replaces most glob patterns naturally. Rules are now maintained in a single format that works across tools. Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
Migrate AI agent rules from Cursor-specific format to the standardized AGENTS.md format, enabling compatibility with Claude Code, Cursor, and 60+ other AI coding tools.
The existing rules were Cursor-only, requiring workarounds for Claude Code. AGENTS.md is an open standard that allows a single set of rules to work everywhere. Directory-scoped files replace glob patterns through proximity matching (nearest AGENTS.md to edited file wins).
Considered maintaining separate rule files for each tool but that would require duplicating content and keeping them in sync. The AGENTS.md format is identical to Claude Code's CLAUDE.md format, so a symlink provides native Claude support without duplication.
Issues
N/A