cqbase.net · English & Chinese

CQBase

Context & Query Base

Tutorials

When Claude Code reads AGENTS.md, and when it does not

The author looks at when Claude Code skips AGENTS.md because a CLAUDE.md is already present, and lists ways to make the rules apply.

On 10 October 2026 @torfinpd posted an analysis of when Claude Code reads AGENTS.md: if a CLAUDE.md is already present, AGENTS.md may never be opened, and what that means in repositories that ship both files. A related X article the post quotes, https://x.com/i/article/2107149896969031680 , was still unavailable on 15 November 2026, so this page relies only on the still-available post and not on that article. Figures cited in the post stay with the original; this page does not retell the full argument.

After you upgrade Claude Code, open your own repository and see which rules file actually loads. If the project agreement lives in AGENTS.md, check whether you need to reference it from CLAUDE.md, or use another approach the author describes. Likes and reposts were captured on 15 November 2026.

This page is a guide, not the original text.

Note (verified 15 November 2026): This post discusses when Claude Code reads AGENTS.md. Product behavior may have changed since then. The original post was not reopened in this review, and there was no reputation sample from the past one to three months.

Subscribe to CQBase Weekly

One email a week with newly catalogued public AI skills, prompts, MCP servers, and methods. Unsubscribe at any time. We will not hand your address to a third party for their marketing.