todo-review

Validate a TODO file's structure and freshness by checking its format compliance, internal anchor integrity, and resolution order. This read-only review process identifies stale items and dependency inconsistencies to produce evidence-based PASS, WARN, or FAIL verdicts.

Task triage for Markdown TODO files is a read-only review mechanism that audits priority summaries, dependency consistency, and resolution order rationales. It works by spot-checking referenced behaviors and recent commit signals to ensure implementation readiness without modifying the target file.

Check internal anchor integrity and format compliance by enforcing structural Markdown requirements and verifying that disallowed markup patterns are absent. The review validates that a correct Priority Summary table exists alongside a complete Suggested resolution order bullet list.

You can review TODO files automatically across multiple task areas by relying on automatic selection of the most recently modified TODO under the todos/ directory. Alternatively, you can specify an explicit file path or use a named area-to-file mapping for single-area reviews.

Your TODO file fails a readiness check when it lacks a valid Priority Summary table, contains broken internal anchors, or has an incomplete Suggested resolution order missing rationales. Dependency inconsistencies and stale items flagged by recent commit signals also trigger FAIL verdicts.

The TODO review process does not modify your target Markdown file. It operates as a strictly read-only review that generates PASS, WARN, or FAIL reports with concrete evidence for anything blocking implementation, ensuring your original task data remains untouched.