(타임테이블)
TIL - 기능 명세서 잘 작성하는 법
📎 참고 아티클
기능 명세서란?
개발자가 구현해야 할 기능과 그 동작 방식을 상세하게 기술한 문서.
단순히 개발자와의 소통 도구가 아니라, 기획 → 개발 → 테스트 전 단계에 영향을 미치는 핵심 문서다.
잘못 작성하면 프로젝트 전체가 뒤틀릴 수 있다.
"기능 명세서를 잘 작성하는 사람은 글을 많이 쓰는 사람이 아니라, 기능을 가장 쉽게 이해시키는 사람이다."
잘 쓰는 법 핵심 3가지
1. 명확하게 쓰기
- 모호한 표현은 개발자가 잘못 이해하는 원인이 된다.
- 나쁜 예: "사용자는 게시물을 작성할 수 있다"
- 좋은 예: "사용자는 제목, 본문, 카테고리를 입력한 후 '작성' 버튼을 클릭하여 게시물을 작성할 수 있다"
- 기능의 입력 / 출력 / 동작 방식을 구체적으로 기재할 것
2. 우선순위 정하기
- 모든 기능이 같은 중요도를 가지지 않는다.
- 핵심 기능(로그인, 결제 등)을 먼저 정의하고, 부가 기능(통계, 대시보드 등)은 후순위로
- 필수 화면 / 선택 화면을 구분하고, 각각에서도 우선순위를 매기면 더 체계적
3. 협업으로 완성하기
- 기능 명세서는 혼자 쓰는 문서가 아니다.
- 기획자, 디자이너, 개발자가 함께 검토하고 의견을 반영해야 완성도가 높아진다.
- 작성 중간에 팀원들과 공유하고 수정하는 과정이 필수
실무 팁
- 텍스트만 나열하지 말고, 다이어그램이나 Figma 시각화를 함께 첨부하면 이해도가 훨씬 높아진다
- 기능을 유닛 테스트 가능한 단위로 쪼개면 개발자가 바로 구현에 들어갈 수 있다 (제대로 된 명세서는 100개 이상의 명세가 나오기도 함)
- 불필요한 기능은 과감히 제거하기 → MVP라면 더더욱
회고
팀 과제 최초 야근의 날..
오늘은 목표했던 PRD와 기능 명세서를 제출하는 날이었다.
문서화 능력자 분이 PRD 작성을 맡아주셨고, 나는 이전 실무에서 기능 명세서 작성 경험이 있어 기능 명세서를 주로 맡아 작업을 진행했다.
MVP이기 때문에 최소한의 기능만 선택해서 결과물이 빠르게 나올 수 있도록 목표를 잡고 기능 명세서를 작성했다.
필수 화면단과 선택 화면단을 나누었고, 각각에서도 우선순위를 정해 보기 편한 구성을 최우선으로 생각했다.
오후에 킥오프 회의를 했을 땐 튜터님께 긍정적인 피드백을 받아서 기분이 좋았다!
확실히 인수인계 아이디어는 좋은 것 같다. (팀원 최고!)
다만 B2B 서비스라 영업이 중요할 것 같고, 반드시 이득이 된다는 걸 어필하는 과정이 필요하다고 하셨다. 정량적인 데이터를 많이 내세워야겠다는 생각을 했다.
이후 기능 명세서를 작성하느라 11시까지 야근을 했다...
내가 생각한 방향대로 작성하다 보니 어쩌다 주도하게 됐는데, 팀원분들이 너무 잘 따라주셔서 정말 감사했다.. 감사합니다..
열정열정열정🔥