AI 코딩 도구를 넘어, 팀의 개발 지식을 남기는 방법: CodeCenter 온보딩 시나리오

min Read

전문 개발자의 90%가 매주, 68%가 매일 AI 코딩 에이전트를 사용합니다(JetBrains, 2026). AI가 개발 업무에 빠르게 자리 잡고 있지만, 그 효과를 결정하는 것은 개인의 활용 능력만이 아닙니다. 마이크로소프트의 2026 업무 동향 지수에 따르면, AI 활용 성과에서 조직 요인의 영향은 개인 요인의 두 배 이상이었습니다.

AI는 조직이 이미 가진 강점과 약점을 확대할 수 있습니다. 개발 기준과 코드 맥락이 팀에 축적되어 있다면 새로운 구성원도 빠르게 적응할 수 있지만, 그렇지 않다면 담당자가 바뀔 때마다 같은 문제를 반복하게 됩니다.

유통 대기업 A사와 협력사 B사의 상황을 가정해 보겠습니다.

B사의 이 사원은 A사 정산 시스템 유지보수 업무에 새로 투입되었습니다. 1년 넘게 정산 배치를 담당해 온 김 책임의 업무를 이어받게 되었지만, 김 책임은 이미 새로운 프로젝트로 바쁜 상황입니다. 남겨진 인수인계 문서는 현재 코드와 일부 달랐습니다.

코드를 읽으면 무엇을 하는지는 알 수 있습니다. 하지만 왜 그렇게 구현했는지, 어떤 부분을 주의해야 하는지는 코드만으로 파악하기 어렵습니다. 그 맥락은 여전히 김 책임의 경험에 의존하고 있었습니다.

이 사원의 첫 출근을 따라가며, CodeCenter가 개발자의 온보딩과 팀의 지식 관리 방식을 어떻게 바꿀 수 있는지 살펴보겠습니다.

새 사람이 올 때마다 처음부터 다시 시작하는 이유

A사 정산개발팀에 새로운 개발자가 합류하는 것은 처음이 아닙니다. 그때마다 몇 주씩 인수인계가 이어졌고, 새로운 담당자가 코드를 이해하는 속도는 전임자가 얼마나 시간을 내주느냐에 따라 달라졌습니다.

프로젝트에서 핵심 인력이 몇 명 빠졌을 때 업무가 멈출 수 있는지를 나타내는 개념이 버스 팩터(Bus Factor)입니다. A사 정산 배치는 사실상 김 책임 한 사람에게 주요 지식이 집중된, 버스 팩터가 1인 상황이었습니다.

AI 코딩 도구의 확산은 또 다른 과제를 만들었습니다. 개발자마다 사용하는 AI 코딩 도구와 모델, 프롬프트 설정이 달랐습니다. 일부 개발자는 AI를 활용해 업무 속도를 높였지만, 그 과정에서 다듬은 프롬프트와 작업 절차는 개인의 PC에만 남았습니다.

관리자에게는 보이지 않는 영역도 늘어났습니다. 협력사 개발자가 어떤 AI 모델에 소스 코드를 전달하는지, 사용량과 비용이 어느 정도인지 일관되게 파악하기 어려웠습니다. 그렇다고 AI 사용을 전면 금지하면 회사가 승인하지 않은 개인 도구, 이른바 섀도 AI(Shadow AI) 사용으로 이어질 가능성도 있습니다.

결국 문제는 AI 도구의 사용 여부가 아니었습니다.

누가 합류하더라도 같은 개발 기준을 적용하고, 기존 코드의 맥락을 이해하며, 업무 과정에서 얻은 지식을 다시 팀에 남길 수 있는지가 중요했습니다.

기존 방식으로는 왜 해결되지 않을까

A사 정산개발팀에 새로운 개발자가 합류하는 것은 처음이 아닙니다. 그때마다 몇 주씩 인수인계가 이어졌고, 새로운 담당자가 코드를 이해하는 속도는 전임자가 얼마나 시간을 내주느냐에 따라 달라졌습니다.

