기능 명세서(Feature Specification)는 집 짓기 전에 만드는 설계 요청서 같은 것 — 만들 서비스에 어떤 기능이 있고 각 기능이 어떻게 동작해야 하는지 미리 정리한 문서예요.
기능 명세서는 집을 짓기 전에 건축가에게 건네는 요청서와 비슷해요. 방은 몇 개인지, 주방은 어디에 둘지, 창문은 어느 쪽으로 낼지 먼저 정해 두면 공사 중에 벽을 허무는 일이 줄어들어요. 사이트나 앱도 로그인, 결제, 게시판처럼 어떤 기능이 필요하고 각 기능이 어떻게 동작해야 하는지 글로 정리해 두는데, 이걸 기능 명세서 또는 spec이라고 불러요.
강의에서는 사이트를 만들기 전에 에이전트에게 초보자용 spec.md 파일을 먼저 만들게 해요. 레퍼런스 사이트를 보여 주고 "와이어프레임, 기능 명세서, 디자인 시안을 먼저 주고 그다음에 만들어"라고 요청하는 식이에요. 기술 스택과 MVP 범위도 함께 정해 큰 틀을 잡고, 결과물을 보며 피드백을 주면 명세서를 다시 업데이트하게 해요. 처음에 잘 정해 둘수록 중간에 고치는 비효율이 줄어든다는 게 강의의 핵심 메시지예요. 그래서 명세서를 직접 처음부터 쓸 필요 없이, 만들고 싶은 서비스를 말로 설명하고 AI에게 초안을 받아 고치는 방식으로 작성하면 돼요.
초보가 헷갈리는 건 와이어프레임과의 차이예요. 와이어프레임은 화면 배치를 그린 그림이고, 기능 명세서는 "버튼을 누르면 무슨 일이 일어나는지"를 글로 적은 문서예요. 또 명세서에 모든 기능을 다 넣으려 하면 일정이 끝없이 늘어나니, 첫 버전에 꼭 필요한 것과 나중에 할 것을 나눠 적는 게 좋아요. 명세서는 한 번 쓰고 끝나는 게 아니라 만들면서 계속 고쳐 가는 살아 있는 문서예요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.