Versioning and Change Control Policy
Purpose
Section titled “Purpose”This policy defines how the corpus evolves over time while preserving ethical integrity, auditability, and stakeholder trust.
Ethical Mapping
Section titled “Ethical Mapping”A4 Truthfulness & Trustworthiness: accurate claims about what a version meansA6 Participation & Consultation: transparent, multi-stakeholder change processA3 Justice, Due Process, and Remedy: change decisions are reviewable and contestable
Policy Summary
Section titled “Policy Summary”- Ethical foundations evolve slowly; technical controls evolve faster.
- Every normative change MUST be traceable to review artifacts and a stated rationale.
- Changes MUST NOT be introduced unilaterally or opaquely.
Semantic Versioning
Section titled “Semantic Versioning”The corpus uses semantic versioning: MAJOR.MINOR.PATCH.
A change is MAJOR if it:
- materially changes the meaning, scope, or priority of
00_foundations/ethical_axioms.md, or - materially changes the risk philosophy or tier definitions in
04_risk_framework/risk_classification.md, or - introduces a new Tier 3 requirement category that effectively changes the compliance baseline for critical systems.
MAJOR changes MUST include explicit migration guidance and a public rationale.
A change is MINOR if it:
- adds a new standard document, control domain, or audit method, or
- adds new normative requirements that do not break existing compliance expectations for previously certified systems when applied as intended, or
- clarifies requirements in ways that may require process updates but not redesign (e.g., additional evidence artifacts).
A change is PATCH if it:
- fixes editorial issues, typos, formatting, or improves clarity without changing meaning, or
- adds non-normative guidance (examples, notes) without changing normative requirements.
Approval Thresholds
Section titled “Approval Thresholds”Approval thresholds are minimums; maintainers MAY require additional review based on controversy, novelty, or risk.
- PATCH: at least 1 maintainer + 1 reviewer.
- MINOR: at least 1 maintainer + 2 reviewers, including at least 1 domain reviewer.
- MAJOR: multi-stakeholder review consistent with Tier 3 governance expectations (see
01_governance/governance_model.md) and a documented public consultation period.
For changes affecting Tier 3 controls, an independent review SHOULD be included even when not strictly required.
Backward Compatibility
Section titled “Backward Compatibility”- A tightening of a MUST requirement is a breaking change unless a transition period is defined and the prior compliance state remains acceptable for a bounded time.
- When backward compatibility is not feasible, the change proposal MUST document:
- the safety/justice justification,
- who is impacted,
- a realistic transition plan by tier.
Deprecation and Sunset
Section titled “Deprecation and Sunset”When deprecating a requirement or standard:
- The deprecation notice MUST name the replacement control(s) or state “no replacement.”
- The notice MUST specify tier-based timelines (Tier 1 may differ from Tier 3).
- Audits MUST treat deprecated requirements as in-force until their sunset date.
Change Logs
Section titled “Change Logs”- Every standard document MUST maintain a
Change Logsection. - The corpus SHOULD tag releases and publish release notes summarizing:
- major normative changes,
- new standards added,
- deprecated controls and sunset timelines.
Visual Summary (Non-normative)
Section titled “Visual Summary (Non-normative)”See:
diagrams/release_pipeline.d2(source)diagrams/rendered/release_pipeline.svg(rendered)