Enable AGENTS.md as Claude Code project instructions in /config
Upgrade to Claude Code v2.1.277 so a repo with no CLAUDE.md loads AGENTS.md instead. Set that file under Project instructions in /config. Skip this on Bedrock, Vertex, or Foundry, which do not have the feature yet.Why this loop
v2.1.277 makes AGENTS.md the project-instruction file whenever CLAUDE.md is missing, and you change that path under Project instructions in /config. Repos that already keep AGENTS.md for other coding agents can share that file instead of maintaining a parallel CLAUDE.md that drifts. A leftover CLAUDE.md still wins, so delete duplicates rather than keeping two copies. This mapping is not on Bedrock, Vertex, or Foundry, so those hosts should keep CLAUDE.md. Headless and SDK (claude -p) startup also no longer waits on the per-directory CLAUDE.md lookup before the first turn, which fits putting instructions in one known file at the project root.
Proposed actions
- Run: claude update && claude --version # require v2.1.277+; AGENTS.md support is not on Bedrock, Vertex, or Foundry
- In the project root, keep AGENTS.md and omit CLAUDE.md so v2.1.277 loads AGENTS.md: ls CLAUDE.md AGENTS.md 2>/dev/null; test ! -f CLAUDE.md && test -f AGENTS.md && echo "Claude Code will load AGENTS.md"
- Open Claude Code, run /config, and set "Project instructions" to AGENTS.md (unavailable on Bedrock, Vertex, or Foundry).
- If CLAUDE.md only duplicates existing AGENTS.md, delete CLAUDE.md so Claude Code reads the shared AGENTS.md instead of the Claude-only copy.
Agent prompt
Paste into your agent or query via MCP (get_agent_prompt) — free, no extra AI costPaste into Claude Code / CLAUDE.md task
DevAgentRadar → Claude Code
You are helping me adopt a real coding-assistant change. Work only from the facts below. Do not invent features.
Context
Assistant: Claude Code Proposal: Enable AGENTS.md as Claude Code project instructions in /config Summary: Upgrade to Claude Code v2.1.277 so a repo with no CLAUDE.md loads AGENTS.md instead. Set that file under Project instructions in /config. Skip this on Bedrock, Vertex, or Foundry, which do not have the feature yet. Primary source: https://github.com/anthropics/claude-code/releases/tag/v2.1.277
Why it matters
v2.1.277 makes AGENTS.md the project-instruction file whenever CLAUDE.md is missing, and you change that path under Project instructions in /config. Repos that already keep AGENTS.md for other coding agents can share that file instead of maintaining a parallel CLAUDE.md that drifts. A leftover CLAUDE.md still wins, so delete duplicates rather than keeping two copies. This mapping is not on Bedrock, Vertex, or Foundry, so those hosts should keep CLAUDE.md. Headless and SDK (claude -p) startup also no longer waits on the per-directory CLAUDE.md lookup before the first turn, which fits putting instructions in one known file at the project root.
Suggested actions
-
Run: claude update && claude --version # require v2.1.277+; AGENTS.md support is not on Bedrock, Vertex, or Foundry
-
In the project root, keep AGENTS.md and omit CLAUDE.md so v2.1.277 loads AGENTS.md: ls CLAUDE.md AGENTS.md 2>/dev/null; test ! -f CLAUDE.md && test -f AGENTS.md && echo "Claude Code will load AGENTS.md"
-
Open Claude Code, run /config, and set "Project instructions" to AGENTS.md (unavailable on Bedrock, Vertex, or Foundry).
-
If CLAUDE.md only duplicates existing AGENTS.md, delete CLAUDE.md so Claude Code reads the shared AGENTS.md instead of the Claude-only copy.
Config surfaces this release may change
- agent context files (high confidence) — check your repo before applying
- background and headless runs (high confidence) — check your repo before applying
- skills (high confidence) — check your repo before applying
- sandbox settings (high confidence) — check your repo before applying
- subagent definitions (high confidence) — check your repo before applying
- MCP servers — check your repo before applying
- hooks — check your repo before applying
- permission rules — check your repo before applying
After you finish
Do not report this as applied to DevAgentRadar. You cannot write the visitor's loop.
Tell the human: open https://devagentradar.com/proposals/claude-code-v2-1-277-enable-agents-md-as-claude-code-project-instruction and mark Applied, Skipped, or Failed. Proposal id: f60eefa9-63ba-4d02-9bac-ae6b83b59232
Your job
- Restate the change in one sentence.
- Propose a minimal plan for my repo (or a throwaway pilot).
- Implement only what I approve; prefer small diffs and tests.
- Call out risks (permissions, breaking APIs, cost).
Start by confirming you understood the proposal.
Your loop
This browser · no sign-in · not shared as “you”After you run the prompt
Only you can mark this. Agents cannot write your loop.
Your decision stays on this device. A public tally appears after a few votes.