What is Semantic Versioning (SemVer)?
Semantic Versioning (SemVer) — A versioning scheme using MAJOR.MINOR.PATCH format that communicates the nature of changes between releases.
What is Semantic Versioning?
Semantic Versioning (SemVer) is a versioning standard that uses a three-part number format: MAJOR.MINOR.PATCH (e.g., 2.1.3). Each part communicates the nature of changes:
| Part | When to increment | Example |
|------|-------------------|---------|
| MAJOR | Breaking changes | 1.0.0 → 2.0.0 |
| MINOR | New features, backwards-compatible | 1.0.0 → 1.1.0 |
| PATCH | Bug fixes | 1.0.0 → 1.0.1 |
How does Agent Shelf use SemVer?
Every agent on Agent Shelf must include a SemVer version field in its YAML frontmatter. When publishing a new version, the version number must be higher than the current one. Each version is stored as an immutable snapshot, so users can always access or roll back to previous versions.
Pre-release suffixes like 1.0.0-beta.1 are also supported for agents under development.