spec-kit

Spec Kit은 GitHub의 오픈소스 툴킷으로, 팀이 AI 코딩 에이전트와 함께 Spec-Driven Development(SDD)를 사용하도록 돕는다. 명세를 일회용 스캐폴딩으로 취급하는 대신, SDD는 명세를 실행 가능하게 만든다. 즉 명세가 직접 동작하는 구현을 생성한다. 이 툴킷은 바로 사용할 수 있는 spec-driven 프로세스를 제공하며, 사용자 정의하거나 자신만의 워크플로로 대체할 수 있다. 주요 구성 요소는 Specify CLI로, uv 또는 PyPI를 통해 설치한다. `specify init`을 실행하면 프로젝트를 설정하고 일반적인 AI 코딩 에이전트용 슬래시 명령 또는 에이전트 스킬을 설치한다. 지원되는 통합에는 Copilot, Codex, Claude Code 등 30개 이상의 CLI 및 IDE 기반 코딩 에이전트가 포함된다. 핵심 슬래시 명령은 구조화된 워크플로를 따른다: - `/speckit.constitution` — 프로젝트 원칙과 개발 가이드라인 수립 - `/speckit.specify` — 무엇을 만들지 정의(요구사항과 사용자 스토리) - `/speckit.plan` — 기술 구현 계획 작성 - `/speckit.tasks` — 계획을 실행 가능한 작업으로 분해 - `/speckit.taskstoissues` — 작업을 GitHub 이슈로 변환 - `/speckit.implement` — 작업을 실행해 기능 구축 - `/speckit.converge` — 구현을 spec, plan, tasks와 비교하고 남은 작업을 새 작업으로 추가 선택적 명령에는 불충분하게 명세된 영역을 명확히 하는 `/speckit.clarify`, 아티팩트 간 일관성 검사를 위한 `/speckit.analyze`, 사용자 정의 품질 체크리스트를 위한 `/speckit.checklist`가 있다. 저장소에는 옵트인 확장도 함께 제공된다. 버그 수정 확장은 범위가 정해지고 증거 기반인 버그 수정을 위한 assess → fix → test 워크플로를 추가한다. 아이디어 평가 확장은 원시 아이디어를 문서화된 go / needs-clarification / kill 결정으로 바꾸기 위한 intake → research → define → shape → decide 워크플로를 제공한다. 사용자 정의는 세 가지 메커니즘을 통해 지원된다. 확장은 새 명령과 템플릿을 추가하고, 프리셋은 기존 템플릿과 명령이 동작하는 방식을 재정의하며, 번들은 큐레이션된 확장, 프리셋, 단계, 워크플로 세트를 역할 기반 구성(예: 프로덕트 매니저, 비즈니스 분석가, 보안 연구원, 개발자)으로 패키징한다. 프로젝트 로컬 오버라이드를 통해 일회성 조정이 가능하다. 템플릿은 런타임에 해석되는 반면, 확장 및 프리셋 명령은 설치 시점에 적용된다. Spec Kit에는 `specify self check`, `specify self upgrade --dry-run`, `specify self upgrade`와 같은 자체 관리 명령도 포함되어 있으며, 특정 릴리스 태그를 고정하는 옵션도 있다. 커뮤니티 리소스에는 문서 사이트의 확장, 프리셋, 번들, 워크스루, 관련 프로젝트가 포함된다. 이 프로젝트는 스스로를 dogfooding한다. 즉 유지관리자들은 Spec Kit을 개발할 때, 특히 규모가 큰 기능의 경우 자동화된 기능 평가 워크플로를 통해 Spec Kit을 사용한다.