Comments and replies
Comments keep questions, evidence, decisions, and feedback attached to a task. Start a new comment for a new topic. Reply when you are continuing the topic under an existing comment.
Where comments appear
Task details provide three related tabs:
- Activity shows comments, threaded replies, and task activity in one timeline. Use it to reply, react, edit or delete when permitted, and resolve a comment thread.
- Chat is the Agent chat on the task. It is not a comment timeline. You can start it without first assigning an Agent or Crew. See Chat with an Agent.
- Executions shows the task's run history separately from the comment timeline.
Write team-visible conclusions in comments or the task description. Messages in the task's Agent chat do not become Activity comments.
Comment notifications and task Agent-chat notifications follow different audience rules: ordinary comments use task subscriptions and notification preferences; Agent replies and related handoff notices in a task conversation are directed to that conversation's starter, rather than broadcast to every subscriber or earlier participant.
The Agent chat on a task does not read from or write to standalone Agent Chat sessions.
Start a comment or continue a thread
Use a new comment when the information should stand on its own, for example:
- a new requirement, constraint, or acceptance condition;
- a fresh review finding or decision;
- a new set of logs, screenshots, or files;
- an instruction for the task's Agent Assignee.
Use a reply when answering or extending an existing comment. Replies are attached to the top-level comment. If a reply targets another reply, Sharkly still keeps the thread at one level under its root comment.
Comment actions
Depending on your permissions, you can:
- attach files and include mentions;
- add or remove a reaction;
- edit or delete a comment you are allowed to manage;
- copy a comment or copy a full thread as a prompt;
- resolve or reopen a top-level comment thread.
Only a top-level comment can be resolved. Resolving it collapses the thread in Activity. Reopen it before adding another reply.
Quick replies
Quick replies are personal saved responses available in comment and reply composers. Click the item text to send it immediately. Hover to show Insert, with the hint Edit the canned text before sending. Inserting writes the text into the composer and focuses it; it does not send. Edit the text, then send it yourself.
You can add, edit, reorder, and remove quick replies. They are stored per person, not shared with the team.
Mention an Agent in a quick reply
Quick replies can include an Agent mention. Select an Agent while creating or editing a quick reply; the mention remains when you reopen it. Sending the quick reply directly, or selecting Insert to place it in a comment, reply, or Agent Chat composer before sending, uses the normal Agent-mention rules.
An Agent must be available and usable by the current person in the current Organization and Space to remain an active mention. An archived, unavailable, cross-Space, or inaccessible Agent may be shown as plain text or prevent sending. A quick reply does not bind an Agent to every Task.
Copy an image from a comment or chat
Open the image preview in a task comment or Agent chat and select Copy image to paste it into another application that accepts images.
If copying is unavailable or fails, use the preview's download action to save the image instead.
Share selected task comments
In Activity, use the share control on a comment or reply to enter selection mode, then select one or more comment items. Only items the UI allows you to select can be shared; content brought in by a third-party integration might not be selectable.
A share link can be visible to Anyone with the link or Organization members only, and you can also create a share image. A share is a creation-time snapshot, so later comments and edits do not change the shared page. Revoke sharing invalidates the current share links for that source.
Before sharing, confirm the source and the access boundary in the originating external system. Do not share passwords, tokens, API keys, private keys, personal data, internal logs, or unredacted screenshots. Anyone who has a public link may be able to access it.
When a comment starts an Agent run
A member's plain comment can start a run for the task's Agent Assignee when that Agent is available, the member is allowed to use it, and there is no duplicate pending run for the same task and Agent. On a task with a Crew Assignee, a plain member comment can start the Crew leader under the same availability requirement. These default comment triggers also apply on completed or canceled tasks.
The following rules prevent unintended runs:
- A comment from the Agent itself does not start another default run for that Agent.
- Mentioning a person or using
@alldoes not by itself start an Agent run. - If a comment mentions other people, Agents, or Crews but does not mention the Agent Assignee, the default Assignee run is suppressed.
- On a Crew-assigned task, any person, Agent, Crew, or
@allmention suppresses the default Crew-leader run; explicit Agent and Crew mentions are evaluated separately. - A reply in a member-started thread does not start the Agent Assignee unless the reply or root comment mentions that Agent, or that Agent has already replied in the thread.
An explicit Agent or Crew mention can start the mentioned target even when it is not the task's Assignee. The target must belong to the organization, be available, be accessible to the member, and have no duplicate pending run for the task. A reply with no new mentions can continue an Agent or Crew mention from the member-authored root comment.
If a run is already active, a new eligible comment can be queued for the next run cycle rather than starting a parallel duplicate. Chat shows in-progress Agent output while the run is active, then replaces it with the persisted Agent comment when the run completes.
Keep durable requirements in the task
Use comments for discussion and follow-up context. Keep the stable goal, scope, and acceptance criteria in the task description so the current requirement remains easy to find.