6 stars. Day one. Copilot을 만든 팀에서 나왔습니다.

이름은 spec-kit입니다. 그리고 이는 AI 지원 개발에서 가장 비용이 많이 드는 문제를 해결합니다.

spec-kit이 없을 때 무슨 일이 일어나는지 보겠습니다.

Claude Code나 Codex를 엽니다. 만들고 싶은 것을 설명합니다. 에이전트는 즉시 코드를 작성하기 시작합니다. 빠르고, 자신만만하며, 생산적으로 보입니다.

4시간 후에는 실제로 원했던 문제와 약간 다른 문제를 해결하는 600줄의 코드가 있습니다. 에이전트가 가정을 했습니다. 당신은 그것을 알아차리지 못했습니다. 코드는 정확합니다. 하지만 사양(spec)은 처음부터 틀렸습니다.

Spec-kit은 이것이 시작되기 전에 막습니다.

실제로 하는 일은 다음과 같습니다.

어떤 코드도 작성되기 전에, spec-kit은 당신의 자연어 설명으로부터 구조화된 기술 명세서(technical specification)를 생성합니다. 이는 당신이 질문할 생각을 하지 못한 질문들을 던집니다. 존재한다는 것을 몰랐던 모호성(ambiguities)을 드러냅니다. 단 하나의 구현 코드 라인이 실행되기 전에 당신과 에이전트 모두가 동의하는 문서를 만들어냅니다.

명세서에는 다음 내용이 포함됩니다:
→ 문제 정의(Problem statement) — 실제로 해결되는 것이 무엇인지 정확하게 명시
→ 제약 조건(Constraints) — 솔루션이 해야 하고 해서는 안 되는 것
→ 인터페이스 정의(Interface definitions) — 입력, 출력, API, 데이터 형태
→ 엣지 케이스(Edge cases) — 순진한 구현을 망가뜨리는 시나리오
→ 수용 기준(Acceptance criteria) — 언제 완료되었는지 정확히 알 수 있는 방법
→ 범위 외(Out of scope) — 이 솔루션이 명시적으로 처리하지 않는 것

에이전트가 명세서를 읽습니다. 당신이 명세서를 검토합니다. 두 분 모두 승인합니다. 그 후에 구현이 시작됩니다.

이것이 특히 AI 코딩 에이전트에게 중요한 이유입니다.

함께 일하는 인간 개발자들은 대화를 통해 요구 사항을 명확히 합니다. 질문, 반박(

Spec-kit은 AI 에이전트가 기본적으로 건너뛰는 명확화 루프(clarification loop)를 만듭니다. 이는 숙련된 엔지니어들이 모든 프로젝트에서 가장 중요하다고 아는 요구 사항 수집 단계를 강제합니다.

이 도구가 가능하게 하는 워크플로우는 다음과 같습니다.

단 하나의 명령으로, 에이전트는 모호한 설명 대신 정확한 목표를 갖게 됩니다. 모든 구현 결정은 시작하기 전에 합의된 내용에 근거하게 됩니다.

여기서 GitHub가 중요한 이유입니다.

GitHub는 Copilot을 구축했습니다. 그들은 수백만 건의 AI 코딩 세션을 지켜봅니다. 그들은 에이전트가 정확히 어디에서 잘못하는지 봅니다. 그들은 누구보다 실패 모드(failure mode)를 잘 알고 있습니다.
spec-kit은 GitHub가 가장 자주 보는 실패 모드, 즉 아무도 무엇이 '정확히' 의미하는지 문서로 남기지 않아 에이전트들이 빠른 속도로 잘못된 방향으로 코드를 작성하는 문제에 대한 해답입니다.

6개의 GitHub 스타. 출시 첫날부터. 그리고 GitHub에서 나왔습니다.
이것은 빠르게 성장할 것입니다.

100% 오픈 소스. MIT 라이선스.

GitHub 링크는 댓글을 확인하세요 👇