๋ฐ์ด๋ธ ์ฝ๋ฉ์ ํ๊ณ ๋ณด์: AI ์ปจํ ์คํธ ํ์ผ(claude.md, agents.md)์ ์ญํ
2025๋ 2์, AI ์ฐ๊ตฌ์ Andrej Karpathy๋ ์์ฐ์ด ์ค๋ช ๋ง์ผ๋ก LLM์ด ์ฝ๋๋ฅผ ์์ฑํ๋ ๋ฐ์ด๋ธ ์ฝ๋ฉ(Vibe coding)์ด๋ผ๋ ์ฉ์ด๋ฅผ ์๊ฐํ์ต๋๋ค. ๋ฐ์ด๋ธ ์ฝ๋ฉ์ ๋๊ตฌ๋ ์ฝ๊ฒ ์ํํธ์จ์ด๋ฅผ ๊ฐ๋ฐํ ์ ์๋๋ก ๋์์ฃผ์์ผ๋, AI๊ฐ ํ๋กฌํํธ์ ๋งฅ๋ฝ์ ์๋ฒฝํ ์ดํดํ์ง ๋ชปํด ๋ฒ๊ทธ, ๋ณด์ ์ทจ์ฝ์ , ๊ทธ๋ฆฌ๊ณ ์์๊ณผ ๋ค๋ฅธ ๊ฒฐ๊ณผ๋ฅผ ์ด๋ํ๋ ๋ฑ ์ฌ๋ฌ ๋ฌธ์ ๊ฐ ๋ฐ์ํ์ต๋๋ค[1].
์ด๋ฅผ ๋ณด์ํ๊ธฐ ์ํด claude.md, agents.md ๊ฐ์ ์ปจํ
์คํธ ํ์ผ์ด ๋ฑ์ฅํ์ต๋๋ค.
claude.md๋ Anthropic์ด 2025๋ 5์ ๊ณต๊ฐํ Claude Code์ ํ๋ก์ ํธ ๊ฐ์ด๋ ํ์ผ๋ก, ๋ํ๋ฅผ ์์ํ ๋ ์๋์ผ๋ก ๋ก๋๋ฉ๋๋ค. ์ฝ๋ ๋ฒ ์ด์ค๋ฅผ ๋ถ์ํด ์ค์ค๋ก ์ปจํ ์คํธ ํ์ผ์ ์์ฑํ ์ ์์ด, ์ด๊ธฐ ์ค์ ์ ๋ํ ์ฌ์ฉ์์ ๋ถ๋ด์ ์ค์ฌ์ฃผ๋ฉฐ ์ธ๋ถ ๋๊ตฌ ์ฐ๊ณ, ์ฌ์ฉ์ ์ง์ ๋ช ๋ น ๋ฑ ๋ค์ํ ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค[2].agents.md๋ 2025๋ 8์, OpenAI๋ฅผ ๋น๋กฏํ AI ์ฝ๋ฉ ์์ด์ ํธ ๊ฐ๋ฐ์ฌ๋ค์ด ํ๋ ฅํ์ฌ ๋ง๋ ์์ด์ ํธ ์ ์ฉ ํ์ค ํ์ผ์ ๋๋ค. ๋ค์ํ ํ๊ฒฝ์์ ์์ ๋กญ๊ฒ ์ฌ์ฉํ ์ ์๋ ๊ณตํต ๊ท์น์ ์งํฅํ๊ธฐ ๋๋ฌธ์, ํ๋์ ํ์ผ๋ก ํ๋ก์ ํธ ๋ด์ฉ์ ๊ณต์ ํ ์ ์์ต๋๋ค. ํ์ฌ 6๋ง ๊ฐ ์ด์์ ์คํ์์ค ํ๋ก์ ํธ์ ์ฑํ๋์์ผ๋ฉฐ, 15๊ฐ ์ด์์ ์ฃผ์ AI ์์ด์ ํธ๋ฅผ ์ง์ํฉ๋๋ค[3].
์ด๋ฌํ ํ์ผ์ ๊ธฐ๋ณธ์ ์ธ ๋ช ์ธ ์ ๊ณต์๋ ์ ์ฉํ์ง๋ง, ์์ ์ ๊ตฌ์กฐํํ๊ธฐ์๋ ๋ถ์กฑํ์ต๋๋ค. ํ์คํ๋ ์์ฑ ๋ฐฉ์, ๋ช ํํ ์์ ์์์ ํ๋จ ๊ธฐ์ค์ด ์ ์๋์ด ์์ง ์์๊ธฐ ๋๋ฌธ์ ๋๋ค. ๊ณต์ ๋ฌธ์ ์ญ์ โํ๋ก์ ํธ ์ํคํ ์ฒ๋ ์ํฌํ๋ก์ฐ๋ฅผ ์ค๋ช ํ๋ผโ๋ ์์ค์ ์ถ์์ ์ธ ์๋ด์ ๊ทธ์ณ, ์ค์ ์คํ ๋ก์ง์ ๊ฐ๋ฐ์๋ค์ด ์ํ์ฐฉ์ค๋ฅผ ํตํด ๊ฐ๋ณ์ ์ผ๋ก ์ค๊ณํด์ผ ํ๊ณ , ๊ทธ๋ก ์ธํด ๊ฒฐ๊ณผ์ ์ผ๊ด์ฑ์ ๋ณด์ฅํ๊ธฐ ์ด๋ ค์ ์ต๋๋ค[4].
์ด๋ฌํ ํ๊ณ๋ ๋จ์ํ ํ๋ก์ ํธ ์๋ด๋ฅผ ๋์ด, ์์ ๊ณผ์ ์ ๊ตฌ์กฐํํ๊ณ ๊ฒ์ฆ ๊ฐ๋ฅํ ํํ๋ก ๊ด๋ฆฌํ ์ ์๋ ์๋ก์ด ์ ๊ทผ์ ํ์์ฑ์ ๋๋ฌ๋์ต๋๋ค. ์ด ์ง์ ์์ ๋ค์ ์ฃผ๋ชฉ๋ฐ์ ๊ฐ๋ ์ด ์๋๋ฐ, ๋ฐ๋ก ๋ช ์ธ ๊ธฐ๋ฐ ๊ฐ๋ฐ(Spec-Driven Development, SDD)์ ๋๋ค.
์ง๋ 12์ 3์ผ ์ด๋ฆฐ GitHub Universe โ25 Recap Seoul ํ์ฌ์์ Microsoft์ ๊ฐ๋ฐ์ Justin Yoo๋ SDD ๋๊ตฌ Spec Kit์ ์๊ฐํ์ต๋๋ค[5]. ์ด๋ฒ ํฌ์คํ ์์๋ ๊ธฐ์กด ๋ฐ์ด๋ธ ์ฝ๋ฉ์ ํ๊ณ๋ฅผ ๊ทน๋ณตํ๊ธฐ ์ํด ๋ฑ์ฅํ SDD์ ๊ฐ๋ ์ ์๊ฐํ๊ณ , ๋ํ์ ์ธ ๋๊ตฌ๋ค์ ๋น๊ตํฉ๋๋ค. ๋ํ ํ์ผ ์ํคํ ์ฒ๋ ์ด๋ป๊ฒ ๊ตฌ์ฑ๋์๋์ง ์ดํด๋ณด๋ ค๊ณ ํฉ๋๋ค. ๋ง์ง๋ง์ผ๋ก, ์ง์ ๋ฐ๋ผ ํด๋ณผ ์ ์๋ Spec Kit ์์ ๊น์ง ํจ๊ป ์ค๋นํด๋ณด์์ต๋๋ค.
1975๋ ์ํํธ์จ์ด ์๊ตฌ์ฌํญ ๋ช ์ธ(Software Requirements Specification, SRS)๋ฅผ ์์์ผ๋ก, ๊ฐ๋ฐ ๊ณผ์ ์์์ ๊ธฐ๋ฅ ์๊ตฌ์ฌํญ๊ณผ ์ดํด๊ด๊ณ์ ๊ฐ์ ํฉ์๋ฅผ ๋ช ์ธ๋ก ์ ๋ฆฌํ์ต๋๋ค. ๋ค๋ง ๊ตฌํ๊ณผ ์ง์ ์ฐ๊ฒฐํ ์ ์๋ ์๋จ์ด ๋ถ์กฑํด, ์ค์ ๊ฐ๋ฐ ๊ณผ์ ์์๋ ์ ์ฐจ ํ์์ ์ธ ๋ฌธ์๋ก ๋จ๊ฒ ๋์์ต๋๋ค[6].
์ต๊ทผ ๋ค์ํ AI ์์ด์ ํธ๊ฐ ๋ฑ์ฅํ๋ฉด์, ๋ช ์ธ๋ฅผ ์คํ ๊ฐ๋ฅํ ์ ๋ ฅ์ผ๋ก ํ์ฉํ ์ ์๋ ํ๊ฒฝ์ด ๋ง๋ จ๋์๊ณ , ์ด์ ๋ฐ๋ผ SRS๋ SDD๋ผ๋ ํํ๋ก ์ฌ์ ์๋๋ฉฐ, ๋ฐ์ด๋ธ ์ฝ๋ฉ์ ํ๊ณ๋ฅผ ๋ณด์ํ๋ ๋์์ผ๋ก ์ฃผ๋ชฉ๋ฐ๊ณ ์์ต๋๋ค.
SDD์ ํต์ฌ์ ์ฝ๋๋ฅผ ์์ฑํ๊ธฐ์ ์์ โ๋ช ์ธ(spec)โ๋ฅผ ๋จผ์ ์์ฑํด์ผํ๋ค๋ ๊ฒ์ ๋๋ค. ์๊ตฌ์ฌํญ, ์ค๊ณ, ์๋ฌ ์กฐ๊ฑด, ๋ณด์ ๊ธฐ์ค์ ์ฌ์ ์ ๋ช ํํ ์ ์ํจ์ผ๋ก์จ ์๋ํ ๊ฒฐ๊ณผ๋ฅผ ์์ ์ ์ผ๋ก ๊ตฌํํ๋ ๊ฒ์ ๋ชฉํ๋ก ํฉ๋๋ค. ์ด๋ ๋ช ์ธ๋ ์ํํธ์จ์ด์ ์๋์ ๋์์ ๊ตฌ์กฐํํ ํ์ผ์ด์, AI ์ฝ๋ฉ ์์ด์ ํธ์ ํ๋์ ์ง์ ์ ์ดํ๋ ๊ธฐ์ค์ผ๋ก ์๋ํฉ๋๋ค.

