Agent instructions as comments on diffs

No description provided.

Prior art: Orca ships this as "Annotate AI Diff" (stablyai/orca, docs/site/content/docs/review/annotate-ai-diff.mdx).

How Orca does it

Hover any diff line and a + appears in the gutter; click it (or press c on the line) and type a note. Notes support markdown; Cmd-Enter saves, Esc cancels.
Notes are pinned to their line and follow it if the diff shifts.
Send to agent builds ONE prompt from all notes, each anchored to its line, then opens a "Send notes to" menu listing the worktree's agents. You can also start a new agent from that menu. A keyboard shortcut for sending exists but is unbound by default.
After the agent revises, the notes stay put so you can check each fix. Resolve collapses a thread, and unresolved notes go out again with the next Send.
Orca's reason for batching: "Sending comments one at a time causes the agent to swing back and forth."

The diff surfaces already exist: macapp/WorkroomApp/Views/DiffViewer.swift and macapp/WorkroomApp/Views/ChangesPanel.swift. A grep of macapp/ for line or review comments finds nothing, so this would be new.
Delivery to the agent: paste into the target pane like agent prompt in CLI: let agents and scripts drive other agents (agent list/prompt/wait/read, terminal read, event stream) #360, ideally refusing while the agent is busy (Agent lifecycle via first-party hooks (Claude Code plugin, Codex notify) instead of inferring from OSC 9;4 #361 gives reliable state). Until then, a paste with Return via ghostty_surface_key works (ghostty_surface_text alone does not submit).
The diff-line-comments-swallow-taps pitfall applies: .textSelection(.enabled) diff text eats real mouse-downs, so the gutter + needs a hit target outside the selectable text.

🤖 Left by Claude Code