compare-harnesses

Featured

Diff two scaffolded harnesses (ADR-031). Reports manifest meta drift + host list + per-file fingerprint changes (added/removed/changed). Exits 0 IDENTICAL, 1 DRIFT, 2 missing manifest. Use --bundle for the ADR-031 schema-1 JSON envelope.

AI & Automation 647 stars 78 forks Updated today MIT

Install

View on GitHub

Quality Score: 88/100

Stars 20%
94
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# compare-harnesses > Codex skill: diff two scaffolded harnesses — the ADR-031 Bundle JSON > Pattern surfaced through Codex (iter 105 → iter 109). ## What it does Two-harness diff. Useful when you've forked an upstream template, when a support ticket says "mine and theirs scaffolded different things", or when a CI script wants a byte-equality check between a candidate scaffold and a known-good baseline. Reports three sections: 1. **Manifest meta** — same name? same kernel? same surface? 2. **Hosts** — which host adapters each side ships (`claude-code` / `codex` / `pi-dev` / `hermes` / `openclaw` / `rvm`) 3. **Files** — added / removed / changed (per-file SHA-256 fingerprints; the cheapest possible byte-equality test) | Verdict | Exit | Meaning | |---|---|---| | `IDENTICAL` | 0 | meta + hosts + every file fingerprint matches | | `DRIFT` | 1 | at least one of meta / hosts / files differs | | `no-manifest-in-a` | 2 | `a/.harness/manifest.json` missing | | `no-manifest-in-b` | 2 | `b/.harness/manifest.json` missing | | `no-manifest-in-either` | 2 | both sides missing manifest | ## Usage from Codex ``` /compare-harnesses a=./my-fork b=./upstream /compare-harnesses a=./my-fork b=./upstream bundle=true ``` ## Equivalent CLI ```bash harness compare ./my-fork ./upstream # text output harness compare ./my-fork ./upstream --bundle # ADR-031 schema-1 JSON ``` The `--bundle` form (ADR-031) emits a schema-1 JSON envelope so CI scripts can json-pars...

Details

Author
ruvnet
Repository
ruvnet/metaharness
Created
2 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

diag-harness

Kernel-version skew check (ADR-027). Reports manifest surface + manifest kernel + installed kernel + verdict (match/patch-diff/minor-diff/major-diff). Exits 1 on minor/major skew with a copy-pasteable `npm install @metaharness/kernel@X.Y.Z` next step. Exits 2 if no .harness/manifest.json at path.

647 Updated today
ruvnet
AI & Automation Solid

upgrade-harness

Drift detection + apply for a scaffolded harness. Re-renders the template with the same vars, computes added/removed/changed file plan, and applies with Git-style conflict markers or .rej files. Default is dry-run.

647 Updated today
ruvnet
Data & Documents Listed

implementation-harness-upgrade

Use when a project already has an installed `.harness/` and the user wants to pull in newer harness changes shipped by this plugin — phrases like "upgrade the harness", "update my harness", "pull in the latest harness changes", "is my harness up to date", "/upgrade-harness". Reconciles the installed `.harness/` against the plugin's bundled reference: refreshes plugin-owned mechanism files and adds new `harness.env` knobs, REPORTING first and asking before every change, and NEVER touching the backlog, worklog, ledgers, or the user's config values. Commits AND PUSHES the result by default once applied — unless told otherwise this conversation or by the project's own CLAUDE.md, in which case it leaves the change uncommitted as before. Also ADOPTS legacy or hand-forked installs (no version marker, hand-maintained since install, or a pre-plugin hand-ported harness) — classifying each difference as plugin-newer vs local-bespoke vs conflict before anything is overwritten. Requires a harness already scaffolded (use i

0 Updated 1 months ago
RyanMKrol