task-management

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:

1. Check if dashboard.html exists in the current working directory
2. If dashboard template is available, copy it to the current working directory
3. Inform the user about the dashboard availability

The task board:

• Reads and writes to the same TASKS.md file
• 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):

# 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