Skip to content

docs: fix Claude Code prompt-cache troubleshooting — .claudeignore is a no-op, use .claude/settings.json deny rules #1845

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
prvthmpcypher wants to merge 1 commit into
base: v8
Choose a base branch
from
+6 −6
Open

docs: fix Claude Code prompt-cache troubleshooting — .claudeignore is a no-op, use .claude/settings.json deny rules #1845

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 does not support `.claudeignore`; the supported mechanism is a `deny` rule in `.claude/settings.json`:
```json
// .claude/settings.json
{ "permissions": { "deny": ["Read(./graphify-out/**)", "Read(./graph.json)"] } }
```
> **Note:** `deny` rules gate Claude Code's *read access*, not just cache inclusion. This means Claude Code can no longer read files under `graphify-out/` — including `GRAPH_REPORT.md` and the wiki — which conflicts with navigation workflows that rely on those files. If you use `graphify-out/` as a navigation source, omit the deny rule and accept the cache invalidation cost, or scope it to specific files (e.g. only `Read(./graphify-out/graph.json)`).

---

Expand Down Expand Up @@ -849,4 +849,4 @@ See [ARCHITECTURE.md](ARCHITECTURE.md) for module responsibilities and how to ad
<a href="https://x.com/graphifyy"><img src="https://img.shields.io/badge/X-graphifyy-000000?logo=x&logoColor=white" alt="X"/></a>
<a href="https://github.com/sponsors/safishamsi"><img src="https://img.shields.io/badge/sponsor-safishamsi-ea4aaa?logo=github-sponsors" alt="Sponsor"/></a>
<a href="https://safishamsi.gumroad.com/l/qetvlo"><img src="https://img.shields.io/badge/Book-The%20Memory%20Layer-2ea44f?style=flat&logo=gitbook&logoColor=white" alt="The Memory Layer"/></a>
</p>
</p>