cyberneticlibrary

Scan Python codebases for TODO comments

todo-scannerworkflowsetup L27
nft-maker-one/claude_course
What it does

Scan Python files and report TODOs by priority

Best for

Quick inventory of technical debt across a Python codebase when distributed priorities and actionable top-3 recommendations are needed.

Inputs
  • · [object Object]
Outputs
  • · [object Object]
Preconditions

Target directory exists; Python files readable

Failure modes

Missing TODOs in deeply nested comments; priority misclassification; agent null returns

Trust signals
  • · Two-phase parallel scan (list-files, per-file agents)
  • · Priority heuristics (FIXME=high, improve=medium)
  • · Markdown report with prioritization