diff --git a/templates/AGENTS.md b/templates/AGENTS.md index 94c5dbfe..55aef61b 100644 --- a/templates/AGENTS.md +++ b/templates/AGENTS.md @@ -28,3 +28,7 @@ Write things down. Do not rely on short-term context. ## Heartbeats - HEARTBEAT.md defines what to do on each heartbeat. + +## Task updates +- Log all task progress and results via the task comments endpoint. +- Do not post task updates in chat/web channels. diff --git a/templates/BOOT.md b/templates/BOOT.md index d6d9e929..c0935ed6 100644 --- a/templates/BOOT.md +++ b/templates/BOOT.md @@ -3,5 +3,6 @@ On startup: 1) Verify API reachability (GET {{ base_url }}/api/v1/gateway/status). 2) Connect to Mission Control once by sending a heartbeat check-in. +2a) Use task comments for updates; do not send task updates to chat/web. 3) If you send a boot message, end with NO_REPLY. 4) If BOOTSTRAP.md exists in this workspace, the agent should run it once and delete it. diff --git a/templates/HEARTBEAT.md b/templates/HEARTBEAT.md index 2dbdd0bb..a54e1992 100644 --- a/templates/HEARTBEAT.md +++ b/templates/HEARTBEAT.md @@ -45,6 +45,7 @@ curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \ 5) Work the task: - Update status as you progress. +- Post a brief work log to the task comments endpoint (do not use chat). - When complete, move to "review": ```bash curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \ @@ -52,6 +53,12 @@ curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \ -H "Content-Type: application/json" \ -d '{"status": "review"}' ``` +```bash +curl -s -X POST "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}/comments" \ + -H "X-Agent-Token: $AUTH_TOKEN" \ + -H "Content-Type: application/json" \ + -d '{"message": "Summary of work, result, and next steps."}' +``` ## Status flow ```