스펙 기반 개발 (Spec Driven Development)

스펙 기반 개발 (Spec Driven Development)

코드를 작서앟기 전에 먼저 "무엇을 만들지"를 명확한 문서(스펙)로 정의하고,

그 스펙을 기준삼아 AI에게 코드를 생성하게 하는 접근법

 

- 스펙

이 소프트웨어가 어떻게 동작해야하는지를 구체적으로 적어놓은 설명서

 

 

 

 

 

일반적인 바이브 코딩과의 차이

바이브 코딩은 대화형으로 진행

그때 그때 떠오르는대로 AI에게 요청하는 방식

간단한 프로젝트에서는 빠르고 효율적이지만, 프로젝트가 복잡해지면 전체 맥락을 기억하지 못하거나 이전에 만든 코드와 일관성이 깨지는 등 문제가 발생

 

스펙 기반 개발은 전체 설계도를 먼저 완성한 뒤 그 설계도를 보면서 하나씩 구현해 나가는 방식

AI에게 매번 새로운 맥락을 설명할 필요 없이, 스펙 문서 하나를 전달하면 AI가 전체 프로젝트의 구조와 방향을 이해한 상태에서 코드를 생성할 수 있음

결과적으로 코드의 일관성과 품질, 유지보수성이 크게 올라감

 

 

 

 

 

스펙 문서에 들어가야 하는 것 (SPEC.md)

1. 프로젝트 개요 (Overview)

기능, 프로젝트의 목적

왜 필요한지 (문제 정의 / 비즈니스 배경)

기대 효과

 

 

2. 용어 정의 (Glossary)

도메인 용어 정의

약어, 내부 용어

 

 

3. 요구사항 (Requirements)

기능 요구사항 (Functional)

> 무엇을 해야하는가

> 유저 시나리오 기반으로 작성

> ex) 사용자는 회원 가입을 할 수 있다, 이메일 인증을 해야한다

 

비기능 요구사항 (Non functional)

> 성능, 보안, 확장성, 가용성

 

 

4. 유스케이스 / 시나리오 (Use cases)

실제 사용자 흐름

 

 

5. API 명세 (API Spec)

엔드 포인트, 메서드, request, response, 에러 코드

 

 

6. 데이터 모델 (Data Model)

DB 스키마

엔티티 관계

필드 설명 (ERD, 테이블 구조 포함)

 

 

7. 상태 흐름 (State / Flow)

상태 변화 정의

 

 

8. 예외 처리 (Error Handling)

실패 케이스 정의

에러 코드 & 메시지

 

 

9. 권한 / 인증 (Auth & Permission)

누가 접근 가능한지

역할별 제한

 

 

10. UI/UX

화면 설계 (피그마 링크 등)

사용자 인터렉션

 

 

11. 테스트 기준 (Acceptance Criteria)

완료 조건 (Done의 정의)

> ex) 회원가입 시 이메일 인증이 완료되어야 한다

> QA 기준이자 PR 기준

 

 

12. 로그 / 모니터링

어떤 이벤트를 로그로 남길지

장애 대응 기준

 

 

13. 배포 / 롤백 전략

배포 방법

실패 시 롤백 방법

 

 

 

 

 

 

MECE 원칙 (코드 설계의 뼈대)

Mutually Exclusive, Collectively Exhaustive

겹치지 않게, 빠짐 없이

각 step과 그룹이 자기 영역만 담당

설계도와 hook 파일로 모든 step과 그룹이 연결

 

 

 

 

MD 라이프 사이클 (MD로 시작해서 MD로 끝)

1. MD 설계

2. 코드 생성

3. 수정 필요 시 MD 먼저 수정

4. 코드 재생성

5. 완료 후 MD 업데이트 요청

 

MD 파일은 한국어로 작성

코드는 프로그래밍 언어로 작성

비개발자가 관리할 수 있는 MD 파일을 자산으로 유지하고 코드는 AI가 MD를 보고 뽑아내는 구조 확립

 

지금 최신 코드 바탕으로 확인해서 계획서랑 hook, md파일 최신화 해줘

 

 

 

 

 

 

 

 

Reference

https://contents.premium.naver.com/vbcoding/vibecoding/contents/260302173046764jw

스펙 기반 개발(Spec-Driven Development) 실전 가이드 — 바이브코딩에 바로 쓸 수 있는 프롬프트 템플

https://www.i-boss.co.kr/ab-6141-69667

AI 개발 전 보면 100시간 아끼는 바이블 (치트키) 꼭 보세요