팀 문화 구축 및 개선

배경

5명 이하 소규모 팀에서 개발 프로세스와 협업 표준이 부재했습니다. 코드 스타일이 개인마다 달라 리뷰 시 불필요한 논쟁이 발생했고, Git 사용법 미숙으로 머지 충돌이 빈번했으며, 시스템 아키텍처에 대한 문서가 없어 특정 개발자에게 지식이 편중되어 있었습니다. 신규 팀원이 합류해도 시스템을 이해하기까지 시간이 오래 걸렸습니다.

해결 과정

Git 워크플로우 정립: Git Flow 전략을 수립하고 팀원 교육을 진행했으며, PR 기반 코드 리뷰 문화를 도입했습니다. 처음에는 리뷰에 대한 저항이 있었지만, 실제 리뷰에서 발견된 버그 사례를 공유하면서 팀 내 인식이 바뀌었습니다.

문서화 표준: 시스템 개요, Docker 서비스, 서버 구조, 워커 구성, 데이터 처리, PLC 통신 등 8개 아키텍처 문서를 직접 작성했습니다. API 문서 자동화(Swagger/OpenAPI)도 적용하여 별도 관리 없이 최신 API 명세를 유지할 수 있게 했습니다.

코드 품질 체계: Pre-commit에 Black(포매팅), isort(임포트 정렬), Ruff(린팅)를 도입하여 커밋 시점에 스타일을 자동 통일했습니다. 프론트엔드에는 ESLint(TypeScript + React Hooks)와 Storybook + MSW 기반 컴포넌트 개발 환경을 구축했습니다.

성과

• Pre-commit + 코드 리뷰 도입으로 팀 전체 코드 스타일 일관성 확보
• 8개 아키텍처 문서 + API 자동 문서화로 지식 편중 해소 및 공유 체계 마련
• 팀 전체의 엔지니어링 역량 상향 평준화
• 신규 인력 온보딩 시간 단축, 체계적 협업 프로세스 정착