Task Supervisor

Manage long-running tasks with checkpoints, progress files, and periodic WhatsApp reports.

Is This a Large Task?

Before doing anything else, mentally check:

Signal	Large?
Steps ≥ 5 OR time > 20 min	✅ Yes
User says "take your time / overnight / keep me posted"

✅ Yes |
| Needs sub-agent + cron + multiple domains | ✅ Yes |
| Single tool call, quick search, short edit, Q&A | ❌ No — skip this skill entirely |
| "Help me write X" (one doc, one sitting) | ❌ No |
| "Search for Y and summarize" (few minutes) | ❌ No |

If not large → respond normally, skip task files and crons entirely.

On Task Start

When you receive a large task, immediately:

1. 1. Create a task file at .tasks/<TASK-SLUG>.md (use kebab-case slug)
2. Decompose the task into numbered steps
3. Spawn a reporter cron to send progress updates
4. Begin execution, updating the file after each step

Task File Format

CODEBLOCK0

During Execution

After every step (success or failure):

• - Update the checkbox in Steps ([x] done, [!] failed)
• Append a Log entry with timestamp and key findings
• Update Last Updated timestamp

On failure:

• - Mark step [!] with error summary
• Try an alternative approach if obvious
• If truly stuck, set Status to paused and note what's needed

Progress Reporting (Cron)

At task start, spawn a cron reporter using exec:

CODEBLOCK1

Adjust interval based on task scope:

• - Quick task (<30 min): every 10 min
• Medium task (30 min–2 hr): every 15 min
• Long task (>2 hr): every 30 min

On Task Completion

1. 1. Fill in ## Result section with a clear summary
2. Set INLINECODE8
3. Send a final Feishu message: task name, what was accomplished, any caveats
4. Remove the progress cron

On Task Failure / Getting Stuck

1. 1. Set INLINECODE9
2. Document exactly what was tried and what's blocked
3. Send Feishu message alert immediately (don't wait for cron)
4. Do NOT silently stop — always notify

Resuming a Paused Task

When asked to continue a task:

1. 1. Read INLINECODE10
2. Find the last completed step
3. Continue from there
4. Re-spawn reporter cron if needed

Multi-Task Awareness

If multiple tasks are running, maintain separate files per task. On heartbeat, check .tasks/ for any in_progress tasks and include a brief status in heartbeat responses.

Quick Reference

Situation	Action
Task assigned	Create file, decompose, spawn cron, start
Step done

Update [x], append log | | Step failed | Mark [!], try alternative, log error | | Truly stuck | Set paused, WhatsApp alert immediately | | Task complete | Fill Result, set done, final message, remove cron | | Asked for update | Read task file, summarize current state |