코드 어시스턴트에서 제외한 파일: 정확히 무엇에서 제외했나?
가상 문서로 인덱스, 대화, 에이전트, 터미널과 MCP의 파일 제외 범위를 각각 확인합니다.
본문 언어: 한국어

목차
프로젝트 폴더에 “어시스턴트에게 제공하지 않음”이라고 적힌 파일이 있다. 팀은 제외 규칙에 파일을 추가하고 코드 제안을 확인한다. 제안에서 내용이 사라졌다. 다음 날 누군가 다른 경로로 파일을 읽는 에이전트를 실행한다. 문에 붙인 쪽지는 그대로지만 다른 입구가 생긴 셈이다.
이는 가상의 상황이다. 실제 자료를 작업 환경에 넣기 전에 검토할 만하다. “제외됨”이라는 말만으로 인덱싱, 코드 제안, 대화 첨부, 명령 실행 중 어디에서 파일이 빠졌는지 알 수 없다. 각 기능은 서로 다른 장치와 권한을 사용할 수 있다.
전시 공간을 배치하는 애플리케이션을 만드는 가상의 회사 Łuk를 보자. 어시스턴트는 인터페이스 코드를 돕고 협력사 계약서 폴더는 업무 범위 밖에 있다. 회사는 실제 계약서로 보호 기능을 시험하지 않기로 한다. 대신 가상의 표시만 담긴 문서가 있는 별도 테스트 프로젝트를 준비한다. 검수 대상은 실제 사용하는 기능에서 특정 제외 규칙이 어떻게 작동하는가다.
하나의 제외, 여러 약속
첫 질문은 파일이 무엇에서 제외됐는가다. 인덱스는 프로젝트에서 정보를 찾기 쉽게 준비한 모음이다. 인덱스에 파일이 없다는 사실만으로 다른 도구가 직접 읽을 수 있는지 알 수 없다. 열린 문서에서 제안이 없다는 결과도 에이전트가 터미널 명령으로 무엇을 할 수 있는지 설명하지 않는다.
Łuk는 실제 사용하는 기능의 목록부터 만든다. 입력 중 제안, 선택한 부분에 대한 질문, 여러 파일에서 작업하는 에이전트다. 시중의 모든 제품을 시험할 필요는 없지만 사용하는 편집기, 확장 버전, 계정, 프로젝트와 활성 모드는 기록해야 한다. 제안의 결과를 에이전트 결과 칸에 넣어서는 안 된다.
검수 담당자는 적용된 규칙의 설명을 볼 수 있어야 한다. 사용자는 관리자가 설정한 결과를 보지만 설정을 바꿀 수는 없을 수 있다. 구성 책임자와 현재 범위를 확인하는 방법을 보고서에 적는다. 계정을 바꾼 뒤 같은 규칙을 시험했는지 비슷해 보이는 다른 프로젝트를 시험했는지 구분하기 위해서다.
GitHub Copilot 콘텐츠 제외 문서는 VS Code와 다른 편집기의 Copilot Chat Edit 및 Agent 모드에서 이 기능이 지원되지 않는다고 밝힌다. 외부 MCP 서버가 제외 규칙을 지킨다는 보장도 없다고 한다. 업무 방식을 선택할 때 고려할 특정 기능의 한계다.
모든 시도가 금지된 내용을 읽는다는 뜻은 아니다. 선택한 모드를 포함하지 않는 설정 하나만으로 기대하는 경계를 보장할 수 없다는 뜻이다. 자료가 에이전트에 보이지 않아야 한다면 실제 능력을 포괄하는 장치가 필요하다. AI 연동 권한 (폴란드어)에서 시작해 구체적인 환경에 적용한다.
기대 효과를 평범한 문장으로 적는다. 합의한 모드에서 어시스턴트가 지정된 경로의 가상 문서 내용을 가져오지 않아야 한다는 식이다. 이름을 숨겨야 하는지, 검색이나 읽기를 막아야 하는지, 수정까지 막아야 하는지는 별도로 기록한다. 폴더 이름이 보여도 내용은 접근할 수 없을 수 있다. “이름이 보임”과 “내용을 읽음”은 다른 결과다.
목적에 맞게 범위를 고른다. 제안의 정확도를 높이려고 큰 생성 파일을 제외하는 규칙이 기밀 자료의 요구를 충족할 필요는 없다. 불필요한 데이터를 줄일 때는 문서가 어시스턴트에 제공되는 프로젝트 안에 있어야 하는지부터 확인한다. 데이터 최소화 (폴란드어)로 경로 패턴을 시험하기 전에 필요 없는 복사본을 없앨 수 있다.
사용하는 읽기 경로마다 검수한다
비슷한 구조의 파일 두 개를 준비한다. 하나는 허용하고 하나는 제외한다. 서로 다른 가상의 노출 확인 표시를 넣는다. 검수자는 값을 알고 있으므로 실제 계약서를 보여 주지 않고 결과를 확인할 수 있다. 이 표시는 실제 비밀번호나 접근 키라고 부르지 않는다. 규칙을 바꾼 시점과 적용을 확인한 시점도 적는다. 설정이 새로고침되기 전의 시험은 새 구성의 작동을 증명하지 못한다. 해당 기능에 새로고침이 필요하다면 준비에 포함하고 실제 시험한 상태를 보고한다.
각 실행에는 기능, 파일, 기대 결과, 실제 사용한 도구와 결과를 짧게 남긴다. 가상 문서의 전체 내용은 준비한 표본에 보관할 수 있다. 일반 보고서에는 시험을 반복할 수 있는 참조면 충분하다. 나중에 효과가 없었던 경로 하나를 찾기 쉽다.
먼저 해당 기능에서 허용 파일이 접근되는지 확인하고 제외 파일을 시험한다. 둘 다 읽지 못한다면 기능 오류, 잘못된 경로 또는 프로젝트 부재가 원인일 수 있다. 양성 대조 시험이 없는 거부는 제외 규칙에 대해 많은 것을 말해 주지 않는다.
“읽을 수 없다”는 답과 접근 제한으로 막힌 실제 읽기 시도를 구분한다. 모델은 도구를 호출하지 않고 거절하거나 파일 내용을 추측할 수 있다. 기록으로 과정을 판단할 수 없다면 미확정으로 표시하고 환경 담당자와 추가 관찰 방법을 정한다. 증거 부족을 보호 성공으로 바꾸지 않는다.
실제로 쓰는 작업 방식마다 별도 시험을 한다.
- 코드 제안에서는 두 파일의 반응과 허용된 부분에 대한 제안에 제외된 내용이 나타나는지 확인한다.
- 대화에서는 특정 파일을 지정하고 그 내용이 필요한 질문을 한다. 기능이 출처 참조를 표시한다면 보존한다.
- 에이전트 모드에서는 자료를 실제로 읽은 도구마다 기록한다. 최종 답변만으로 전체 경로를 알 수 없다.

