๐ซ 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.ymlindex 6b11a1d09..b3ad19d31 100644--- a/.github/workflows/lint.yml+++ b/.github/workflows/lint.yml@@ -15,6 +15,8 @@ jobs:docs/**/*.mdREADME.mdREADME.zh-CN.md+ README.ja.md+ README.ko.mdCODE_OF_CONDUCT.mdCONTRIBUTING.mdDEVELOPMENT.mddiff --git a/README.ja.md b/README.ja.mdindex 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.mdnew file mode 100644index 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.mdindex 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 structureddiff --git a/README.zh-CN.md b/README.zh-CN.mdindex 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 ็ผ็ ๅฉๆๆไพ็ปๆๅๆต็จใๅฏๅค็จๆจกๆฟๅๆๆฎๅฏๆฅ็ๆๆใ