GitHub 사양 키트란?
GitHub 사양 키트는 사양 기반 개발을 용이하게 하기 위해 GitHub 개발한 오픈 소스 도구 키트입니다. GitHub Copilot 같은 AI 코딩 도우미와 통합하고 구조적 명령, 템플릿 및 영구 아티팩트를 통해 SDD 워크플로를 오케스트레이션하도록 설계되었습니다.
GitHub Spec Kit을 보조 조종사처럼 생각해 보세요. 이는 개발의 각 단계에서 AI가 구조화된 프로세스를 통해 일관되고 높은 품질의 결과를 낼 수 있도록 안내합니다.
GitHub 사양 키트는 코딩 도우미와의 여러 상호 작용에서 컨텍스트 및 일관성을 유지하는 AI 지원 개발의 근본적인 과제를 해결합니다. 구조가 없으면 AI와의 각 채팅 세션이 격리되어 작동하며 이전 결정 또는 전반적인 프로젝트 요구 사항에 대한 인식이 부족합니다. GitHub 사양 키트는 다음을 통해 이 문제를 해결합니다.
영구 아티팩트 만들기: 사양, 계획 및 작업은 리포지토리에 Markdown 파일로 저장되어 요구 사항 및 결정에 대한 영구 레코드를 만듭니다.
워크플로 표준화: 정의된 프로세스는 사양, 계획, 작업 분석 및 구현을 통해 높은 수준의 요구 사항을 안내합니다.
재사용 가능한 명령 제공: 기본 제공 슬래시 명령은 모범 사례 프롬프트 패턴을 캡슐화하므로 각 개발 단계에 대한 최적의 프롬프트를 작성할 필요가 없습니다.
핵심 사항: GitHub 사양 키트는 AI 모델 자체가 아니며 선택한 AI 에이전트에 작동하는 프레임워크 및 CLI입니다. 모든 항목을 수동으로 작성하도록 요구하는 대신 AI를 사용하여 사양, 계획 및 작업을 생성하여 고급 아이디어를 작업 코드로 변환하는 데 도움이 됩니다.
GitHub 사양 키트의 핵심 원칙
GitHub Spec Kit의 디자인은 SDD 원칙을 직접 구현합니다.
Executable specifications: GitHub 사양 키트는 명령을 통해 코드 생성을 구동하는 데 사용하여 사양을 "실행 가능"으로 만듭니다. 사양은 설명서가 아니라 구현을 생성하는 입력입니다.
구조화된 워크플로 적용: GitHub 사양 키트는 단계를 순서대로 안내합니다. 도구의 워크플로는 이전 단계에서 각 단계를 빌드하도록 설계되었기 때문에 먼저 사양과 계획이 없으면 효과적으로 구현할 수 없습니다.
의도 우선 접근 방식: 항상 도구 흐름에서 의도(사양)를 명시적으로 명시하는 것으로 시작합니다. 작성자의 목표는 개발자가 제품 요구 사항 및 결과에 집중할 수 있도록 하는 것이었고 AI는 상용구 코드를 처리합니다.
지원되는 프로젝트 형식
GitHub 사양 키트는 다양한 유형의 프로젝트에서 작동하여 상황에 맞게 접근 방식을 조정합니다.
그린필드 프로젝트
Greenfield 프로젝트는 프로젝트 폴더로 시작하지만 기존 코드는 없습니다. 프로젝트 폴더에서 GitHub Spec Kit를 초기화하면 애플리케이션을 만드는 데 도움이 됩니다. 기능 아이디어를 설명하고, GitHub 사양 키트는 전체 사양, 계획 및 작업 목록을 생성하는 것을 안내합니다. 이 모듈의 랩 연습에서는 이 시나리오를 보여 줍니다.
브라운필드 프로젝트
Brownfield 프로젝트는 기존 코드베이스로 시작합니다. 기존 리포지토리에서 GitHub Spec Kit를 초기화하면 기존 아키텍처 및 디자인 결정을 준수하면서 새 기능을 추가하는 데 도움이 됩니다. GitHub 사양 키트는 코드베이스의 구조와 규칙을 프로젝트에 대한 표준 및 지침이 포함된 문서인 프로젝트 헌법으로 요약하는 데 도움이 될 수 있습니다. 새 기능에 대한 사양을 만들고 GitHub 사양 키트는 기능을 현재 코드와 통합하는 계획 및 작업을 생성합니다. 이 프로세스를 통해 AI에서 생성된 코드가 기존 애플리케이션과 일관되게 유지됩니다.
예비 프로젝트
여러 가지 잠재적 접근 방식을 탐색하는 경우 GitHub 사양 키트는 동일한 사양에서 여러 계획을 생성할 수 있습니다. 접근 방식을 선택하기 전에 대체 계획을 생성하고 비교하여 성능, 유지 관리 가능성 또는 비용 등 다양한 최적화 목표를 탐색할 수 있습니다.
리팩터링 및 현대화
GitHub 사양 키트는 원하는 최종 상태를 사양으로 처리하여 리팩터링 작업을 안내할 수 있습니다. 리팩터링된 코드가 달성해야 하는 작업(구조가 개선된 동일한 기능)을 문서화하고, 리팩터링 방법에 대한 계획을 만들고, 증분 변경 작업을 생성합니다.
GitHub 사양 키트가 SDD 단계에 맞추는 방법
GitHub 사양 키트는 각 SDD 단계에 대한 명령 또는 단계를 제공합니다.
| SDD 단계 | GitHub 사양 키트 명령 | 출력 파일 |
|---|---|---|
| 구성(설정) | /speckit.constitution |
헌법.md |
| 지정 | /speckit.specify |
spec.md |
| Plan | /speckit.plan |
계획.md |
| 업무 | /speckit.tasks |
tasks.md |
| Implement | /speckit.implement |
소스 코드 |
이 일대일 매핑은 SDD가 단순한 이론이 아니라는 것을 보여줍니다. GitHub Spec Kit는 이를 구체적인 명령 및 아티팩트로 운영합니다.
GitHub 사양 키트에 포함된 구성 요소
GitHub 사양 키트를 설정하면 다음과 같은 여러 통합 구성 요소가 제공됩니다.
CLI 도구 지정
명령줄 도구는 specify 사양 기반 프로젝트를 초기화하고 관리합니다. 프로젝트 디렉터리에서 실행 specify init 하면 다음을 수행합니다.
- AI 코딩 도우미를 선택하라는 메시지가 표시됩니다.
- 워크플로 템플릿을 사용하여
.github/prompts/디렉터리를 만듭니다. - 사양에 대한 폴더를 사용하여 프로젝트 구조를 생성합니다.
- 템플릿 파일 만들기: constitution.md, spec.md, plan.md, tasks.md
- 선택한 AI 도우미와의 통합 구성
Markdown 아티팩트 파일
GitHub 사양 키트는 구조적 Markdown 파일을 기본 개발 아티팩트로 사용합니다. 이러한 파일은 수동 설명서가 아니며 AI 코드 생성을 적극적으로 추진합니다.
- constitution.md: 프로젝트 전반의 원칙, 제약 조건 및 비협상 요구 사항
- spec.md: 기능 요구 사항, 사용자 스토리 및 수용 조건
- plan.md: 기술 아키텍처 및 구현 전략
- tasks.md: 실행 가능한 개별 작업 항목
슬래시 명령
GitHub 사양 키트는 특정 워크플로 단계를 트리거하는 사용자 지정 채팅 명령을 통해 Visual Studio Code 통합됩니다. 이러한 명령은 초기화 후 GitHub Copilot Chat 패널에 표시됩니다.
템플릿
GitHub 사양 키트에는 사양, 계획, 작업 및 기타 아티팩트용 템플릿 파일이 포함되어 표준 구조를 보장합니다. 새 프로젝트를 시작할 때 템플릿은 채울 섹션을 제공하여 포함할 정보를 안내합니다.
다중 에이전트 지원
GitHub Spec Kit는 GitHub Copilot 이외의 여러 AI 코딩 도우미를 지원합니다.
specify init를 실행할 때, 지원되는 에이전트 중에서 선택합니다.
- GitHub Copilot(Visual Studio Code 통해 통합)
- 클로드 코드
- Cursor
- Windsurf
- Amazon Q 개발자
- 그리고 다른 것들
기본 사양 아티팩트(spec.md, plan.md, tasks.md)는 사용하는 AI 도우미와 관계없이 동일하게 유지됩니다. 이 에이전트에 구애받지 않은 접근 방식은 공급업체의 잠금을 방지하고 팀이 일관된 SDD 사례를 유지하면서 다양한 AI 도구를 실험할 수 있도록 합니다.
GitHub 사양 키트를 사용하는 이유는 무엇인가요?
GitHub 사양 키트는 AI 지원을 통해 사양 기반 개발을 채택하는 개발자에게 다음과 같은 몇 가지 이점을 제공합니다.
효율성: AI를 사용하여 사양 및 계획을 신속하게 작성합니다. 처음부터 작성하는 데 몇 시간이 걸릴 수 있는 내용을 GitHub Spec Kit를 사용하면 몇 분 안에 생성할 수 있습니다 (생성 후에는 사용자가 구체화할 수 있습니다).
일관성: 템플릿을 통해 일관된 형식을 적용하고 매번 일관된 접근 방식을 적용합니다. 이는 팀워크와 반복 가능한 프로세스에 유용합니다.
Multi-agent 유연성: 워크플로를 변경하지 않고 원하는 AI 환경(GitHub Copilot, Claude 등과 Visual Studio Code 사용)을 사용합니다.
Enterprise ready: 헌법 개념은 GitHub Spec Kit가 회사 차원의 모범 사례를 인코딩하고 AI가 모든 계획에서 이를 따르도록 할 준비가 됨을 의미합니다.
오펜 소스 및 확장 가능: 조직에서는 템플릿을 사용자 지정하거나, 개선에 기여하거나, GitHub 사양 키트를 시스템과 통합할 수 있습니다.
GitHub 사양 키트를 사용하면 며칠이 걸릴 수 있는 작업을 몇 분 안에 수행할 수 있습니다. 제품 요구 사항 및 결과에 중점을 두면서 코드 생성을 안내하는 AI 프로젝트 관리자가 있는 것과 같습니다.
요약
GitHub 사양 키트는 구조화된 워크플로, 영구 아티팩트 및 AI 통합을 제공하여 사양 기반 개발을 운영하는 오픈 소스 도구 키트입니다. 명령 및 템플릿을 사용하여 지정, 계획, 작업 및 구현의 SDD 단계를 안내하여 효율적이고 일관되며 고품질의 소프트웨어 개발을 가능하게 합니다. 다중 에이전트 지원 및 엔터프라이즈 준비 상태를 통해 GitHub Spec Kit는 팀이 프로젝트 요구 사항 및 디자인 원칙에 대한 제어를 유지하면서 AI를 효과적으로 적용할 수 있도록 지원합니다.
메모
자세한 내용은 텍스트 및 이미지 탭을 참조하세요.