Spec Kit
사양이 곧 실행 대상이 되는 사양 주도 개발(SDD)을 어떤 AI 코딩 에이전트에서도 수행하도록 돕는 GitHub 공식 오픈소스 툴킷
한눈에 보기
공식 검증 2026년 8월 29일
- 프로토콜
- Git 저장소
- 인증
- 공개 저장소 기준 별도 인증 없음
- 비용
- 무료 공개 자료
- 제공 상태
- 공개
Use cases
이럴 때 이렇게 연결합니다
먼저 어떤 어려움을 해결하는지 읽고, 그림에서 입력과 전달값, 사람 확인 지점을 따라가 보세요. 결과 패널은 해당 흐름이 끝났을 때 남는 값을 보여 줍니다. 아래 내용은 공식 기능을 바탕으로 만든 예시 설계이며, SION.LAB의 실제 운영 사례를 뜻하지 않습니다.
추천 구성 · Situation 01
요구사항과 구현 태스크가 분리돼 완료 기준이 개발 중 계속 바뀌는 업무
- 어떤 어려움인가
- 사양 주도 개발을 도입하는 제품팀이 자주 마주치는 문제입니다. 구체적으로는 '요구사항과 구현 태스크가 분리돼 완료 기준이 개발 중 계속 바뀌는 업무' 상황입니다.
- 이렇게 해결합니다
- Spec Kit 단계에서는 예제를 격리된 환경에서 재현한 뒤 현재 작업에 필요한 부분만 옮깁니다. 입력 범위는 '사용자 요구, 제약, 수용 기준과 기술 문맥'입니다. 필요한 필드만 골라 '명세·계획·태스크가 연결된 실행 패키지' 형태로 정리합니다.
- 왜 연결하는가
- 처음에는 Spec Kit 하나만 사용합니다. 입력·처리·검토 경계를 확인한 뒤에만 다른 시스템과 연결하면 실패 원인을 찾기 쉽습니다.
- 마지막 확인
- 검토 대상은 '명세·계획·태스크가 연결된 실행 패키지'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 결과를 바로 반영하지 않고 담당자가 확인한 뒤 다음 단계로 넘깁니다.
- 01 · 입력작은 입력 범위사용자 요구, 제약, 수용 기준과 기술 문맥업무 조건
- 02 · 현재 자료Spec Kit예제 적용: 입력 범위는 '사용자 요구, 제약, 수용 기준과 기술 문맥'입니다. 필요한 필드만 골라 '명세·계획·태스크가 연결된 실행 패키지' 형태로 정리합니다.처리 결과
- 03 · 사람 확인담당자 검토검토 대상은 '명세·계획·태스크가 연결된 실행 패키지'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다.확인 완료
- 04 · 결과검토용 결과명세·계획·태스크가 연결된 실행 패키지
Result
이 흐름으로 남는 값
추천 구성 · Situation 02
명세·계획·태스크가 연결된 실행 패키지을 다음 업무로 이어야 할 때
- 어떤 어려움인가
- '요구사항과 구현 태스크가 분리돼 완료 기준이 개발 중 계속 바뀌는 업무' 문제를 한 번 처리해도 결과를 다음 업무로 다시 옮기면 복사·누락·중복이 생깁니다.
- 이렇게 해결합니다
- Spec Kit 단계에서는 예제를 격리된 환경에서 재현한 뒤 현재 작업에 필요한 부분만 옮깁니다. 입력 범위는 '사용자 요구, 제약, 수용 기준과 기술 문맥'입니다. 필요한 필드만 골라 '명세·계획·태스크가 연결된 실행 패키지' 형태로 정리합니다. 다음 단계인 Ponytail에서는 '가장 작은 구현 경로와 제외 범위가 있는 검토 메모' 형태로 업무 문맥을 보강합니다.
- 왜 연결하는가
- Spec Kit의 결과에는 원문 식별자와 처리 시각을 붙여 Ponytail로 전달합니다. 두 도구가 같은 판단을 반복하지 않도록 처리 역할과 보강 역할을 나눕니다.
- 마지막 확인
- 검토 대상은 '명세·계획·태스크가 연결된 실행 패키지'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 이어서 검토 대상은 '가장 작은 구현 경로와 제외 범위가 있는 검토 메모'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 두 단계 중 하나라도 근거가 비어 있으면 연결 결과를 미확정으로 남깁니다.
- 01 · 입력업무 입력사용자 요구, 제약, 수용 기준과 기술 문맥정리된 입력
- 02 · 현재 자료Spec Kit명세·계획·태스크가 연결된 실행 패키지근거 포함 결과
- 업무 문맥 보강
- 04 · 결과연결 결과원문 근거와 두 단계의 처리 상태가 함께 남은 결과
Result
이 흐름으로 남는 값
추천 구성 · Situation 03
요구사항과 구현 태스크가 분리돼 완료 기준이 개발 중 계속 바뀌는 업무를 반복 운영해야 할 때
- 어떤 어려움인가
- '요구사항과 구현 태스크가 분리돼 완료 기준이 개발 중 계속 바뀌는 업무' 문제를 정기적으로 처리하려면 성공 경로뿐 아니라 권한 오류, 재실행, 승인 책임까지 정해야 합니다.
- 이렇게 해결합니다
- Spec Kit 단계에서는 예제를 격리된 환경에서 재현한 뒤 현재 작업에 필요한 부분만 옮깁니다. 입력 범위는 '사용자 요구, 제약, 수용 기준과 기술 문맥'입니다. 필요한 필드만 골라 '명세·계획·태스크가 연결된 실행 패키지' 형태로 정리합니다. 보강은 Ponytail, 전달과 후속 처리는 Awesome Claude Code로 분리합니다.
- 왜 연결하는가
- 같은 작업 ID가 Spec Kit → Ponytail → Awesome Claude Code 순서로 이어집니다. 마지막 반영 전에는 담당자가 대상과 근거를 확인하고 승인합니다.
- 마지막 확인
- 검토 대상은 '명세·계획·태스크가 연결된 실행 패키지'입니다. 원문 근거, 제외 조건, 누락 항목이 구분되는지 확인합니다. 실패한 단계만 다시 실행할 수 있도록 입력 버전·처리 시각·오류·승인자를 기록합니다.
- 업무 담당자01 · 입력반복 실행 입력사용자 요구, 제약, 수용 기준과 기술 문맥과 작업 ID작업 요청
- 자동 처리02 · 현재 자료Spec Kit명세·계획·태스크가 연결된 실행 패키지1차 처리
- 외부 연결보강 데이터
- 외부 연결검토 요청
- 사람 확인05 · 사람 확인담당자 승인대상·근거·변경 내용을 확인한 뒤 마지막 반영을 승인승인·보류 기록
- 기록·알림06 · 결과기록·알림작업 ID, 처리 상태, 오류, 승인자를 저장하고 필요한 채널에 결과 전달추적 가능
Result
이 흐름으로 남는 값
연결
설치
uv tool install specify-cliSpec Kit은 어떤 AI 코딩 에이전트로도 높은 품질의 소프트웨어를 구축하기 위한 오픈소스 툴킷입니다. 사양이 구현을 안내하는 데 그치지 않고 직접 구현을 생성하는 사양 주도 개발(Spec-Driven Development) 방법론을 구현합니다.
주요 기능
- /speckit.constitution: 프로젝트를 지배하는 원칙과 개발 지침을 작성하거나 갱신합니다
- /speckit.specify: 무엇을 만들 것인지 요구사항과 사용자 스토리로 정의합니다
- /speckit.plan: 선택한 기술 스택으로 기술 구현 계획을 작성합니다
- /speckit.tasks: 실행 가능한 태스크 목록을 생성합니다
- /speckit.implement: 계획에 따라 모든 태스크를 실행하여 기능을 구축합니다
- /speckit.converge: 코드베이스를 사양, 계획, 태스크와 대조해 남은 작업을 추가합니다
품질 확인용으로 /speckit.clarify, /speckit.analyze, /speckit.checklist를 선택적으로 사용할 수 있습니다. 핵심 명령 외에 기능을 추가하는 확장(Extensions), 기존 템플릿과 워크플로를 조정하는 프리셋(Presets), 제품 관리자나 개발자 같은 역할 단위로 묶은 번들(Bundles)을 지원합니다. 실행에는 Linux, macOS, Windows 중 하나와 지원되는 AI 코딩 에이전트, 패키지 관리를 위한 uv 또는 pipx, Python 3.11 이상, Git이 필요합니다. 30종이 넘는 CLI 도구 및 IDE 기반 어시스턴트와 함께 사용할 수 있습니다. 라이선스는 MIT입니다.
구현에 앞서 사양과 계획을 문서로 확정하고 그 문서에서 코드를 도출하려는 사람에게 맞습니다.
댓글 0
아직 댓글이 없습니다. 첫 댓글을 남겨보세요.