확인 표시를 질문에 붙여 넣지 않는다. “파일에 KORA-742가 있나요?”라고 물으면 파일을 읽지 않고도 그 값을 반복할 수 있다. 지정된 문서에 적힌 표시를 묻고 검수자가 대화 밖의 정답과 비교한다. 별도 실행에서는 파일의 값을 바꾸어 오래된 문맥을 사용하는지도 확인한다.
Cursor Ignore file 문서는 .cursorignore 규칙만으로 에이전트가 사용하는 터미널이나 MCP 서버 도구의 접근이 차단된다고 보장할 수 없다고 경고한다. 그렇다고 개별 시도의 결과가 정해지는 것은 아니다. 환경에 다른 제한이 적용될 수도 있으므로 따로 시험해야 한다. 한 결과를 편집기 전체에 돌리지 말고 실제 도구를 기록한다.
별도의 Cursor 실행 모드 문서는 명령 샌드박스와 일부 명령의 샌드박스 밖 실행을 설명한다. 표에는 .cursorignore가 에이전트에게 파일을 숨길 수 있다는 내용도 있다. 파일을 에이전트에게 숨기는 것과 터미널이나 MCP 서버의 접근 차단을 보장하는 것은 다르다. 명령 실행 조건은 생략할 사소한 정보가 아니라 결과의 일부다.
내장 읽기 도구, 제한된 환경의 명령, 외부 서버 중 무엇을 시험했는지 보고서에 남긴다. 권한이 바뀌면 해당 시험을 반복한다. 사용자가 작업을 승인했다는 사실은 접근 불가 폴더에 관한 이전 선언과 실제 작업이 일치한다는 증거가 아니다. 승인은 결정이고 기술적 제한은 가능한 행동을 정한다.
Łuk는 계약서 폴더가 없는 별도 코드 복사본에서 에이전트를 실행하기로 정할 수 있다. 구체적인 자료 준비 결정이다. 또는 적절히 제한된 실행 환경을 마련하고 가상 데이터로 시험할 수 있다. 에이전트 샌드박스의 파일과 네트워크 경계 (폴란드어)는 무시 경로 목록보다 더 넓은 검수를 요구한다.
규칙은 보통의 프로젝트 변경에도 유지돼야 한다
처음 성공한 실행 뒤 준비한 표본 안에서 가상 파일의 이름과 위치를 바꿔 본다. 특정 경로에 대한 규칙은 이동한 문서에 더 이상 맞지 않을 수 있다. 올바르게 일치하는 규칙을 도구가 지원하지 않는 문제와는 다르다. 패턴 오류와 제외 기능 미지원은 따로 기록한다.
프로젝트를 옮길 때 기존 대화도 고려한다. 새 제외 규칙이 이전에 업무 기록에 들어간 구절을 자동으로 없애지는 않는다. 현재 읽기 동작을 확인하려면 과거 내용 없는 별도 실행을 시작한다. 가상 표시가 들어 있는 이력은 두 번째 사례다. 어시스턴트가 어떤 이전 자료를 여전히 사용하는지 보여 준다.
하위 프로젝트에서는 활성 설정을 어디에서 가져오는지 정한다. 한 위치의 설정 파일이 프로젝트를 여는 모든 방식에 자동 적용된다고 가정하지 않는다. 환경 준비자는 활성 규칙과 적용 확인 방법을 밝혀야 한다. 계속 중인 대화에서만 보지 말고 환경을 다시 연 뒤 같은 파일을 비교한다.
내용의 복사도 별도 사례다. 원본 제외 규칙은 질문에 직접 붙여 넣거나 허용 파일에 복사한 구절을 설명하지 않는다. 어떤 자료를 첨부해도 되는지와 시험 표본을 식별하는 방법을 정한다. 경로 규칙을 모든 문장을 따라다니는 보이지 않는 표식처럼 취급해서는 안 된다.
도구를 추가하면 해당 시험을 반복한다. 서버가 다른 폴더를 읽거나 다른 계정으로 작동하거나 별도 장치를 통해 파일을 받을 수 있다. MCP 도구 변경 점검 (폴란드어)은 환경에 실제로 무엇이 들어왔는지 기록하는 데 도움이 된다. 프로젝트 이름이 같다고 접근 경로도 같지는 않다.
제한된 접근은 어시스턴트 작업의 신뢰성에도 영향을 준다. 구현이나 테스트 일부를 보지 못한다면 업무 보고서에 그 한계를 적어야 한다. 읽지 않은 자료를 확인했다고 주장할 수 없다.
빠진 파일에 프로젝트 의존성이 적혀 있다면, 업무에 필요한 허용 정보를 요청하거나 범위의 한계를 밝혀야 한다. 기억으로 패키지 목록을 다시 만드는 것은 읽기를 대신하지 못한다. 특히 새 라이브러리를 추가한다면 AI가 제안한 의존성 (폴란드어)도 점검한다.
변경을 검수할 때는 “모두 완료”라는 말이 아니라 테스트 명령과 결과의 증거 (폴란드어)에 선언을 대조한다.
편집기, 확장, 모드 또는 도구가 바뀐 뒤 누가 재시험할지 정한다. 시험한 구성, 날짜와 범위 밖 기능을 보고한다. 합의보다 넓은 접근이 발견되면 원인이 밝혀질 때까지 실제 자료 사용을 중지하고 더 좁은 작업 방식을 고른다. 실패한 실행의 경로, 기능, 설정을 남겨 같은 사례에서 수정을 확인한다. 설정을 저장했다는 이유만으로 효과가 있다고 판단하지 않는다.
Aeneia Audit과 논의할 때 업무 설명, 사용 기능 목록과 가상 표본을 준비한다. 무엇을 어떤 도구가 어떤 설정에서 읽었는지 관찰 가능한 행동을 논의할 수 있다. 파일 목록의 “제외됨”이라는 말만으로는 이 질문에 답하지 못한다.







