Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Comments and Mentions

Collaborate in context and pull teammates in with @mentions.

Overview

Comments keep discussion attached to the work item.

@mentions create a high-signal notification to a specific Teammate.

Key Concepts

  • Comment: message attached to an item

  • @mention: notification to a Teammate

  • Permalink: stable link to an item or comment

  • Follower / watcher: subscription to item updates (when enabled)

How It’s Used

Use comments for decisions, status updates, questions, and approvals.

Use external messaging tools only for transient coordination.

Summarize outcomes back into the item record for traceability.

Benefits

  • Clear decision trail inside the work item

  • Faster reviews through in-context discussion

  • Reduced context loss during handoffs

Setup Steps

1

Add a comment

Screenshot placeholder: item detail panel with the comment box highlighted.

  1. Open the task, requirement, or test case.

  2. Locate the comment box in the detail panel.

  3. Enter the message.

  4. Select Comment (or submit with Enter).

2

Mention a Teammate

  1. Type @ in the comment field.

  2. Select a Teammate from the list.

  3. Add the expected action and timing.

GIF placeholder: type @ → select a Teammate → post the comment.

3

Edit or delete a comment

  1. Open the comment menu (⋮).

  2. Select Edit or Delete.

  3. Confirm the change.

Edits and deletions may be limited by role and policy.

Best Practices

  • Keep one decision per comment when possible.

  • Use a consistent pattern, such as Decision: and Approved by:.

  • Use @mentions for action-required requests only.

  • Link related items instead of copying long text.

Summary

Related:

Last updated