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/team-debate.md
View on GitHub# TeamAgent Debate
## Summary
TeamAgent Debate is a read-only review pass where multiple agents read the same change from different perspectives to reduce blind spots.
## When required
Run when any of the following applies:
- Changes span multiple modules
- Change touches security / auth / release / distribution / mirror
- Alignment with the spec source-of-truth or `Plans.md` is ambiguous
- Regression risk is high
- Claude and Codex verdicts diverge
- Reviewers disagree on perspective-based ratings
- Same issue fails two consecutive post-fix re-reviews
## Agents
| Agent | Primary question |
|---|---|
| Spec Agent | Find contradictions between the spec source-of-truth and the implementation diff |
| Plans Agent | Verify the diff aligns with `Plans.md` task / DoD / Depends |
| Regression Agent | Find regressions in existing behavior, tests, distribution mirrors, CLI/skill UX |
| Skeptic Agent | Find major risks being missed because of an implicit assumption that the change should pass |
Minimum 2 perspectives; up to 4 when needed.
All agents are read-only.
## Codex fallback
Do not skip TeamAgent Debate when native TeamAgents are unavailable in a Codex environment.
Available fallbacks:
- `codex-companion.sh review`
- reviewer subagent
- explicit manual-pass (each perspective reviewed separately)
Record one of the following in `team_agent_mode`:
- `native`
- `codex-companion`
- `manual-pass`
- `unavailable`
If `unavailable` and manual-pass is also impossible, stop with `decision_needed`.
## Output
```json
{
"team_debate": {
"required": true,
"mode": "manual-pass",
"team_agent_mode": "manual-pass",
"agents": ["Spec Agent", "Plans Agent", "Regression Agent"],
"disagreements": [],
"acceptance_bar": {
"spec_alignment": "pass",
"plans_alignment": "pass",
"regression_safety": "pass"
}
}
}
```
## Pass criteria
If a TeamAgent Debate disagreement is critical / major → `REQUEST_CHANGES`.
If downgrading to minor / recommendation, document the reason with evidence.
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 |