> skills // review & truth
honesty
Audit a codebase so every comment, docstring and doc tells the truth about the code.
// what it is
Comments rot. honesty walks a codebase module by module and finds the comments, docstrings, READMEs and architecture notes that no longer match what the code does. It ships the safe fixes through a confidence and blast-radius gate, and queues the risky ones for a human.
GOOD FOR // Making a codebase trustworthy for the next agent or developer who reads it before changing anything.
// how it works
Say "run honesty" or "do the comments match the code"
Splits findings into auto-fix vs human-review by confidence and blast radius
// install
It is a Claude Code plugin. Add the marketplace, then install. Two lines in the Claude Code prompt:
/plugin marketplace add jezweb/honesty
/plugin install honestysource & docs: github.com/jezweb/honesty