feat(agents): Update documentation for task updates and logging mechanism
This commit is contained in:
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user