From de33bc70e70ddeac4e6f421bd5992b9b28086f6e Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 19 Jan 2026 04:01:32 +0000
Subject: [PATCH] docs: clarify node_modules guidance

---
 AGENTS.md    | 1 +
 CHANGELOG.md | 1 +
 2 files changed, 2 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index b3232360f..f7df7daef 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -84,6 +84,7 @@
 
 ## Agent-Specific Notes
 - Vocabulary: "makeup" = "mac app".
+- Never edit `node_modules` (global/Homebrew/npm/git installs too). Updates overwrite. Skill notes go in `tools.md` or `AGENTS.md`.
 - When working on a GitHub Issue or PR, print the full URL at the end of the task.
 - When answering questions, respond with high-confidence answers only: verify in code; do not guess.
 - Never update the Carbon dependency.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e676e2359..b7ad5b6bc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@ Docs: https://docs.clawd.bot
 
 ### Changes
 - Usage: add `/usage cost` summaries and macOS menu cost submenu with daily charting.
+- Agents: clarify node_modules read-only guidance in agent instructions.
 
 ### Fixes
 - Plugins: surface plugin load/register/config errors in gateway logs with plugin/source context.