todo-management

Project Todo Management

Manage project tasks using the todo.md file as the source of truth.

When to Use This Skill

• When starting a work session on this project
• When the user asks about todos, tasks, or what to work on
• When completing a task (to mark it done)
• When adding new work items

Instructions

1. Always use todo.md as the source of truth for project todos

   • The TodoWrite tool is for tracking progress within a single session
   • The todo.md file persists across sessions and is version-controlled

2. Showing todos:

   • Read todo.md and display pending items clearly
   • Group by category if applicable

3. Adding todos:

   • Read todo.md, add the new item under the appropriate "Pending" section
   • Use - [ ] checkbox format for consistency

4. Completing todos:

   • Find the matching item in Pending section
   • Move it to the Completed section with - [x] format
   • Include any sub-items if applicable

5. Managing completed items:

   • Keep only the 10 most recent completed items in the Completed section
   • When Completed exceeds 10 items, delete the oldest items
   • No separate archive section - just maintain last 10 completed
   • This keeps the todo.md file focused and scannable

6. Starting work:

   • Read todo.md, identify the task to work on
   • Create a TodoWrite session list to track progress on that item
   • Begin working on it

Important

When starting any work session on this project, check todo.md first to understand pending work and maintain continuity across sessions.