프로덕트 스펙 문서 작성법

 뉴딜코리아 홈페이지 

프로덕트 스펙 문서 작성법
스펙 문서는 왜, 어떻게 써야 하는가?

“스펙 문서”란 단어를 들으면 대부분은 인상을 찌푸린다.
아무도 읽지 않을 문서를 작성하는 데 보낸 시간을 생각하면서…
문서 작성까지 해야 한다면 누가 과연 민첩하게 코드를 쏟아낼 수 있겠는가?
수백만의 사람들이 사용하는 소프트웨어 프로덕트를 만들며 10년 넘는 시간을 보낸 후, 난 기존의 이런 생각이 잘못되었다는 것을 깨달았다.

효과적인 스펙 문서는 훌륭한 소프트웨어를 만드는 과정에서 결정적인 역할을 한다.
그러한 문서는, 개발 초기부터 비판적 사고를 하게끔 하고, 커뮤니케이션을 효율화하며 , 책임 소재를 분명히 함으로써 높은 품질, 일정 리스크 축소, 시간 낭비 최소화에 기여한다.
사례와 함께 관련된 일반적인 조언을 적어놓았다.

이 포스팅은 200명 정도 되는 mid-to-large 사이즈 기업의 프로덕트 매니저에게 가장 도움이 될 것이다.

□ 왜 스펙 문서를 쓰는가?

적합한 프로덕트를 더 높은 품질로, 빠르고, 예측할 수 있게 내놓기 위해서.

어떻게 스펙 문서가 그걸 가능하게 하는가? 벤 호로비츠의 말과 스펙 문서 예시를 통해 ‘왜' 에 대해서는 설명했지만 확실하기 위해 더 적어보았다.


1. 초기부터 비판적 사고를 하게끔 한다.
글을 쓰는 것은, 설계, 코딩, 디자인, QA 등의 ‘비싼 작업'이 시작되기 전에 먼저 구체적인 부분에 대해 생각하게 한다. 선택의 질을 높여주며, 생각하지 못한 돌발 상황이 생길 확률도 줄여준다.

2. 커뮤니케이션을 효율적으로 할 수 있게 한다.
어떤 방식으로든, 당신은 다양한 관계자들(운영, 개발, 디자인, 재무, 경영진 등)과 이 계획에 대해 커뮤니케이션하게 될 것이다. 스펙 문서는 이러한 커뮤니케이션을 묶어서 해결할 수 있게 해주고(이런 문서 없이 구두로 설명한다면 각자가 이해하는 바가 모두 달라질지도 모른다), 모호한 부분이 없게 함으로써 다른 사람들이 이해하고, 지적인 응답을 할 수 있게 해준다.

3. 책임 소재를 분명히 한다.
측정 가능한 목표를 공개적으로 알림으로써 팀의 목표를 정렬해주는 효과가 있다.
관계자들은 마지막 순간에 추가 요청하는 것이 얼마나 무리한 일인지 알게 될 것이고, 개발자들은 일정을 산정할 때 숙고하게 될 것이다.


□ 스펙 문서에 무엇이 포함되어야 하는가?

스펙 문서는 무엇을, 왜 만들어야 하는지에 대한 명확한 결정사항을 모아놓은 문서이다. 아이디어를 구조화하는 방법은 여러 가지가 있지만, 핵심 내용은 다음 다섯 가지다.

1. 문제(The Problem)
풀고 싶은 문제를 정리하라. 중요한 것은, 이게 왜 다뤄져야 하는지를 설명하는 것이다. 구체적으로 설명하고 지표를 제공하라.

2. 측정 가능한 목표(Measurable Goals)
결과물을 명시하라. 무엇이 범위에서 제외되는지도 밝혀라. 목표를 보고 “우리가 이걸 달성했나?” 라는 질문에 답변할 수 있도록 목표를 세워야 한다.

3. 상황(Context)
문제에 대해 이해하고 당신의 제안 사항에 동의할 수 있게끔 하는 근거를 제공하라. 가정, 사례, 지표 등..

4. 상세한 해결방안(Detailed Solution)
팀에서 보고 실행할 수 있을 정도로 자세하게 적어야 한다. 실제 작업에 참여할 사람들의 두뇌를 가동하게 하는 코드를 작성한다고 생각하라.

5.일정(Timeline)
팀에서 논의된 날짜별 마일스톤을 적어라. 처음엔 대략 적더라도, 마지막 리뷰미팅 전에 최종적으로 결정되어야 한다.


☞ 추가 상세 내용은 아래 원문 자료와 번역본을 참고 바랍니다

(원본)
https://goberoi.com/on-writing-product-specs-5ca697b992fd

(번역본)
https://webuildproduct.com/%EC%8A%A4%ED%8E%99-%EB%AC%B8%EC%84%9C-%EC%9E%91%EC%84%B1%EC%97%90-%EA%B4%80%ED%95%98%EC%97%AC-ee61a1fc294f

컨설팅 : ISMS-P, ISO27001  GDPR,PCI-DSS 

취약점 진단 및 모의 침투

개인정보 비식별화 솔루션

보안솔루션 공급
070-7867-3721, ismsbok@gmail.com