프로젝트에서 핵심 인력이 몇 명 빠졌을 때 업무가 멈출 수 있는지를 나타내는 개념이 버스 팩터(Bus Factor)입니다. A사 정산 배치는 사실상 김 책임 한 사람에게 주요 지식이 집중된, 버스 팩터가 1인 상황이었습니다.

AI 코딩 도구의 확산은 또 다른 과제를 만들었습니다. 개발자마다 사용하는 AI 코딩 도구와 모델, 프롬프트 설정이 달랐습니다. 일부 개발자는 AI를 활용해 업무 속도를 높였지만, 그 과정에서 다듬은 프롬프트와 작업 절차는 개인의 PC에만 남았습니다.

관리자에게는 보이지 않는 영역도 늘어났습니다. 협력사 개발자가 어떤 AI 모델에 소스 코드를 전달하는지, 사용량과 비용이 어느 정도인지 일관되게 파악하기 어려웠습니다. 그렇다고 AI 사용을 전면 금지하면 회사가 승인하지 않은 개인 도구, 이른바 섀도 AI(Shadow AI) 사용으로 이어질 가능성도 있습니다.

결국 문제는 AI 도구의 사용 여부가 아니었습니다.

누가 합류하더라도 같은 개발 기준을 적용하고, 기존 코드의 맥락을 이해하며, 업무 과정에서 얻은 지식을 다시 팀에 남길 수 있는지가 중요했습니다.

1) 위키는 코드보다 빨리 낡는다

인수인계 문서는 작성 시점의 코드를 설명합니다. 하지만 운영 중인 시스템에는 기능 수정과 예외 처리, 장애 대응을 위한 변경이 계속 반영됩니다.

문서를 별도로 갱신하지 않으면 실제 코드와의 차이가 벌어지고, 새로운 개발자는 문서와 소스 중 무엇을 신뢰해야 할지 판단해야 합니다.

2) 개인 AI 코딩 도구는 노하우를 개인에게 묶는다

마이크로소프트·링크드인의 2024 업무 동향 지수에 따르면, AI를 사용하는 직장인의 78%가 회사에서 제공하지 않은 개인 AI 도구를 업무에 활용한다고 답했습니다.

개발자가 직접 구성한 프롬프트와 AI 도구 설정, 반복 작업 절차는 개인의 생산성을 높일 수 있습니다. 그러나 공유하고 재사용할 수 있는 체계가 없다면 담당자가 떠날 때 함께 사라질 수 있습니다.

3) 코드를 이해하려면 결국 사람에게 물어야 한다

새로운 담당자에게 가장 익숙한 해결책은 전임자에게 묻는 것입니다.

하지만 전임자가 모든 질문에 답할 수 있는 것은 아닙니다. 특히 여러 프로젝트를 동시에 담당하는 상황에서는 질문할 내용을 정리하는 데도, 답변을 기다리는 데도 시간이 필요합니다.

이러한 한계를 줄이려면 문서를 더 많이 만드는 것만으로는 부족합니다. 개발 환경의 공통 기준과 실제 코드에 근거한 지식을 조직 안에 축적하는 구조가 필요합니다.

CodeCenter: 팀의 AI 코딩 기준과 코드 지식을 한곳에

CodeCenter는 온프레미스 및 폐쇄망 환경에 구축할 수 있는 엔터프라이즈 AI 코딩 플랫폼입니다.

조직이 공통으로 사용하는 시스템 프롬프트, MCP, Skill을 관리하고, Deep Analysis로 코드 저장소를 분석해 Wiki와 다이어그램을 생성합니다. 사내에 구축한 AI 모델과 연결하면 소스 코드를 외부 AI 서비스에 전달하지 않고 활용할 수도 있습니다.

