Task Management
Tasks are tracked in a simple TASKS.md file that both you and the user can edit.
File Location
Always use TASKS.md in the current working directory.
- •If it exists, read/write to it
- •If it doesn't exist, create it with the template below
Dashboard Setup (First Run)
A visual dashboard is available for managing tasks and memory. On first interaction with tasks:
- •Check if
dashboard.htmlexists in the current working directory - •If not, copy it from
${CLAUDE_PLUGIN_ROOT}/skills/dashboard.htmlto the current working directory - •Inform the user: "I've added the dashboard. Run
/productivity:startto set up the full system."
The task board:
- •Reads and writes to the same
TASKS.mdfile - •Auto-saves changes
- •Watches for external changes (syncs when you edit via CLI)
- •Supports drag-and-drop reordering of tasks and sections
Format & Template
When creating a new TASKS.md, use this exact template (without example tasks):
markdown
# Tasks ## Active ## Waiting On ## Someday ## Done
Task format:
- •
- [ ] **Task title** - context, for whom, due date - •Sub-bullets for additional details
- •Completed:
- [x] ~~Task~~ (date)
How to Interact
When user asks "what's on my plate" / "my tasks":
- •Read TASKS.md
- •Summarize Active and Waiting On sections
- •Highlight anything overdue or urgent
When user says "add a task" / "remind me to":
- •Add to Active section with
- [ ] **Task**format - •Include context if provided (who it's for, due date)
When user says "done with X" / "finished X":
- •Find the task
- •Change
[ ]to[x] - •Add strikethrough:
~~task~~ - •Add completion date
- •Move to Done section
When user asks "what am I waiting on":
- •Read the Waiting On section
- •Note how long each item has been waiting
Conventions
- •Bold the task title for scannability
- •Include "for [person]" when it's a commitment to someone
- •Include "due [date]" for deadlines
- •Include "since [date]" for waiting items
- •Sub-bullets for additional context
- •Keep Done section for ~1 week, then clear old items
Extracting Tasks
When summarizing meetings or conversations, offer to add extracted tasks:
- •Commitments the user made ("I'll send that over")
- •Action items assigned to them
- •Follow-ups mentioned
Ask before adding - don't auto-add without confirmation.