Repository Harness Compatibility Protocol
Overview
Two agents share one taxonomy: deterministic and semantic Phase 0 parity invariants (offline, Bash-based) and seven Phase 1 external-drift dimensions (web-research-backed). The checker detects; the fixer remediates what's safely mechanical and flags the rest for human judgment.
Reference Modules
- phase0-parity-invariants.md — the five invariants, each with detection tool/pass/fail/criticality AND fix scope (auto-fixable vs. human-required)
- phase0-quality-gate-filter.md — exact-ID delegation and retained semantic parity for quality-gate invocation
- phase1-drift-dimensions-d1-d3.md and phase1-drift-dimensions-d4-d7.md — the seven dimensions (D1–D7), each with drift indicator/criticality AND fix target/action
- checker-workflow.md and checker-finding-format.md — the checker's own workflow steps, research delegation pattern, and finding format
- fixer-confidence-and-scope.md, fixer-patterns-and-process.md, and fixer-report-format.md — the fixer's own confidence re-validation, fix patterns, process summary, fix report format, and FALSE_POSITIVE carry-forward
Core Principles
- Standalone Phase 0 runs in full. In the quality-gate workflow, exact
delegated-gate-idsfilter registered vendor, binding, ownership, catalog, and duplication predicates. Missing/stale evidence ispending, not a fallback run; unregistered semantic parity still runs. - Only Invariant 3 (binding sync) and most Phase 1 dimensions auto-fix — anything touching governance prose, root-instruction files, agent-set divergence, or a new color/tier mapping requires human judgment.
- Confidence propagates from the checker's cited source:
[Verified]→ HIGH,[Needs Verification]/[Unverified]→ MEDIUM (fixer downgrades and skips),[Outdated]→ FALSE_POSITIVE. - Conservative drift threshold — flag substantive changes only (a different filename, a renamed directory, a removed required field), never minor wording differences.
Related Agents
harness-compatibility-checker, harness-compatibility-fixer, web-researcher
(delegated Phase 1 research), rules-checker and rules-propagation (different scope).