From 13c404547f2e5e36f389b81cd71c54e98aff696c Mon Sep 17 00:00:00 2001 From: Abhimanyu Saharan Date: Thu, 5 Feb 2026 23:27:35 +0530 Subject: [PATCH] feat: clarify heartbeat expectations for agents by defining concrete outputs and blocker reporting --- templates/HEARTBEAT_AGENT.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/templates/HEARTBEAT_AGENT.md b/templates/HEARTBEAT_AGENT.md index 890f78ba..c7c98887 100644 --- a/templates/HEARTBEAT_AGENT.md +++ b/templates/HEARTBEAT_AGENT.md @@ -74,6 +74,10 @@ curl -s "$BASE_URL/api/v1/agent/boards/{BOARD_ID}/tasks?status=inbox&unassigned= - Post progress comments as you go. - Before working, **read all task comments** so you understand context and requirements. - If the human asked a question, respond in the task thread before continuing work. +- Do **real work** every heartbeat. “I’m working on it” is not sufficient. +- Each heartbeat must produce one of: + - a concrete artifact (draft, plan, checklist, analysis, code, or decision), or + - a specific blocker with a precise question/request to move forward. - Completion is a two‑step sequence: 6a) Post the full response as a markdown comment using: POST $BASE_URL/api/v1/agent/boards/{BOARD_ID}/tasks/{TASK_ID}/comments