rlaope/oh-my-hermes / skills/omh-code-review
omh-code-review
Verified[omh] Pull request or changes to vet: bug-first review with evidence. Use when the user says: code-review, review, audit, find bugs, claim audit, evidence audit, README claim, what actually happened.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.9 KB |
| references/architecture-delta.md | markdown | 4.9 KB |
| references/finding-validation.md | markdown | 4.9 KB |
| references/native-review-contract.md | markdown | 7.2 KB |
| references/review-dispatch.md | markdown | 11.6 KB |
| references/review-lenses.md | markdown | 5.2 KB |
| references/review-response.md | markdown | 2.4 KB |
| references/risk-selection.md | markdown | 4.3 KB |
| references/smell-baseline.md | markdown | 4.4 KB |
references/review-response.md
View on GitHub# Receiving a Review
Review feedback is a technical claim to evaluate, not a verdict to perform
agreement with. Load this when findings arrive, before changing anything.
## Verify before implementing
1. **Read** the whole set without reacting.
2. **Restate** each item in your own words. If you cannot, you do not understand it yet.
3. **Verify** it against the codebase as it actually is.
4. **Evaluate** whether it is correct *for this project*, not in general.
5. **Respond** with a technical acknowledgement or reasoned push-back.
6. **Implement** one item at a time, checking each.
## The clarification gate is all-or-nothing
If any item is unclear, ask about it **before implementing any of them**.
Findings are frequently related. Implementing the four you understood can make
the two you did not understand harder to fix, or can implement them wrongly by
implication. Partial understanding produces a partial-fix diff that then needs
its own review round.
## Push-back is part of the contract
A reviewer working from a diff has less context than you do. When a finding is
wrong, say so with the technical reason and the evidence - the test that covers
it, the constraint that forbids the suggested shape, the platform it breaks.
Do not implement a change you believe is wrong in order to close a finding. That
trades a review round for a defect.
What is not push-back: silence, partial implementation, or implementing
something adjacent and calling the finding addressed.
## Order the work
1. Anything that blocks other items.
2. Correctness, highest severity first.
3. Everything mechanical.
Re-run the verifying command after each, not once at the end. A batch of fixes
verified together cannot tell you which one regressed.
## What not to say
Performative agreement wastes a turn and hides whether the item was understood.
Skip "you're absolutely right", "great catch", and "let me implement that now" -
restate the requirement, or start working.
## Convergence
From round two, the review is a ratchet: new findings on ground the previous
round already settled need a stated reason they were not visible earlier, and a
finding carried forward keeps the severity it was raised at. If the repository
has no `REVIEW.md`, apply these two rules as written; this file only covers the
reviewee's side.
## Boundary
Reading a finding is not fixing it. A fix is observed only when the command that
demonstrated the defect no longer does.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |