Log in
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.