Add Automated Task Worker section to TOOLS.md for session continuity

This commit is contained in:
Matt Bruce 2026-02-24 10:07:31 -06:00
parent 2fc03b178b
commit 58c6e27a5f

View File

@ -144,6 +144,80 @@ cd /Users/mattbruce/Documents/Projects/OpenClaw/Web/gantt-board
- **Matt:** 0a3e400c-3932-48ae-9b65-f3f9c6f26fe9 - **Matt:** 0a3e400c-3932-48ae-9b65-f3f9c6f26fe9
- **Max:** 9c29cc99-81a1-4e75-8dff-cd7cc5ceb5aa - **Max:** 9c29cc99-81a1-4e75-8dff-cd7cc5ceb5aa
---
## 🔄 Automated Task Worker (24/7)
**CRITICAL:** This is the PRIMARY workflow for all task work. Read this every session.
### Cron Job
- **Job ID:** `b9f3bbe6-bcb5-4483-8816-d044fd91c58a`
- **Schedule:** Every hour (24/7)
- **Scope:** Current sprint ONLY (ignores backlog/future sprints)
- **Statuses:** `open`, `todo`, `in-progress`
- **Assignee:** Max (9c29cc99-81a1-4e75-8dff-cd7cc5ceb5aa)
### When User Says "Create a Task"
1. Immediately add to Gantt Board via CLI: `./scripts/gantt-task-crud.sh create "Title" todo high ...`
2. Assign to current sprint
3. Do NOT create separate files (unless specifically asked)
### Reading Full Task Details (REQUIRED)
**ALWAYS query Supabase for complete task before working:**
```bash
curl -s "https://qnatchrjlpehiijwtreh.supabase.co/rest/v1/tasks?id=eq.{task_id}&select=*" \
-H "apikey: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InFuYXRjaHJqbHBlaGlpand0cmVoIiwicm9sZSI6InNlcnZpY2Vfcm9sZSIsImlhdCI6MTc3MTY0MDQzNiwiZXhwIjoyMDg3MjE2NDM2fQ.rHoc3NfL59S4lejU4-ArSzox1krQkQG-TnfXb6sslm0" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InFuYXRjaHJqbHBlaGlpand0cmVoIiwicm9sZSI6InNlcnZpY2Vfcm9sZSIsImlhdCI6MTc3MTY0MDQzNiwiZXhwIjoyMDg3MjE2NDM2fQ.rHoc3NfL59S4lejU4-ArSzox1krQkQG-TnfXb6sslm0"
```
**READ in this order:**
1. **Title** - High-level goal
2. **Description** - Implementation details, steps
3. **Comments** (ALL of them) - What's done? What's next? What's left?
### Task Comment Format (APPEND to existing)
```json
{
"id": "{timestamp}-{random}",
"text": "[YYYY-MM-DD HH:MM] 🔄 In Progress\n\n**What was just done:**\n- Step completed\n\n**What is next:**\n- Next action\n\n**What is left to do:**\n- Remaining work",
"replies": [],
"createdAt": "YYYY-MM-DDTHH:MM:SSZ",
"commentAuthorId": "9c29cc99-81a1-4e75-8dff-cd7cc5ceb5aa"
}
```
### Status Flow
```
open/todo → in-progress → review → (user validates) → done
Add progress comment at EACH step
```
### Updating Tasks
```bash
curl -s -X PATCH "https://qnatchrjlpehiijwtreh.supabase.co/rest/v1/tasks?id=eq.{task_id}" \
-H "apikey: {service_key}" \
-H "Authorization: Bearer {service_key}" \
-H "Content-Type: application/json" \
-d '{
"status": "in-progress",
"comments": [EXISTING_COMMENTS_PLUS_NEW_ONE]
}'
```
### Subagent Coordination
- Spawn subagents for parallel work
- Subagents READ same full task details
- Subagents REPORT back with progress
- YOU update task comments with their work
### User Workflow
- User creates task in Gantt Board
- Cron/auto picks it up hourly
- I work on it, log everything in comments
- Move to `review` when complete
- User validates, moves to `done`
## Tavily AI Search (Configured) ## Tavily AI Search (Configured)
**API Key:** Stored in `.env.tavily` (auto-loaded) **API Key:** Stored in `.env.tavily` (auto-loaded)