task-management

# Task Management

Tasks are tracked in a simple `TASKS.md` file that both you and the user can edit.

When task sources are supplied as web pages, read [the SandBase API map](references/sandbase-api-map.md) and use only the capabilities listed there. Resolve the listed capability with `sandbase_discover`, inspect its returned `name` with `sandbase_inspect`, then follow `execute_as` to call `sandbase_run(name: "<returned name>", arguments: { ... })` using only the current schema. For async results, poll `sandbase_run_get` with the returned `run_id` within the task budget; report pending or failed runs without automatically resubmitting them.

## File Location

**Always use `TASKS.md` in the current working directory.**

- If it exists, read it and make only user-requested edits
- If it doesn't exist, offer the template below; create it when the user asks to add or manage tasks

## Optional Dashboard

If the project already provides a task dashboard, it may be used with the same
`TASKS.md` file. Do not create or copy dashboard assets unless the user requests
that separately and a valid source asset is available.

## 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 completed items for at least ~1 week; clear or archive them only when the user requests it

## 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.

Shown under the source repo’s Apache-2.0 license. Read the full folder on GitHub.