์ด๋ฏธ์ง 1. SDD ์ํฌํ๋ก์ฐ (์ ๋ ผ ์ฌ๊ตฌ์ฑ). ์ถ์ฒ: Marmelab[7]
ํ์ฌ SDD๋ ์์ง ๋ช ํํ๊ฒ ์ ๋ฆฝ๋ ๊ฐ๋ ์ด ์๋๋ฉฐ, ๋๊ตฌ์ ์ ๊ทผ ๋ฐฉ์์์ ๋ค์ํ ํํ๋ก ๋ฐ์ ํ๊ณ ์์ต๋๋ค. ์ธ๊ณ์ ์ธ IT ์ปจ์คํ ๊ธฐ์ ์ํธ์์ค(Thoughtworks)์ AI ์๋น์ค ์ ๋ฌธ๊ฐ Birgitta Bรถckeler๋ ์๋ ๋ ๊ฐ์ง ๊ธฐ์ค์ ๋ฐํ์ผ๋ก SDD๋ฅผ ์ธ ๊ฐ์ง ์ ํ์ผ๋ก ๋ถ๋ฅํ์ต๋๋ค.
๊ฐ๋ฐ ์๋ฃ ์ดํ์๋ ์ด๊ธฐ ๋ช ์ธ ํ์ผ์ ์ ์งํ๋๊ฐ
์ธ๊ฐ์ด ์ฝ๋๋ฅผ ์ง์ ๊ด๋ฆฌํ๋๊ฐ, ํน์ ๋ช ์ธ(spec)๋ง ๊ด๋ฆฌํ๋๊ฐ

