AI가 만든 코드와 유령 라이브러리: 설치를 습관처럼 하기 전에 의존성을 확인한다
AI가 제안한 의존성을 프로젝트에 받아들이기 전에 필요성, 정확한 이름, 출처와 버전을 확인합니다.
본문 언어: 한국어

목차
어시스턴트가 코드를 만들고 라이브러리도 설치해야 한다고 덧붙였다. 이름은 전문적으로 들리고 설명은 작업에 맞으며 예시는 문서에서 가져온 것 같다. 한 가지 작은 문제는 그 패키지가 존재하지 않거나 생각한 대상이 아닐 수도 있다는 것이다. 아무리 그럴듯해도 자신감 있는 말투는 레지스트리 항목이 아니다.
AI의 도움을 받은 코드에서는 의존성 제안과 프로젝트에 의존성을 받아들이는 결정을 구분한다. 의존성은 코드가 의지할 외부 구성 요소다. 답변에 새 이름이 나왔다고 자동으로 설치 명령이 되어서는 안 된다. 먼저 정체, 출처, 버전, 사용 이유를 확인해야 한다.
이 검토는 그런 결정과 그 근거를 조직하는 방법을 다룬다. 특정 라이브러리의 보안 분석이 아니다. 예제를 실행하거나 의심스러운 패키지를 내려받지 않고도 수행할 수 있다. 팀이 근거 없는 제안이 일상 업무에 들어오기 전에 중단할 수 있는지 확인하는 것이 목적이다.
설치를 묻기 전에
가상의 상점 프로젝트에서 어시스턴트가 제품 데이터를 가져오기 위한 '카탈로그 어댑터'를 제안한다. 여기의 이름은 예시를 설명할 뿐 검색할 실제 패키지가 아니다. 작업에는 단순한 연산 하나가 필요하다. 첫 질문은 왜 새 의존성이 필요한가다. 프로젝트에 이미 지원되는 방식이 있거나 기존 시스템 인터페이스로 충분할 수도 있다.
제안된 요소를 코드의 어디에서 쓰고 어떤 역할을 하는지 요청한다. '통합이 쉬워진다'는 일반적인 말로는 부족하다. 검토자는 어떤 기능이 필요한지, 올바른 라이브러리에서 그 기능이 확인됐는지 알아야 한다. 이는 범위를 설명하지 않은 작은 작업을 위해 큰 요소를 받아들이는 일을 줄인다.
대안도 기록한다. 프로젝트에서 이미 쓰는 해결책이나 더 단순한 범위일 수 있다. 모든 라이브러리를 피하라는 규칙이 아니다. 하나를 더 유지할 이유를 알아볼 수 있어야 한다. 비교에는 처음 코드를 생성하기 편한지만이 아니라 이후 변경을 책임질 사람도 포함해야 한다.
구매 전 AI 공급업체 평가 (AI 공급업체 평가 안내 (폴란드어))에서도 작업 적합성과 계속 사용할 조건을 묻는다. 의존성은 결정 규모가 더 작을 수 있지만 무엇을 프로세스에 들이는지 알아야 한다. 별도 청구서가 없다고 업데이트나 프로젝트 변경에 필요한 일이 없는 것은 아니다.
새 라이브러리 없이 작업하라는 지시도 시험에 포함한다. 그 방식에서 무엇이 부족하고 어떤 절충이 필요한지 설명해 달라고 요청한다. 비교는 제안이 실제 문제를 해결하는지 아니면 편리한 응답 패턴을 반복하는지 판단하는 데 도움이 된다. 기존 요소로 충분하다면 다음 코드 조각에서 같은 논쟁이 반복되지 않도록 유지한 이유를 기록한다.
의존성 추가를 승인할 수 있는 사람을 정한다. 합의된 설명과 근거에 접근할 수 있어야 한다. 어시스턴트가 이름을 제안하고 직접 내려받아 스스로 올바르다고 판정한다면 그 과정에는 독립적인 확인 순간이 없다. 한 번의 좋은 결과도 다음 실수를 팀이 어떻게 잡을지 보여 주지 못한다.
이름을 올바른 대상과 연결한다
프로젝트에 적합한 레지스트리에서 정확한 이름을 확인한다. 조직 스코프가 식별자의 일부라면 포함한다. 비슷한 발음은 정체의 증거가 아니다. 대조 시험에는 지정한 이름이 없는 경우, 다른 프로젝트의 기존 패키지, 필요한 기능을 지원하지 않는 버전의 올바른 라이브러리라는 세 상태를 사용한다.
레지스트리 항목에서 프로젝트가 가리키는 문서와 소스로 이동한다. 그 위치들이 실제로 같은 패키지를 설명하는지 확인한다. 어시스턴트는 올바른 이름과 다른 라이브러리의 예제를 결합할 수 있다. 보고서는 비슷한 제목의 검색 결과를 무작정 확인으로 받아들이지 말고 연결 근거를 보여 줘야 한다.
다음으로 버전을 확인한다. 현재 문서에 있는 기능이 프로젝트가 채택한 릴리스에는 없을 수 있다. 어느 릴리스의 인터페이스를 확인했는지와 코드 예제가 같은 릴리스에 관한 것인지 정한다. '최신'이라는 말은 금방 정확성을 잃는다. 결정 기록에는 나중에 다시 확인할 수 있는 버전 표시가 필요하다.
이는 구조는 올바르지만 의미가 틀린 JSON (JSON 형식과 의미에 관한 글 (폴란드어))과 비슷한 경계다. 이름의 모양이 올바르더라도 존재하지 않거나 잘못된 대상을 가리킬 수 있다. 문자열 형식 확인은 정체와 작업의 관계를 확인하는 일을 대신하지 못한다.
올바른 이름으로 문서를 찾았지만 다른 환경을 설명하는 사례도 추가한다. 브라우저 예제가 서버 작업에 맞는 것은 아니다. 기대 결과에 프로젝트의 대상 환경과 호환성을 평가할 수 있는 사람을 명시한다. 프로세스 감사는 그런 평가의 부재를 드러내야지 예제가 비슷하다는 이유로 결론 내리지 않아야 한다.
버전 표시가 없는 제안도 확인한다. 검토자에게 승인의 근거가 될 자료를 지목해 달라고 한다. 릴리스를 스스로 추측해야 한다면 변경 설명은 평가할 준비가 되지 않았다. 이를 개발자가 더 주의해야 한다는 막연한 요구가 아니라 제안 문서의 구체적 수정 사항으로 기록한다.
어시스턴트가 확인 근거를 찾지 못하는 통제된 사례를 준비한다. 근거가 없다고 표시하는가, 비슷한 다른 이름을 확실한 것처럼 제시하는가? 검토자가 설치를 실행하지 않고 제안을 거부할 수 있는가? 좋은 프로세스는 모든 제안을 성공적인 다운로드로 끝내야 한다고 요구하지 않고 '확인되지 않음'을 허용한다.
실패한 사례 하나를 끝까지 추적한다. 어시스턴트가 이름을 제시했지만 합의된 출처에서 찾지 못해 대체품을 제안했다. 첫 결정은 확인되지 않은 상태로 닫고 두 번째에는 독립적인 평가 근거가 필요하다. 같은 문단에서 이름만 바꿨다고 다른 요소에 부여한 승인을 물려받을 수는 없다.

