diff --git a/agents/claude.ts b/agents/claude.ts
index 4817814..59a47e7 100644
--- a/agents/claude.ts
+++ b/agents/claude.ts
@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { type Options, query, type SDKMessage } from "@anthropic-ai/claude-agent-sdk";
 import type { Effort } from "../external.ts";
 import { ghPullfrogMcpName } from "../external.ts";
diff --git a/agents/codex.ts b/agents/codex.ts
index 7ac91aa..14676a4 100644
--- a/agents/codex.ts
+++ b/agents/codex.ts
@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import {
diff --git a/agents/cursor.ts b/agents/cursor.ts
index 0162c89..76c7aa6 100644
--- a/agents/cursor.ts
+++ b/agents/cursor.ts
@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
diff --git a/agents/gemini.ts b/agents/gemini.ts
index 103d102..bcd1dd0 100644
--- a/agents/gemini.ts
+++ b/agents/gemini.ts
@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
diff --git a/agents/opencode.ts b/agents/opencode.ts
index 3414481..c8726a1 100644
--- a/agents/opencode.ts
+++ b/agents/opencode.ts
@@ -1,3 +1,6 @@
+// changes to effort level configuration should be reflected in wiki/effort.md and docs/effort.mdx
+// changes to tool permissions should be reflected in wiki/granular-tools.md
+// changes to web search configuration should be reflected in wiki/websearch.md
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { ghPullfrogMcpName } from "../external.ts";
diff --git a/main.ts b/main.ts
index 2bc300a..f903c2c 100644
--- a/main.ts
+++ b/main.ts
@@ -1,3 +1,4 @@
+// changes to tool permissions should be reflected in wiki/granular-tools.md
 import { ensureProgressCommentUpdated } from "./mcp/comment.ts";
 import { initToolState, startMcpHttpServer } from "./mcp/server.ts";
 import { computeModes } from "./modes.ts";
diff --git a/mcp/bash.ts b/mcp/bash.ts
index b9559c1..0c5c36b 100644
--- a/mcp/bash.ts
+++ b/mcp/bash.ts
@@ -1,3 +1,4 @@
+// changes to bash security (filterEnv, spawnBash) should be reflected in wiki/bash-sandbox.md, wiki/security.md, wiki/landlock.md, and docs/security.mdx
 import { type ChildProcess, type StdioOptions, spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { closeSync, openSync, writeFileSync } from "node:fs";
diff --git a/modes.ts b/modes.ts
index 929db6e..f8e0967 100644
--- a/modes.ts
+++ b/modes.ts
@@ -1,3 +1,4 @@
+// changes to mode definitions should be reflected in docs/modes.mdx
 import { type } from "arktype";
 import { ghPullfrogMcpName } from "./external.ts";
 
diff --git a/utils/instructions.ts b/utils/instructions.ts
index 4b141a4..8d61169 100644
--- a/utils/instructions.ts
+++ b/utils/instructions.ts
@@ -1,3 +1,4 @@
+// changes to prompt assembly should be reflected in wiki/prompt.md
 import { execSync } from "node:child_process";
 import { encode as toonEncode } from "@toon-format/toon";
 import { ghPullfrogMcpName, type PayloadEvent } from "../external.ts";