document-haness/.agents/skills/refactoring-from-analysis/references/evidence-contract.md

Refactoring Evidence Contract

Every WorkItem retains enough evidence for another reviewer or later Tech Log reanalysis to answer:

1. What source revision was analyzed?
2. What exact problem was confirmed in current code?
3. What changed?
4. What commands/tests/measurements were run?
5. What raw outputs support the result?
6. What conditions or limitations apply?

Store:

• execution/measurement environment;
• raw baseline and after output when the type requires comparison;
• functional/architecture/integration verification output;
• changed-file/diff summary;
• explicit acceptance result and limitations.

Evidence is append-only for a completed cycle where practical. Do not replace a failed raw run with only the successful run; retain material failed attempts when they explain the final result. Never store secrets.