대체품에서는 사용 이유로 돌아간다. 비슷한 작업을 처리하지만 데이터를 전달하는 방법이 다르거나 더 넓은 변경이 필요할 수 있다. 승인자는 결정 전에 그 차이를 보아야 한다. 그렇지 않으면 이름 확인은 올바르게 작동해도 승인은 여전히 잘못 설명된 해결책에 적용된다.
인기도나 익숙해 보이는 페이지에만 승인을 의존하지 않는다. 이런 정보는 평가에 도움이 될 수 있지만 올바른 의존성과 기능인지에 홀로 답하지는 못한다. 하나의 만능 '확인됨' 도장을 만들지 말고 각 결정의 구체적인 근거를 보고서에 남긴다.
출처는 검증을 돕지만 평가를 끝내지는 않는다
npm의 출처 증명 문서는 패키지와 소스, 빌드 지침 사이의 검증 가능한 연결을 악성 코드가 없다는 보장과 구분한다. 이런 증명은 특정한 증거를 제공한다. 패널에서 설득력 있어 보인다는 이유로 더 넓은 의미를 부여해서는 안 된다.
자체 결정에는 무엇을 어느 버전에서 확인했는지 기록한다. 증명을 이용할 수 있고 검증했다면 그 결과의 범위를 명시한다. 증명이 없을 때 자동으로 비난하지 않는다. 소스를 평가할 합의된 경로와, 전문 분석이 필요한 경우 책임질 기술 담당자가 필요하다.
GitHub의 dependency review 문서는 알려진 취약점 정보와 함께 추가, 삭제, 변경된 의존성을 보여 주는 화면을 설명한다. 변경 검토에 도움이 될 수 있다. 표시된 경고가 없다는 것만으로 특정 요소를 받아들일지에 관한 모든 질문에 답할 수는 없다.
검수할 때 이 정보를 작업의 근거와 연결한다. 검토자는 왜 의존성을 추가하는지, 어떤 코드가 사용하는지, 누가 정체를 확인했는지 볼 수 있어야 한다. 그렇지 않으면 검토가 프로젝트가 실제로 받는 변경을 평가하지 않고 초록색 표시를 훑어보는 일로 바뀔 수 있다.
제안 설명과 실제로 검토에 전달된 변경 범위를 비교한다. 직접 의존성 하나를 승인했는데 묶음에는 다른 추가 항목도 있는가? 새 요소를 추가하면서 기존 버전도 바뀌었는가? 통제된 시험에서 검토자는 차이를 지목하고 결정을 닫기 전에 기술 평가로 보낼 수 있어야 한다.
보고서에서 증거 부족과 문제의 증거를 구분한다. 확인되지 않은 이름은 제안이 수용 조건을 충족하지 못했다는 뜻이다. 누군가 의도적으로 잘못 행동했다고 자동으로 증명하지는 않는다. 정확한 기록은 출처 보완, 다른 요소 선택, 변경 포기라는 다음 행동을 돕는다.
코드 검수와 AI 에이전트의 기밀성 (AI 에이전트 코드 인수 안내 (폴란드어))을 고려하면서 채택한 의존성 문서도 보존한다. 다음 사람이 예전 모델 대화에서 이유를 재구성해서는 안 된다. 생성 이력 전체를 내보내는 것보다 결정, 출처, 버전을 짧게 기록하는 편이 더 유용하다.
Aeneia Audit과의 운영 논의는 코드 예제 하나, 제안된 요소 이름, 현재 승인 경로에서 시작할 수 있다. 확인되지 않은 라이브러리를 설치하지 않고도 이 예시를 논의할 수 있다.
결정 이후에 일어나는 일도 확인한다
결과 기록에서 '정체 확인', '시험에 채택', '프로젝트에 승인'을 구분한다. 각 상태에 남은 작업과 책임자를 명시한다. 그러면 인수자가 올바른 페이지를 찾은 것을 전체 검수 완료로 오해하지 않는다.
제안을 거부했다면 코드, 실행 지침이나 설정에 여전히 남아 있는지 확인한다. 생성된 코드가 여전히 그것을 가져온다면 설명에서 한 번 언급을 삭제하는 것으로 충분하지 않다. 통제된 시험에서 실행자에게 전달하는 전체 묶음을 검수해 수정이 작업 댓글에만 남지 않도록 한다.
의존성을 채택했다면 프로젝트에 맞는 환경에서 이후 기술 확인 경로를 정한다. 이름과 소스 평가는 코드 전체가 올바르게 작동한다는 증거가 아니다. AI 어시스턴트가 보고한 시험 (AI가 보고한 시험에 관한 글 (폴란드어))의 범위와 실제 결과를 따로 확인하고 시험을 작업과 변경 범위에 연결한다. 시험을 위한 요소 채택과 완성된 기능의 사용 승인을 보고서에서 합치지 않는다.
AI 에이전트 워크플로 (AI 에이전트 권한에 관한 글 (폴란드어))에서는 변경 제안 권한과 이후 작업 실행 권한을 구분한다. 어시스턴트가 도구 인터페이스를 조작한다면 클릭과 애플리케이션의 결과 차이 (브라우저 조작과 결과에 관한 글 (폴란드어))도 확인한다. 명령을 보냈다는 기록은 프로젝트 상태의 확인이 아니다.
두 번째 사람에게 프로젝트를 넘기는 시험도 한다. 승인된 기록을 보고 어떤 의존성에 대한 결정이며 왜 내렸는지 재구성하도록 한다. 원래 작성자와 대화해야 한다면 부족한 정보를 추가한다. 거부된 제안의 다음 단계도 지목해 달라고 한다. 기존 해결책으로 돌아가야 하는지, 대체품의 새 평가를 기다려야 하는지 아는가? 지침은 확인되지 않은 설치를 다시 실행하지 않고 작업을 이어갈 수 있게 해야 한다.
업데이트나 사용 변경 후 재평가할 책임자를 정한다. 작은 작업에 추가된 라이브러리가 나중에 제품의 더 큰 부분의 기반이 될 수 있다. 예전 이유가 새 역할까지 포함하지는 않을 수 있다. 누군가 이름의 출처를 우연히 기억하길 기대하기보다 알아볼 수 있는 재평가 시점을 두면 된다.
좋은 감사 결과는 명확한 흔적을 남긴다. 무엇이 제안됐고, 무엇을 확인했으며, 누가 결정했고, 어떤 추가 시험 범위를 합의했는가. 어시스턴트는 여전히 코드를 빠르게 도울 수 있다. 그렇다고 그 자신감에 무언가를 설치할 독자적인 권한까지 부여할 필요는 없다.







