SSD 철학 구현 워크플로우 도구

GitHub Spec Kit 워크플로우

2025년 9월, GitHub은 Spec Kit이라는 오픈소스 도구를 발표했다. Spec Kit은 명세 주도 개발의 철학을 실제 개발 워크플로우로 구현한 도구이며, GitHub Copilot, Claude Code, Gemini CLI 등 다양한 AI 코딩 도구와 연동된다. 이 도구는 바이브 코딩의 한계를 보완하면서도, 그 장점을 극대화하기 위해 설계되었다.

Spec Kit이 해결하는 문제

Spec Kit은 AI 코딩의 가장 흔한 실패 패턴을 정면으로 겨냥한다. 많은 개발자들이 AI를 '검색 엔진'처럼 사용하고 있다. 대략적인 목표를 AI에게 던지고, AI가 뱉어낸 코드가 '그럴듯해 보이지만, 실제로는 잘 동작하지 않는' 경험을 반복한다.

4단계 워크플로우 심층 분석

Spec Kit의 핵심은 4단계 워크플로우다. 각 단계는 슬래시 명령어(/speckit.*)로 실행되며, 이전 단계의 출력이 다음 단계의 입력이 되는 파이프라인 구조를 가진다.

1단계: /specify --- 무엇을 만들 것인가. 이 단계에서 개발자는 자연어로 만들고자 하는 소프트웨어를 기술한다. Spec Kit은 이 입력을 바탕으로 구조화된 명세 문서(spec.md)를 생성한다. 이 문서에는 유저 스토리, 인수 기준(Acceptance Criteria), 기능 흐름 등이 포함된다.

2단계: /plan --- 어떻게 구현할 것인가. 명세가 확정되면, 기술적 설계로 넘어간다. 프론트엔드 프레임워크, 백엔드 아키텍처, 데이터베이스 선택, API 설계 등 기술적 결정을 내린다. 중요한 것은, 이 결정들이 1단계의 명세에 '종속적'이라는 것이다.

3단계: /tasks --- 실행 가능한 단위로 분해. 기술 계획이 완성되면, 작업을 AI가 한 번에 처리할 수 있는 크기의 단위로 분해한다. 이 분해는 단순한 목록이 아니라, 의존성과 순서가 정의된 실행 계획이다. 각 작업에는 정확한 파일 경로, 구현해야 할 내용, 그리고 테스트 기준이 포함된다.

4단계: /implement --- 순차적 구현. 마지막으로, AI가 작업 목록에 따라 코드를 순차적으로 생성한다. 각 작업은 독립적으로 완료되고 검증될 수 있는 단위이므로, 문제가 발생하면 해당 작업만 수정하면 된다.

Constitution 시스템의 철학

Spec Kit에서 가장 흥미로운 개념은 Constitution(헌법)이다. 이것은 이전 글에서 다룬 '프로젝트 헌법(CLAUDE.md)'의 개념을 더 체계적으로 발전시킨 것이다. Constitution은 프로젝트의 비양도적 원칙(Non-negotiable Principles)을 정의하는 문서로서, 이후 모든 단계의 명세, 계획, 작업이 이 원칙에 부합하는지를 AI가 자동으로 검증한다.

# Project Constitution 예시 (Blackyak 100대명산 CLAUDE.md 기반)
## Core Principles
- 한국어 UI 기본, 정적 JSON 우선
- Supabase 무료 티어 내 운영 (500MB DB, 1GB Storage)
- 외부 결제 없이 운영 가능한 구조
## Technology Constraints
- Frontend: React 18+ with TypeScript, Vite, Tailwind CSS v4
- Backend: Supabase (PostgreSQL + Edge Function)
- 배포: Vercel (프론트엔드), Supabase (백엔드)
## Don'ts
- 유료 API 호출 금지 (무료 대안 우선)
- 서버 사이드 렌더링 사용 금지 (CSR 전용)
- 직접 크롤링 대신 공식 API/데이터 우선