file-todos

Installation
SKILL.md

File-Based Todo Tracking Skill

Overview

The .context/systematic/todos/ directory contains a file-based tracking system for managing code review feedback, technical debt, feature requests, and work items. Each todo is a markdown file with YAML frontmatter and structured sections.

Legacy support: During the transition period, always check both .context/systematic/todos/ (canonical) and todos/ (legacy) when reading or searching for todos. Write new todos only to the canonical path. Unlike per-run scratch directories, .context/systematic/todos/ has a multi-session lifecycle -- do not clean it up as part of post-run scratch cleanup.

This skill should be used when:

  • Creating new todos from findings or feedback
  • Managing todo lifecycle (pending -> ready -> complete)
  • Triaging pending items for approval
  • Checking or managing dependencies
  • Converting PR comments or code findings into tracked work
  • Updating work logs during todo execution

Directory Paths

Installs
1
GitHub Stars
23
First Seen
Mar 26, 2026
file-todos — marcusrbrown/systematic