Skip to content

Build a reproducible benchmark for rewrite fidelity, useful edits, and voice preservation #201

Description

@conorbronsdon

Prepared by ChatGPT/Codex, incorporating an independent GPT-5.6 Sol review at extra-high reasoning, at @conorbronsdon's request. This is an implementation plan, not a claim that the proposed behavior has already been validated.

Parent plan: #199

Problem

The skill's main promise is useful editing that preserves the source. Detector fixtures and authorship corpus measurements do not establish that promise. The quick-demo correction is tracked separately and supplies an initial regression case.

Scope

  • Add a small, reproducible editing evaluation harness and case format. Begin with targeted preservation regressions and expand to a 40–60-case development pilot across social, newsletter/blog, technical documentation, email, and already-good prose.
  • Record source claims, protected content, allowed edits, uncertainty/negation, and expected preserve/change decisions. Use observable constraints and acceptable outcomes rather than exact rewritten sentences.
  • Compare a pinned current skill baseline, the candidate, and a fixed simple editing prompt on the same editor model and settings. Use at least two editor model families for the release comparison when available, report family-specific results, and do not generalize from one family. Use three repetitions per case/condition for the pilot or document a preregistered disagreement-rerun strategy. Keep a held-out split by document/author; do not tune against held-out results.

Acceptance criteria

  • Cases cover invented and removed facts, quantities/units, negation, certainty drift, authentic voice, technical terms, necessary hedges, quoted or attributed text, links, code, tables, and no-op edits.
  • The demo regression fails when the unsupported investor/integration claim is added or the supplied dashboard capability disappears.
  • Reports keep preservation failures, unnecessary edits, missed justified edits, and blind reader preference separate. Detector score reduction is not the quality target. Unchanged output cannot win solely by preserving everything.
  • Record exact skill commit, case-set hash, prompt, provider/model version, settings, tool availability, raw outputs, repetitions, timing, and actual token usage when available; label estimates. Separate editor and judge roles and randomize comparison order. Human review adjudicates subjective or disputed cases.
  • Freeze metrics and decision rules before comparative runs. Treat the pilot as diagnostic, not a statistically sufficient public benchmark; report counts and limitations rather than claiming universal improvement. Predefine a held-out release evaluation and per-register regression policy.
  • Local fixture/schema checks run without model credentials; paid model runs are explicit. Mechanical checks do not claim to prove semantic fidelity. Preserve privacy/licensing and avoid committing private drafts.

Boundaries and sequencing

This is the baseline for behavioral refactoring. It does not expand or recalibrate the authorship detector corpus, which remains under #70, #71, #72, #85; cross-tool authorship benchmarking stays in #84. The separately tracked demo correction can land before this full pilot.

Initial case matrix

Use 48 cases as a concrete starting point: 12 clean/no-op, 12 clear edits, 12 contextual judgments, and 12 preservation/scope conflicts, spread across supported profiles and modes. Encode atomic source propositions and allowed equivalences. Freeze a held-out split and noninferiority/improvement gates before looking at candidate outputs; inconclusive results do not justify a default rollout.

Linked prerequisites

Seed case: #200.

Repository integration

Edit canonical sources and regenerate shipped copies using the existing sync scripts; do not hand-edit generated artifacts. Run the relevant tests and existing packaging/parity checks. Follow CONTRIBUTING.md's changelog/version policy for user-visible changes. Preserve existing public modes, options, detector type IDs, and machine-readable interfaces unless a compatibility change is explicitly documented and tested.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions