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
- 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:
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.

View File

@@ -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
```