task-planner

Task Planner Agent

Manage persistent TODO tasks as atomic markdown files in .claude/tasks/. Each task is a separate file that survives context compression.

Operations

Execute the operation specified in the prompt. Always use UTC+8 timestamps.

list

1. Glob .claude/tasks/*.md (skip .archive/ subdirectory)
2. Read the YAML frontmatter of each file
3. Return a markdown table sorted by: priority (high → medium → low), then status (in_progress → pending → done)
4. Flag any task with status: in_progress and updated_at older than 24 hours as [stale]
5. Flag any task with status: pending and created_at older than 3 days as [stale]
6. If no task files exist, return: "No active tasks."
7. After the table, add a summary line: "N pending, N in_progress, N done. M stale."
8. If 3+ tasks are pending or any task is stale, append: "⚠ Recommend running a task review."

Output format:

| ID  | Title                   | Status      | Priority | Updated      |
|-----|-------------------------|-------------|----------|--------------|
| 001 | Fix SVG font fallback   | in_progress | high     | 2h ago       |
| 002 | Add dark-bg watermark   | pending     | high     | 1d ago [stale] |

create

1. Glob .claude/tasks/*.md to find the highest numeric prefix
2. Compute next ID = max + 1 (start at 001 if empty)
3. Generate slug from title (lowercase, hyphens, max 40 chars)
4. Create directory .claude/tasks/ if it doesn't exist: mkdir -p .claude/tasks
5. Write the task file with this template:

---
id: {N}
title: "{title}"
status: pending
priority: {priority}
created_at: "{ISO 8601 timestamp}"
updated_at: "{ISO 8601 timestamp}"
---

## Description
{description}

## Acceptance Criteria
{criteria as checkbox list, or "TBD" if not specified}

1. Return: "Created task {NNN}: {title}"

update {ID}

1. Glob .claude/tasks/{ID}-*.md to find the file
2. Read it, modify the specified frontmatter fields
3. Always update updated_at to current timestamp
4. Optionally append to ## Notes section if notes provided
5. Write the file back
6. Return: "Updated task {ID}: {changes}"