diff --git a/.versionrc b/.versionrc
index 56a493e..47c1ef3 100644
--- a/.versionrc
+++ b/.versionrc
@@ -14,5 +14,30 @@
   "releaseCommitMessageFormat": "release: {{currentTag}} 버전 릴리스",
   "commitUrlFormat": "https://github.com/ummgoban/shared/commit/{{hash}}",
   "compareUrlFormat": "https://github.com/ummgoban/shared/compare/{{previousTag}}...{{currentTag}}",
-  "includeNames": true
+  "includeNames": true,
+  "headerPartial": "# Changelog\n\nAll notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.\n",
+  "header": "# Changelog\n\nAll notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.\n",
+  "releaseCommitMessageFormat": "release: {{currentTag}} 버전 릴리스",
+  "issuePrefixes": ["#"],
+  "issueUrlFormat": "https://github.com/ummgoban/shared/issues/{{id}}",
+  "preset": "angular",
+  "skip": {
+    "bump": false,
+    "changelog": false,
+    "commit": false,
+    "tag": false
+  },
+  "bumpFiles": [
+    {
+      "filename": "package.json",
+      "type": "json"
+    }
+  ],
+  "packageFiles": [
+    {
+      "filename": "package.json",
+      "type": "json"
+    }
+  ],
+  "template": "{{> header}}\n{{#each releases}}\n{{#if @first}}{{else}}\n---\n\n{{/if}}\n## {{#if href}}[{{title}}]({{href}}){{else}}{{title}}{{/if}}{{#if tag}} - {{isoDate}}{{/if}}\n{{#if summary}}\n{{summary}}\n{{/if}}\n\n{{#each merges}}\n* {{#if commit.breaking}}**Breaking change:** {{/if}}{{message}}{{#if href}} ([#{{id}}]({{href}})){{/if}}\n{{/each}}\n{{#each fixes}}\n* {{#if commit.breaking}}**Breaking change:** {{/if}}{{commit.subject}}{{#each fixes}}{{#if href}} ([#{{id}}]({{href}})){{/if}}{{/each}}\n{{/each}}\n{{#each commits}}\n* {{#if breaking}}**Breaking change:** {{/if}}{{subject}}{{#if href}} ([{{shorthash}}]({{href}})){{/if}}\n{{/each}}\n{{/each}}"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d8ece1f..f7ae8f8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,45 +2,45 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [0.0.3](https://github.com/ummgoban/shared/compare/v0.0.2...v0.0.3) (2025-06-02)
-
+## [0.0.3](https://github.com/ummgoban/shared/compare/v0.0.2...v0.0.3) - 2025-06-02
 
 ### 🔨 기타 변경사항
 
 * update github action ([556d8c2](https://github.com/ummgoban/shared/commit/556d8c2569e4d223764bbcf871c039754c4465bb))
 
-
 ### ✨ 새로운 기능
 
 * 상수 추가 ([#10](https://github.com/ummgoban/shared/issues/10)) ([63f6d59](https://github.com/ummgoban/shared/commit/63f6d5911c2c57cc11735daf2483adb4c8981c21))
 
-### [0.0.2](https://github.com/ummgoban/shared/compare/v0.0.1...v0.0.2) (2025-06-02)
+---
 
+## [0.0.2](https://github.com/ummgoban/shared/compare/v0.0.1...v0.0.2) - 2025-06-02
 
 ### ✨ 새로운 기능
 
 * **react:** use pull down refresh ([#5](https://github.com/ummgoban/shared/issues/5)) ([fd7945b](https://github.com/ummgoban/shared/commit/fd7945b2329f53ef3528c11dd1cb6a549c0f3b11))
 
-
 ### 🔨 기타 변경사항
 
 * remove merged state ([41c784c](https://github.com/ummgoban/shared/commit/41c784cfe06582b1aec24319a1826e6a76bb6efc))
 * resolve recursive action; chore: create release & publish ([2d0b2bb](https://github.com/ummgoban/shared/commit/2d0b2bb0f04da61c8aedc2859d8d4d5202b58a56))
 
-### [0.0.1](https://github.com/ummgoban/shared/compare/v0.0.1-alpha.9...v0.0.1) (2025-06-02)
+---
 
+## [0.0.1](https://github.com/ummgoban/shared/compare/v0.0.1-alpha.9...v0.0.1) - 2025-06-02
 
 ### ✨ 새로운 기능
 
 * api client, React와 각종 공통 타입 선언합니다. ([#1](https://github.com/ummgoban/shared/issues/1)) ([90b7ef8](https://github.com/ummgoban/shared/commit/90b7ef8e8d8cdc469ebc3420226996bf4f54843b))
 
-
 ### 🔨 기타 변경사항
 
 * auto change log ([#4](https://github.com/ummgoban/shared/issues/4)) ([fe516e2](https://github.com/ummgoban/shared/commit/fe516e2d7f65fd4d0a9ca8398fe8857d864a3633))
 * remove secret ([0bda09d](https://github.com/ummgoban/shared/commit/0bda09df7822f368d5904487f2f95d84eb6bba5f))
 * update github actino ([236f5ef](https://github.com/ummgoban/shared/commit/236f5efe271c5d7d77016caae081105f3283f023))
 
+---
+
 ## [0.0.1-alpha.19] - 2025-06-02
 
 ### 초기 릴리스
diff --git a/README.md b/README.md
index 1baa1af..ca14fda 100644
--- a/README.md
+++ b/README.md
@@ -55,8 +55,17 @@ yarn format
 
 # publish
 
-- `package.json`의 버전을 증가시킵니다. (`v[x].[y].[z]` 또는 `v[x].[y].[z]-[alpha|candy|rc].[n]`)
-- `main` 브랜치에 머지 후 `git tag`로 버전을 생성한 후 `git push`를 실행합니다.
+## 수동 배포
+
+1. `package.json`의 버전을 증가시킵니다. (`v[x].[y].[z]` 또는 `v[x].[y].[z]-[alpha|candy|rc].[n]`)
+2. `yarn build` 후 `yarn npm publish`를 실행합니다.
+
+## 자동 배포
+
+1. 개발이후 pull request를 생성합니다.
+2. pull request가 머지되면 github action이 실행됩니다.
+3. github action이 실행되면 `release: v[x].[y].[z]`로 pull request 가 생성됩니다.
+4. `release: v[x].[y].[z]` pull request가 머지되면 release tag가 생성되고 publish가 실행됩니다.
 
 # ummgoban productions