Comment Accuracy — Development agent for Claude Code
Detects stale comments, docstring-signature mismatches, and contradicted NOTE/TODO/FIXME markers.
How to install Comment Accuracy
Installs to ~/.claude/agents/andyzengmath-soliton-comment-accuracy.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/andyzengmath/soliton/HEAD/agents/comment-accuracy.md -o ~/.claude/agents/andyzengmath-soliton-comment-accuracy.md Restart Claude Code, or start a new session, for it to be picked up.
What Comment Accuracy does
name: comment-accuracy description: Detects stale comments, docstring-signature mismatches, and contradicted NOTE/TODO/FIXME markers model: haiku tools: ["Read", "Grep", "Glob"]
Comment Accuracy Agent
You are a specialist reviewer for **comment rot** — the failure mode where code changes but comments describing it do not. Because LLM coding agents tend to edit the code they touch and leave surrounding comments alone, this is an empirically high-frequency issue in AI-authored PRs.
**
Alternatives in Development
- Lex Legal — Use this agent when dealing with legal and compliance activities 523 ★
- Comprehensive Todo List — Comprehensive TODO: Implement Agent Orchestration in mcp-prompts 113 ★
- Dependency Tracer — Traces which components and scripts import a specific function from src/scripts/utils.js 108 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Todo Scanner
MUST be used whenever the user asks to find, list, count, or triage TODO/FIXME/HACK/XXX comments (or similar c
API Type Contract Review
Reviews a diff for API/contract violations and type-safety failures — breaking signature changes, incompatible
Swe Dev Change Assurance Engineer
Reviews consequential changes by asking which prior claims and evidence still apply, what became stale or cont
Sdd Cross Auditor
Cross-references all 9 SDD skill definitions for I/O contract mismatches, version inconsistencies, and stale c
Git Reconciler
Git branch reconciliation specialist using git and the gh CLI. Use whenever there are merge conflicts, a diver
Comment Analyzer
Use this agent when you need to analyze code comments for accuracy, completeness, and long-term maintainabilit
Related Skills
Todo Finder
Find TODO/FIXME comments and suggest priorities
Tech Debt Tracker
Scans codebase for technical debt indicators (TODO/FIXME, high complexity, duplication, outdated deps) and gen
Audit End Sprint
End-of-sprint code audit — run 9-dimension sweep (security, quality, tests, dead code, TODO/FIXME, perf, docs,