회고

Tech Spec을 작성해야 하는 이유

2023년 9월 1주차 회고

2023.09.08 | 조회 393 |
스타트업 라이프의 프로필 이미지

스타트업 라이프

제품을 만드는 이야기, 조직에 대한 이야기를 모아서 주 1회씩 뉴스레터로 전달드리고자 합니다.

 

여러 IT 회사를 다니면서 회고 항상 언급되는 이슈가 있는데 바로 기획에서 개발로 넘어가는 중간 애매한 부분에 대해 고충을 토로하는 분들이 많다는 것입니다. 예를 들면 PO/PM/서비스 기획자들이 기획안을 설명했는데 개발팀이 개발을 안하고 있어서 일정이 미뤄진다는 이야기 혹은 기획안을 보았는데 이건 뭐를 만들어 달라는 것인지 모르겠다는 개발팀 이야기, 검증을 해야하는데 이걸 어떻게 개발하겠다는건지 모르겠다는 검증팀 이야기 등입니다. 정말 많은 회사를 다녀보았지만 군데 빼고는 이슈가 없었던 회사는 없었습니다. 이러한 이슈가 발생하는 것일까요? 

 

바로 명확한 기획안 리뷰가 진행되지 않았기 때문입니다. 기획안을 0부터 같이 만들면 정말 좋겠지만 각자 해야 하는 일들이 많기 때문에 현실적으로는 불가능합니다. 그러다보니 PO/PM/서비스 기획자들이 우선 기능 명세를 작성하지만 이는 제품 베이스가 아닌 유저 단의 시나리오에 불과합니다. 유저 시나리오만 보고 제품을 만들 수는 없습니다. 유저 시나리오를 현재 우리 제품의 형상과 구조에 맞게 제품 베이스로 변환하는 작업이 반드시 필요합니다.   필요한 작업이 바로 Tech Spec 작성입니다. 

 

Tech Spec 유저 시나리오를 기반으로 우리 제품의 어떠한 부분이 변경되어야 하며 어떠한 부분이 변경되면 안되는지, 그로 인해 발생할 있는 리스크는 무엇인지, 기획의도와 부합하는지를 검토하는 제품 중심의 기술 문서입니다. PRD 사용자/고객 중심의 문서라면 Tech Spec 우리 제품의 형상을 정의하는 문서입니다. 그렇기 때문에 기획안 리뷰를 한다하면 화면설계서, IA, 디자인 등의 기획안만 보는 것이 아니라 Tech Spec 다같이 이야기를 나눠야 합니다. 대부분의 회사에서는 기획안 리뷰는 다같이 하나, Tech Spec 개발팀과 검증팀 만의 문서로만 남는 경우가 많습니다. 혹은 Tech Spec 일을 위한 일이라며 작성하지 않는 경우도 많습니다. 배경에는 PO/PM/서비스 기획자들에게 이렇게까지 필요 없다, 기획이 개발까지 참견하는 것은 아니다는 개발팀의 생각과 설명해줘도 어차피 모르기 때문에 우리는 들어도 된다는 기획팀의 생각일 것입니다. Tech Spec 통해 기획팀이 봐야할 부분은 목표와 목표가 아닌 것입니다. 또한 기획팀이라 할지라도 기술과 멀어져서는 절대 안됩니다. 제품의 형상을 모르고 기획한다는 것이 얼마나 위험한 일인지를 깨달아야 합니다. 또한 개발팀은 Tech Spec 작성이 일을 위한 일이 아닌 사전에 Tech Spec 작성하여 숙련자/전문가에게 혹은 구성원에게 이렇게 구현했을 경우 어떠한 리스크가 발생할지 같이 논의하고 피드백을 통해 성장하는 기회로 삼아야 합니다. 코드리뷰를 통해서는 스킬적인 부분을, Tech Spec 통해서는 문제를 접근하는 방식 부분을 배워야 2 이상 성장할 있습니다. 

 

또한 항상 말씀드리듯 Tech Spec 있다는 것은 중요하지 않습니다. 어떠한 내용이 어떻게 담기고 어떻게 활용하냐가 중요합니다. 단순히 구글 검색해서 이러한 것들도 있으니 우리도 해보자라는 생각보다는 현재 우리에게 비어있는 부분은 무엇이고 앞서 이야기한 기획에서 개발로 넘어가는 중간 애매한 부분이 발생하는지 고민하고 해당 내용을 어디에 담을지 결정하는 과정이 반드시 필요합니다. 

 

결국 명확한 기획안 리뷰란 PRD, 화면설계서, 유저시나리오 등의 기획안과 기획안을 바탕으로 만들어진 제품의 개발 방향이 담긴 Tech Spec 같이 리뷰되는 것을 말합니다. 그렇기 때문에 Tech Spec 있으면 좋고가 아닌 반드시 작성되어야 하는 문서입니다. PRD Tech Spec 관계와 언제 어떻게 검토되어야 하는지 등에 대한 전체적인 제품의 개발 프로세스에 관련된 글은 9 내에 작성할 예정입니다.

 

제품을 만들어야 하는 많은 분들에게 도움이 되었으면 합니다. 

 

다가올 뉴스레터가 궁금하신가요?

지금 구독해서 새로운 레터를 받아보세요

✉️

이번 뉴스레터 어떠셨나요?

스타트업 라이프 님에게 ☕️ 커피와 ✉️ 쪽지를 보내보세요!

© 2024 스타트업 라이프

제품을 만드는 이야기, 조직에 대한 이야기를 모아서 주 1회씩 뉴스레터로 전달드리고자 합니다.

메일리 로고

자주 묻는 질문 서비스 소개서 오류 및 기능 관련 제보

서비스 이용 문의admin@team.maily.so

메일리 사업자 정보

메일리 (대표자: 이한결) | 사업자번호: 717-47-00705 | 서울 서초구 강남대로53길 8, 8층 11-7호

이용약관 | 개인정보처리방침 | 정기결제 이용약관 | 라이선스