docs/adr/0005-scenario-operation-name-immutability.md
27 lines · 1.0 KB
ADR-0005: Scenario and operation names are immutable identity
- Status: accepted
- Date: 2026-06-10 (rule predates in docs; recorded as ADR)
Context
Historical charts and regression baselines key on
profile + scenario + operation. If a name silently changes meaning (new
fixture shape, different command, different semantics), every trend line
through that point becomes a lie.
Decision
A scenario or operation name, once published in results, never changes
meaning. Material changes to fixture shape, commands, or semantics require a
new scenario/operation name (or a fixture/prompt/semantics version bump where
the schema provides one: fixture_version, scenario_version,
command_semantics_version). Old names may be retired but never reused.
Consequences
- Refactors must be measurement-identical or introduce new names.
- The command-semantics contract lives in
config/command_semantics.json; changing a mapped command requires bumping its version, which all rows record. - Reviewers can reject renames-in-place by citing this ADR.