CLI 도구를 맡기기 전, 조직이 정할 권한과 검증 기록

Agent에게 명령 실행을 맡길지 검토하는 기술·보안 의사결정자를 위한 글입니다. 읽고 나면 도구를 사용할 수 있게 하는 결정과 특정 작업을 실행해도 된다는 결정을 나누고, 그 근거를 기록할 수 있습니다. 명령어 문법을 알 필요는 없지만, 맡기려는 업무 하나와 다룰 데이터의 범위는 정해 두세요. 특정 출시 소식이나 관리 화면 조작법 대신 조직이 정할 권한과 검증 기준을 다룹니다.

도구를 신뢰하는 결정과 실행을 허락하는 결정은 다릅니다

CLI는 명령어로 프로그램을 조작하는 방식입니다. 이 글에서 CLI Harness는 CLI 명령의 입력·실행·결과를 정해진 인터페이스로 다루는 도구를 뜻합니다. 이는 논의를 위한 개념 정의이며, 모든 제품 환경의 구현이 같다는 뜻은 아닙니다.

핵심은 두 가지입니다. 누가 어떤 범위의 도구 사용을 허용할지, 그리고 무엇을 확인했다는 기록을 어디에 남길지를 먼저 정하세요. Harness를 사용한다는 사실만으로 Agent의 모든 명령이 조직의 허용 목록에 갇힌다고 보아서는 안 됩니다. 다른 명령 실행 경로, 계정 권한, 파일과 네트워크 접근은 별도로 확인해야 합니다.

도입 회의에서는 다음 네 질문을 나누면 판단이 또렷해집니다. 아래는 조직의 검토 틀이며 제품의 화면 이름이나 자동 처리 순서를 설명하는 목록이 아닙니다.

• 등록 — 어떤 도구와 버전을 검토 대상으로 올렸습니까?
• 검증 — 어떤 입력·동작·결과를 어떤 환경에서 확인했습니까?
• 신뢰 지정 — 확인한 도구를 어떤 조건에서 사용할 수 있다고 판단했습니까?
• 개별 실행 승인 — 이번 대상과 데이터에 이 작업의 영향을 허용합니까?

검증 통과는 검사한 항목의 결과입니다. 검사하지 않은 동작까지 안전하다는 증명은 아닙니다. 도구를 신뢰 대상으로 정했더라도 운영 데이터 삭제나 외부 전송 같은 개별 실행의 영향은 다시 판단해야 합니다.

ClawPod Guide는 CLI·파일 작업에서 대상 작업 공간과 허용 경로를 명시하고, 검사 → 승인 → 실행 → 검증을 나누도록 안내합니다. 삭제, 자격 증명 변경, 패키지 설치, 배포, Git push, 외부 API 호출처럼 영향이 큰 명령은 요청에 명시하고 실행 전에 다시 확인하도록 권고합니다. 이 안내는 작업을 요청하고 확인하는 기준이며, 모든 실행 경로의 기술적 차단을 입증하는 자료는 아닙니다. 작업 요청 가이드를 기준으로 검토 범위를 정하세요.

먼저 책임자와 기록 위치 두 칸을 채우세요

신뢰 결정의 책임자는 역할, 현재 담당자, 대리자를 함께 적습니다. 역할만 적으면 지금 누가 결정할지 흐려지고, 개인 이름만 적으면 인사 변경 뒤 책임이 끊길 수 있습니다. 요청자와 승인자를 분리할지도 업무 위험에 맞춰 정하세요.

중앙 관리 조직이 결정하면 기준을 모으기 쉽지만 승인 대기를 관리해야 합니다. 업무별 책임자가 결정하면 업무 맥락을 반영하기 쉽지만 팀마다 기준이 달라지는지 살펴야 합니다. 요청과 승인을 두 사람에게 나누면 서로 확인할 수 있지만 부재 시 대리 절차가 필요합니다. 어느 구조든 특정 제품의 기본 권한이라고 가정하지 말고 조직의 운영 방식으로 명시하세요.

기록은 기존 변경 관리나 보안 검토 체계에 연결하는 편을 권합니다. 도구 이름·버전, 요청자, 검사한 환경과 항목, 근거 링크, 결정한 사람, 허용 범위, 유효 기간, 재검토 날짜를 남기세요. 비밀값이나 원본 민감 데이터 대신 해당 자료를 안전하게 확인할 수 있는 참조를 사용합니다. 누가 기록을 읽을 수 있고 얼마나 보관할지도 별도로 정해야 합니다. 이 항목들이 제품에 자동으로 저장된다고 전제하지 않습니다.

시험용 CSV 요약 도구로 판단을 끝까지 이어 보기

가상 조직 정책 예시입니다. 실제 실행 기록, 제품 화면 또는 제한의 자동 강제 동작을 나타내지 않습니다. CSV는 데이터를 행과 열로 담는 텍스트 파일 형식입니다. 아래 조직은 비민감 시험 파일의 합계만 계산하는 도구를 검토한다고 가정합니다.

