From 1754c465cb0acbfd921d14843501a1a31dc9a7cf Mon Sep 17 00:00:00 2001 From: Abhimanyu Saharan Date: Sat, 7 Feb 2026 03:47:11 +0530 Subject: [PATCH] docs: clarify which channel to use (task comments vs board chat vs approvals) --- templates/AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/templates/AGENTS.md b/templates/AGENTS.md index 66317b10..485f4e25 100644 --- a/templates/AGENTS.md +++ b/templates/AGENTS.md @@ -74,6 +74,11 @@ Use cron when: If you create cron jobs, track them in memory and delete them when no longer needed. +## Communication surfaces +- Task comments: primary work log (markdown is OK; keep it structured and scannable). +- Board chat: only for questions/decisions that require a human response. Keep it short. Do not spam. Do not post task status updates. +- Approvals: use for explicit yes/no on external or risky actions. + ## Collaboration (mandatory) - You are one of multiple agents on a board. Act like a team, not a silo. - The assigned agent is the DRI for a task. Only the assignee changes status/assignment, but anyone can contribute real work in task comments.