github/spec-kit은 GitHub이 만든 오픈소스 도구입니다. 코딩 에이전트에 정해진 절차, 다시 쓰는 템플릿, 기록으로 남는 결과를 줍니다. Claude Code, Codex, GitHub Copilot 같은 에이전트와 함께 쓰고, 라이선스는 MIT입니다. 2026년 11월 7일 기준 깃허브 스타는 14만 8천 개입니다.
설치
Python 3.11 이상과 uv, 지원되는 코딩 에이전트가 필요합니다.
uv tool install specify-cli
specify init my-project --integration claude # copilot, codex 등
cd my-project프로젝트를 만든 뒤 그 폴더에서 에이전트를 실행하고, 아래 명령은 터미널이 아닌 에이전트 채팅에 입력합니다.
스펙 주도 개발 순서
/speckit-constitution 코드 품질, 테스트, 유지보수를 중시하는 원칙을 만들어 줘
/speckit-specify 날짜별 앨범과 미리보기가 있는 사진 정리 앱
/speckit-plan Vite와 순수 JavaScript, 이미지는 로컬, 메타데이터는 SQLite
/speckit-tasks
/speckit-implement
/speckit-converge| 단계 | 하는 일 |
|---|---|
| constitution | 프로젝트마다 한 번, 지킬 원칙 정하기 |
| specify | 기능마다 무엇을 왜 만들지 스펙 쓰기 |
| plan | 기술 선택과 설계 |
| tasks | 할 일 목록으로 쪼개기 |
| implement | 구현 |
| converge | 스펙과 실제 결과 맞춰 보기. Converged가 나올 때까지 implement와 반복 |
README는 명령을 하나씩 돌리고, 결과를 검토한 뒤 다음으로 넘어가라고 권합니다.
버그 고치기 확장
specify extension add bug/speckit-bug-assess "빈 비밀번호로 제출하면 로그인 폼이 멈춘다" slug=login-crash
/speckit-bug-fix slug=login-crash
/speckit-bug-test slug=login-crash결과 보고서는 .specify/bugs/login-crash/에 남고, 최종 판정은 verified, partial, failed 중 하나입니다. verified일 때만 고친 것으로 봅니다.
아이디어 판단 확장
specify extension add assess를 설치하면 코드 없이도 아이디어가 해 볼 만한지 근거를 모아 진행, 보완, 중단 중 하나로 판단합니다.
그 밖에
확장, 프리셋, 워크플로, 번들로 우리 팀 절차를 만들거나 바꿀 수 있습니다. 커뮤니티 카탈로그의 구성 요소는 감사를 거친 것이 아니니, 설치 전에 코드를 읽어 보라고 README가 당부합니다.
오늘 할 일
다음에 만들 기능 하나를 /speckit-specify부터 시작해 보세요. 에이전트가 무엇을 만들지 먼저 글로 맞추고 나면, 엉뚱한 결과가 확 줄어듭니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.68의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/68.