From a88dac5510ef1578e7a8f02b6782d7304056c67b Mon Sep 17 00:00:00 2001
From: Amr Gharbeia <amr@gharbeia.net>
Date: Wed, 13 May 2026 13:14:42 -0400
Subject: [PATCH] docs: add versioning convention to naming doc

X.Y.Z semver: Z=bugfix, Y=minor feature, X=major/breaking
---
 notes/naming-convention.org | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/notes/naming-convention.org b/notes/naming-convention.org
index c78a465..31eb2a2 100644
--- a/notes/naming-convention.org
+++ b/notes/naming-convention.org
@@ -12,6 +12,16 @@
 
 cl-tty is the first harvested library of the Stoa cannibalization pipeline — a pure-CL terminal I/O library, independent of any project.
 
+* Versioning Convention
+
+All projects follow strict semver: X.Y.Z where:
+- **X** — major release (architecture-breaking changes)
+- **Y** — minor release (new features, backwards-compatible)
+- **Z** — patch release (bug fixes only, no new features)
+
+Feature releases increment Y. Bugfix and hardening releases increment Z.
+No feature release ships without its prerequisite hardening releases resolved.
+
 * Identity Architecture
 
 | Name | Greek | Layer | Role |