Skip to content

๐Ÿ’ซ Toolkit to help you get started with SDD or any other process!

docs: add Korean (ํ•œ๊ตญ์–ด) README (#4939)

Yang-woo449da1c44399
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 6b11a1d09..b3ad19d31 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -15,6 +15,8 @@ jobs:
docs/**/*.md
README.md
README.zh-CN.md
+ README.ja.md
+ README.ko.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
DEVELOPMENT.md
diff --git a/README.ja.md b/README.ja.md
index d8d03540a..c9b16a561 100644
--- a/README.ja.md
+++ b/README.ja.md
@@ -14,7 +14,8 @@
<p align="center">
<a href="./README.md">English</a> ยท
<a href="./README.zh-CN.md">็ฎ€ไฝ“ไธญๆ–‡</a> ยท
- <strong>ๆ—ฅๆœฌ่ชž</strong>
+ <strong>ๆ—ฅๆœฌ่ชž</strong> ยท
+ <a href="./README.ko.md">ํ•œ๊ตญ์–ด</a>
</p>
Spec Kitใฏใ€AIใ‚ณใƒผใƒ‡ใ‚ฃใƒณใ‚ฐใ‚จใƒผใ‚ธใ‚งใƒณใƒˆใซๆง‹้€ ๅŒ–ใ•ใ‚ŒใŸใƒ—ใƒญใ‚ปใ‚นใ€ๅ†ๅˆฉ็”จๅฏ่ƒฝใชใƒ†ใƒณใƒ—ใƒฌใƒผใƒˆใ€่จ˜้Œฒใซๆฎ‹ใ‚‹ๆˆๆžœใ‚’ใ‚‚ใŸใ‚‰ใ™ใ‚ชใƒผใƒ—ใƒณใ‚ฝใƒผใ‚นใฎใƒ„ใƒผใƒซใ‚ญใƒƒใƒˆใงใ™ใ€‚ไปฅไธ‹ใฎ3ใคใฎใƒ—ใƒญใ‚ปใ‚นใฎใ„ใšใ‚Œใ‹ใ‹ใ‚‰ๅง‹ใ‚ใ€ๅฟ…่ฆใซๅฟœใ˜ใฆใ‚ซใ‚นใ‚ฟใƒžใ‚คใ‚บใ—ใŸใ‚Šใ€่‡ชๅˆ†่‡ช่บซใฎใƒ—ใƒญใ‚ปใ‚นใ‚’ๆŒใก่พผใ‚“ใ ใ‚Šใ™ใ‚‹ใ“ใจใ‚‚ใงใใพใ™ใ€‚
diff --git a/README.ko.md b/README.ko.md
new file mode 100644
index 000000000..65f32c8fd
--- /dev/null
+++ b/README.ko.md
@@ -0,0 +1,208 @@
+<div align="center">
+ <img src="https://raw.githubusercontent.com/github/spec-kit/main/media/logo_large.webp" alt="Spec Kit ๋กœ๊ณ " width="200" height="200"/>
+ <h1>๐ŸŒฑ Spec Kit</h1>
+ <h3><em>์ฝ”๋”ฉ ์—์ด์ „ํŠธ์™€ ํ•จ๊ป˜ ์ŠคํŽ™์œผ๋กœ ๊ฐœ๋ฐœํ•˜๊ณ , ๋ฒ„๊ทธ๋ฅผ ๊ณ ์น˜๊ณ , ์•„์ด๋””์–ด๋ฅผ ํ‰๊ฐ€ํ•˜์„ธ์š”.</em></h3>
+</div>
+
+<p align="center">
+ <a href="https://github.com/github/spec-kit/releases/latest"><img src="https://img.shields.io/github/v/release/github/spec-kit" alt="์ตœ์‹  ๋ฆด๋ฆฌ์Šค"/></a>
+ <a href="https://github.com/github/spec-kit/stargazers"><img src="https://img.shields.io/github/stars/github/spec-kit?style=social" alt="GitHub stars"/></a>
+ <a href="https://github.com/github/spec-kit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/github/spec-kit" alt="๋ผ์ด์„ ์Šค"/></a>
+ <a href="https://github.github.io/spec-kit/"><img src="https://img.shields.io/badge/docs-GitHub_Pages-blue" alt="๋ฌธ์„œ"/></a>
+</p>
+
+<p align="center">
+ <a href="./README.md">English</a> ยท
+ <a href="./README.zh-CN.md">็ฎ€ไฝ“ไธญๆ–‡</a> ยท
+ <a href="./README.ja.md">ๆ—ฅๆœฌ่ชž</a> ยท
+ <strong>ํ•œ๊ตญ์–ด</strong>
+</p>
+
+Spec Kit์€ AI ์ฝ”๋”ฉ ์—์ด์ „ํŠธ์—๊ฒŒ ์ฒด๊ณ„์ ์ธ ํ”„๋กœ์„ธ์Šค, ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ํ…œํ”Œ๋ฆฟ, ๋ฌธ์„œ๋กœ ๋‚จ๋Š” ๊ฒฐ๊ณผ๋ฌผ์„
+์ œ๊ณตํ•˜๋Š” ์˜คํ”ˆ ์†Œ์Šค ํˆดํ‚ท์ž…๋‹ˆ๋‹ค. ์•„๋ž˜ ์„ธ ๊ฐ€์ง€ ํ”„๋กœ์„ธ์Šค ์ค‘ ํ•˜๋‚˜๋กœ ์‹œ์ž‘ํ•ด ํ•„์š”์— ๋งž๊ฒŒ ๊ณ ์ณ ์“ฐ๊ฑฐ๋‚˜,
+์ง์ ‘ ๋งŒ๋“  ํ”„๋กœ์„ธ์Šค๋ฅผ ๊ฐ€์ ธ์™€๋„ ๋ฉ๋‹ˆ๋‹ค.
+
+## ํ”„๋กœ์„ธ์Šค ์„ ํƒ
+
+| ํ•„์š”ํ•œ ๊ฒƒ | ํ”„๋กœ์„ธ์Šค | ๊ฒฐ๊ณผ |
+| --- | --- | --- |
+| ๊ธฐ๋Šฅ์ด๋‚˜ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋งŒ๋“ค๊ธฐ | [์ŠคํŽ™ ์ฃผ๋„ ๊ฐœ๋ฐœ](#์ŠคํŽ™-์ฃผ๋„-๊ฐœ๋ฐœ) | ๊ณ„ํš, ๊ตฌํ˜„, ์ˆ˜๋ ด๊นŒ์ง€ ์ด์–ด์ง€๋Š” ์ŠคํŽ™ |
+| ์ž˜๋ชป๋œ ๋™์ž‘์„ ์ง„๋‹จํ•˜๊ณ  ๊ณ ์น˜๊ธฐ | [๋ฒ„๊ทธ ์ˆ˜์ •](#๋ฒ„๊ทธ-์ˆ˜์ •) | ํ‰๊ฐ€๋ฅผ ๊ฑฐ์นœ ์›์ธ, ๋ฒ”์œ„๋ฅผ ํ•œ์ •ํ•œ ์ˆ˜์ •, ๊ธฐ๋ก์œผ๋กœ ๋‚จ๋Š” ๊ฒ€์ฆ |
+| ์•„์ด๋””์–ด์— ํˆฌ์žํ•  ๊ฐ€์น˜๊ฐ€ ์žˆ๋Š”์ง€ ํŒ๋‹จํ•˜๊ธฐ | [์•„์ด๋””์–ด ํ‰๊ฐ€](#์•„์ด๋””์–ด-ํ‰๊ฐ€) | ๊ทผ๊ฑฐ์— ๊ธฐ๋ฐ˜ํ•œ ์ง„ํ–‰, ๋ช…ํ™•ํ™”, ์ค‘๋‹จ ๊ฒฐ์ • |
+
+์„ธ ํ”„๋กœ์„ธ์Šค๋Š” ๋ฐ˜๋“œ์‹œ ๊ฑฐ์ณ์•ผ ํ•˜๋Š” ์„ธ ๋‹จ๊ณ„๊ฐ€ ์•„๋‹ˆ๋ผ **๊ฐ๊ฐ ๋…๋ฆฝ๋œ ์ง„์ž…์ **์ž…๋‹ˆ๋‹ค. ์ŠคํŽ™ ์ฃผ๋„ ๊ฐœ๋ฐœ(SDD)์€
+์ฝ”์–ด์— ํฌํ•จ๋˜์–ด ์žˆ๊ณ , ๋ฒ„๊ทธ ์ˆ˜์ •๊ณผ ์•„์ด๋””์–ด ํ‰๊ฐ€๋Š” Spec Kit์— ํ•จ๊ป˜ ์ œ๊ณต๋˜๋ฉฐ ํ•„์š”ํ•  ๋•Œ ์„ค์น˜ํ•˜๋Š” ํ™•์žฅ์ž…๋‹ˆ๋‹ค.
+
+<a id="-get-started"></a>
+<a id="-prerequisites"></a>
+
+## ์‹œ์ž‘ํ•˜๊ธฐ
+
+Linux, macOS, Windows ํ™˜๊ฒฝ์—์„œ **Python 3.11+**, **[uv](https://github.github.io/spec-kit/install/uv.html)**,
+๊ทธ๋ฆฌ๊ณ  ์ง€์›๋˜๋Š” AI ์ฝ”๋”ฉ ์—์ด์ „ํŠธ๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
+**CLI ์„ค์ •**์€ ํ„ฐ๋ฏธ๋„์—์„œ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์•„๋ž˜ ๋ช…๋ น์–ด๋ฅผ ์‹คํ–‰ํ•ด Spec Kit์„ ์„ค์น˜ํ•˜๊ณ  ํ”„๋กœ์ ํŠธ๋ฅผ ๋งŒ๋“œ์„ธ์š”:
+
+```bash
+uv tool install specify-cli
+specify init my-project --integration copilot
+cd my-project
+```
+
+<a id="-supported-ai-coding-agent-integrations"></a>
+
+์˜ˆ์‹œ๋Š” **GitHub Copilot์˜ ๊ธฐ๋ณธ ์Šคํ‚ฌ ๋ชจ๋“œ**๋ฅผ ๊ธฐ์ค€์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค. ์ง€์›๋˜๋Š” ๋‹ค๋ฅธ ์—์ด์ „ํŠธ๋ฅผ ์“ฐ๋ ค๋ฉด
+`copilot`์„ ํ•ด๋‹น ์—์ด์ „ํŠธ์˜ [ํ†ตํ•ฉ ํ‚ค](https://github.github.io/spec-kit/reference/integrations.html)๋กœ ๋ฐ”๊พธ์„ธ์š”.
+
+์ด๋ฏธ ์ฝ”๋“œ๊ฐ€ ์žˆ๋‚˜์š”? [๊ธฐ์กด ํ”„๋กœ์ ํŠธ ๊ฐ€์ด๋“œ](https://github.github.io/spec-kit/guides/existing-projects.html)๋ฅผ ๋”ฐ๋ฅด์„ธ์š”.
+ํŠน์ • ๋ฒ„์ „ ๊ณ ์ •, ๋‹ค๋ฅธ ์„ค์น˜ ๋ฐฉ๋ฒ•, CI, ๋ฌธ์ œ ํ•ด๊ฒฐ์€
+[์„ค์น˜](https://github.github.io/spec-kit/installation.html) ๋ฌธ์„œ๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.
+๊ธฐ์กด ์„ค์น˜๋ฅผ ์—…๋ฐ์ดํŠธํ•˜๋ ค๋ฉด [์—…๊ทธ๋ ˆ์ด๋“œ](https://github.github.io/spec-kit/upgrade.html) ๋ฌธ์„œ๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.
+
+์ด์ œ **ํ”„๋กœ์ ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ์ฝ”๋”ฉ ์—์ด์ „ํŠธ๋ฅผ ์‹คํ–‰**ํ•˜๊ณ  ์•„๋ž˜ ํ”„๋กœ์„ธ์Šค ์ค‘ ํ•˜๋‚˜๋ฅผ ๊ณ ๋ฅด์„ธ์š”.
+๊ฐ `/speckit-*` **์Šคํ‚ฌ์€ ์—์ด์ „ํŠธ ์ฑ„ํŒ…์—์„œ** ํ•œ ๋ฒˆ์— ํ•˜๋‚˜์”ฉ ํ˜ธ์ถœํ•˜๊ณ , ๊ฒฐ๊ณผ๋ฅผ ๊ฒ€ํ† ํ•œ ๋’ค ๋‹ค์Œ์œผ๋กœ
+๋„˜์–ด๊ฐ€์„ธ์š”. ์ด๋“ค์€ ํ„ฐ๋ฏธ๋„ ๋ช…๋ น์–ด๊ฐ€ ์•„๋‹ˆ๋ผ ์—์ด์ „ํŠธ ์Šคํ‚ฌ์ž…๋‹ˆ๋‹ค. ์—์ด์ „ํŠธ๋‚˜ ๋ชจ๋“œ์— ๋”ฐ๋ผ
+[ํ˜ธ์ถœ ๋ฌธ๋ฒ•์ด ๋‹ค๋ฅผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค](https://github.github.io/spec-kit/reference/integrations.html#command-invocation).
+
+<a id="-what-is-spec-driven-development"></a>
+<a id="sdd-quickstart"></a>
+
+## ์ŠคํŽ™ ์ฃผ๋„ ๊ฐœ๋ฐœ
+
+**์–ด๋–ป๊ฒŒ** ๋งŒ๋“ค์ง€ ์ •ํ•˜๊ธฐ ์ „์— **๋ฌด์—‡์„, ์™œ** ๋งŒ๋“œ๋Š”์ง€๋ถ€ํ„ฐ ์ •์˜ํ•ฉ๋‹ˆ๋‹ค. SDD๋Š” ์š”๊ตฌ ์‚ฌํ•ญ์„ ์ŠคํŽ™,
+๊ธฐ์ˆ  ๊ณ„ํš, ์‹คํ–‰ ๊ฐ€๋Šฅํ•œ ์ž‘์—…์œผ๋กœ ๋ฐ”๊พธ๊ณ , ์ด ์‚ฐ์ถœ๋ฌผ์„ ๊ธฐ์ค€์œผ๋กœ ๊ตฌํ˜„์„ ์ด๋•๋‹ˆ๋‹ค.
+
+**์›์น™(constitution)์€ ํ”„๋กœ์ ํŠธ๋‹น ํ•œ ๋ฒˆ ์ •ํ•˜๊ณ , ๊ธฐ๋Šฅ๋งˆ๋‹ค ์ŠคํŽ™ ์ž‘์„ฑ(specify) โ†’ ๊ณ„ํš(plan) โ†’ ์ž‘์—… ๋ถ„ํ•ด(tasks) โ†’ ๊ตฌํ˜„(implement) โ†’ ์ˆ˜๋ ด(converge)์„ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.**
+
+์—์ด์ „ํŠธ ์ฑ„ํŒ…์—์„œ ๋‹ค์Œ ์Šคํ‚ฌ์„ ํ˜ธ์ถœํ•˜์„ธ์š”:
+
+```text
+/speckit-constitution Create principles focused on code quality, testing, and maintainability.
+/speckit-specify Build a photo organizer with albums grouped by date and a tile preview of each album.
+/speckit-plan Use Vite with vanilla JavaScript. Keep images local and store metadata in SQLite.
+/speckit-tasks
+/speckit-implement
+/speckit-converge
+```
+
+์ˆ˜๋ ด ๊ฒฐ๊ณผ๊ฐ€ **Converged**๋กœ ๋‚˜์˜ฌ ๋•Œ๊นŒ์ง€ **implement โ†’ converge**๋ฅผ ๋ฐ˜๋ณตํ•˜์„ธ์š”.
+ํ’ˆ์งˆ ๊ฒŒ์ดํŠธ๋ฅผ ๋” ๋‘๊ณ  ์‹ถ๋‹ค๋ฉด ๋ช…ํ™•ํ™”, ์ฒดํฌ๋ฆฌ์ŠคํŠธ, ์ผ๊ด€์„ฑ ๋ถ„์„์„ ์ถ”๊ฐ€ํ•˜์„ธ์š”.
+
+[SDD ์‹ค์Šต ๊ฐ€์ด๋“œ](https://github.github.io/spec-kit/quickstart.html) ยท
+[๋ช…๋ น์–ด ๋ ˆํผ๋Ÿฐ์Šค](https://github.github.io/spec-kit/reference/agentic-sdd.html)
+
+<a id="-bug-fixing-with-spec-kit"></a>
+<a id="bug-fix-quickstart"></a>
+
+## ๋ฒ„๊ทธ ์ˆ˜์ •
+
+์ง„๋‹จ, ์ˆ˜์ •, ๊ฒ€์ฆ์„ ๋ถ„๋ฆฌํ•ด์„œ ์—์ด์ „ํŠธ๊ฐ€ ํ‰๊ฐ€๋กœ ๋ฐํ˜€๋‚ธ ์›์ธ์„ ๊ณ ์น˜๊ณ  ์›๋ž˜ ์ฆ์ƒ์„ ๋‹ค์‹œ ํ™•์ธํ•˜๊ฒŒ
+ํ•ฉ๋‹ˆ๋‹ค. SDD ๊ธฐ๋Šฅ ์›Œํฌํ”Œ๋กœ๋ฅผ ๋จผ์ € ๊ฑฐ์น  ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค.
+
+**CLI ์„ค์ •(ํ„ฐ๋ฏธ๋„):** ํ”„๋กœ์ ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ์„ ํƒํ˜• ํ™•์žฅ์„ ์„ค์น˜ํ•˜์„ธ์š”:
+
+```bash
+specify extension add bug
+```
+
+๊ทธ๋‹ค์Œ ์—์ด์ „ํŠธ ์ฑ„ํŒ…์—์„œ **ํ‰๊ฐ€(assess) โ†’ ์ˆ˜์ •(fix) โ†’ ํ…Œ์ŠคํŠธ(test)** ์Šคํ‚ฌ์„ ํ˜ธ์ถœํ•˜์„ธ์š”:
+
+```text
+/speckit-bug-assess "Submitting an empty password crashes the login form." slug=login-crash
+/speckit-bug-fix slug=login-crash
+/speckit-bug-test slug=login-crash
+```
+
+๋ณด๊ณ ์„œ๋Š” `.specify/bugs/login-crash/`์— ์ €์žฅ๋ฉ๋‹ˆ๋‹ค. ์ตœ์ข… ํŒ์ •์ด
+`verified`(๊ฒ€์ฆ๋จ), `partial`(๋ถ€๋ถ„ ๊ฒ€์ฆ), `failed`(์‹คํŒจ) ์ค‘ ๋ฌด์—‡์ธ์ง€ ํ™•์ธํ•˜์„ธ์š”. ๊ฒ€์ฆ์ด ๋น ์กŒ๋‹ค๋ฉด ์ˆ˜์ •์—
+์„ฑ๊ณตํ•œ ๊ฒƒ์ด ์•„๋‹™๋‹ˆ๋‹ค.
+
+[๋ฒ„๊ทธ ์ˆ˜์ • ์‹ค์Šต ๊ฐ€์ด๋“œ](https://github.github.io/spec-kit/guides/bugfix.html) ยท
+[๋ช…๋ น์–ด ๋ ˆํผ๋Ÿฐ์Šค](https://github.github.io/spec-kit/reference/agentic-bugfix.html)
+
+<a id="-assessing-ideas-with-spec-kit"></a>
+<a id="idea-assessment-quickstart"></a>
+
+## ์•„์ด๋””์–ด ํ‰๊ฐ€
+
+์†Œํ”„ํŠธ์›จ์–ด๊ฐ€ ๋˜๋“  ์•ˆ ๋˜๋“ , ์•„์ด๋””์–ด์— ๋›ฐ์–ด๋“ค๊ธฐ ์ „์— ๊ทผ๊ฑฐ๋ถ€ํ„ฐ ๋ชจ์๋‹ˆ๋‹ค.
+๋…๋ฆฝ์ ์œผ๋กœ ์“ฐ๋Š” ํ”„๋กœ์„ธ์Šค๋ผ์„œ ์†Œ์Šค ์ฝ”๋“œ๊ฐ€ ์—†๋Š” ํ”„๋กœ์ ํŠธ์—์„œ๋„ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค.
+
+**CLI ์„ค์ •(ํ„ฐ๋ฏธ๋„):** ํ”„๋กœ์ ํŠธ ๋””๋ ‰ํ„ฐ๋ฆฌ์—์„œ ์„ ํƒํ˜• ํ™•์žฅ์„ ์„ค์น˜ํ•˜์„ธ์š”:
+
+```bash
+specify extension add assess
+```
+
+๊ทธ๋‹ค์Œ ์—์ด์ „ํŠธ ์ฑ„ํŒ…์—์„œ **์ ‘์ˆ˜(intake) โ†’ ์กฐ์‚ฌ(research) โ†’ ์ •์˜(define) โ†’ ๊ตฌ์ฒดํ™”(shape) โ†’ ๊ฒฐ์ •(decide)** ์Šคํ‚ฌ์„ ํ˜ธ์ถœํ•˜์„ธ์š”:
+
+```text
+/speckit-assess-intake "Let users work offline and sync when they reconnect." slug=offline-mode
+/speckit-assess-research slug=offline-mode
+/speckit-assess-define slug=offline-mode
+/speckit-assess-shape slug=offline-mode
+/speckit-assess-decide slug=offline-mode
+```
+
+์‚ฐ์ถœ๋ฌผ์€ `.specify/assessments/offline-mode/`์— ์ €์žฅ๋˜๋ฉฐ, ๋งˆ์ง€๋ง‰์—
+**์ง„ํ–‰(go) / ๋ช…ํ™•ํ™” ํ•„์š”(needs-clarification) / ์ค‘๋‹จ(kill)** ์ค‘ ํ•˜๋‚˜๋กœ ๊ฒฐ์ •์ด ๋‚˜์˜ต๋‹ˆ๋‹ค.
+๋ถˆํ™•์‹คํ•œ ๋ถ€๋ถ„์€ ๋‹จ๊ณ„ ์ „์ฒด๋ฅผ ๋‹ค์‹œ ์ƒ์„ฑํ•˜์ง€ ๋ง๊ณ , ๊ธฐ์กด Markdown ์‚ฐ์ถœ๋ฌผ์„ ์ง์ ‘ ๋˜๋Š” ์—์ด์ „ํŠธ์™€ ํ•จ๊ป˜
+๋‹ค๋“ฌ์–ด ํ•ด์†Œํ•˜์„ธ์š”. ๋งŒ๋“ค๊ธฐ๋กœ ํ–ˆ๋‹ค๋ฉด `go` ๊ฒฐ์ •์„ `/speckit-specify`๋กœ ๋„˜๊ธธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด์œ ๋ฅผ
+๊ธฐ๋กํ•ด ๋‘๊ณ  ๋ฉˆ์ถ”๋Š” ๊ฒƒ๋„ ์œ ์šฉํ•œ ๊ฒฐ๊ณผ์ž…๋‹ˆ๋‹ค.
+
+[์•„์ด๋””์–ด ํ‰๊ฐ€ ์‹ค์Šต ๊ฐ€์ด๋“œ](https://github.github.io/spec-kit/guides/assessment.html) ยท
+[๋ช…๋ น์–ด ๋ ˆํผ๋Ÿฐ์Šค](https://github.github.io/spec-kit/reference/agentic-assessment.html)
+
+<a id="-making-spec-kit-your-own-extensions--presets"></a>
+<a id="-bundles-role-based-setups"></a>
+<a id="-community"></a>
+
+## ์ปค์Šคํ„ฐ๋งˆ์ด์ฆˆํ•˜๊ฑฐ๋‚˜ ์ง์ ‘ ๋งŒ๋“  ํ”„๋กœ์„ธ์Šค ๊ฐ€์ ธ์˜ค๊ธฐ
+
+**ํ™•์žฅ**์€ ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€ํ•˜๊ณ , **ํ”„๋ฆฌ์…‹**์€ ๊ธฐ์กด ๋™์ž‘์„ ์กฐ์ •ํ•˜๋ฉฐ, **์›Œํฌํ”Œ๋กœ**๋Š” ๋‹จ๊ณ„๋ฅผ ์ž๋™ํ™”ํ•˜๊ณ ,
+**๋ฒˆ๋“ค**์€ ์—ญํ• ๋ณ„ ๊ตฌ์„ฑ์„ ํ•˜๋‚˜๋กœ ๋ฌถ์Šต๋‹ˆ๋‹ค. ์ผํšŒ์„ฑ ํ…œํ”Œ๋ฆฟ ๋ณ€๊ฒฝ์—๋Š” ํ”„๋กœ์ ํŠธ ๋กœ์ปฌ ์˜ค๋ฒ„๋ผ์ด๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.
+
+[์ปค์Šคํ„ฐ๋งˆ์ด์ฆˆ ๊ฐ€์ด๋“œ](https://github.github.io/spec-kit/guides/customization.html) ยท
+[์ปค๋ฎค๋‹ˆํ‹ฐ ํ™•์žฅ, ํ”„๋ฆฌ์…‹, ๋ฒˆ๋“ค, ์‹ค์Šต ๊ฐ€์ด๋“œ](https://github.github.io/spec-kit/community/overview.html)
+
+<a id="-specify-cli-reference"></a>
+<a id="available-slash-commands"></a>
+<a id="-learn-more"></a>
+<a id="-core-philosophy"></a>
+<a id="-development-phases"></a>
+<a id="-experimental-goals"></a>
+<a id="-video-overview"></a>
+<a id="-does-spec-kit-use-spec-kit"></a>
+
+## ๋ฌธ์„œ
+
+- [CLI ๋ ˆํผ๋Ÿฐ์Šค](https://github.github.io/spec-kit/reference/overview.html)์™€ [ํ”„๋กœ์„ธ์Šค ๋ช…๋ น์–ด](https://github.github.io/spec-kit/reference/agentic-sdd.html#command-overview)
+- [SDD ์ฒ ํ•™](https://github.github.io/spec-kit/concepts/sdd.html), [์ „์ฒด ๋ฐฉ๋ฒ•๋ก ](./spec-driven.md), [๊ธฐ์กด ์ŠคํŽ™ ๋ฐœ์ „์‹œํ‚ค๊ธฐ](https://github.github.io/spec-kit/guides/evolving-specs.html)
+- [์†Œ๊ฐœ ์˜์ƒ](https://github.github.io/spec-kit/quickstart.html#video-overview)๊ณผ [ํ”„๋กœ์ ํŠธ ์—ฐํ˜](https://github.github.io/spec-kit/history.html)
+- [Spec Kit์ด Spec Kit์„ ์“ฐ๋Š” ๋ฐฉ๋ฒ•](./CONTRIBUTING.md#does-spec-kit-use-spec-kit)
+
+## ์Šคํƒ€ ์ถ”์ด
+
+<p align="center">
+ <a href="https://www.star-history.com/#github/spec-kit&Date">
+ <picture>
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=github%2Fspec-kit&type=Date&theme=dark"/>
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=github%2Fspec-kit&type=Date"/>
+ <img src="https://api.star-history.com/svg?repos=github%2Fspec-kit&type=Date" alt="Spec Kit ์Šคํƒ€ ์ถ”์ด ์ฐจํŠธ"/>
+ </picture>
+ </a>
+</p>
+
+<p align="center">
+ <em>Spec Kit์„ ๋น›๋‚ด ์ฃผ์‹œ๋Š” ๋ชจ๋“  ๋ถ„๊ป˜ ๊ฐ์‚ฌ๋“œ๋ฆฝ๋‹ˆ๋‹ค.</em>
+</p>
+
+<a id="-support"></a>
+
+## ์ง€์› ๋ฐ ๊ธฐ์—ฌ
+
+[๋ฒ„๊ทธ ์‹ ๊ณ  ๋˜๋Š” ๊ธฐ๋Šฅ ์š”์ฒญ](https://github.com/github/spec-kit/issues/new) ยท
+[๊ธฐ์—ฌ ๊ฐ€์ด๋“œ](./CONTRIBUTING.md) ยท [ํ–‰๋™ ๊ฐ•๋ น](./CODE_OF_CONDUCT.md)
+
+<a id="-license"></a>
+
+Spec Kit์€ [MIT ๋ผ์ด์„ ์Šค](./LICENSE)๋กœ ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.
diff --git a/README.md b/README.md
index 4b463b2e5..373a07cbe 100644
--- a/README.md
+++ b/README.md
@@ -14,7 +14,8 @@
<p align="center">
<strong>English</strong> ยท
<a href="./README.zh-CN.md">็ฎ€ไฝ“ไธญๆ–‡</a> ยท
- <a href="./README.ja.md">ๆ—ฅๆœฌ่ชž</a>
+ <a href="./README.ja.md">ๆ—ฅๆœฌ่ชž</a> ยท
+ <a href="./README.ko.md">ํ•œ๊ตญ์–ด</a>
</p>
Spec Kit is an open source toolkit that gives AI coding agents structured
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 087696bb3..79809f2ae 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -14,7 +14,8 @@
<p align="center">
<a href="./README.md">English</a> ยท
<strong>็ฎ€ไฝ“ไธญๆ–‡</strong> ยท
- <a href="./README.ja.md">ๆ—ฅๆœฌ่ชž</a>
+ <a href="./README.ja.md">ๆ—ฅๆœฌ่ชž</a> ยท
+ <a href="./README.ko.md">ํ•œ๊ตญ์–ด</a>
</p>
Spec Kit ๆ˜ฏไธ€ไธชๅผ€ๆบๅทฅๅ…ทๅฅ—ไปถ๏ผŒไธบ AI ็ผ–็ ๅŠฉๆ‰‹ๆไพ›็ป“ๆž„ๅŒ–ๆต็จ‹ใ€ๅฏๅค็”จๆจกๆฟๅ’Œๆœ‰ๆฎๅฏๆŸฅ็š„ๆˆๆžœใ€‚