Where does the bug appear (feature/product)? Cursor IDE Describe the Bug docs say that nested agents.md files should be loaded when agents work in those directories, but in my testing they do not every get appended automatically. Only the root agents file is appended automatically. Link to docs: R…

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug https://cursor.com/docs/context/rules#agentsmd The AGENTS.md file is not automatically added to the AI chats. Steps to Reproduce Create an AGENTS.md file. Put any instruction in there. Chat with AI. AI will ignore instructi…

Hey, thanks for the report. You’re right: nested AGENTS.md files should auto-load when the agent works in those directories. This looks like a bug in the nested AGENTS.md functionality. I’ll pass this to the team. As a temporary workaround, you can manually add the nested AGENTS.md files to the ag…

Yeah but that kinda defeats the purpose. I’d suggest updating your documentation to reflect that this functionality is not yet supported.

This seems to have been fixed now: Rules | Cursor Docs

@deanrie Has this been taken care of already, or is it still in progress?

Hi, any updates on this? Still experiencing this issue. Thank you so much!

double check that your files is named AGENTS.md (capital letters)

We have, and still observe that nested AGENTS.md are not reliably loaded into context.

Nested agents.md files not being loaded

Support Bug Reports

deanrie (Dean Rie) November 18, 2025, 3:54pm 8

Hey, the team is working on it.

Topic		Replies	Views
AGENTS.md is ignored Bug Reports	2	958	December 3, 2025
AGENTS.md not automatically injected Bug Reports rules , context , agents-window	11	909	April 26, 2026
Agents.md isolated within a subdirectory is applied to root? Help rules , context , large-codebases	2	422	May 21, 2026
Nested Markdown files inside `.cursor/agents` are incorrectly detected as subagents Bug Reports subagents	3	94	October 1, 2026
AGENTS.md not read in worktree agents Bug Reports worktrees , rules	2	135	June 22, 2026

Nested agents.md files not being loaded

Related topics