Preservation Verifier

Preservation Verifier

Verify that a rewrite or file edit kept the content the original ../avoid-ai-writing/SKILL.md says to protect.

For cross-Skill work, follow ../avoid-ai-writing-router/references/handoff-contract.md and ../avoid-ai-writing-router/references/skill-graph.json.

Connection contract

Incoming

Accept before/after verification from:

• avoid-ai-writing-router via ROUTE when the user directly supplies before and after material.
• voice-preserving-rewriter via VERIFY after returned-text rewriting.
• file-edit-in-place via VERIFY after an authorized named-file mutation.

Require both original and current versions. If either is unavailable, return control to the router rather than inventing a comparison.

Produce

Update the handoff envelope with:

• execution_evidence.verifier: executed only if the bundled validator ran, otherwise model_only.
• verification_summary.status: PASS, REVIEW, or FAIL.
• blocking errors and warnings.
• exact repair target when repair is possible.

A FAIL is a blocking workflow result. The rewrite/edit stage is not complete merely because text was produced or a file write succeeded.

Outgoing

• REPAIR to voice-preserving-rewriter when returned text failed preservation and the shared editing budget has room.
• REPAIR to file-edit-in-place when a named file failed preservation and the shared editing budget has room.
• RECHECK to ai-writing-detector only when convergence or a residual audit was part of the user's request.
• Stop on PASS unless another user-requested stage remains.
• Stop and report on a second verification failure. Do not start another repair loop.

Architecture and implementation lenses

Apply both encoded lenses from ../avoid-ai-writing-router/references/agency-role-lenses.md:

• agency-software-architect: verification is a boundary gate with explicit ownership and bounded repair cycles.
• agency-senior-developer: execution claims require actual command evidence, errors propagate, and before/after state remains attributable to the correct target.

The verifier does not rewrite content itself.

Preferred deterministic path

The bundled scripts/validate.js is an exact copy of the source repository's preservation validator. When Node execution is available, run:

node scripts/validate.js --residual-policy warn before.md after.md

For programmatic use:

const { validate } = require("./scripts/validate.js");
const result = validate(original, rewritten, { residualPolicy: "warn" });

Use the explicit warn residual policy for editorial verification. The validator exposes mechanical preservation results separately from quality diagnostics while retaining top-level errors, warnings, and stats. Residual growth stays visible as a warning; it is not proof of content damage and does not by itself authorize a repair. A skipped, unavailable, or unscored quality check is not a clean residual audit. It does not decide whether a semantic change was grounded in an explicit user correction or whether the user specifically authorized editing a normally protected span. Never claim it ran unless the current host executed it.

If execution is unavailable, compare the original and rewrite manually using the same preservation contract and label the result as model_only.

Additional protected constraints

In addition to the canonical validator's structural checks, apply the canonical editing contract in a separate semantic review. Check remaining meaning, attribution, quantities and units, negation, conditions, causality, uncertainty, and speaker experience. Treat an explicit user correction as the intended change rather than an invention. If the user specifically placed a normally protected span in scope, verify that requested change and continue protecting its data and attribution; do not infer permission from a general cleanup, style, or voice request. Report this review as model-only rather than claiming the deterministic validator performed it.

When human_representation_sensitive: true, review identity and representation details protected by the agency-inclusive-visuals-specialist lens. A structurally valid rewrite may still require REVIEW or FAIL if it erased or genericized material cultural, geographic, disability, attire, skin-tone/lighting, physical-reality, or anti-stereotype constraints.

Do not claim the deterministic validator checked semantic representation details that it does not implement. Report that portion separately as model-only semantic review.