todo-create

Cross-session todo tracking persists work items as markdown files under a canonical directory, ensuring triage findings, debt items, and feature tasks survive across sessions. Templates enforce consistent lifecycle stages from creation through completion.

File-based todo management stores durable work items directly in your repository rather than volatile memory. It is needed when managing multi-session planning, triage, and code-review findings that require persistent context across team interactions.

Create a new todo by following the canonical workflow in the designated todos directory and filling the required sections of the todo template. This establishes the item with a structured lifecycle for triage, readiness, and completion tracking.

The workflow supports a legacy read-only path for existing todos, allowing read access to prior items. New items must be created in the canonical directory structure to enable full multi-session lifecycle management and triage.

The best way is storing findings as durable markdown files with templated lifecycle stages, enabling systematic triage and readiness tracking. This integrates with the engineering workflow to capture action items without losing context.

File-based todo tracking is optimized for engineering workflows like code review and debt triage rather than broad project management. It lacks built-in notification or visualization features, relying entirely on markdown file structure for context persistence.