Spec Kit으로 AI와 함께 소프트웨어 개발 시작하기

Spec Kit의 특징

Spec Kit은 자연어로 기능 요구사항을 작성하면, AI 에이전트가 실제 실행 가능한 코드와 작업 계획으로 바꿔주는 개발 프레임워크입니다. 복잡한 기술 지식 없이도 원하는 기능을 쉽게 정의하고, 작업을 단계별로 분리해 빠르게 개발할 수 있습니다.

Spec-Driven Development 개념

이 방식은 '무엇을' 만들고 싶은지 생생하게 묘사하는 것에서 시작합니다. 상세 구현이나 기술 방식은 나중에 결정하며, AI가 이를 바탕으로 필요한 코드를 자동 생성합니다.

주요 커맨드와 역할

프로젝트 전 과정은 세 가지 기본 명령으로 이루어집니다.

/specify: 만들고 싶은 기능과 목적을 자연어로 설명합니다. /plan: 기술 도구와 구조를 선택해, AI가 구현 전략을 세웁니다. /tasks: 전체 작업을 세부 단계별로 나누고, 순서대로 정리합니다.

설치를 위한 준비 사항

Spec Kit을 사용하려면 다음이 필요합니다:

Python 3.11 이상 (범용 실행 환경)
uv 패키지 매니저 (설치 관리)
Git (버전 관리)
AI 에이전트 (예: Claude, Copilot, Gemini, Cursor 중 하나)

프로젝트 시작 및 초기화 방법

프로젝트를 만들기 위해 specify init 명령어로 템플릿과 디렉터리 구조를 자동 생성합니다. AI 에이전트나 스크립트 타입(윈도우/리눅스에 따라)을 고를 수 있어, 환경에 맞게 최적화됩니다.

uvx --from git+https://github.com/github/spec-kit.git specify init myproject --ai claude
uvx --from git+https://github.com/github/spec-kit.git specify init myproject --script sh

생성되는 프로젝트 구조

초기화 후에는 다음과 같은 폴더와 파일이 생깁니다:

.specify/ (명령 템플릿과 스크립트)
specs/ (기능별 요구사항, 계획, 작업 목록)
scripts/ (자동화 스크립트)
memory/, constitution.md 등 프로젝트 관리 파일

예시: 사진 정리 앱 개발 흐름

프로젝트 생성
/specify로 "사진을 날짜별로 앨범으로 정리하고, 메인 페이지에서 드래그앤드롭으로 재분류할 수 있도록" 설명 작성
/plan으로 "Vite, HTML, CSS만 사용. 이미지 메타데이터는 SQLite에 저장"처럼 기술 결정
/tasks로 기능별 실질 작업 목록 자동 생성
계획서 따라 구현 시작

자동화 스크립트 지원

운영체제에 따라 셸(.sh) 또는 파워셸(.ps1) 스크립트가 함께 생성됩니다. 윈도우는 ps1, 맥·리눅스는 sh 스크립트가 기본입니다.

올바른 설치 확인법

초기화 후에는 .specify 폴더와 각 명령에 맞는 템플릿·스크립트가 있는지, AI가 명령을 인식하는지 확인합니다. 환경 체크는 다음 명령어로 손쉽게 할 수 있습니다.

uvx --from git+https://github.com/github/spec-kit.git specify check

다음 단계와 활용 팁

프로젝트를 성공적으로 관리하려면 처음엔 '무엇을 만들지'에 집중하고, 구체적 방법은 이후 단계에서 AI와 함께 조율하세요. 튜토리얼로 전체 흐름을 익히고, 필요에 따라 템플릿을 직접 수정해 맞춤화할 수도 있습니다.

출처 및 참고 : Getting Started | github/spec-kit | DeepWiki