뱅크샐러드의 애자일한 테크스펙 문화: 오해와 진실

테크스펙에 대한 오해 해소 및 애자일 원칙 재해석

• 뱅크샐러드의 코드 작성 전 테크스펙 문화는 애자일 선언문의 문서 경시 관점과 상충한다는 오해를 받습니다.
• 애자일 선언은 작동하는 소프트웨어보다 문서를 더 중요시하는 관행을 경계하며, 상호작용을 촉진하는 문서는 애자일의 취지를 극대화합니다.
• 현대의 노션, 구글 문서 등은 실시간 협업 및 피드백이 가능한 동적인 "문서 도구"이며, 테크스펙은 이를 통해 질의응답, 브레인스토밍을 위한 도구로 기능합니다.

테크스펙의 핵심 역할과 적용 기준

• 테크스펙의 본질은 "토론방"으로, 생산적인 토론을 통해 솔루션을 모색하는 데 목적이 있습니다.
• 주로 2인 이상의 협업 프로젝트 또는 창의력이 요구되는 작업에 작성되어, 초기 단계에서 다양한 관점의 팀원 피드백을 받습니다.
• 이를 통해 코드 구현 전 잠재적 문제를 해결하고, 명확한 작업의 경우 PR 본문 등으로 대체하여 효율성을 추구합니다.

테크스펙의 수명 주기 및 유지 관리 전략

• 테크스펙은 단기적인 수명을 가지며, 스펙이 배포됨과 동시에 목적을 다합니다.
• 스펙 변경 시 기존 문서를 수정하지 않고 새로운 테크스펙을 작성하는 것이 원칙입니다.
• 최신화가 필요한 장기 참조 명세는 IDL, 주석, 테스트 코드, README 등을 활용합니다.
• 테크스펙의 핵심은 가독성보다는 고민 주제, 조사 내용, 그리고 피드백 포인트의 명확성입니다.