harness-refine

Generates and routes rule proposals from trajectory findings by blast radius.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-refine-maicongambini
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-refine
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/harness-refine
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-refine-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It turns recurring violations, blind spots, and stalled objectives found in agent trajectory findings into governed rule proposals, without letting machine-learned rules influence the current run's approval. ## Core Features & Use Cases - Failure-signature detection: Maps recurring violations, uncitable blind spots, tool-call loops, stalled objectives, unmeasured escapes, and dead rules to Create/Update/Delete proposals. - Blast-radius routing: Routes prose proposals to a rule-verifier for refutation and lint/test/gate-metric or high-risk-path proposals to an operator gate with literal text rendered. - Evidence-bound proposals: Requires source findings with file:line citations, conflict checks, refuted_by criteria, and records every outcome including rejections in refine-log.md. - Use Case: After a Judge phase completes, dispatch the refiner over the findings window so a recurring lint violation becomes a proposed rule update that the operator approves or rejects at confirmation. ## Quick Start Run the Refine phase after Judge by dispatching the refiner subagent with the findings window counts and per-rule proposeBar blocks from harness-findings.mjs.

Frequently Asked Questions about harness-refine

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the Refine phase in the continual harness?▼

Run Refine after Judge and before awaiting_confirmation by dispatching the refiner subagent with the findings window counts from harness-findings.mjs --window <n> --json. The scheduler supplies all numbers; the refiner never recomputes them.

How are rule proposals routed by blast radius?▼

Proposals with prose enforcement on non-high-risk paths go to a rule-verifier that tries to refute them; unrefuted proposals auto-activate. Lint, test, gate-metric, or high-risk-path proposals go to the operator gate with literal text rendered for approval.

What happens when there are no new findings to refine?▼

The refiner says "no new evidence" and stops without proposing anything. Absence of findings is named as a gap, never treated as a clean run, and tier auto produces no findings by design.

Can the refiner write rules directly into the rulebook?▼

No. The refiner is read-only and writes nothing. The Confirm phase applies approved prose as a separate rulebook commit after the code commit and trailer, keeping the gate's sourceHash valid.

What is the blind_spot path and why is it high risk?▼

The blind_spot signature authors new rule text with no rule pointer, so pointer-resolution defenses do not apply. Mitigations include ledger validation, untrusted-data fencing, redaction of diff-originating fields, and human or verifier review of literal text.