Skip to content

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

10.3 KB
Raw Blame
Spec Kit ๋กœ๊ณ 

๐ŸŒฑ Spec Kit

์ฝ”๋”ฉ ์—์ด์ „ํŠธ์™€ ํ•จ๊ป˜ ์ŠคํŽ™์œผ๋กœ ๊ฐœ๋ฐœํ•˜๊ณ , ๋ฒ„๊ทธ๋ฅผ ๊ณ ์น˜๊ณ , ์•„์ด๋””์–ด๋ฅผ ํ‰๊ฐ€ํ•˜์„ธ์š”.

์ตœ์‹  ๋ฆด๋ฆฌ์Šค GitHub stars ๋ผ์ด์„ ์Šค ๋ฌธ์„œ

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๋กœ ๋„˜๊ธธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด์œ ๋ฅผ ๊ธฐ๋กํ•ด ๋‘๊ณ  ๋ฉˆ์ถ”๋Š” ๊ฒƒ๋„ ์œ ์šฉํ•œ ๊ฒฐ๊ณผ์ž…๋‹ˆ๋‹ค.

์•„์ด๋””์–ด ํ‰๊ฐ€ ์‹ค์Šต ๊ฐ€์ด๋“œ ยท ๋ช…๋ น์–ด ๋ ˆํผ๋Ÿฐ์Šค

์ปค์Šคํ„ฐ๋งˆ์ด์ฆˆํ•˜๊ฑฐ๋‚˜ ์ง์ ‘ ๋งŒ๋“  ํ”„๋กœ์„ธ์Šค ๊ฐ€์ ธ์˜ค๊ธฐ

ํ™•์žฅ์€ ๊ธฐ๋Šฅ์„ ์ถ”๊ฐ€ํ•˜๊ณ , ํ”„๋ฆฌ์…‹์€ ๊ธฐ์กด ๋™์ž‘์„ ์กฐ์ •ํ•˜๋ฉฐ, ์›Œํฌํ”Œ๋กœ๋Š” ๋‹จ๊ณ„๋ฅผ ์ž๋™ํ™”ํ•˜๊ณ , ๋ฒˆ๋“ค์€ ์—ญํ• ๋ณ„ ๊ตฌ์„ฑ์„ ํ•˜๋‚˜๋กœ ๋ฌถ์Šต๋‹ˆ๋‹ค. ์ผํšŒ์„ฑ ํ…œํ”Œ๋ฆฟ ๋ณ€๊ฒฝ์—๋Š” ํ”„๋กœ์ ํŠธ ๋กœ์ปฌ ์˜ค๋ฒ„๋ผ์ด๋“œ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

์ปค์Šคํ„ฐ๋งˆ์ด์ฆˆ ๊ฐ€์ด๋“œ ยท ์ปค๋ฎค๋‹ˆํ‹ฐ ํ™•์žฅ, ํ”„๋ฆฌ์…‹, ๋ฒˆ๋“ค, ์‹ค์Šต ๊ฐ€์ด๋“œ

๋ฌธ์„œ

์Šคํƒ€ ์ถ”์ด

Spec Kit ์Šคํƒ€ ์ถ”์ด ์ฐจํŠธ

Spec Kit์„ ๋น›๋‚ด ์ฃผ์‹œ๋Š” ๋ชจ๋“  ๋ถ„๊ป˜ ๊ฐ์‚ฌ๋“œ๋ฆฝ๋‹ˆ๋‹ค.

์ง€์› ๋ฐ ๊ธฐ์—ฌ

๋ฒ„๊ทธ ์‹ ๊ณ  ๋˜๋Š” ๊ธฐ๋Šฅ ์š”์ฒญ ยท ๊ธฐ์—ฌ ๊ฐ€์ด๋“œ ยท ํ–‰๋™ ๊ฐ•๋ น

Spec Kit์€ MIT ๋ผ์ด์„ ์Šค๋กœ ๋ฐฐํฌ๋ฉ๋‹ˆ๋‹ค.