fnl-versioning

Installation
SKILL.md

Versioning and release tags

One standard for every repository: applications, libraries, CLIs, services, plugins and skill packages, API and tool contracts, and versioned governance documents (constitutions, policies). A repository's own documented policy or a hard ecosystem requirement may differ: expose the conflict and follow the stricter rule or ask.

Version numbers

  • SemVer 2.0.0 for every released artifact; no date-based or arbitrary numbers unless the ecosystem requires them.
  • Phase 0, 0.y.z, until the owner declares the first public stable release: MINOR for breaking or incompatible changes; PATCH for every compatible change (features, additions, fixes, wording).
  • Stable, ≥1.0.0: MAJOR for breaking changes; MINOR for backward-compatible features or additions; PATCH for backward-compatible fixes, clarifications and wording.
  • 1.0.0 and every later MAJOR need an explicit owner decision. Feature completeness, a template default or a skill's instruction never implies one.
  • Breaking is judged against the documented public surface: API and SDK signatures, CLI commands and flags, MCP tools and schemas, configuration keys, data and migration formats, wire protocols, and principles of a governance document. A change that needs consumers to act is breaking; deprecate first, remove at the next breaking bump.
  • Skills or templates with their own bump rules (for example Spec Kit's constitution command) map onto these: in phase 0, MAJOR becomes MINOR and MINOR becomes PATCH.

Cadence

Installs
2
GitHub Stars
4
First Seen
Nov 3, 2026