AL-JANEF/janef-forge / skills/engineering/review-defect-first
review-defect-first
VerifiedIndependent review of a diff, PR, or file that hunts concrete defects introduced by the change: correctness, security, data loss, authorization or tenant escape, production failure, broken contracts, performance regressions, missing critical tests. Severity-ordered findings citing a real code path; no style inflation; "no qualifying defect" is valid. Use for code review and as the independent gate at high risk.
Defect-First Review
A review exists to find concrete, actionable defects introduced by the change. Style preferences, speculative concerns, and unsupported findings are noise; "no qualifying defect found" is a valid, honest result.
Method
- Read applicable repository instructions and the complete relevant diff, plus enough surrounding code to trace behavior end to end.
- Continue through the whole diff; do not stop at the first finding.
- Prioritize: correctness, security, data loss, authorization or tenant escape, production failure, broken contracts, performance regressions, missing critical tests. Then maintainability issues that will cause defects.
- Confirm each finding from a real code path, call site, invariant, or test gap. If you cannot point at it, it is not a finding.
- Order by severity and cite the smallest useful path and line range.
- End with residual risks and material verification gaps only.
The dimension checklist and the forbidden-pattern scan are in references/review-checklist.md.
Severity
- Blocking: correctness or security defect, data loss, authorization escape, broken contract.
- Should fix: real issue that is not blocking merge.
- Consider: hardening or improvement with a concrete benefit.
- Verified good: what is demonstrably correct; say so.
Output
## Review: <target>
### Blocking
- <file:line> — <defect> → <fix> (evidence: <path/test/invariant>)
### Should fix
### Consider
### Verified good
### Residual risk / not verified
Reviewers report; they do not edit. Route security-class findings to vuln-audit for remediation and to variant-hunt to sweep for siblings.
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: 468k | 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: 468k | 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: 468k | 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 |