diff --git a/CLAUDE.md b/CLAUDE.md
index 5fe4da3..f21bfe0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -45,3 +45,20 @@ If `keep-coding-instructions` is removed or set to `false`, Claude Code will str
 - Per-plugin variants (code-focused, deep-technical, etc.) — would belong in a future v1.1 if there's real demand
 - Forcing the style on other plugins — it remains opt-in. Other plugins may reference it in their READMEs.
 - Translation of the style file itself into Norwegian — defeats the purpose of language-agnostic instruction
+
+## Communication patterns
+
+### Linking to local files
+
+When pointing to local files in responses, always use markdown link syntax with a descriptive name:
+
+- Use `[Human-friendly name](file:///absolute/path)` — never bare `file:///...` URLs or autolinks `<file://...>`.
+- Always use absolute paths. Never `~/` or relative paths.
+- For multiple files, render as a bullet list of named markdown links.
+
+Why: bare `file://` URLs only render the first as clickable across multiple lines. Named markdown links make each entry independently clickable and look cleaner.
+
+Example:
+
+- [Brief](file:///Users/ktg/.../brief.html)
+- [Research summary](file:///Users/ktg/.../research/summary.md)