2026-10-11 16:36 UTC

Redditor microlatency reports that Claude Code loads nested CLAUDE.md instructions through native Read calls but not shell-based file access, potentially leaving repository-specific rules absent during coding work.

state: corroboratedheat: lowuncertainty: mediumconvergesscott: highcoding-agents instruction-loading agent-harnessesmicrolatencyAnthropic
Surfaced 2026-09-19T08:26:33Z β€” priced heat=high at reprice: Repository-instruction compatibility has become a front-page attention event, with the spread reading warranting high heat despite no new substantive evidence. That attention concerns AGENTS.md fallback, not independent confirmation or repair of the native-Read-versus-shell loading gap; the defect hypothesis remains unverified.

What is this?

Claude Code ships a conditional instruction system: the root CLAUDE.md loads at session start, while nested per-directory CLAUDE.md files and path-scoped .claude/rules/ entries load only on demand β€” docs quoted in the supplied sources say they load 'on access', when Claude reads files in that part of the repo. Redditor microlatency reports a failure mode where that access trigger fires only for the native Read tool and not shell access: when Auto Mode steers the model toward cat/sed via Bash, scoped repository instructions are silently never injected; two further independent accounts (gabgoss's GitHub issues #90449/#90450, and mudmohammad's transcript token accounting finding CLAUDE.md/agent configs unloaded in 9/10 sessions) support instruction absence in routine work, though none of the supplied web material isolates the Read-vs-shell mechanism and no Anthropic acknowledgment of the specific bypass appears anywhere supplied. The snippets do corroborate the documented on-demand loading design and a long history of nested-loading bugs (anthropics/claude-code issue #2571), and a related confirmed defect β€” the v2.1.277 AGENTS.md fallback silently gated on telemetry being enabled, acknowledged by Anthropic and fixed in v2.1.281 per the case record β€” shows conditional instruction delivery breaking is a real pattern for this harness.

Why it matters to Scott

Independently converges with Manners-vs-Physics and Guardrail Illusion: Claude Code's on-access instruction loading is a probability barrier keyed to the model's tool choice, and mudmohammad's 9/10-session measurement shows it silently failing in real work β€” dated third-party receipts for the deterministic-boundary position he already argues. It bears directly on his own stack rather than merely illustrating it: the router project's markdown-defined Claude Code agents depend on nested CLAUDE.md delivery, so the indicated Read-vs-shell regression test and deny-permissions on cat/sed are immediate build actions, and the failure mode sharpens his context-engineering claim that just-in-time loading needs a deterministic trigger (hooks/path-level injection) instead of model cooperation.
ip:concept.manners-vs-physicsip:concept.guardrail-illusionip:framework.context-engineeringip:concept.claude-md-patterndev:project.routerdev:technology.claude-coderadar:concept.claude-coderadar:claude-code-agents-md-supportradar:claude-code-machine-level-config-bleedradar:claude-code-denied-read-secret-bypassradar:graft-automatic-agent-contextradar:concept.deterministic-guardrails
queries asked of Scott's wikis
  • deterministic control plane agent behavior vs prompt adherence
  • nested CLAUDE.md scoped instruction loading deployments
  • router project markdown-defined Claude Code agents
  • agent memory wiki on-demand loading context injection
  • tool call gating deny permissions shell commands
  • agent harness regression testing transcript audit

Measured heat

now 0 pts/hpeak 6 pts/hcomments 0/hpeers p14momentum: steady3 platformsage 1082h
points/hour across evidence Β· reading as of 2026-10-12 02:59:37.977291+11:00 Β· deterministic, not a model opinion

How the heat travelled

08-27 14:00⭐ origin echo-reconstructedThe issue reports that Auto Mode tells Claude to use Bash commands such as cat and sed instead of native Read/Edit/Write tools. Its firsthan
Gabriel Gosselin (gabgoss) on github (echo) Β· attributed from reddit.post.1wj7v4y
β€”
09-17 22:05first on r/ClaudeAI Β· published Β· +512.1hIn auto mode, your nested CLAUDE.md files are probably not being loaded
microlatency
β€”
09-18 18:26first on hacker news Β· published Β· +532.4hAnthropic finally adds AGENTS.md support to Claude Code
deaux
β€”
09-17 22:05amplified on r/ClaudeAIreddit.post.1wj7v4y
microlatency
peak 20 Β· 9 comments Β· 1% of case engagement
09-18 18:26amplified on hacker newshn.story.49758250
deaux
peak 52 Β· 10 comments Β· 3% of case engagement
09-18 19:58amplified on hacker newshn.story.49759414
skwashd
peak 3 Β· 0 comments Β· 0% of case engagement
09-18 21:00amplified on hacker news πŸ‘‘hn.story.49760187
datadrivenangel
peak 740 Β· 283 comments Β· 54% of case engagement
09-19 11:30amplified on hacker newshn.story.49765635
tosh
peak 3 Β· 0 comments Β· 0% of case engagement
09-20 11:58amplified on hacker newshn.story.49774919
thisisfatih
peak 4 Β· 0 comments Β· 0% of case engagement
4 more amplifiers in ainews.case_chain
09-17 22:20our radar first saw it Β· +512.3hdiscovery anchor: reddit.post.1wj7v4yβ€”
09-19 08:26reached heat=high Β· +546.4h Β· via ledgerβ€”β€”

Evidence (11) β€” ⭐ canonical anchor

sourceobjectauthorscorecomments
🟠 redditIn auto mode, your nested CLAUDE.md files are probably not being loaded
ClaudeAI
microlatency209
🟧 echo.github ⭐The issue reports that Auto Mode tells Claude to use Bash commands such as cat and sed instead of native Read/Edit/Write tools. Its firsthanGabriel Gosselin (gabgoss)β€”β€”
🟧 hnAnthropic finally adds AGENTS.md support to Claude Codedeaux522
🟧 hnClaude Code 2.1.277 adds support for AGENTS.mdskwashd30
🟧 hnClaude Code now reads AGENTS.md if there is no Claude.mddatadrivenangel740283
🟧 hnClaude Code Supports AGENTS.mdtosh30
🟧 hnClaude Code is getting native AGENTS.md supportthisisfatih40
🟧 hnWhat Claude Code's AGENTS.md fallback does not coversamplexBro30
🟧 hnClaude Code reads AGENTS.md only when telemetry is onpszypowicz486284
🟠 redditI read my Claude Code transcripts to find where the tokens went. Caveman would have saved 1%. The real leak was 4 things nobody talks about.
ClaudeAI
mudmohammad010
🟠 redditHeads-up: Claude Code ignores your AGENTS.md if you also have a CLAUDE.md (plus the 4-stage workflow I use)
ClaudeAI
bestpromptfinder06

Interpretation history

Decision trace