Original Reddit post

I use Claude Code, Codex, and Gemini CLI. What I’ve been doing is this - updating CLAUDE.md to have the following contents:

Claude Code Context This file is deprecated. All AI agent context has been centralized into a single file: AGENTS.md . Please refer to that file for all project information, conventions, and guidelines. Do not update this file. All future context updates should be made to AGENTS.md.<br> Do not move or delete this file. This file needs to remain here for its corresponding AI agent.

And I’ve done the same with with GEMINI.md , just with the heading reading

Gemini Code Assistant Context

. And then at the top of the AGENTS.md file, I’ve always had:

AI Agent Context This file provides guidance to all AI code assistants when working with code in this repository. Important : To provide more specific, directory-level context and to reduce the size of the main context file, additional AGENTS.md files may be placed in subdirectories. When working within a subdirectory, please refer to the nearest AGENTS.md file in the directory hierarchy.

This has seemed to work perfectly for me. However, I was looking through the OpenClaw codebase and noticed that the full contents of the CLAUDE.md file was quite simply: AGENTS.md Well, if this works just as well, then I’m wasting precious context by adding all these extra words for the sake of clarity. If you consolidate agent context files, how do you do it? submitted by /u/Odd-Aside456

Originally posted by u/Odd-Aside456 on r/ClaudeCode