version-scheme

How the next version number is derived and what a bump touches. Load in /release step 2 or before any version edit.

설치 방법

기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.

npx skills add https://github.com/jgravelle/jcodemunch-mcp --skill version-scheme

명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.

로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.

설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.

SKILL.md

소스 지침 · 읽기 전용 미리보기

name	version-scheme
description	How the next version number is derived and what a bump touches. Load in /release step 2 or before any version edit.

Authority: docs/cicd/RUNBOOK.md section 1, scripts/release_preflight.py (read_pins, pins_verdict), tests/test_release_preflight.py.

Scheme: 1.108.N; a release is N + 1. Minor or major moves are a human decision with a stated reason (/release --minor|--major <reason>).
Derivation, printed every time: latest tag git for-each-ref refs/tags --sort=-v:refname --format='%(refname:short) %(creatordate:iso-strict)' | head -1 must equal pyproject.toml's version. Unequal means a bump is already pending (refuse) or a tag is missing (the pipeline tags; see the runbook).
Pin sites are ENUMERATED BY GREP for the old version (--include=*.json --include=*.toml --include=*.lock), never listed here: the list grew from two to seven and a listed copy was wrong each time it grew. git check-ignore every hit; a generated file is not a pin site. whatsnew.json is regenerated (current + entry), not edited.
git tag <name> is DENIED in a session (the pipeline tags); the read form above is the one to use.
uv.lock: only the name-scoped version = line; never uv lock to bump (a newer local uv rewrites platform markers; CLAUDE.md).
The pre-flight is the authority on whether the pins agree: uv run python scripts/release_preflight.py --version X --pins-only.