์ด๋ฏธ์ง 2. SDD ๋ถ๋ฅ (์ ๋ ผ ์ฌ๊ตฌ์ฑ). ์ถ์ฒ: Thoughtworks[8]
์ฒซ๋ฒ์งธ, ๋ช ์ธ ์ฐ์ (Spec-first) ๋ฐฉ์์์ ๋ช ์ธ๋ ์ด๊ธฐ ๊ธฐ๋ฅ ๊ฐ๋ฐ์ ๋๊ธฐ ์ํ ์ผํ์ฑ ํ์ผ์ด๋ฉฐ, ์ฝ๋ ์์ฑ ์ดํ์๋ ์ญ์ ๋๊ณ ๋ณ๋๋ก ๊ด๋ฆฌ๋์ง ์์ต๋๋ค. ๋ฐ๋ผ์ ์์ ์ด ํ์ํ ๋๋ ๋ช ์ธ ํ์ผ์ ์๋กญ๊ฒ ์์ฑํด์ผ ํฉ๋๋ค.
๋๋ฒ์งธ, ๋ช ์ธ ๊ณ ์ (Spec-anchored) ๋ฐฉ์์์ ๋ช ์ธ๋ ๊ฐ๋ฐ ์ดํ์๋ ์ฝ๋์ ํจ๊ป ์ง์์ ์ผ๋ก ๊ด๋ฆฌ๋ฉ๋๋ค. ์ด๋ก ์ธํด ๊ธฐ๋ฅ ๋ณ๊ฒฝ์ผ๋ก ๋ช ์ธ ์์ ์ด ํ์ํ ๊ฒฝ์ฐ, ๊ธฐ์กด ๋ช ์ธ๋ฅผ ๋ถ๋ฌ์ ๋ด์ฉ์ ๊ฐฑ์ ํ ์ ์์ต๋๋ค.
์ธ๋ฒ์งธ, ๋ช ์ธ ์์ค(Spec-as-source) ๋ฐฉ์์์ ๊ฐ๋ฐ์๋ ๋ช ์ธ๋ง ์์ ํ๋ฉฐ ์ฝ๋๋ ์์ ํ์ง ์์ต๋๋ค. ๋ํ ๋ช ์ธ ๊ณ ์ ๋ฐฉ์๊ณผ ๋ง์ฐฌ๊ฐ์ง๋ก, ์์ ๋ ๋ช ์ธ๋ ๊ด๋ฆฌ๋๋ฉฐ ๊ณ์ ์ฌ์ฉ๋ฉ๋๋ค. ์ด ๋ฐฉ์์์๋ ๋ช ์ธ ์์ฒด๊ฐ ์ฃผ์ ์์ค ํ์ผ๋ก์จ ๋์ํฉ๋๋ค.
์ด์ SDD๊ฐ ๋ฌด์์ธ์ง ์ดํด๋ณด์์ผ๋, SDD ๋๊ตฌ์ธ Spec Kit์ ๋ํด ์์๋ณด๊ฒ ์ต๋๋ค.

