피드로 돌아가기
뱅크샐러드 기술블로그Career
원문 읽기
뱅크샐러드 기술블로그뱅크샐러드의 특별한 스펙, '테크 스펙'
뱅크샐러드가 개발 착수 전 기술 설계 문서(테크 스펙)를 필수화해 팀 간 커뮤니케이션 복잡도를 O(3^N)에서 O(N)으로 감소
AI 요약
Context
조직이 급성장하면서 개발자 간 구두 설명이 불가능해졌다. 10개 이상의 PR이 Review Required 상태로 쌓였고, 팀원별 1시간씩 설명하면 총 10시간 이상 소요되는 상황이 발생했다. 동시에 레거시 코드의 작성 배경이 기록되지 않아 신입이나 담당자 변경 시 이해에 어려움이 발생했다.
Technical Solution
- 테크 스펙 문서 도입: 기능 개발 전에 Google Docs에 기술 설계 문서를 작성하고 전체 개발팀에 공유
- 표준 템플릿 구성: Summary(3줄 요약), Background(동기/문제점), Goals(측정 가능한 목표), Non-Goals(명시적 범위 제외), Plan(기술적 상세 설계), Other Considerations(검토된 대안), Milestones(일정 세부 계획) 포함
- 다중 플랫폼 소통 채널 단일화: 오프라인/슬랙/문서 3가지 채널의 소통을 테크 스펙 1개 문서로 통합
- 일정 산정 투명성 확보: 마일스톤을 구체적으로 기재해 기획팀이 비즈니스 요구사항 변경 시 개발 영향도 사전 판단
- 플랫폼별 구조화: 공통 스펙은 단일 문서로 작성하고, 플랫폼 고유 구현(예: Android 아키텍처)은 별도 문서로 분리
Impact
아티클에서 정량적 수치로 명시된 영향이 없음.
Key Takeaway
테크 스펙 작성은 코딩과 별도의 업무가 아니라 설계 단계에서 이미 상당한 코드 논리가 구체화되므로, 기록된 설계를 바탕으로 개발하면 구현 속도가 빨라지고 커뮤니케이션 비용이 절감되며 비즈니스 변화에 투명하게 대응할 수 있다.
실천 포인트
개발팀 규모가 5명 이상이고 동시 진행 기능이 3개 이상인 조직에서는 기능별로 1~2페이지 규모의 테크 스펙(배경·목표·비기술 요구사항 제외 범위·상세 설계·마일스톤 포함)을 공유 문서에 작성해 리뷰 전에 배포하면, PR 설명 시간과 오프라인 동기화 미팅을 50% 이상 줄일 수 있다.
태그