권한 체계는 시스템, 조직, 팀, 사용자 네 단계로 구분됩니다. 하나의 설치 환경 안에서 원청과 협력사가 각각 조직을 운영하고, 협력사 개발자를 원청의 팀에 초대하는 방식으로 협업할 수 있습니다.

A사와 B사는 이 구조를 활용해 새로운 개발자를 위한 AI 코딩 환경을 준비했습니다.

AI 코딩 도구

1) 첫 출근 전, 관리자가 준비한 AI 코딩 환경

이 사원이 출근하기 전날, A사 운영 담당자는 CodeCenter에서 정산개발팀의 AI 사용 환경을 설정했습니다.

먼저 허용 도메인을 지정해 A사와 B사 이메일 계정만 초대할 수 있도록 했습니다. 정산개발팀에는 보안 검토를 통과한 AI 모델을 할당하고, 이 사원에게는 개인별 사용 예산 한도를 설정했습니다.

협력사 개발자가 필요한 AI 기능을 이용하되, 조직이 승인한 모델과 예산 범위 안에서 사용하도록 한 것입니다.

AI 코딩 환경에도 최소 권한 원칙을 적용한 셈입니다.

관리자가 공통 설정을 준비해 두었기 때문에, 이 사원은 개인적으로 AI 모델을 선정하거나 별도의 사용 정책을 구성할 필요가 없었습니다.

2) 첫 번째 업무: 팀의 개발 기준부터 확인하다

① 조직을 바꾸면, 그 조직의 규칙이 따라온다

출근 첫날, 이 사원은 CodeCenter에 로그인해 A사 정산개발팀으로 이동했습니다. 정산개발팀에는 이미 팀에서 사용하는 시스템 프롬프트가 등록되어 있었습니다. 이 사원은 개인별로 개발 규칙을 새로 작성하는 대신, 조직과 팀에 설정된 프롬프트를 바탕으로 AI를 활용할 수 있었습니다.

담당자가 바뀌더라도 기본적인 AI 작업 기준을 다시 전달할 필요가 줄어든 것입니다.

② MCP는 관리자가 등록하고, 개발자는 필요한 도구를 연결한다

정산 업무를 파악하려면 사내 Git 저장소와 이슈 트래커도 확인해야 했습니다.

다행히 CodeCenter에는 관리자가 MCP 서버를 미리 등록해 두었습니다. 이 사원은 자신의 자격 증명만 입력해 필요한 도구를 연결했고, 사용하지 않을 도구는 ‘내 사용 비활성화’로 껐습니다. 이후 ‘MCP 설정 내보내기’ 기능으로 같은 도구 구성을 IDE에서도 활용할 수 있도록 했습니다.

개발자가 각자 MCP 서버를 찾고 설정 방법을 공유하는 대신, 조직이 관리하는 도구 구성을 재사용하는 방식입니다.

AI 코딩 도구

③ 시니어의 작업 절차는 Skill로 남는다

MCP & Skills 메뉴에는 김 책임이 만들어 둔 ‘정산 배치 배포 전 점검’ Skill도 있었습니다. SKILL.md와 참고 파일을 하나로 묶은 패키지로, 정산 배치를 배포하기 전에 확인해야 할 작업 절차가 정리되어 있었습니다.

이 사원은 한국어 요약으로 Skill의 내용을 먼저 파악하고, 버전 이력을 살펴보며 점검 항목이 어떻게 변경되었는지도 확인했습니다. 이전에는 김 책임에게 직접 물어야 했던 배포 전 점검 절차를 이제는 팀에 등록된 Skill에서 확인할 수 있게 된 것입니다.

AI 코딩 도구

시스템 프롬프트는 팀의 AI 작업 기준을, MCP는 필요한 개발 도구와의 연결을, Skill은 반복해서 수행하는 작업 절차를 담당합니다.

이 사원은 첫날부터 김 책임이 사용하던 작업 기준과 도구, 절차를 팀의 공통 자산으로 활용할 수 있었습니다.

