> For the complete documentation index, see [llms.txt](https://docs.sysout.co.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sysout.co.kr/etc/semantic-version.md).

# Semantic Version

## Semantic Version

소프트웨어의 버전을 체계적으로 관리하기 위한 버전 관리 규칙. 줄여서 <mark style="color:blue;">**`SemVer`**</mark>라고도 한다.

{% embed url="<https://semver.org/lang/ko/>" %}

## SemVer 명세

버전 관리는 반드시 다음과 같은 규칙을 따라야 한다.

### Major, Minor, Patch 버전

버전은 **`x.y.z`** 형태로 구성할 것을 권장한다.

* x - Major(주) 버전. 하위 버전과 호환되지 않는 업데이트가 발생하는 경우 변경한다.
* y - Minor(부) 버전. 하위 버전과 호환되며 기능이 추가된 경우 변경한다.
* z - Patch(수) 버전. 하위 버전과 호환되며 버그를 수정한 경우 변경한다.

{% hint style="info" %}
일반적으로 1.0.0 버전을 상용화 소프트웨어로 간주한다. 따라서 배포 전 베타 테스트 중인 경우 0.y.z 형태로 버전을 부여해서 관리한다.
{% endhint %}

버전을 변경하는 규칙은 다음과 같다.

* 각 버전은 증가만 가능하며, 감소는 불가하다.
* 상위 버전이 변경되면 하위 버전은 0으로 초기화된다.
  * (ex) 1.2.3에서 minor 버전이 바뀌면 1.3.0이다.

## FAQ

{% embed url="<https://semver.org/lang/ko/#faq>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sysout.co.kr/etc/semantic-version.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.