Versioning and Commit Conventions
Commit convention
Section titled “Commit convention”Use Conventional Commit-style prefixes where practical:
feat:new behaviorfix:defect correctionrefactor:internal restructuringtest:test-only changedocs:documentationci:pipeline and automationchore:maintenancesecurity:explicit security remediation
Commit messages describe intent, not file activity.
Service versioning
Section titled “Service versioning”Services may version independently using semantic versioning. Platform releases may use calendar-aligned versions such as 2026.08.0; that external packaging model is outside this handbook’s current scope.
Immutable identity
Section titled “Immutable identity”CI always uses the full Git SHA internally. Human-friendly tags are additional aliases. Mutable tags such as develop or latest may support Image Updater, but audit and rollback evidence records the immutable digest and source SHA.