3) 두 번째 업무: 정산 시스템의 구조를 이해하다

작업 환경을 갖췄지만, 아직 가장 중요한 일이 남아 있었습니다. 실제 정산 시스템의 코드를 이해하는 것입니다.

김 책임은 인수인계에 앞서 CodeCenter의 Deep Analysis로 정산 시스템의 코드 저장소를 분석해 두었습니다. 저장소 주소를 입력하면 서버가 소스 코드를 가져와 분석하므로, 별도의 압축 파일을 만들어 업로드할 필요가 없습니다.

① Wiki와 다이어그램으로 전체 구조부터 파악한다

이 사원은 팀에 공유된 Deep Analysis 결과를 열었습니다.

자동 생성된 Wiki에는 프로젝트 개요부터 모듈별 구현 내용까지 목차가 정리되어 있었습니다. 파일과 함수의 연결 관계는 다이어그램으로 확인할 수 있었고, 각 설명에는 근거가 되는 소스 파일과 줄 번호가 함께 표시되어 있었습니다.

기존 인수인계 문서는 작성자가 선택한 내용을 중심으로 정리되어 있었습니다. 반면 Deep Analysis 결과에서는 실제 코드에 근거한 설명과 구조를 함께 살펴볼 수 있었습니다.

이 사원은 정산 배치의 전체 구성과 주요 모듈의 관계를 먼저 확인한 뒤, 자신이 담당할 부분을 중심으로 분석 범위를 좁혀 갔습니다.

AI 코딩 도구

② 질문하면, 근거가 된 코드 위치와 함께 답한다

전체 구조를 살펴본 이 사원에게 한 가지 궁금증이 생겼습니다.

“결제가 실패하면 몇 번까지 다시 시도하나요?”

평소 같았다면 김 책임에게 메신저를 보냈을 질문입니다. 이번에는 CodeCenter의 Ask에 먼저 물었습니다. AI는 재시도 횟수를 정의한 함수와 README의 설명을 근거로 답했습니다. 옆 화면에서는 답변에 활용된 코드 구간을 직접 확인할 수 있었습니다.

답변을 읽는 데서 끝나는 것이 아니라, AI가 어떤 소스를 근거로 설명했는지 검토할 수 있는 것입니다. 이 사원은 해당 함수와 연관된 코드까지 살펴보며 재시도 로직을 확인했습니다.

AI 코딩 도구

③ 전임자와의 시간은 확인이 필요한 부분에 쓴다

물론 코드 분석 결과가 모든 업무 맥락을 설명하는 것은 아닙니다.

Deep Analysis는 코드에서 직접 확인한 내용과 AI가 추론한 내용을 구분하고, 추가 확인이 필요한 페이지를 ‘검토 필요’로 표시합니다. 이 사원은 해당 페이지를 중심으로 김 책임에게 확인할 질문을 정리했습니다.

김 책임과의 인수인계 시간에는 AI가 제시한 설명 중 확인이 필요한 부분과 코드만으로 알기 어려운 운영상의 판단 근거를 함께 검토했습니다.

예를 들어 특정 예외 처리 로직이 왜 추가되었는지는 코드에서 구현 내용을 확인하더라도, 당시의 장애 상황이나 업무적 판단까지 알 수 있는 것은 아닙니다. 그런 배경은 김 책임의 설명을 통해 보완해야 했습니다.

전임자의 시간을 코드 전체를 설명하는 데 쓰는 대신, 코드만으로 확인하기 어려운 맥락을 채우는 데 집중할 수 있었습니다.

4) 세 번째 업무: 새롭게 확인한 지식을 팀에 남기다

CodeCenter에서는 대화의 공유 범위를 조직 전체, 특정 팀 또는 사용자로 지정할 수 있고, 공유 링크의 만료일도 설정할 수 있습니다.

