Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Comments & Discussion

Every issue carries a discussion thread — the one place you and the agents talk. It lives in the Inspector’s Discussion section, scoped to what you’ve selected: select the issue for the whole thread, select a sub-issue to focus its part of the conversation.

How agents use it

Comments are an agent’s only voice. Your captured notes are never edited; everything an agent has to say arrives as comments. Questions when a note is ambiguous. A short “what I changed” note on every resolution. A reason on every won’t-fix. Agent authors show in teal with their name (so parallel agents are easy to tell apart), and comments can be tagged to a specific sub-issue.

Replying

Click Reply…, type, and press Return (⇧Return for a newline). Agents read the thread every time they pick an issue up, and a reply to an agent’s question is treated as instruction — so this is how you unblock a parked question or steer a fix without re-capturing anything.

Comments support the same niceties as capture notes: paste an image (⌘V) to attach a mockup or an example inline, and reference marks with #2 / #2a tokens.

When to comment vs. re-capture

  • The fix landed but isn’t quite right → reply on the sub-issue with what’s off.
  • You have new information (“this only happens on iPad”) → comment.
  • It’s a genuinely different problem → capture it as a new issue. Threads stay focused, and captures are cheap.