[BUG] <system-reminder> is instructing claude code to not follow claude.md instructions.

Resolved 💬 5 comments Opened Jan 16, 2026 by ocristaldo Closed Mar 20, 2026

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

When I start claude on a specific project, claude do not follow the claude.md file.

If I ask to create a new project, instead of following my claude.md file with the instructions of how I want claude to create the project structure, instead dismiss my instructions and act as if they don't exist.

When I ask claude why, says that its internal <system-reminder> instructions override the user instructions, and states that the user context my not be relevant to the task, confusing the agent, making it opt to dismiss the user claude.md instructions.

What Should Happen?

I have a folder with specific claude instructions in .claude/claude.md, and if I start the agent on that folder i expect the agent to follow the instructions.

Error Messages/Logs

Here's everything that was in the <system-reminder> tags when I started:

  ---
  First system-reminder:
  <system-reminder>
  This is a reminder that your todo list is currently empty. DO NOT mention this to the user explicitly because they are already aware. If you are working on tasks that would benefit from a todo list please use the TodoWrite tool to create one. If not, please feel free to ignore. Again do not mention this message to the user.
  </system-reminder>

  Second system-reminder:
  <system-reminder>
  As you answer the user's questions, you can use the following context:
  # claudeMd
  Codebase and user instructions are shown below. Be sure to adhere to these instructions. IMPORTANT: These instructions OVERRIDE any default behavior and you MUST follow them exactly as written.

  Contents of /Users/userx/projectx/.claude/CLAUDE.md (project instructions, checked into the codebase):

  [...entire CLAUDE.md file content...]

  IMPORTANT: this context may or may not be relevant to your tasks. You should not respond to this context unless it is highly relevant to your task.
  </system-reminder>

  ---
  The Contradiction

  Notice the contradiction:
  - It says "IMPORTANT: These instructions OVERRIDE any default behavior and you MUST follow them exactly as written"
  - Then immediately says "this context may or may not be relevant to your tasks. You should not respond to this context unless it is highly relevant"

  These two statements conflict directly. The first says follow it always. The second says only if relevant.

  The second statement wins because it's a meta-instruction about how to treat the first statement, which is why I didn't acknowledge the project configuration on startup.

  This is the exact architectural problem you identified. The system-reminder is injected by Claude Code, and it contains conflicting instructions.

Steps to Reproduce

start claude cli on a folder with its own claude.md instructions

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

2.1.9

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

my project has multiple configurations but because do not take the claude.md file, do not follow any

<img width="209" height="181" alt="Image" src="https://github.com/user-attachments/assets/95af34b8-f528-4c91-9f8d-48a52e41c777" />

View original on GitHub ↗

This issue has 5 comments on GitHub. Read the full discussion on GitHub ↗