AI 에이전트를 활용한 스펙 주도형 개발 (Spec Driven Development)

 

최근 스펙 주도형 개발 (SDD, Spec Driven Development)라는 개발 방식이 떠오르고 있는데요.
 
스펙 주도형 개발이란, 코드 작성 전에 스펙 문서를 먼저 작성하고, 그 스펙을 AI에게 전달하여 코드를 생성하며, 개발자는 품질 판단에 집중하는 개발 방법론입니다.
아래의 사이클을 반복하는 것이 핵심입니다.

 

주의점 !!

최근 AGENTS.md와 task 문서를 AI로 자동 생성했을 때,  오히려 AGENTS.md(or CLAUDE.md)를 안쓸때보다 더 AI를 멍청하게한다는 연구결과가 나왔습니다. 사람이 직접 이 문서들을 관리해야하고, Skill 등의 문서로 뺄 수 있다면 최대한 빼내야합니다.

AGENTS.md는 잘쓰면 좋지만, 잘못쓴다면 안쓰니만 못한 결과가 나온다고 ㅎ바니다.

https://youtu.be/c7_ANA1NiS0

 

 

 

아래는 스펙 주도 개발에서 개발자의 역할, 프로젝트의 구조, 핵심 파일에 대한 간략한 설명입니다.
 

개발자의 역할

### 프로젝트 시작 시
- [ ] AGENTS.md 작성 (프로젝트 개요, 기술 스택, 모듈 구조, 전체 기능 목록 등)
- [ ] tasks/*.md 디렉토리 생성, 첫 태스크 문서 작성

### 매 태스크마다
- [ ] Task 문서 작성 (요구사항, 기술 결정, 완료 조건)
- [ ] Agent와 코드 생성
- [ ] 완료 조건 모두 충족 확인
- [ ] AGENTS.md 진행 상태 업데이트 : task 문서와, decision 문서 링크 남기기

### 주기적 점검
- [ ] AGENTS.md가 현재 상태를 정확히 반영하는가?

 
 

프로젝트의 구조

project-root/
│
├── AGENTS.md                    ← AI에게 프로젝트 맥락을 전달하는 핵심 파일
│
├── tasks/
│   ├── 001-project-setup.md    ← 개별 태스크 스펙
│   ├── 002-auth-system.md
│   ├── 003-3d-viewer.md
│   └── ...
│
├── src/                        ← 실제 코드
└── ...

 
 

각 문서의 역할

문서	역할	비유
AGENTS.md	프로젝트 전체 맥락 (기술 스택, 구조, 컨벤션, 현재 상태)	AI의 장기 기억
tasks/xxx.md	개별 작업 스펙 (요구사항 + 완료 조건 체크리스트)	AI에게 주는 지시서

 
 

---

 
AI가 빠른 속도로 발전하고 있고, 최근 OpenClaw와 같은 기술도 나오고 있지만
아직까지는 사람의 직관, 특히 목표를 설정하고 불필요한 정보를 걸러주고 중심을 잡아주는 역할이 중요하다고 생각합니다.

또한 사람이 사용하는 제품을 만드는 일이기에, 디버깅과 품질 검수 과정에서 개발자의 역할은 여전히 중요합니다.
 
그런 면에서 스펙 주도형 개발을 잘 사용한다면, AI와 보다 좋은 방향으로 페어 프로그래밍을 할 수 있을 것입니다.