Skip to main content
Collaboration

Discussions

Clarify engineering questions with teammates and specialist agents, review options, and record actionable decisions.

Availability: Business plans (Teams and Enterprise). Not yet available on individual plans.
Discussions let you work with teammates and specialist agents to clarify requirements, review technical proposals, or investigate defects. Add context, reply to specific questions, and use @ to ask an agent to analyze information or compare options. Mark agreed conclusions as key messages so participants can find and follow up on them. For a payment idempotency review, invite backend teammates to explain the current implementation, test teammates to add failure cases, and an agent to compare designs. After the review, record the chosen approach, open questions, and owners of the follow-up work.

Start a discussion

State what needs deciding and what result you need. This helps participants focus their contributions and recognize when the question has been answered. If an issue already exists, open it in a project and start a discussion with its title and description prefilled. For a proposal or topic without an issue, create a standalone discussion with the following steps.
  1. Open Discussion in the main sidebar and choose New discussion.
  2. Enter Discussion title to state the question to discuss.
  3. Use Discussion description for the background, open questions, and expected outcome.
  4. Optionally select existing project members or agents, or add attachments. You can also create the discussion first and invite people with a sharing link.
  5. Choose Create to open the discussion.
For example: 
Topic: Review payment request idempotency.
Context: A client retry after a timeout may produce duplicate requests.
Backend teammates: explain the current constraints. Test teammates: identify failure cases.
Participating agents: compare the options using the supplied design material.
Expected output: tradeoffs, risks, regression tests, and owners of next steps.
The project lead confirms the decision. Analyze only; do not change code or deploy.

Invite participants

When creating a discussion, you can select existing project members. After creating it, send the discussion link to anyone else you want to invite so they can join through the link. The sharing dialog does not yet support searching for members to invite, and you cannot directly add arbitrary people from the organization directory. Invite people whose input the decision needs. For a payment design review, backend teammates can explain implementation constraints and test teammates can identify failure cases.
  1. Open the discussion and choose Share at the top.
  2. Check whether Allow joining from share link is enabled. Enable it when you want to invite people with the link.
  3. Choose Copy link and send it to the intended participants.
  4. Review participants under Who has access in the sharing dialog or Details > Members on the right.
Turn off joining via link in the sharing dialog when you no longer need link invitations.

Add context and reply to messages

Add design documents, screenshots, and other context and reply to specific points so participants can check feedback against the same context. Write in the input box and choose Send message. To add design material, choose Add attachment, select a file, and send the message. The file appears with the sent message. To respond to a specific point, choose Reply on the message, write in the input box with the quoted context, and send. Choose Go to quoted message on the reply to return to the original message. Type @ to select a person or agent to mention.

Ask agents for help

Ask your own agents to compare options, analyze risks, or suggest test cases. Use their responses as review input: ask for supporting reasoning, add missing constraints, and have participants confirm the chosen approach. You can choose agents when creating a discussion. After creation, open Share > Add Agent / Agent Team to add your own agents. To configure an agent’s model, instructions, or other settings, open Settings > Agent before adding it to a discussion. For details, see Custom Agents.
  1. Search for and select the agents you want to include.
  2. Choose Add selected Agents.
  3. Back in the discussion, type @, switch to the Agent tab, select an agent, describe the request, and choose Send message.
If an agent is unavailable, read the reason beside it and use View settings to check its configuration. Give the agent a clear result, source material, and action boundary. For example: “Compare these two idempotency designs using the supplied material and list failure cases. Analyze only; do not modify code.” After sending an @Agent request, choose Open execution chat to inspect the record, response, and status. The completed response also appears in the discussion, where you can ask follow-up questions or mark important content as a key message.
In a discussion, only an agent’s owner can invoke it with @. You can only @ your own agents, not another member’s agents.

Record decisions and next steps

A useful review ends with a chosen approach, its rationale, and owners for the next steps. Recording these gives teammates a reference during implementation and acceptance. Mark a message as a key message when it records a decision, delivery requirement, or important reference:
  1. Choose Mark as key message on the message.
  2. Open the Key messages tab on the right to review marked content.
  3. Choose Go to original message when you need context. Choose Unmark key message to remove the mark.
Once a proposal is agreed, post a summary with the chosen approach, rationale, open questions, and owners of next steps. Mark it as a key message so participants can find the decision later. If the discussion started from an issue, manually record the remaining work in that issue and update its status. For example, record how to handle the same request ID with a different payload as an open question, and add the corresponding test case to the regression-test issue.

Find discussion content

During implementation or acceptance, return to the discussion when you need to check an earlier constraint, decision, or contribution.
  • Use Search messages at the top of a discussion.
  • Choose Pin to sidebar for quick access to a frequently used discussion.
  • Use Details on the right to review its description and participants.
Get Started
Features
Collaboration
Extensions
Configuration
Support