File Todos

This skill is the source of truth for the file-based todo system. A todo is a markdown file in todos/; it is distinct from an application's Todo model and from temporary progress tracked by an agent runtime.

Authorization and scope

Do not create or modify todo files merely because the user asks a question, requests a review, or wants findings triaged. Persist a finding only when the user asks to track it, approves it during triage, or has already authorized a workflow whose requested output is a todo file.

Within that authorization:

• keep filename status and frontmatter status consistent;
• never reuse an issue ID;
• leave skipped or deferred items unchanged;
• do not implement a finding during triage; and
• do not stage, commit, push, or post external comments unless the user authorized that action. If staging is authorized, stage only the relevant todo and implementation paths.

Choose the operation