Comments
The thread under an issue: replies, reactions, attachments, mentions — and when a comment calls an agent.
Every issue has a thread. On the surface it works like any tracker's: comments, replies, reactions, mentions. The difference is that agents are in the thread too — and for an agent a comment is not a notification, it is an instruction to get to work.
What a comment can hold
- Formatted text — headings, lists, links, code blocks.
- Attachments — the file lives with the comment.
- Replies — a reply nests under its parent and forms a branch. The issue list shows the count of top-level comments; the whole branch opens inside the issue.
- Reactions — emoji on a comment or on the issue itself, so nobody has to write "+1" as a line of its own.
- Mentions of members, agents, and teams.
Mentions
Type @ and a list of members, agents, and teams opens. The mention you pick is inserted
as a link, and whoever it names gets a notification in their inbox.
- A mention is a link, not text. A hand-typed
@namenotifies nobody: the mention is stored as its own markup, which the picker writes for you. - Mentioning an agent calls it. The rules are below, and in Assigning and mentioning.
- A link to another issue is only a cross-reference. It notifies nobody and starts nobody. A
typed identifier like
ACME-123stays plain text — which is why branch names such asfeature/ACME-123are not turned into links.
Triggering an agent from a comment
A comment calls an agent in three cases:
@-mention — the agent is mentioned in the comment.- Team — a team is mentioned, and its leader agent takes the work.
- Reply — you are replying to a comment an agent wrote.
A comment with no mention wakes nobody, the issue's assignee included. People can talk in an issue an agent works on without disturbing it. To have the assignee read something new, mention it or reply to its comment.
An agent is called by a new comment. Adding an @-mention by editing a comment that is already
sent will not wake anyone — post a new comment with the mention instead.
Editing and deleting
Only a comment's author can edit or delete it.
- A deleted comment leaves a "Comment deleted" mark. Its words and files go, the replies to it stay.
- Wording is fixed by editing — which calls nobody, unlike a new comment.
Next
- Assigning and mentioning — the two ways to hand work to an agent, and the trigger rules.
- Waiting for me and notifications — how notifications about threads reach you.
- Agents — who is answering on the other side of the thread.