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.