GitHub - github/spec-kit: 💫 Toolkit to help you get started with Spec-Driven Development

Spec-Driven Development(SDD)는 기존 소프트웨어 개발 방식의 패러다임을 전환하는 접근 방식으로, 코딩이 중심이 아닌 실행 가능한(executable) 명세(specifications)가 핵심이 되어 직접 동작하는 구현체를 생성하도록 하는 방법론입니다. 이는 단순히 코드 작성을 위한 가이드 역할을 넘어, 명세 자체가 실제 구현의 원천이 되는 것을 목표로 합니다. Spec Kit은 이러한 SDD를 가능하게 하는 오픈 소스 툴킷입니다.

핵심 방법론은 다음과 같은 단계로 진행됩니다:

Specify CLI 설치 (Install Specify CLI):

uv tool install specify-cli 명령어를 사용하여 Specify CLI를 설치합니다. 이 CLI 도구는 프로젝트 초기화 및 도구 상태 확인 등의 기능을 제공합니다.
* $specify init <PROJECT_NAME>$: 새 프로젝트를 생성하거나 기존 프로젝트를 초기화합니다. 이 과정에서 --ai 플래그를 통해 사용할 AI 에이전트를 지정할 수 있으며, --here 플래그로 현재 디렉토리에 초기화할 수 있습니다.
* specify check: 필요한 도구들이 설치되어 있는지 확인합니다.

프로젝트 원칙 수립 (Establish project principles):

프로젝트 디렉토리에서 AI 에이전트를 실행하고, /speckit.constitution 명령어를 사용하여 프로젝트의 기본적인 원칙과 개발 가이드라인을 정의합니다. 이는 memory/constitution.md 파일에 기록되며, 코드 품질, 테스팅 표준, 사용자 경험 일관성, 성능 요구사항 등 전반적인 개발 과정의 의사결정을 안내하는 역할을 합니다.

명세 생성 (Create the spec):

/speckit.specify 명령어를 사용하여 구축하고자 하는 것에 대한 요구사항과 사용자 스토리를 명세합니다. 이 단계에서는 기술 스택보다는 무엇을(what) 만들고 왜(why) 만드는지에 집중해야 합니다. AI 에이전트(예: Claude Code)는 이 입력을 바탕으로 사용자 스토리가 포함된 상세 명세(예: specs/001-create-taskify/spec.md)를 생성하며, 이를 위해 새로운 Git 브랜치(예: 001-create-taskify)를 생성하기도 합니다.
* 명세 명확화 (Functional specification clarification): 기술 계획을 세우기 전, /speckit.clarify 명령어를 통해 명세를 구조적으로 명확화하는 과정을 거칩니다. 이는 모호하거나 불완전한 부분을 질문과 답변을 통해 보완하고, 명세의 일관성과 완전성을 검증하는 데 도움을 줍니다. 필요시 자유 형식의 추가 질문이나 Review & Acceptance Checklist를 활용하여 명세를 개선할 수 있습니다.

기술 구현 계획 생성 (Create a technical implementation plan):

/speckit.plan 명령어를 사용하여 기술 스택과 아키텍처 선택을 포함한 기술 구현 계획을 제공합니다. 예를 들어, .NET Aspire, Postgres, Blazor server, REST API 등의 구체적인 기술 요소를 지정할 수 있습니다. 이 단계의 결과물은 plan.md, data-model.md, api-spec.json, research.md 등 다양한 구현 상세 문서들을 포함합니다. AI 에이전트와 상호작용하며 계획의 정확성을 검토하고, 필요한 경우 추가적인 조사를 지시하여 기술 선택의 타당성을 확보합니다.

태스크 분해 (Break down into tasks):

/speckit.tasks 명령어를 사용하여 구현 계획을 구체적이고 실행 가능한 태스크 목록으로 분해합니다. 이 과정에서 tasks.md 파일이 생성되며, 다음을 포함합니다:
* 사용자 스토리에 따른 태스크 분해 (각 사용자 스토리는 별도의 구현 단계가 됨)
* 의존성 관리 (컴포넌트 간 의존성 고려하여 태스크 순서 지정)
* 병렬 실행 가능한 태스크 표시 ([P])
* 파일 경로 명시 (각 태스크의 구현 위치)
* 테스트 주도 개발(TDD) 구조 (테스트 태스크 포함 및 구현 전 작성 순서)
* 체크포인트 유효성 검사 (각 사용자 스토리 단계에서 독립적인 기능 검사)

구현 실행 (Execute implementation):

모든 준비가 완료되면 /speckit.implement 명령어를 사용하여 구현 계획에 따라 태스크를 실행하고 기능을 구축합니다. 이 명령은 constitution, spec, plan, tasks의 유효성을 검사하고, tasks.md의 태스크 분해를 파싱하여 의존성과 병렬 실행 마커를 준수하며 태스크를 순서대로 실행합니다. AI 에이전트는 로컬 CLI 명령(예: dotnet, npm)을 실행하여 코드를 생성하므로, 해당 도구들이 시스템에 설치되어 있어야 합니다. 구현 완료 후에는 애플리케이션을 테스트하고, 런타임 오류 발생 시 AI 에이전트에 오류 메시지를 제공하여 해결하도록 할 수 있습니다.

Spec-Driven Development는 이러한 다단계의 정제 과정을 통해 단일 프롬프트에서 코드를 생성하는 것이 아닌, AI 모델의 고급 기능을 활용하여 명세를 해석하고, 이를 바탕으로 체계적인 소프트웨어 개발을 유도합니다. 이 방법론은 기술 독립적인 애플리케이션 생성, 엔터프라이즈 제약 조건 통합, 사용자 중심 개발, 그리고 창의적이고 반복적인 개발 프로세스 지원을 목표로 합니다.