Skip to content

make AGENTS.md the default rule file - #273

Merged
SyedFahad7 merged 1 commit into
mainfrom
docs/agents-md-default
Nov 17, 2026
Merged

SyedFahad7 merged 1 commit into
mainfrom
docs/agents-md-default

Conversation

@SyedFahad7

Copy link
Copy Markdown
Collaborator

Claude Code 2.1.277 started reading AGENTS.md when a project has no CLAUDE.md, so one AGENTS.md now covers Claude Code as well as Codex and most other agents. The setup steps for agents never said which file to create when none exists, and two cookbooks still sent Claude Code users to CLAUDE.md only. This makes AGENTS.md the default and keeps CLAUDE.md as the place to add the rule when a project already has one.

Copilot AI balanced review requested due to automatic review settings November 17, 2026 01:12
@mintlify

mintlify Bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
graphify-labs-inc 🟢 Ready View Preview Nov 17, 2026, 1:12 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

@graphify-labs-staging graphify-labs-staging Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Graphify code review View in Graphify

Reviewed · e3590a42f072

Updates agent instruction precedence so AGENTS.md becomes the default file Codex and most agents read at session start.

Full summary

Updates agent instruction precedence so AGENTS.md becomes the default file Codex and most agents read at session start. Claude Code 2.1.277+ follows it only when no CLAUDE.md exists in the project; otherwise the existing CLAUDE.md is used unchanged. Cursor continues to read .cursor/rules/, and the same rule text is appended without altering any prior file contents.

No blocking issues surfaced. 1 lower-confidence candidate did not survive cross-model review.

Code graph and static checks · 41 functions depend on this change

Impact & health

Impact — 41 functions depend on the 41 functions this change touches.

Health — grade A; no new coupling hotspots.

Formal checks — 41 functions this change can affect weren't formally checked in this review. Formal checks are informational only.

Health delta baseline: last indexed commit 445ead8 (diverged from this PR's base — delta is approximate).

Gate & verification

✅ PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.

Advisory (not blocking):

  • verification_scope: 41 function(s) in the blast radius were not formally verified this run

@SyedFahad7
SyedFahad7 merged commit 538ed5e into main Nov 17, 2026
3 checks passed

This branch was successfully deployed

1 active deployment
staging — e3590a42 Deployed Nov 17, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants