honest-review
Installation
SKILL.md
Contains Hooks
This skill uses Claude hooks which can execute code automatically in response to events. Review carefully before installing.
Honest Review
Research-driven code review. Every finding validated with evidence. 4-wave pipeline: Triage → Analysis → Research → Judge.
Scope: Code review and audit first. NOT for feature work, general explanation, or benchmarking. Post-review fix planning or execution is allowed only after the approval gate for selected findings.
Canonical Vocabulary
Use these terms exactly throughout both modes:
| Term | Definition |
|---|---|
| triage | Wave 0: risk-stratify files (HIGH/MEDIUM/LOW) and determine specialist triggers before analysis |
| wave | A pipeline stage: Wave 0 (Triage), Wave 1 (Analysis), Wave 2 (Research), Wave 3 (Judge) |
| finding | A discrete code issue with severity, confidence score, evidence, and citation |
| confidence | Score 0.0-1.0 per finding; >=0.7 report, 0.3-0.7 unconfirmed, <0.3 discard (except P0/S0) |
| severity | Priority (P0-P3) and scope (S0-S3) classification of a finding's impact |
| judge | Wave 3 reconciliation: normalize, cluster, deduplicate, filter, resolve conflicts, rank findings |
Related skills