์ด๋ฏธ์ง 3. ๋ฐ์ด๋ธ์ฝ๋ฉ์ ๋, Spec Kit. ์ถ์ฒ: Meta-Quantum[9]
Spec Kit[10]์ 2025๋ 8์ GitHub๊ฐ ๊ณต๊ฐํ ์คํ์์ค CLI ๋๊ตฌ๋ก Claude, Copilot, Gemini ๋ฑ ๋ค์ํ AI ์ฝ๋ฉ ์ด์์คํดํธ์ ๋ง๋ ์์ ๊ณต๊ฐ์ ์๋์ผ๋ก ๊ตฌ์ฑํฉ๋๋ค. ์ด๊ธฐ ์์ ๊ณต๊ฐ ๊ตฌ์กฐ๊ฐ ์ค์ ๋๋ฉด, ์ฌ์ฉ์๋ ๋ช ๋ น์ด๋ฅผ ํตํด AI ์์ด์ ํธ์ ๋จ๊ณ์ ์ผ๋ก ์ํธ ์์ฉํ ์ ์์ผ๋ฉฐ, ์๋์ ์ ๋ฆฌํ ์ธ ๊ฐ์ง SDD ๋๊ตฌ ์ค์์๋ ์ฌ์ฉ์ ์ ์์ ์ ์ฐํ ํธ์ ์ํฉ๋๋ค.
Kiro[11] | Spec Kit[10] | Tessl[12] | |
|---|---|---|---|
๊ฐ๋ฐ ๋ฐ ์ด์ | AWS | GitHub | Tessl |
๋ฐฉ์ | ๋ช ์ธ ์ฐ์ (Spec-first) ๋ฐฉ์ | ๋ช ์ธ ๊ณ ์ ํ(Spec-anchored) ๋ฐฉ์ | ๋ช ์ธ ๊ณ ์ ํ(Spec-anchored) ์ ๊ทผ ๋ฐฉ์, ๋ช ์ธ ์์ค(Spec-as-source)๋ก ํ์ฉ ํ๊ตฌ ์ค |
์ํฌํ๋ก์ฐ | Requirementsโ Design โ Tasks โ Implements | Constitution โ Specify โ Plan โ Tasks โ Implements | Plan โ Specify โ Implements โ Test |
์ง์ | ๋ค์ค ๋ชจ๋ ์ ๋ ฅ(codebase, file, docs ๋ฑ) | ์ปค๋งจ๋ ๊ธฐ๋ฐ ๋ช ๋ น์ด๋ก ์ํฌํ๋ก์ฐ ์คํ | CLI๊ฐ MCP ์๋ฒ ์ญํ ์ํ |
Memory bank | - steering | - memory - constitution.md | - .tessl/framework |
๋ฐฐํฌ | IDE | CLI | CLI |
์ด์์ฒด์ | Window, macOS, Linux | Window, macOS, Linux | macOS, Linux (x64,arm64), WSL2 |
๊ธฐํ | - | - ํจํค์ง ๋งค๋์ :
- Git | - Node.js v22.17.0+ |
Specs ๋ค์ด๋ฐ ๋ฐฉ์ | category-label-enhancement | specs/[์ซ์]-[๊ธฐ๋ฅ๋ช ] | [๊ธฐ๋ฅ๋ช ].spec.md |
Specs ๊ตฌ์ฑ ํ์ผ | - requirements.md | - data-model.md | ๋จ์ผ spec ํ์ผ |
๋ช ์ธ-์ฝ๋ ๋งคํ | 1:n | 1:n | 1:1 |
์ฝ๋ ์์ | O | O | X |
๋ค์ค ํ์ผ ์์ฑ | O | O | X (ํฅํ ๊ฐ๋ฅ์ฑ ์ธ๊ธ๋จ) |
ํ 1. SDD ๋๊ตฌ ๋น๊ตํ Kiro vs Spec Kit vs Tessl
์๋ ์ด๋ฏธ์ง 4์์ ๋ณด์ด๋ ๊ฒ์ฒ๋ผ Spec Kit์ 3๊ฐ์ ์ฃผ์ ํด๋์ผ๋ก ๋๋ ์ ์์ต๋๋ค.

