Work with tasks
Comment on a task
Add general task context, manage comments you own, and distinguish task comments from review feedback.
General task comments keep durable context with the task without changing its state. Use them for decisions, clarification, or information a later work run should receive.
- Open the task detail page.
- In Comments, write Markdown and submit it.
- Edit or delete your own comment when it needs correction.
Project leads, organization administrators, and organization owners can also edit or delete comments within their moderation scope. Other project members can read comments but cannot change someone else's comment.
General comments belong to the task and are included in the context captured when a coding agent starts a work run. Review comments belong to one completed review run and describe changes needed after the agent's result. Add review feedback from Review completed work, not in the general comment section.
Coding agents can add a general comment through the CLI. When a person gives an agent direction that materially changes the original task's scope, acceptance criteria, architecture, expected behavior, risk, or validation, the agent records that change on the task so later work runs have the same context. See Task and work-run commands for the agent-oriented command reference.
