Automates the identification, comparison, and quality gating of TODO and FIXME comments across your codebase.
todo-scan is a specialized utility designed to manage technical debt by scanning source code for comments like TODO, FIXME, BUG, and HACK. It enables developers to list issues with priority filters, compare changes between git branches to prevent debt accumulation, and enforce CI/CD quality gates that block merges if critical bugs or excessive tasks are detected. By integrating with Claude, this skill provides structured visibility into codebase annotations, ensuring that temporary notes do not become permanent oversights during the development lifecycle.
主な機能
01Structured JSON output for programmatic analysis and automated reporting.
024 GitHub stars
03Multi-tag scanning for TODO, FIXME, HACK, XXX, BUG, and NOTE comments.
04CI quality gating with configurable limits on task counts and blocked tags.
05Git-based diffing to track newly added or removed tasks between branches.
06Customizable exclusion patterns and project-level configuration via .todo-scan.toml.
ユースケース
01Blocking pull requests that contain critical BUG or FIXME tags via CI gates.
02Monitoring task accumulation by comparing the current feature branch against the main branch.
03Auditing technical debt by listing and sorting high-priority TODOs before a release.