이 사원은 정산 시스템을 파악하는 과정에서 반복해서 확인한 내용을 Ask 대화로 정리한 후, 해당 대화를 정산개발팀에 공유했습니다. 이제 같은 시스템을 담당할 다른 개발자는 동일한 질문을 처음부터 반복하기보다 공유된 대화를 참고할 수 있습니다.

코드 분석 결과는 팀의 Wiki와 다이어그램으로, 작업 절차는 Skill로, 질의응답 과정에서 확인한 내용은 공유 대화로 남게 됩니다.

5) 김 책임이 자리를 옮긴 뒤, 팀에 남은 것

얼마 뒤 김 책임은 새로운 프로젝트로 완전히 자리를 옮겼습니다. 하지만 정산개발팀에는 그의 업무 경험을 이어받을 수 있는 여러 자산이 남아 있었습니다.

  • 시스템 프롬프트: 조직과 팀에 설정된 AI 작업 기준
  • MCP 서버 및 도구 구성: 개발에 필요한 도구 연결 환경
  • Skill과 버전 이력: 정산 배치 점검 등 반복 업무의 실행 절차
  • Deep Analysis Wiki와 다이어그램: 실제 소스 코드에 근거한 시스템 구조와 구현 설명
  • 공유된 Ask 대화: 개발 과정에서 확인한 질문과 답변

관리자는 사용량과 감사 로그를 통해 AI 사용 현황과 설정 변경 내역을 확인할 수 있었습니다. 대화 원문을 감사 로그에 남기지 않는 방식으로, 필요한 관리 정보와 대화 내용의 접근 범위를 구분했습니다.

또 기존에는 담당자에게 직접 물어야 했던 개발 기준과 작업 절차, 코드 구조를 이제는 조직이 관리하는 환경에서 확인할 수 있게 되었습니다. 다음에 새로운 개발자가 합류하더라도 모든 것을 처음부터 파악할 필요가 줄어듭니다.

마무리: 개발자의 경험이 팀의 자산으로 남으려면

새로운 개발자가 합류하고 기존 담당자가 자리를 옮기는 일은 피할 수 없습니다. 하지만 그때마다 개발 기준을 다시 정하고, 코드 구조를 처음부터 설명하고, 같은 질문을 반복해야 하는 것은 아닙니다.

CodeCenter는 이 문제를 세 가지 방식으로 다룹니다.

첫째, 프롬프트·MCP·Skill을 조직 차원에서 관리해 개발자가 바뀌더라도 같은 AI 코딩 기준과 작업 환경을 활용할 수 있도록 합니다.

둘째, Deep Analysis로 코드 구조와 구현 내용을 Wiki·다이어그램으로 정리하고, 근거가 되는 코드 위치를 함께 제공해 새로운 담당자의 코드 이해를 돕습니다.

셋째, 권한·모델·예산·감사 로그를 통합 관리해 원청과 협력사처럼 서로 다른 조직의 개발자가 정해진 기준 안에서 AI를 활용할 수 있도록 합니다.

AI 코딩 도구의 가치는 개발자 한 사람의 생산성을 높이는 데서 끝나지 않습니다. 개발자가 바뀌어도 작업 기준과 코드 지식이 조직에 남고, 다음 사람이 그 위에서 일을 이어갈 수 있을 때 AI는 개인의 도구를 넘어 팀의 역량이 됩니다.

각자의 PC에 흩어진 노하우를 팀이 함께 쓰고 싶다면,

우리 개발 조직과 보안 환경에 맞는 CodeCenter 운영 방식을 슬렉슨과 함께 설계해보세요.

Latest Posts

SOLUTION

Tags

Category

Latest Posts

© SLEXN, Inc. All rights reserved.

ALM 신규 도입부터 기존 개발 관리 환경의 통합·확장까지, 우리 조직에 맞는 ALM 선택 가이드를 이번 슬렉슨 웨비나에서 확인해 보세요.

Days
Hours
Minutes
Seconds