feat(agents): Update documentation for task updates and logging mechanism

This commit is contained in:
Abhimanyu Saharan
2026-02-04 18:17:24 +05:30
parent 7892dfad7c
commit d2f4d11508
3 changed files with 12 additions and 0 deletions

View File

@@ -28,3 +28,7 @@ Write things down. Do not rely on short-term context.
## Heartbeats ## Heartbeats
- HEARTBEAT.md defines what to do on each heartbeat. - 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.

View File

@@ -3,5 +3,6 @@
On startup: On startup:
1) Verify API reachability (GET {{ base_url }}/api/v1/gateway/status). 1) Verify API reachability (GET {{ base_url }}/api/v1/gateway/status).
2) Connect to Mission Control once by sending a heartbeat check-in. 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. 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. 4) If BOOTSTRAP.md exists in this workspace, the agent should run it once and delete it.

View File

@@ -45,6 +45,7 @@ curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \
5) Work the task: 5) Work the task:
- Update status as you progress. - Update status as you progress.
- Post a brief work log to the task comments endpoint (do not use chat).
- When complete, move to "review": - When complete, move to "review":
```bash ```bash
curl -s -X PATCH "$BASE_URL/api/v1/boards/{BOARD_ID}/tasks/{TASK_ID}" \ 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" \ -H "Content-Type: application/json" \
-d '{"status": "review"}' -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 ## Status flow
``` ```