요청

시험용 CSV 요약 도구의 도입 판단안을 작성해 주세요. 입력은 제공한 비민감 시험 CSV로 제한하고, 외부 전송·삭제·운영 데이터 접근은 제외하세요. 실행하지 말고, 사용할 범위와 검증할 항목, 결정 책임자와 기록 위치를 제안해 주세요.

채워진 판단안

• 대상과 범위 — 시험용 CSV 요약 도구 1.0. 비민감 시험 CSV 한 개의 금액 합계를 새 요약 파일로 작성
• 제외할 동작 — 원본 변경·삭제, 운영 데이터 접근, 외부 전송
• 책임자 — 데이터 운영 책임자(현재 담당자 A), 대리자 B. 도구 작성자 C와 검토자 A를 분리
• 검증 기준 — 입력 금액 10·20·30의 합계가 60인지, 원본이 그대로인지, 범위 밖 파일 접근과 외부 전송이 없는지 시험 환경에서 확인
• 근거와 기록 — 조직의 기존 변경 관리 기록 TEST-017에 도구 버전, 시험 조건, 출력 비교와 접근 검토 근거를 연결
• 현재 결정 — 검증 전이므로 사용 허용을 보류. 모든 기준을 확인한 뒤 시험 데이터 작업에 한해 허용 여부 결정
• 유효 기간과 재검토 — 허용 결정 후 30일. 도구 버전·입력 범위·접근 권한이 바뀌면 기간 안에도 다시 검토

숫자와 식별자는 모두 설명용입니다. 판단안에 적힌 제한은 정책 목표이지 강제 장치가 아닙니다. 파일 접근 권한, 실행 환경의 격리, 네트워크 제어 등으로 그 제한을 실제로 지킬 수 있는지는 담당자가 별도 증거로 확인해야 합니다.

성공 확인 — 담당자는 허가된 시험에서 합계 60이라는 출력뿐 아니라 원본 유지와 접근 범위를 함께 확인합니다. 출력이 맞아도 외부 전송 여부를 확인하지 못했다면 전체 검증을 통과시킨 것이 아닙니다. 확인한 근거와 아직 확인하지 못한 항목이 TEST-017의 결정 내용에 정확히 반영됐는지 대조합니다.

실패 시 다음 행동 — 예상하지 못한 접근 권한이나 외부 연결이 발견되면 사용 허용을 보류합니다. 해당 실행의 비민감 오류 요약과 누락된 증거를 기록하고, 범위나 통제 수단을 수정한 뒤 다시 검토합니다. 결과를 알 수 없는 작업은 실패했다고 단정해 반복 실행하지 않습니다. 먼저 실제 변경 여부를 확인합니다.

이렇게 하면 “등록됐으니 써도 된다”는 판단을 “이 버전과 시험 범위에서 확인한 조건이 충족될 때만 쓴다”는 결정으로 바꿀 수 있습니다.

도구가 준비됐어도 확인할 경계가 남습니다

ClawPod Guide는 사용 가능한 도구가 Agent 실행 환경에 따라 달라지며, 도구가 준비됐더라도 Agent 정책이 허용하는 범위에서 작업을 요청해야 한다고 설명합니다. 필요한 자격 증명은 Agent에 연결하되 대화나 도구 패키지에 비밀값을 넣지 않도록 안내합니다. 도입 전에 대상 환경에서 필요한 도구와 접근 권한을 실제로 확인하세요. Skills와 도구가 이 준비 조건의 출처입니다.

운영 시작 전에는 다음 질문도 답해 두세요.

• 허용을 철회할 책임자와 절차는 무엇이며, 이미 진행 중인 작업은 어떻게 확인합니까?
• 긴급 예외를 누가 결정하고, 적용 범위와 만료 시점을 어디에 남깁니까?
• 도구나 권한이 바뀌면 어떤 검사를 다시 실행합니까?
• 기록의 보관 기간과 열람 권한은 조직 정책에 맞습니까?

이 글은 출시 시점, 특정 관리 화면, 기본 역할 권한, 자동 기록 보존 기능을 설명하지 않습니다. 또한 Harness 하나로 모든 실행 경로를 통제할 수 있다고 보장하지 않습니다. 이런 조건이 도입의 필수 요건이라면 실제 대상 환경의 증거를 확보한 뒤 결정하세요.

다음 검토 회의에는 도구 하나만 가져오세요. 결정 책임자와 기록 위치 두 칸을 먼저 채운 뒤, 위 사례처럼 허용 범위와 검증 전 보류 조건을 붙여 첫 판단안을 만드세요.

Sources

• ClawPod Guide — Browser와 CLI 작업 요청: 작업 범위, 승인, 실행 후 확인.
• ClawPod Guide — Skills와 도구: 환경별 준비 상태, 정책 범위, 비밀값 취급.