스펙 기반 개발
생산성중급
기능을 바로 코딩하지 않고, 먼저 소크라틱 질문으로 요구사항을 명확히 한 후 구현 스펙을 작성합니다. 이 스펙을 기반으로 구현을 진행하면 재작업을 크게 줄일 수 있습니다.
트리거
/spec사용빈도주 1-2회
기획자 겸 개발자 (1인 개발)라면? /spec으로 기획과 개발을 한 세션에서 체계적으로 진행
PM이 개발팀에 요구사항을 전달할 때라면? 모호한 요구사항을 구체적 스펙으로 변환
스펙기획개발 프로세스품질
작동 흐름
/spec [기능 아이디어] 실행 → 인터뷰 시작
↓
Phase 1: 질문을 통해 4개 영역 정의
scope
범위 정의
edge-cases
엣지 케이스 도출
tech-choice
기술 선택
acceptance
인수 기준 정의
↓
실행 스펙 문서 생성
↓
✓ 구현 스펙 + 이 스펙으로 새 세션에서 바로 구현 가능
스킬 코드
# Spec-Driven Development Skill
## Trigger: /spec [feature idea]
When invoked:
1. Interview phase (ask questions one at a time):
- What exactly should this feature do?
- Who is the primary user?
- What are the inputs and outputs?
- What should NOT be included? (scope boundary)
- What edge cases should we handle?
- Any existing patterns to follow?
2. Generate spec document:
---
## 📐 Implementation Spec: [Feature]
### Overview
[1-2 sentence summary]
### Scope
**In scope**: [list]
**Out of scope**: [list]
### Technical Approach
- [Architecture decision]
- [Key libraries/patterns]
- [File structure]
### Implementation Steps
1. [Step with file and approach]
2. [Step with file and approach]
3. [Step with file and approach]
### Edge Cases
- [case → expected behavior]
### Acceptance Criteria
- [ ] [testable criterion]
- [ ] [testable criterion]
---
3. Save as SPEC-[feature].md for use in implementation session
복사해서 CLAUDE.md에 붙여넣으면 바로 사용할 수 있습니다.
스펙 기반 개발 작동 방식
Spec-Driven Dev는 기능 요구사항에 대한 구조화 인터뷰를 진행하고, 답변을 수락 기준이 포함된 공식 스펙 문서로 변환한 후, 각 기준을 충족하는 구현 코드를 생성합니다.
스펙 기반 개발이(가) 빛나는 순간
모호한 기능 요청과 정확한 구현 사이의 간극을 해소합니다. 특히 프로덕트 요구사항이 불명확하여 코드 작성 전에 테스트 가능한 스펙으로 구체화해야 할 때 유용합니다.
핵심 특장점
- 구조화 인터뷰로 정확한 요구사항 추출
- 테스트 가능한 수락 기준을 자동 생성
- 구현 코드가 스펙에 추적 가능
- 경계를 사전에 정의하여 스코프 크리프 방지