1
0
Fork 0

docs(claude-md): the linking example published one machine's home directory

org-ops census sweep 07 flagged CLAUDE.md:56 as LINK-FILE-URL (ERROR): the
example link carried file:///Users/ktg/..., which is dead for every reader but
the author and publishes the operator's directory layout on a public surface.

The rule itself is unchanged — absolute file:// paths with a descriptive name
are still what a response should use. Only the example is now a placeholder,
with a note saying why it has to stay one.

Note for the verify step: 'grep -n file:///' over this file cannot go empty by
construction — line 48 specifies the link syntax and must contain the literal.
The distinguishing check is 'grep -n file:///Users/', which is now empty.
This commit is contained in:
Kjell Tore Guttormsen 2026-08-13 20:08:12 +02:00
commit 72de0e0c15

View file

@ -51,6 +51,7 @@ When pointing to local files in responses, always use markdown link syntax with
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:
Example (the path is a placeholder — the checkout root is the reader's own, and
this file is published, so it must not carry one machine's directory layout):
- [Brief](file:///Users/ktg/repos/llm-ingestion-pipeline-security/docs/BRIEF.md)
- [Brief](file:///absolute/path/to/llm-ingestion-pipeline-security/docs/BRIEF.md)