From 2a2dfdcb0c132edd6754d3806da95468cf287608 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B9=80=EC=9E=AC=ED=98=84?=
 <231584193+kimdzhekhon@users.noreply.github.com>
Date: Thu, 16 Jul 2026 07:18:00 +0900
Subject: [PATCH] docs: replace .claudeignore troubleshooting tip with
 permissions.deny
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Claude Code never shipped .claudeignore support — the original feature
request (anthropics/claude-code#579) was closed pointing users at
permissions.deny rules instead, and a long tail of reports confirms
the file is silently a no-op (anthropics/claude-code#36163, #16704,
#46699, #56997, #65812). The README's prompt-cache troubleshooting
entry told users to create one, which does nothing and leaves the
cache-invalidation symptom unresolved.

Replace it with the supported .claude/settings.json deny-rule
equivalent, with a caveat that deny rules gate access (not just
caching), which conflicts with reading graphify-out/ back for
navigation.

Fixes #1843.
---
 README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index 81685cf72..82453706c 100644
--- a/README.md
+++ b/README.md
@@ -597,12 +597,12 @@ graphify install  # overwrites the skill file
 ```
 
 **Claude Code prompt cache invalidated after every `graphify extract`**
-Graphify writes output files (`graph.json`, `graphify-out/`) into the workspace. If those paths aren't ignored, every write invalidates Claude Code's prompt cache, forcing a full re-upload at cache-write rates on the next turn. Add them to `.claudeignore`:
-```text
-# .claudeignore
-graph.json
-graphify-out/
+Graphify writes output files (`graph.json`, `graphify-out/`) into the workspace. If those paths aren't ignored, every write invalidates Claude Code's prompt cache, forcing a full re-upload at cache-write rates on the next turn. Claude Code has no `.claudeignore` support — deny read access to those paths instead:
+```json
+// .claude/settings.json
+{ "permissions": { "deny": ["Read(./graphify-out/**)", "Read(./graph.json)"] } }
 ```
+Note this gates *access*, not just cache behavior — it also blocks workflows that read `graphify-out/` back (e.g. using the generated wiki for navigation). If you rely on those, skip this and accept the cache cost instead.
 
 ---