์ด๋ฏธ์ง 4. Spec Kit ํ์ผ ์ํคํ ์ฒ(์ ๋ ผ ์ฌ๊ตฌ์ฑ). ์ถ์ฒ. Thoughtworks[8]
์ฒซ ๋ฒ์งธ, memory ํด๋๋ Spec Kit ๋ช ๋ น์ด๋ฅผ ์ฒ์ ์คํํ ๋ ์๋์ผ๋ก ์์ฑ๋๋ฉฐ ๋ด๋ถ์
constitution.mdํ์ผ์ ํฌํจํฉ๋๋ค. ์ด ํ์ผ์๋speckit.constitution๋ช ๋ น์ด๋ฅผ ํตํด ๊ธฐ์ ์คํ, ๋ณด์ ์์น, ์ฝ๋ ์คํ์ผ ๋ฑ ํ๋ก์ ํธ ์ ๋ฐ์ ์ ์ฉ๋๋ ๋ถ๋ณ ์์น์ ์ ์ํ ์ ์์ต๋๋ค. ๋ํ ๋ชจ๋ Spec Kit ๋ช ๋ น์ด ์คํ ์ AI ์์ด์ ํธ๊ฐ ์๋์ผ๋ก ์ฐธ์กฐํ์ฌ ์์ ์ผ๊ด์ฑ์ ์ ์งํฉ๋๋ค.๋ ๋ฒ์งธ, templates ํด๋๋
plan.md,spec.md,tasks.mdํ์ผ๋ค์ ๊ธฐ๋ณธ ์์ฑ ํ์์ด ์ ์๋์ด ์์ต๋๋ค. ๊ฐ ํ์ผ์ ํด๋นํ๋template.mdํ์ผ์ ๊ธฐ๋ฐ์ผ๋ก ์์ฑ๋๋ฉฐ, ์ด๋ ์์ด์ ํธ๊ฐ ๋ช ์ธ๋ฅผ ํด์ํ๋ ๋ฐฉ์์ ํ๋๋ก ๊ณ ์ ํ๊ธฐ ์ํจ์ ๋๋ค. ๋ช ์ธ ๊ตฌ์กฐ๊ฐ ๊ณ ์ ๋์ง ์์ผ๋ฉด ๋์ผํ ์๊ตฌ์ฌํญ๋ ๋งค๋ฒ ๋ค๋ฅด๊ฒ ํด์๋ ์ ์๊ธฐ ๋๋ฌธ์, ํ ํ๋ฆฟ์ ํตํด ํด์ ๊ธฐ์ค์ ์ผ๊ด๋๊ฒ ์ ์งํฉ๋๋ค. ์ด๋ฌํ ๊ธฐ์ค(constitution.md,template.md)์ ๋ฐํ์ผ๋ก AI ์์ด์ ํธ๋ Spec Kit ๋ช ๋ น์ด๋ฅผ ํตํด ์์ ์ฐ์ถ๋ฌผ์ Specs ํด๋์ ์์ฑํฉ๋๋ค.์ธ ๋ฒ์งธ, Specs ํด๋์๋
/speckit.specify๋ช ๋ น์ด์ ํจ๊ป ์ฌ์ฉ์๊ฐ ์ํ๋ ๊ธฐ๋ฅ์ ๋ํ ํ๋กฌํํธ๋ฅผ ์ ๋ ฅํ๋ฉด [๋ฒํธ]-[๊ธฐ๋ฅ์ด๋ฆ] ํ์(์: 001-when-a-user)์ ํด๋๊ฐ ์์ฑ๋ฉ๋๋ค. ์ด๋, ๋ฒํธ๋ 001๋ถํฐ ์์ฐจ์ ์ผ๋ก ๋ถ์ฌ๋๋ฉฐ ์ค๋ณต๋์ง ์๊ธฐ ๋๋ฌธ์, ์ฌ๋ฌ ๋ธ๋์น์์ ๋์์ ์์ ํ๋๋ผ๋ ํ์ผ๋ช ์ถฉ๋์ด ๋ฐ์ํ์ง ์์ต๋๋ค. ๋ํ ๊ธฐ๋ฅ์ ์ญ์ ํ๋๋ผ๋ ๋ฒํธ๋ ์ ์ง๋์ด, ํ๋ก์ ํธ์ ํ์คํ ๋ฆฌ ๊ด๋ฆฌ์๋ ์ฉ์ดํฉ๋๋ค. ํด๋น ํด๋ ์์๋ ๊ธฐ๋ฅ์ ์๊ตฌ์ฌํญ์ ๋ด์spec.md๊ฐ ์์ฑ๋ฉ๋๋ค.
์ดํ /speckit.plan ๋ช
๋ น์ด๋ฅผ ์คํํ๋ฉด, ํด๋น ๊ธฐ๋ฅ์ ์ด๋ป๊ฒ ๊ตฌํํ ์ง์ ๋ํ ๋ด์ฉ์ด ์๋์ผ๋ก ํ์ฅ๋ฉ๋๋ค. ์ด ๊ณผ์ ์์ plan.md๋ฅผ ํฌํจํ์ฌ data-model.md, research.md, contracts(api.md, component.md), quickstart.md ํ์ผ๋ค์ด ํจ๊ป ์์ฑ๋ฉ๋๋ค.

