Issue·PR에서 @멘션하면 움직이는 AI 팀원, CodeBuddy NPC

핵심: AI를 ‘옆에 있는 챗봇’이 아니라 Git 안의 팀원으로 둔다

CodeBuddy NPC의 핵심은 AI를 개발자가 별도 창에서 대화하는 보조 도구가 아니라, 기존 Git 개발 시스템 안에서 인증된 이벤트 기반 참여자로 작동하게 하는 데 있다. 개발자는 Issue나 PR에서 특정 역할을 @멘션해 요청하고, NPC는 저장소의 작업 흐름을 따라 비동기적으로 대응한다. CNB 문서상 NPC 이벤트는 Issue 설명·댓글 또는 PR 설명·리뷰·댓글에서 NPC를 멘션할 때 발생한다. 16

이 구조에서 Git 저장소는 단순한 코드 보관함이 아니라 AI가 참조하는 지속적 작업 맥락이 된다. 저장소 이력, Issue, PR, CI/CD 결과, 품질 게이트가 모두 같은 흐름 안에 있으므로, 요구사항·코드·빌드 로그를 매번 별도 AI 도구에 복사해 넣는 방식을 줄이는 것이 목표다. 17

호출 방식: Issue·PR에서 필요한 역할을 바로 부른다

예를 들어 PR 댓글에서 @CodeBuddy 코드 리뷰처럼 멘션하면 pull_request.comment@npc 이벤트로 AI 리뷰 작업을 시작할 수 있다. Issue에서도 역할을 멘션해 조사나 후속 작업을 요청하는 방식이 지원된다. 16

이 방식의 요점은 AI 호출이 개발팀의 표준 협업 산출물에서 이뤄진다는 데 있다. 요청의 배경은 Issue에, 변경 제안은 PR에, 검증 결과는 파이프라인에 남는다. 따라서 개발자가 긴 대화 세션을 계속 붙잡고 있지 않아도, 작업 요청과 결과를 팀의 일반적인 협업 화면에서 추적할 수 있다. 16

YAML로 역할별 AI 팀원을 구성한다

CNB에서는 저장소의 .cnb/settings.yml에 NPC 설정을 넣어 전용 AI 역할을 구성할 수 있다. 설정 항목에는 역할 이름, 프롬프트, 지식베이스용 저장소 가져오기, 아바타와 버튼 같은 상호작용 요소가 포함될 수 있다. 3

역할별 동작을 더 세밀하게 제어하려면 NPC가 속한 저장소의 .cnb.yml에 NPC 이벤트용 파이프라인을 정의할 수 있다. 맞춤 동작이나 실행 환경을 별도로 정의하지 않으면 기본 NPC 실행 환경이 사용된다. 6

이 덕분에 구현 담당, 코드 리뷰 담당, 조사 담당, 프로젝트 조율 담당처럼 역할을 나눠 둘 수 있다. 규모가 큰 작업에서는 여러 NPC 역할이 각자의 이벤트와 파이프라인을 통해 협업하도록 설계할 여지도 생긴다. 다만 역할 분담의 실제 품질과 자동화 범위는 각 저장소의 프롬프트, 파이프라인, 권한 설정에 따라 달라진다. 36

조사부터 PR·CI 수정까지: 비동기 전달 루프의 기반

CodeBuddy NPC가 지향하는 흐름은 작업을 받은 뒤 코드베이스를 파악하고, 접근법을 세우며, 변경을 만들고, PR과 CI 결과를 통해 검증·수정하는 전달 루프다. 이때 핵심은 각 단계가 Git 산출물과 파이프라인 위에서 수행되도록 연결하는 것이다. 17

CNB는 그 실행 기반으로 Git 호스팅, CI/CD, 아티팩트 저장소, 클라우드 네이티브 개발 환경을 제공한다. 파이프라인 YAML에서는 Docker 이미지, Dockerfile로 빌드한 임시 이미지, dev container, 볼륨, CPU 태그를 포함한 실행 노드 설정 등을 지정할 수 있다. Docker 캐시는 이후 빌드에서 재사용할 수 있어 의존성 재다운로드 같은 반복 비용을 줄이는 데 쓰인다. 45

즉 AI가 로컬 개발자의 노트북 상태에 의존하기보다, 팀이 정의한 격리된 빌드·테스트 환경에서 작업하도록 구성할 수 있다. CI 실패가 발생했을 때에도 실패 로그와 파이프라인 결과가 같은 개발 흐름에 남으므로, 수정과 재검증을 연결하는 구조를 만들기 쉽다. 45

권한과 거버넌스: AI에도 일시적·이벤트 기반 권한을 부여

CNB 파이프라인에는 실행 기간에만 쓰이는 임시 CNB_TOKEN이 자동 주입될 수 있다. 이 토큰은 코드 및 아티팩트의 읽기·쓰기, API 호출에 사용되며, 파이프라인이 끝나면 자동 폐기된다. 권한은 파이프라인을 발생시킨 이벤트 유형에 따라 달라지고, NPC 신원으로 실행되는 경우 코드·PR·Issue·댓글 등에 대한 권한 항목도 문서화돼 있다. 15

민감 정보는 별도의 키 저장소에 보관하고, 파이프라인 설정에서 이를 환경 변수로 주입할 수 있다. CNB는 이 저장소에 접근 제어, 작업 제한, 감사 로그, 워터마킹 같은 보호 장치를 설명한다. 9

이런 설계는 AI가 무제한 권한을 가진 채 외부에서 작업하는 모델보다, 정해진 이벤트와 파이프라인 문맥에서 권한을 행사하도록 만들려는 접근으로 볼 수 있다.

왜 ‘AI 엔지니어링 협업’인가

AI 코딩 보조는 대체로 사람이 코드를 작성하는 속도를 높이는 데 초점이 맞춰진다. 반면 NPC 모델은 Issue와 PR이라는 팀의 업무 접점에서 요청을 받고, 저장소·CI·권한·품질 게이트라는 실제 개발 통제 장치 안에서 역할을 수행하도록 설계됐다. 167

따라서 CodeBuddy NPC의 ‘AI 네이티브 Git’은 AI가 코드 생성만 하는 기능이라기보다, 계획·구현·리뷰·검증·수정의 전달 과정에 참여하도록 Git 운영 모델을 확장하는 아키텍처다. 다만 이것이 모든 작업을 사람의 검토 없이 안전하게 배포할 수 있다는 뜻은 아니다. 최종 승인 기준과 보호 규칙은 여전히 팀의 PR 정책, CI 설정, 접근 권한에 달려 있다. 1915