๐ซ Toolkit to help you get started with SDD or any other process!
๐ฑ Spec Kit
์ฝ๋ฉ ์์ด์ ํธ์ ํจ๊ป ์คํ์ผ๋ก ๊ฐ๋ฐํ๊ณ , ๋ฒ๊ทธ๋ฅผ ๊ณ ์น๊ณ , ์์ด๋์ด๋ฅผ ํ๊ฐํ์ธ์.
English ยท ็ฎไฝไธญๆ ยท ๆฅๆฌ่ช ยท ํ๊ตญ์ด
Spec Kit์ AI ์ฝ๋ฉ ์์ด์ ํธ์๊ฒ ์ฒด๊ณ์ ์ธ ํ๋ก์ธ์ค, ์ฌ์ฌ์ฉ ๊ฐ๋ฅํ ํ ํ๋ฆฟ, ๋ฌธ์๋ก ๋จ๋ ๊ฒฐ๊ณผ๋ฌผ์ ์ ๊ณตํ๋ ์คํ ์์ค ํดํท์ ๋๋ค. ์๋ ์ธ ๊ฐ์ง ํ๋ก์ธ์ค ์ค ํ๋๋ก ์์ํด ํ์์ ๋ง๊ฒ ๊ณ ์ณ ์ฐ๊ฑฐ๋, ์ง์ ๋ง๋ ํ๋ก์ธ์ค๋ฅผ ๊ฐ์ ธ์๋ ๋ฉ๋๋ค.
ํ๋ก์ธ์ค ์ ํ
| ํ์ํ ๊ฒ | ํ๋ก์ธ์ค | ๊ฒฐ๊ณผ |
|---|---|---|
| ๊ธฐ๋ฅ์ด๋ ์ ํ๋ฆฌ์ผ์ด์ ๋ง๋ค๊ธฐ | ์คํ ์ฃผ๋ ๊ฐ๋ฐ | ๊ณํ, ๊ตฌํ, ์๋ ด๊น์ง ์ด์ด์ง๋ ์คํ |
| ์๋ชป๋ ๋์์ ์ง๋จํ๊ณ ๊ณ ์น๊ธฐ | ๋ฒ๊ทธ ์์ | ํ๊ฐ๋ฅผ ๊ฑฐ์น ์์ธ, ๋ฒ์๋ฅผ ํ์ ํ ์์ , ๊ธฐ๋ก์ผ๋ก ๋จ๋ ๊ฒ์ฆ |
| ์์ด๋์ด์ ํฌ์ํ ๊ฐ์น๊ฐ ์๋์ง ํ๋จํ๊ธฐ | ์์ด๋์ด ํ๊ฐ | ๊ทผ๊ฑฐ์ ๊ธฐ๋ฐํ ์งํ, ๋ช ํํ, ์ค๋จ ๊ฒฐ์ |
์ธ ํ๋ก์ธ์ค๋ ๋ฐ๋์ ๊ฑฐ์ณ์ผ ํ๋ ์ธ ๋จ๊ณ๊ฐ ์๋๋ผ ๊ฐ๊ฐ ๋ ๋ฆฝ๋ ์ง์ ์ ์ ๋๋ค. ์คํ ์ฃผ๋ ๊ฐ๋ฐ(SDD)์ ์ฝ์ด์ ํฌํจ๋์ด ์๊ณ , ๋ฒ๊ทธ ์์ ๊ณผ ์์ด๋์ด ํ๊ฐ๋ Spec Kit์ ํจ๊ป ์ ๊ณต๋๋ฉฐ ํ์ํ ๋ ์ค์นํ๋ ํ์ฅ์ ๋๋ค.
์์ํ๊ธฐ
Linux, macOS, Windows ํ๊ฒฝ์์ Python 3.11+, uv, ๊ทธ๋ฆฌ๊ณ ์ง์๋๋ AI ์ฝ๋ฉ ์์ด์ ํธ๊ฐ ํ์ํฉ๋๋ค. CLI ์ค์ ์ ํฐ๋ฏธ๋์์ ์งํํฉ๋๋ค. ์๋ ๋ช ๋ น์ด๋ฅผ ์คํํด Spec Kit์ ์ค์นํ๊ณ ํ๋ก์ ํธ๋ฅผ ๋ง๋์ธ์:
uv tool install specify-cli
specify init my-project --integration copilot
cd my-project
์์๋ GitHub Copilot์ ๊ธฐ๋ณธ ์คํฌ ๋ชจ๋๋ฅผ ๊ธฐ์ค์ผ๋ก ํฉ๋๋ค. ์ง์๋๋ ๋ค๋ฅธ ์์ด์ ํธ๋ฅผ ์ฐ๋ ค๋ฉด
copilot์ ํด๋น ์์ด์ ํธ์ ํตํฉ ํค๋ก ๋ฐ๊พธ์ธ์.
์ด๋ฏธ ์ฝ๋๊ฐ ์๋์? ๊ธฐ์กด ํ๋ก์ ํธ ๊ฐ์ด๋๋ฅผ ๋ฐ๋ฅด์ธ์. ํน์ ๋ฒ์ ๊ณ ์ , ๋ค๋ฅธ ์ค์น ๋ฐฉ๋ฒ, CI, ๋ฌธ์ ํด๊ฒฐ์ ์ค์น ๋ฌธ์๋ฅผ ์ฐธ๊ณ ํ์ธ์. ๊ธฐ์กด ์ค์น๋ฅผ ์ ๋ฐ์ดํธํ๋ ค๋ฉด ์ ๊ทธ๋ ์ด๋ ๋ฌธ์๋ฅผ ์ฐธ๊ณ ํ์ธ์.
์ด์ ํ๋ก์ ํธ ๋๋ ํฐ๋ฆฌ์์ ์ฝ๋ฉ ์์ด์ ํธ๋ฅผ ์คํํ๊ณ ์๋ ํ๋ก์ธ์ค ์ค ํ๋๋ฅผ ๊ณ ๋ฅด์ธ์.
๊ฐ /speckit-* ์คํฌ์ ์์ด์ ํธ ์ฑํ
์์ ํ ๋ฒ์ ํ๋์ฉ ํธ์ถํ๊ณ , ๊ฒฐ๊ณผ๋ฅผ ๊ฒํ ํ ๋ค ๋ค์์ผ๋ก
๋์ด๊ฐ์ธ์. ์ด๋ค์ ํฐ๋ฏธ๋ ๋ช
๋ น์ด๊ฐ ์๋๋ผ ์์ด์ ํธ ์คํฌ์
๋๋ค. ์์ด์ ํธ๋ ๋ชจ๋์ ๋ฐ๋ผ
ํธ์ถ ๋ฌธ๋ฒ์ด ๋ค๋ฅผ ์ ์์ต๋๋ค.
์คํ ์ฃผ๋ ๊ฐ๋ฐ
์ด๋ป๊ฒ ๋ง๋ค์ง ์ ํ๊ธฐ ์ ์ ๋ฌด์์, ์ ๋ง๋๋์ง๋ถํฐ ์ ์ํฉ๋๋ค. SDD๋ ์๊ตฌ ์ฌํญ์ ์คํ, ๊ธฐ์ ๊ณํ, ์คํ ๊ฐ๋ฅํ ์์ ์ผ๋ก ๋ฐ๊พธ๊ณ , ์ด ์ฐ์ถ๋ฌผ์ ๊ธฐ์ค์ผ๋ก ๊ตฌํ์ ์ด๋๋๋ค.
์์น(constitution)์ ํ๋ก์ ํธ๋น ํ ๋ฒ ์ ํ๊ณ , ๊ธฐ๋ฅ๋ง๋ค ์คํ ์์ฑ(specify) โ ๊ณํ(plan) โ ์์ ๋ถํด(tasks) โ ๊ตฌํ(implement) โ ์๋ ด(converge)์ ์งํํฉ๋๋ค.
์์ด์ ํธ ์ฑํ ์์ ๋ค์ ์คํฌ์ ํธ์ถํ์ธ์:
/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 ์ค์ต ๊ฐ์ด๋ ยท ๋ช ๋ น์ด ๋ ํผ๋ฐ์ค
๋ฒ๊ทธ ์์
์ง๋จ, ์์ , ๊ฒ์ฆ์ ๋ถ๋ฆฌํด์ ์์ด์ ํธ๊ฐ ํ๊ฐ๋ก ๋ฐํ๋ธ ์์ธ์ ๊ณ ์น๊ณ ์๋ ์ฆ์์ ๋ค์ ํ์ธํ๊ฒ ํฉ๋๋ค. SDD ๊ธฐ๋ฅ ์ํฌํ๋ก๋ฅผ ๋จผ์ ๊ฑฐ์น ํ์๋ ์์ต๋๋ค.
CLI ์ค์ (ํฐ๋ฏธ๋): ํ๋ก์ ํธ ๋๋ ํฐ๋ฆฌ์์ ์ ํํ ํ์ฅ์ ์ค์นํ์ธ์:
specify extension add bug
๊ทธ๋ค์ ์์ด์ ํธ ์ฑํ ์์ ํ๊ฐ(assess) โ ์์ (fix) โ ํ ์คํธ(test) ์คํฌ์ ํธ์ถํ์ธ์:
/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(์คํจ) ์ค ๋ฌด์์ธ์ง ํ์ธํ์ธ์. ๊ฒ์ฆ์ด ๋น ์ก๋ค๋ฉด ์์ ์
์ฑ๊ณตํ ๊ฒ์ด ์๋๋๋ค.
๋ฒ๊ทธ ์์ ์ค์ต ๊ฐ์ด๋ ยท ๋ช ๋ น์ด ๋ ํผ๋ฐ์ค
์์ด๋์ด ํ๊ฐ
์ํํธ์จ์ด๊ฐ ๋๋ ์ ๋๋ , ์์ด๋์ด์ ๋ฐ์ด๋ค๊ธฐ ์ ์ ๊ทผ๊ฑฐ๋ถํฐ ๋ชจ์๋๋ค. ๋ ๋ฆฝ์ ์ผ๋ก ์ฐ๋ ํ๋ก์ธ์ค๋ผ์ ์์ค ์ฝ๋๊ฐ ์๋ ํ๋ก์ ํธ์์๋ ๋์ํฉ๋๋ค.
CLI ์ค์ (ํฐ๋ฏธ๋): ํ๋ก์ ํธ ๋๋ ํฐ๋ฆฌ์์ ์ ํํ ํ์ฅ์ ์ค์นํ์ธ์:
specify extension add assess
๊ทธ๋ค์ ์์ด์ ํธ ์ฑํ ์์ ์ ์(intake) โ ์กฐ์ฌ(research) โ ์ ์(define) โ ๊ตฌ์ฒดํ(shape) โ ๊ฒฐ์ (decide) ์คํฌ์ ํธ์ถํ์ธ์:
/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๋ก ๋๊ธธ ์ ์์ต๋๋ค. ์ด์ ๋ฅผ
๊ธฐ๋กํด ๋๊ณ ๋ฉ์ถ๋ ๊ฒ๋ ์ ์ฉํ ๊ฒฐ๊ณผ์
๋๋ค.
์์ด๋์ด ํ๊ฐ ์ค์ต ๊ฐ์ด๋ ยท ๋ช ๋ น์ด ๋ ํผ๋ฐ์ค
์ปค์คํฐ๋ง์ด์ฆํ๊ฑฐ๋ ์ง์ ๋ง๋ ํ๋ก์ธ์ค ๊ฐ์ ธ์ค๊ธฐ
ํ์ฅ์ ๊ธฐ๋ฅ์ ์ถ๊ฐํ๊ณ , ํ๋ฆฌ์ ์ ๊ธฐ์กด ๋์์ ์กฐ์ ํ๋ฉฐ, ์ํฌํ๋ก๋ ๋จ๊ณ๋ฅผ ์๋ํํ๊ณ , ๋ฒ๋ค์ ์ญํ ๋ณ ๊ตฌ์ฑ์ ํ๋๋ก ๋ฌถ์ต๋๋ค. ์ผํ์ฑ ํ ํ๋ฆฟ ๋ณ๊ฒฝ์๋ ํ๋ก์ ํธ ๋ก์ปฌ ์ค๋ฒ๋ผ์ด๋๋ฅผ ์ฌ์ฉํ์ธ์.
์ปค์คํฐ๋ง์ด์ฆ ๊ฐ์ด๋ ยท ์ปค๋ฎค๋ํฐ ํ์ฅ, ํ๋ฆฌ์ , ๋ฒ๋ค, ์ค์ต ๊ฐ์ด๋
๋ฌธ์
- CLI ๋ ํผ๋ฐ์ค์ ํ๋ก์ธ์ค ๋ช ๋ น์ด
- SDD ์ฒ ํ, ์ ์ฒด ๋ฐฉ๋ฒ๋ก , ๊ธฐ์กด ์คํ ๋ฐ์ ์ํค๊ธฐ
- ํ๋ก์ ํธ ์ฐํ
- Spec Kit์ด Spec Kit์ ์ฐ๋ ๋ฐฉ๋ฒ
์คํ ์ถ์ด
Spec Kit์ ๋น๋ด ์ฃผ์๋ ๋ชจ๋ ๋ถ๊ป ๊ฐ์ฌ๋๋ฆฝ๋๋ค.
์ง์ ๋ฐ ๊ธฐ์ฌ
๋ฒ๊ทธ ์ ๊ณ ๋๋ ๊ธฐ๋ฅ ์์ฒญ ยท ๊ธฐ์ฌ ๊ฐ์ด๋ ยท ํ๋ ๊ฐ๋ น
Spec Kit์ MIT ๋ผ์ด์ ์ค๋ก ๋ฐฐํฌ๋ฉ๋๋ค.