์ด๋ฏธ์ง 5. /speckit.plan ๋ช ๋ น์ด๋ก ์์ฑ๋๋ ํ์ผ(์ ๋ ผ ์ฌ๊ตฌ์ฑ). ์ถ์ฒ. medium[13]
๋ง์ง๋ง์ผ๋ก, /speckit.tasks ๋ช
๋ น์ด๋ฅผ ์ฌ์ฉํด plan ๋จ๊ณ์์ ์์ฑ๋ ํ์ผ๋ค์ ์ข
ํฉ์ ์ผ๋ก ๋ถ์ํ์ฌ, ๊ตฌํ ์์
๋ชฉ๋ก์ ๋จ๊ณ๋ณ๋ก ๋ถํดํ๊ณ tasks.md์ ์ ๋ฆฌํฉ๋๋ค. ์ด๋ ๊ฒ Spec Kit์ ํ์ฉํ๋ฉด ๊ธฐ์กด์ ๋ฐ์ด๋ธ ์ฝ๋ฉ ์๊ฐ์ ํฌ๊ฒ ๋จ์ถ์ํค๋ฉฐ, ๊ธฐ๋ฅ ๋ช
์ธ๋ถํฐ ๊ตฌํ ๊ณํ, APIยท๋ฐ์ดํฐ ๋ชจ๋ธ, ํ
์คํธ ์๋๋ฆฌ์ค, ๋ฒ์ ๊ด๋ฆฌ๋ ํ์ผ๊น์ง ํ ๋ฒ์ ์์ฑํ ์ ์์ต๋๋ค.

