tim-hub/powerball-harness / harness/skills/harness-review
harness-review
VerifiedMulti-angle code and plan review with security, scope, and UI profiles. Use when reviewing code, plans, PRs, or running pre-merge quality gates.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| references/code-review.md | markdown | 2.1 KB |
| references/codex-closeout.md | markdown | 2.6 KB |
| references/codex-review.md | markdown | 1.2 KB |
| references/dual-review.md | markdown | 2.8 KB |
| references/governance.md | markdown | 2.2 KB |
| references/opencode-review.md | markdown | 2.3 KB |
| references/plan-review.md | markdown | 891 B |
| references/result-schema.md | markdown | 2.7 KB |
| references/scope-review.md | markdown | 344 B |
| references/security-profile.md | markdown | 11.8 KB |
| references/team-debate.md | markdown | 2.0 KB |
| references/ui-rubric.md | markdown | 7.3 KB |
| references/verdict-framework.md | markdown | 1.6 KB |
references/result-schema.md
View on GitHub# Review Result Schema (review-result.v1)
Output JSON for all review types:
```json
{
"schema_version": "review-result.v1",
"verdict": "APPROVE | REQUEST_CHANGES",
"verdict_reasoning": {
"rationale": "Explanation of why this verdict was selected",
"triggering_issues": ["List of critical/major findings that triggered REQUEST_CHANGES, if applicable"],
"confidence": "high | medium"
},
"reviewer_profile": "static | runtime | browser",
"critical_issues": [
{
"category": "Security | Performance | Quality | Accessibility | AI Residuals",
"location": "filename:line_number",
"issue": "issue description",
"severity_justification": "Why this is critical",
"suggestion": "fix suggestion"
}
],
"major_issues": [
{
"category": "Security | Performance | Quality | Accessibility | AI Residuals",
"location": "filename:line_number",
"issue": "issue description",
"severity_justification": "Why this is major",
"suggestion": "fix suggestion",
"scope": "task-specific | universal"
}
],
"observations": [
{
"severity": "minor | recommendation",
"category": "Security | Performance | Quality | Accessibility | AI Residuals",
"location": "filename:line_number",
"issue": "issue description",
"suggestion": "fix suggestion",
"scope": "task-specific | universal"
}
],
"recommendations": ["non-mandatory improvement suggestions"],
"calibration": {
"label": "false_positive | false_negative | missed_bug | overstrict_rule",
"source": "manual | post-review | retrospective",
"notes": "observation memo",
"prompt_hint": "key points for few-shot",
"few_shot_ready": true
}
}
```
For browser reviews, `generate-browser-review-artifact.sh` determines `browser_mode` and route/artifacts.
`write-review-result.sh` normalizes and saves to `.claude/state/review-result.json`.
Calibration entries with `calibration` are appended to `.claude/state/review-calibration.jsonl` via `record-review-calibration.sh`; the few-shot bank is updated via `build-review-few-shot-bank.sh`.
For `--ui-rubric` flag, add this field:
```json
{
"ui_rubric": {
"design_quality": { "score": 8, "observations": ["..."] },
"originality": { "score": 6, "observations": ["..."] },
"craft": { "score": 9, "observations": ["..."] },
"functionality": { "score": 7, "observations": ["..."] }
}
}
```
UI rubric scores are informational and do not affect the verdict unless `functionality` score ≤ 3.
For `--dual` flag, add a `dual_review` field — see [`${CLAUDE_SKILL_DIR}/references/dual-review.md`](${CLAUDE_SKILL_DIR}/references/dual-review.md).
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 |