[DOCS] `claude agents` job-row summaries do not document `[Image #N]` rendering for pasted images

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/agent-view

Section/Topic

• "Row summaries" subsection (the section that explains how the one-line summary per row is generated by a Haiku-class model)
• "From agent view" subsection, specifically the line that introduces pasted images into the dispatch prompt

Current Documentation

The agent view guide describes row summaries as follows:

### Row summaries The one-line summary in each row is generated by a Haiku-class model so the row can tell you what the session is doing, what it needs, or what it produced without opening the transcript. While a session is actively working, the summary refreshes at most once every 15 seconds, plus once when each turn ends. From v2.1.161, when the session is running two or more parallel work items, such as subagents, background shell commands, or monitors, a done/total count such as 2/5 appears before the summary text.

The same page mentions pasted images only in the dispatch section:

Paste an image into the prompt to include a screenshot or diagram with the task.

The docs do not describe how pasted images are represented inside the row summary text itself.

The [Image #N] placeholder is documented on other pages, but not on the agent view page:

• interactive-mode.md, "General controls" table:

| Ctrl+V or Cmd+V (iTerm2) or Alt+V (Windows and WSL) | Paste image from clipboard | Inserts an [Image #N] chip at the cursor so you can reference it positionally in your prompt. On WSL, both Ctrl+V and Alt+V are bound; use Alt+V if your terminal intercepts Ctrl+V |

• common-workflows.md, "Work with images" tips:

* When Claude references images (for example, [Image #1]), Cmd+Click (Mac) or Ctrl+Click (Windows/Linux) the link to open the image in your default viewer

What's Wrong or Missing?

In v2.1.191, the changelog says: "Fixed claude agents job rows showing full filesystem paths for pasted images instead of the [Image #N] placeholder".

After this fix, the one-line summary shown in an agent view job row replaces any pasted-image reference with an [Image #N] placeholder (matching how the prompt input chip and Claude's response references render on the other docs pages). The agent view guide does not mention this rendering rule anywhere. Two concrete gaps:

A. The "Row summaries" section does not describe the [Image #N] substitution

It explains the model used, the refresh cadence, and the parallel-work done/total prefix, but never tells readers that pasted-image content is collapsed into [Image #N] placeholders in that summary text. Users comparing what the row actually shows to what the docs describe have to discover this behavior on their own.

B. The dispatch section's image-paste sentence does not connect to the row output

The line "Paste an image into the prompt to include a screenshot or diagram with the task" is the only mention of pasted images in the agent view guide. It does not say what the user will see in the row summary afterwards, and it does not warn that the summary is generated and so will not contain the raw image path even though the prompt itself did.

Suggested Improvement

Update the agent view guide so the [Image #N] placeholder behavior is documented for the job-row surface.

For example:

• In "Row summaries", add a short note such as:

Pasted images in the original dispatch prompt are summarized as [Image #N] placeholders instead of as filesystem paths, so the row text stays short and stable across machines.

• In "From agent view", expand the existing "Paste an image into the prompt to include a screenshot or diagram with the task" sentence to make the placeholder substitution explicit, e.g.:

Paste an image into the prompt to include a screenshot or diagram with the task. The pasted image is referenced as [Image #N] in the dispatch input and continues to appear as an [Image #N] placeholder in the job row summary and in Claude's replies, not as the underlying file path.

That keeps the agent view page consistent with how the [Image #N] placeholder is described in interactive-mode.md and common-workflows.md.

Impact

Medium - Makes feature difficult to understand

Additional Context

This gap matters for the v2.1.191 release entry: "Fixed claude agents job rows showing full filesystem paths for pasted images instead of the [Image #N] placeholder". The fix changes what users see in every job row whose dispatch prompt included a pasted image, and the agent view guide is the natural place to look for an explanation.

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/agent-view | 134-140 | "Row summaries" section describes the model, refresh cadence, and parallel-work prefix but does not mention [Image #N] substitution for pasted images |
| https://code.claude.com/docs/en/agent-view | 246 | "From agent view" subsection is the only mention of pasted images on the page and does not explain how they render in the row summary |

Total scope: 1 documentation page affected (agent view), with cross-references to the pages where the placeholder is already documented.

Related existing documentation for context:

• https://code.claude.com/docs/en/interactive-mode — documents the [Image #N] chip inserted at the cursor in the prompt input (different surface; covers paste behavior, not row rendering).
• https://code.claude.com/docs/en/common-workflows — documents [Image #N] in the context of Claude's response references (different surface; covers reply references, not row rendering).
• https://code.claude.com/docs/en/changelog — v2.1.83 ("Pasted images now insert an [Image #N] chip at the cursor so you can reference them positionally in your prompt") and v2.1.191 ("Fixed claude agents job rows showing full filesystem paths for pasted images instead of the [Image #N] placeholder") together define the placeholder behavior across the prompt input, response, and job-row surfaces.

Version context: The placeholder substitution in job rows ships in v2.1.191. The behavior is new enough that the agent view guide should describe it explicitly rather than leave users to infer it from the other two pages.