같은 코드를 봐도 설명은 필요했다

해외 연구소 동료에게 프로젝트를 맡길 때면, 먼저 해야 할 일이 있었다. 지금 코드가 어떻게 돌아가는지 설명하는 일이었다.

우리는 같은 코드를 함께 유지보수한다. 기술 방향과 주요 의사결정은 주로 한국 팀에서 맡는다. 해외 동료가 다음 작업을 이어가려면 코드의 구조와 기능부터 이해해야 했다.

정작 우리도 문서 쓰는 일은 자꾸 뒤로 미뤘다. 개발하면서 설명까지 남기려니 번거로웠다. 코드는 매일 바뀌는데 문서는 충분히 쌓이지 않았다.

주요 코드 내용을 두 언어로 정리했다

camera-hal-sdd-generator를 사내에 적용해 주요 코드 내용을 문서로 정리하는 과정을 자동화했다. 문서는 한글과 영어를 함께 지원한다.

사외 프로젝트 개발에는 Claude와 Codex를, 사내 시스템 구축에는 Claude를 썼다. 반복적인 문서 생성은 사내 LLM에 맡겼다. 기업용 AI 이용 비용이 부담되는 환경이라 운영 비용도 고려했다.

업무를 넘길 때 함께 건넬 문서가 생겼다

2026년 10월 중순부터 약 일주일간 실제 업무에 적용했다. 생성된 문서는 해외 동료에게 코드를 설명하고 다른 프로젝트를 맡길 때 유용하게 썼다.

아직 시간을 얼마나 아꼈는지, 비용이 얼마나 줄었는지는 측정하지 않았다. 지금 확인한 변화는 업무 인계에 활용할 문서가 생겼다는 점이다.

작은 코드 모듈 하나부터 시작할 수 있다

비슷한 어려움이 있다면 관련 기능을 묶은 작은 코드 단위부터 문서를 만들어볼 수 있다. 두 언어의 뜻이 같은지, 코드의 조건을 빠뜨리지 않았는지 사람이 확인한다. 자동 검사 통과만으로 내용이 정확하다고 볼 수는 없다.

사내 원본은 공개할 수 없어 첨부 자료에는 공개 소프트웨어 libcamera의 기존 자료를 담았다. 사내 활용 경험과 구분해 문서 형식과 구조 반영 예시를 보여준다.