{"version":"2.1.290","anchor":"hooks-module-fsancestors-reads-agentsmd-with-a-held-outs","canonical_anchor":"hooks-module-fsancestors-reads-agentsmd-with-a-held-outs","heading":"CLAUDE.md, AGENTS.md and rules files outside your working folders can be withheld","tier":"use","area":"Hooks","scope":"both","heads_up":true,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.290\/e\/hooks-module-fsancestors-reads-agentsmd-with-a-held-outs","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.290","markdown":"### CLAUDE.md, AGENTS.md and rules files outside your working folders can be withheld\n\nWhen reads are restricted, instruction files that a Read deny rule covers or that lie outside your working folders are skipped, with the reason logged\n\n**Unclear.** What the new options do, and how AGENTS.md is handled, is not clear.\n\n**What**\n\nInstruction files are files such as `CLAUDE.md`, `CLAUDE.local.md`, `AGENTS.md` and rules files that Claude Code loads to learn about your project. When file reads are restricted, or `blockReadsOutsideWorkingDirectories` is set, Claude Code now checks each one before loading it:\n\n- A file covered by a Read deny rule, or one that resolves to a location outside your working folders, for example through a symbolic link (a shortcut to another place), is skipped. The log records why, starting with \"Instruction file not loaded\".\n\n- Claude Code also times how long the auto-memory index takes to load.\n\n- For hooks modules, `$.fs.ancestors` now accepts held and session options and treats `AGENTS.md` and `.claude\/AGENTS.md` specially, applying the same outside-the-folder check.\n\n- When a plugin withholds the result of a call, the error now says whether the call had \"started\" or \"ran\" before the plugin withheld its result, instead of just `$.<name>: <reason>`.\n\n**Why**\n\nA `CLAUDE.md` that is symlinked from elsewhere or covered by a deny rule can now silently stop loading when reads are restricted. If Claude seems to ignore your instructions, check the log for \"Instruction file not loaded\". Plugin authors using hooks modules see the new `AGENTS.md` handling and clearer withheld-result errors.\n\n- Area: Hooks\n- Tier: Use it now\n- Useful: 3\/5\n- Signal: 3\/5\n- Scope: both\n- Heads-up: yes"}