์ด๋ฏธ์ง 6. Spec Kit ์ํฌํ๋ก์ฐ. ์ถ์ฒ. ์ ๋ ผ
Spec Kit์ ์๊ตฌ์ฌํญ์ ์ ๋ฆฌํ๋ ๋จ๊ณ๋ถํฐ ๊ตฌํ๊น์ง ์์๋๋ก ์งํํ๋ ์ํฌํ๋ก์ฐ๋ฅผ ์ ๊ณตํ๋ฉฐ, ๊ฐ ๋จ๊ณ์ ์ญํ ๊ณผ ๊ฒฐ๊ณผ๋ฌผ์ด ๋ช ํํ ๊ตฌ๋ถ๋์ด ์์ต๋๋ค.
๋จ๊ณ | ๋ช ๋ น์ด | ๋ช ๋ น์ด ์ ํ | ์ญํ (๋ฌด์์ ํ๋ ๋จ๊ณ์ธ๊ฐ) | ํต์ฌ ๋ชฉ์ | ๋ช ๋ น์ด์ ํฌํจํด์ผ ํ ๊ฒ | ๋ช ๋ น์ด์ ํฌํจํ๋ฉด ์ ๋๋ ๊ฒ |
|---|---|---|---|---|---|---|
์์น ์๋ฆฝ |
| ํต์ฌ (Core) | ํ๋ก์ ํธ ์ ๋ฐ์ ์ ์ฉ๋๋ ๊ธฐ๋ณธ ์์น ์ ์ | ์ผ๊ด๋ ๊ฐ๋ฐ ๊ธฐ์ค ํ๋ฆฝ | ํ์ง ๊ธฐ์ค, ์ ํ์ฑ, UX ์์น, ์ ์ฝ ์กฐ๊ฑด | ๊ธฐ๋ฅ ์๊ตฌ์ฌํญ, ๊ธฐ์ ์ ํ |
์๊ตฌ์ฌํญ ๋ช ์ธ |
| ํต์ฌ (Core) | ๋ฌด์์, ์ ๋ง๋ค ๊ฒ์ธ์ง ์ ๋ฆฌ | ๋ฌธ์ ์ ๋ชฉํ ๋ช ํํ | ์ฌ์ฉ์ ์ง๋ฌธ, ๊ธฐ๋ฅ ๋ฒ์, ์ฑ๊ณต ๊ธฐ์ค | ๊ธฐ์ ์คํ, ์์คํ ๊ตฌ์กฐ |
์๊ตฌ์ฌํญ ๋ช ํํ |
| ์ ํ (Optional) | ์ ๋งคํ ์๊ตฌ์ฌํญ์ ์ง๋ฌธ๊ณผ ๋ต๋ณ์ผ๋ก ์ ๋ฆฌ | ์๊ตฌ์ฌํญ ๋ช ํํ | - | ์๋ก์ด ๊ธฐ๋ฅ ์ถ๊ฐ, ๊ตฌํ ๋ฐฉ๋ฒ ์ ์ |
๊ตฌํ ๊ณํ |
| ํต์ฌ (Core) | ๊ตฌํ ๋ฐฉ๋ฒ๊ณผ ๊ตฌ์กฐ ๊ฒฐ์ | ๊ตฌํ ๋ฐฉํฅ ์๋ฆฝ | ๊ธฐ์ ์คํ, ์์คํ ๊ตฌ์กฐ, ๋ฐ์ดํฐ ํ๋ฆ | ์๊ตฌ์ฌํญ ๋ณ๊ฒฝ |
๋ช ์ธ ์ ๊ฒ |
| ์ ํ (Optional) | ์๊ตฌ์ฌํญ๊ณผ ์ค๊ณ ๋ด์ฉ ์ ๊ฒ | ๋๋ฝยท๋ชจํธํจ ํ์ธ | - | ์ฝ๋, ์ค์ ๊ตฌํ ๋ด์ฉ |
์์ ๋ถํด |
| ํต์ฌ (Core) | ๊ตฌํ ์์ ์ ์คํ ๋จ์๋ก ๋ถํด | ๋ฐ๋ก ์คํ ๊ฐ๋ฅํ ์์ ์ ๋ฆฌ | - | ์ถ์์ ์ธ ์ค๊ณ ๋ ผ์ |
์ฌ์ ๊ฒ์ฆ |
| ์ ํ (Optional) | ํ์ผ ๊ฐ ๋ด์ฉ์ด ์ ๋ง๋์ง ํ์ธ | ๋๋ฝยท๋ถ์ผ์น ๋ฐฉ์ง | - | ์๊ตฌ์ฌํญ ์ถ๊ฐ, ์ฝ๋ ์์ |
๊ตฌํ |
| ํต์ฌ (Core) | ์ ๋จ๊ณ์์ ์ ๋ฆฌํ ๋ด์ฉ์ ๋ฐํ์ผ๋ก ์ฝ๋๋ฅผ ์์ฑํ๋ ๋จ๊ณ | ๊ธฐ๋ฅ ๊ตฌํ | - | ์๊ตฌ์ฌํญยท๊ณํ ๋ณ๊ฒฝ |
ํ 2. Spec Kit์ ์ํฌํ๋ก์ฐ[10]

