From 2b1a1832ef15cb010ee561a32bde532631d5df88 Mon Sep 17 00:00:00 2001 From: Kjell Tore Guttormsen Date: Mon, 29 Jun 2026 10:25:49 +0200 Subject: [PATCH] =?UTF-8?q?docs(claude-md):=20compress=20communication-pat?= =?UTF-8?q?terns=20block=20(=E2=88=9293=20always-tok)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit CLAUDE.md loads every turn while working in this repo (776 always-loaded tokens). The file is otherwise lean (project context + conventions + workflow invariants, all kept). The one verbose block was the "Linking to local files" section: a 3-bullet rule plus a "Why" paragraph and a 2-line worked example with full absolute paths. Compressed to a single sentence that keeps the rule (named markdown links, absolute paths, one bullet per file) and the reason (bare file:// renders only the first as clickable). 50→36 lines, 776→683 tok. Docs-only. Co-Authored-By: Claude Opus 4.8 (1M context) Claude-Session: https://claude.ai/code/session_01683eAqVecv9VZfQzL8CQ9h --- CLAUDE.md | 15 +-------------- 1 file changed, 1 insertion(+), 14 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 40e9847..55a86b3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -33,17 +33,4 @@ Python ≥3.10. MAF (`agent-framework-core` 1.9.0). Pakkehåndtering: `uv`. To b ## 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 ``. -- 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: - -- [Research report](file:///Users/ktg/repos/portfolio-optimiser/docs/research/2026-06-23-prior-art-platform.md) -- [Incremental plan](file:///Users/ktg/repos/portfolio-optimiser/docs/plan/2026-06-23-incremental-plan.md) +When linking to local files in responses, use named markdown links — `[Human-friendly name](file:///absolute/path)`, never bare `file://` URLs or autolinks ``, always absolute paths (never `~/` or relative), one bullet per file when there are several. (Bare `file://` URLs render only the first as clickable across multiple lines; named links stay independently clickable.)