Use when creating durable work items, managing todo lifecycle, or tracking findings across sessions in the file-based todo system
The .context/compound-engineering/todos/ directory is a file-based tracking system for code review feedback, technical debt, feature requests, and work items. Each todo is a markdown file with YAML frontmatter.
Legacy support: Always check both
.context/compound-engineering/todos/(canonical) andtodos/(legacy) when reading. Write new todos only to the canonical path. This directory has a multi-session lifecycle -- do not clean it up as scratch.
| Purpose | Path |
|---|---|
| Canonical (write here) | .context/compound-engineering/todos/ |
| Legacy (read-only) |
todos/ |
{issue_id}-{status}-{priority}-{description}.md
pending | ready | completep1 (critical) | p2 (important) | p3 (nice-to-have)Example: 002-ready-p1-fix-n-plus-1.md
Each todo has YAML frontmatter and structured sections. Use the todo template included below when creating new todos.
---