github/spec-kit

무엇을 해결하는가

Spec Kit은 AI 코딩 에이전트를 사용할 때 발생하는 상위 수준의 요구사항과 최종 코드 사이의 간극을 해결합니다. 에이전트가 구현 단계로 바로 뛰어드는 것(이는 종종 버그나 불일치를 초래함)을 방지하기 위해, 사양(specification)이 실행 가능하며 구현을 직접 생성하는 구조화된 사양 중심 프로세스를 강제합니다.

작동 방식

Spec Kit은 30개 이상의 AI 코딩 에이전트(GitHub Copilot 또는 Claude 등)와 통합되는 CLI 도구(specify-cli)를 제공합니다. 이는 에이전트가 특정 개발 라이프사이클을 따르도록 안내하는 일련의 구조화된 슬래시 명령어를 도입합니다:

1. Constitution: 프로젝트 전반의 거버넌스 원칙을 수립합니다.
2. Specify: '무엇을(what)' 그리고 '왜(why)'(요구사항)를 정의합니다.
3. Plan: 기술 아키텍처와 기술 스택을 정의합니다.
4. Tasks: 계획을 실행 가능한 항목으로 나눕니다.
5. Implement: 기능을 구축하기 위해 작업을 실행합니다.
6. Converge: 사양 및 계획에 따라 코드를 검증하고, 남은 작업을 새로운 작업으로 추가합니다.

이 도구는 extensions(새로운 기능/명령어 추가) 및 presets(기존 워크플로우의 동작 방식 사용자 정의)를 통해 높은 확장성을 제공합니다.

대상 사용자

소프트웨어 품질을 개선하고, 팀 간의 일관성을 유지하며, AI가 생성한 코드가 문서화된 요구사항을 엄격히 준수하도록 보장하고자 하는 AI 코딩 에이전트 사용자(소프트웨어 개발자 및 조직)입니다.

주요 특징

• Agent Agnostic: 30개 이상의 CLI 및 IDE 기반 AI 코딩 에이전트와 작동합니다.
• Spec-Driven Development (SDD): 사양을 코드의 주요 실행 가능한 드라이버로 만듦으로써 기존 방식을 뒤집습니다.
• Modular Customization: 새로운 기능을 위한 extensions, 워크플로우 재정의를 위한 presets, 역할 기반 팀 설정을 위한 bundles를 지원합니다.
• Specialized Workflows: 증거 기반 버그 수정(assess → fix → test) 및 아이디어 평가(intake → research → decide)를 위한 선택적 extensions를 포함합니다.