todo-files

Manage TODO files with structured sections and naming conventions for multi-session development tracking.

9|10|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/jkomoros/community-patterns --skill todo-files
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: todo-files
Source: https://github.com/jkomoros/community-patterns/tree/main/.claude/skills/todo-files
Command: npx skills add https://github.com/jkomoros/community-patterns --skill todo-files

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of losing context, design decisions, and progress when working on complex patterns across multiple sessions or when collaborating. It ensures continuity and efficiency, allowing you to pick up exactly where you left off.

Core Features & Use Cases

  • Persistent Working Memory: Maintain detailed TODO files that track design rationale, implementation steps, and technical notes. This acts as your external brain for ongoing projects.
  • Multi-Session Continuity: Quickly resume work by reviewing "Next Steps" and "Technical Notes" from previous sessions, eliminating the need to re-familiarize yourself with the project.
  • Knowledge Transfer: Document choices and challenges, making it easier for others (or your future self) to understand the pattern's evolution and rationale.
  • Use Case: When starting a new, multi-feature pattern, create a TODO file to outline requirements, document early design decisions, and track your progress. This ensures you can pick up exactly where you left off days later, without missing a beat.

Quick Start

I'm starting a new complex pattern called 'data-ingestor'. Use the todo-files skill to create a new TODO file for it and outline the initial structure.

Frequently Asked Questions about todo-files

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I maintain project context across multiple development sessions?

Persistent TODO files track design decisions, implementation progress, and technical notes across sessions. By documenting rationale, blockers, and next steps in structured sections, you capture your working memory externally so you can resume work immediately without re-familiarizing yourself with the project state.

What's the best way to document complex pattern development decisions?

Structure TODO files with sections for requirements, design rationale, implementation steps, technical notes, testing progress, and blockers. This enforced organization ensures all stakeholders and your future self understand the pattern's evolution, trade-offs, and architectural choices.

Can I use TODO files for multi-session feature design and research-driven decisions?

Yes. TODO files are designed for multi-session pattern development, feature design, research workflows, and architecture documentation. Frequent updates to capture design decisions and progression make them ideal for collaborating across sessions or handing off work.

How do I prevent losing progress when working on complex patterns over time?

TODO files enforce structured sections and naming conventions that capture implementation progress, design choices, and next steps. This persistent working memory eliminates context loss and ensures continuity when picking up work days or weeks later.

What information should I track in a TODO file for knowledge transfer?

Document design choices, implementation rationale, technical challenges, testing notes, and blockers encountered. This creates a complete pattern evolution record that makes it easier for collaborators or your future self to understand decisions and resume progress without redundant discovery.