์ด๋ฏธ์ง 7. ์ฑ๋ด ์คํ ๊ฒฐ๊ณผ. ์ถ์ฒ. ์ ๋ ผ
Spec Kit์ ํ์ฉํ์ฌ ๊ตฌํํ ์์ธ ์ํฐํ์คํ ์ฑ๋ด์ ์คํ ๊ฒฐ๊ณผ์ ๋๋ค. ์ฌ์ฉ์๋ ๋ฐ๋ชจ ํ์ด์ง์์ ์ง๋ฌธ์ ์ ๋ ฅํ๋ฉด, ๊ณต์ยท์ ๋ขฐ ๊ฐ๋ฅํ ์น ์ ๋ณด๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ์ ๋ฆฌ๋ ๋ต๋ณ๊ณผ ํจ๊ป ์ถ์ฒ๋ฅผ ํ์ธํ ์ ์์ต๋๋ค. ์ด ์ฑ๋ด์ ๋ณต์กํ ๊ธฐ๋ฅ์ ๋ง์ด ํฌํจํ๊ณ ์์ง๋ ์์ง๋ง, ์งง์ ์๊ฐ ์์ ๊ฒ์ํ ์ง๋ฌธ์ ๋์ํ๋ ์ถ์ฒ ๊ธฐ๋ฐ์ ์ ํํ ์ฑ๋ด์ ๊ตฌํํ๋ค๋ ์ ์์ ์๋ฏธ๊ฐ ์์ต๋๋ค.
๋ค๋ง ๋ช ์ธ ๋ณด์กด ๋ฐฉ์(Spec-anchored)์ ์ฌ์ฉํ๋ Spec Kit์์๋ ์์ฑ๋ ๊ฒฐ๊ณผ๋ฅผ ๊ทธ๋๋ก ์ ๋ขฐํ๊ธฐ๋ณด๋ค, ๊ฐ๋ฐ์๊ฐ ์ง์ ๊ฒ์ฆํ๋ ๊ณผ์ ์ด ๊ถ์ฅ๋ฉ๋๋ค. ์ด๋ฒ ์ค์ต์์๋ ์ผ๋ถ ๋ต๋ณ์ด 2024๋ ๊ธฐ์ค ์ ๋ณด๋ฅผ ํฌํจํ๊ฑฐ๋ ๊ณต์ ์ถ์ฒ๊ฐ ์๋ ๋งํฌ๋ฅผ ์ฌ์ฉํด, ์ด๋ฅผ ์ง์ ํ์ธํด ์์ ํ์ต๋๋ค. ์ด๋ฅผ ํตํด Spec Kit์ ํต์ฌ์ ๋ช ํํ ๋ช ์ธ๋ฅผ ๊ธฐ์ค์ผ๋ก AI๋ฅผ ํ์ฉํ๋, ์ฌ๋์ ์ ๊ฒ๊ณผ ๋ณด์์ ์ ์ ๋ก ํ๋ ๊ฐ๋ฐ ํ๋ฆ์์ ํ์ธํ ์ ์์์ต๋๋ค.
์ด์์ผ๋ก SDD์ Spec Kit์ ๊ฐ๋ , ๊ทธ๋ฆฌ๊ณ ์ค์ต ์ ๊ณผ์ ์ ์ดํด๋ณด์์ต๋๋ค. ์ง์ ๋ช ์ธ๋ฅผ ์ ์ํ๊ณ ๊ตฌํํด ๋ณด๋ฉด์, ๊ฐ๋ฐ์ด ์ค์ ๋ก ์ด๋ป๊ฒ ์๋ํ๋์ง ๊ฒฝํํด ๋ณด์๊ธธ ๋ฐ๋๋๋ค.
์ ์ ๋ฐ ์ถ์ฒ
์ ์
๊ถ๋ฏผ์ง(Minji Kwon | LinkedIn)
ํฉ๋์(Nayoung Hwang | LinkedIn)
๊นํ๊ทผ(Hyun-geun Kim | LinkedIn)
์ถ์ฒ
[1] Wikipedia. 2025. "Vibe coding". https://en.wikipedia.org/wiki/Vibe_coding
[2] Anthropic. 2025. "Using CLAUDE.md files: Customizing Claude Code for your codebase.". Claude Blog. https://claude.com/blog/using-claude-md-files
[3] Agentic AI Foundation. 2025. "AGENTS.md". https://agents.md/
[4] W Chatlatanagulchai et al. 2025. "Agent READMEs: An Empirical Study of Context Files for Agentic Coding". arXiv. https://arxiv.org/abs/2511.12884v1
[5] Github. 2025. โGitHub Universe โ25 Recap Seoul". GitHub Universe. https://github.registration.goldcast.io/events/a6bd39d0-520a-4d7b-b0a3-864f1c510ab7?utm_source=sdr&utm_medium=email&utm_campaign=recap25-SEL&utm_content=
[6] Wikipedia. 2025. "Software requirements specification". https://en.wikipedia.org/wiki/Software_requirements_specification
[7] Franรงois Zaninotto. 2025. "Spec-Driven Development: The Waterfall Strikes Back". Marmelab. https://marmelab.com/blog/2025/11/12/spec-driven-development-waterfall-strikes-back.html
[8] Birgitta Bรถckeler. 2025. "Understanding Spec-Driven-Development: Kiro, spec-kit, and Tessl". Thoughtworks. https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html
[9] Meta-Quantum.Today. 2025. "SpecKit: Github's NEW tool That FINALLY Fixes AI Coding". https://meta-quantum.today/?p=8026
[10] GitHub. 2025. "Spec Kit". https://github.com/github/spec-kit
[11] Kiro. "Agentic AI development from prototype to production". https://kiro.dev/
[12] Tessl. 2025. "What is Tessl?". https://docs.tessl.io/
[13] Meer Hashaam khan. 2025. "Spec-Driven Development with Spec Kit". Medium. https://medium.com/@hashaamkhan975/spec-driven-development-with-spec-kit-34c443e3eaf6


