user: how to actually show him an image

Asked three times on 2026-08-19 to see a generated icon and answered with a
Preview window, a hunt for terminal image tools, and a hyperlink before an image
appeared. Nothing said he reads through a markdown client, or that the file has
to be public before a tag can reach it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

user/CLAUDE.md

@@ -126,6 +126,26 @@ tool authenticates.
 Never revoke, rotate or invalidate a credential on your own. That breaks things
 he did not ask you to break.
 
+## Showing him an image: markdown, and a public URL
+
+He reads these sessions through a client that renders markdown — web or the
+phone app. `![](https://…)` is the ONLY way an image reaches him.
+
+Everything else fails, and most of it fails silently:
+
+- reading the file shows it to YOU. He sees nothing.
+- `open`/`xdg-open` opens a viewer on a machine he may not be sitting at.
+- a BARE URL renders as a link on the web client. Always write the `![]()`.
+- a local path in the tag renders nothing. The client fetches over the network,
+  from its own device, so the file has to be somewhere public first.
+
+Known hosts: anything Atelier generated is already served at
+`https://atelier.officer.dev/images/<id>.png`. `oas.officer.dev` is key-gated and
+answers 401 to his client, so it cannot be used for this.
+
+If you have an image he needs to see and nowhere public to put it, say so rather
+than sending a path — a path is indistinguishable from a broken image.
+
 ## Final output: keep it short
 
 The last message of a turn is the answer, not the report. Keep it as short as