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.
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
Acceptance criteria
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.