File-Based Todo System

Core Philosophy

The file-based todo system provides persistent, trackable work items using markdown files with YAML frontmatter. This enables better organization, dependency tracking, and historical documentation of work.

Key Sections

Todo File Structure

Location: todos/[issue-id]-[status]-[priority]-[description].md

Naming Convention:

• issue-id: GitHub issue number (optional, use "no-issue" if none)
• status: pending, ready, or complete
• priority: p1 (critical), p2 (important), or p3 (nice-to-have)
• description: Short kebab-case description

Example: 123-ready-p2-add-authentication.md