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.