회사 에이전트 가드레일은(는) 무엇을 하나요?
목적
AI 코딩 에이전트가 Keshet 전반에서 실질적인 안전 가드레일을 정의하고 적용합니다. 위험한 작업에 대해 가시적이고 인간이 확인하는 제어를 제공하며, 이는 샌드박스 수준의 보안이 아닙니다. Claude Code, Cowork, 그리고 Claude를 사용하는 모든 파이프라인 또는 자동화 에이전트에 적용됩니다. 기본 정책 범주와 앱별 파일 배치 경로는 reference.md에 있습니다.
트리거 조건
모든 AI 에이전트 세션에서 항상 활성화됩니다. 다음과 같은 경우에 명시적으로 활성화하세요: Keshet 프로젝트에서 새 세션이 시작될 때, 에이전트가 셸/git/MCP 호출을 실행하려고 할 때, 사용자가 광범위한 자율성을 부여할 때("그냥 처리해 줘"), 파이프라인이 설계되거나 검토 중일 때, 또는 작업이 프로젝트 디렉토리 외부의 시크릿이나 파일에 접근하려고 할 때.
첫 번째 원칙
- 작업 표면을 식별합니다: 셸, 파일 읽기/쓰기, git, MCP 호출, 패키지 설치, 훅, 스킬, 시크릿.
- 각 제어를
deny,ask,monitor또는guidance로 분류합니다. - 광범위하고 모호한 규칙보다는 작고 명시적인 규칙을 선호합니다.
- 개발자 생산성을 유지합니다 — 모호한 작업은 확인을 요청하고, 명백히 안전하지 않은 작업만 거부합니다.
- 한계를 명확히 밝힙니다: 지시 파일은 동작을 안내합니다. 훅/엔드포인트 도구는 더 강력하게 적용하지만, 둘 다 실제 격리 없는 완전한 OS 샌드박스가 아닙니다.
규칙 작성 워크플로
- 규칙이 저장될 위치를 확인합니다: 개인 설정, 프로젝트 공유 설정, 또는 둘 다.
- 범주별로 어떤 일이 발생해야 하는지 확인합니다: 차단, 확인, 모니터링, 허용.
- 가장 작고 유용한 규칙 집합을 초안합니다.
- 규칙을 트리거하는 작업의 예를 포함합니다.
- 알려진 한계 — 여전히 샌드박싱 또는 엔드포인트 제어가 필요한 항목을 포함합니다.
- 파일을 작성하는 경우 대상 앱의 기본 위치를 사용하고, 정책 문구는 앱에 구애받지 않도록 유지합니다.
권장 기본 입장
회사가 더 엄격한 정책을 제공하지 않는 한 이를 사용하십시오:
- 거부(Deny): 시크릿 유출, 파이프-투-셸(
curl ... | sh), 샌드박스/권한 비활성화, 파괴적 시스템 명령(재귀적 삭제, 디스크 포맷, 기록 삭제), 자격 증명 저장소 접근. - 확인 필요(Ask): git push/force-push, 배포, 패키지 설치, 스키마 변경, 프로젝트 디렉토리 외부 쓰기, 조직 승인 목록에 없는 MCP 도구 호출.
- 모니터링(Monitor): 모든 셸 실행, 프로젝트 내 파일 쓰기, 외부 API 호출 — 기록되고 표시되며 차단되지 않습니다.
하지 말아야 할 것
- 명시적인 사용자 승인 없이 MCP 서버, 훅 또는 지속적 서비스를 설치하지 마십시오
.env파일이나 자격 증명 파일을 어떤 컨텍스트로든 읽거나 표시하거나 전달하지 마십시오- 확인 없이 파괴적인 셸 명령을 실행하지 마십시오
- 사용자가 정확히 무엇을 push할지 보지 않고 git에 push하거나 배포하지 마십시오
- 현재 프로젝트 디렉토리 외부의 파일 경로에 접근하지 마십시오
- 실패한 작업을 자동으로 재시도하지 마십시오 — 항상 실패를 표시하십시오
- 지시 전용 가드레일 파일을 OS 수준의 적용으로 취급하지 마십시오
- 보안 검토 없이 검증되지 않은 출처의 타사 에이전트 도구를 설치하지 마십시오 — 사전 빌드된 릴리스 아티팩트를 설치하는 것보다 소스를 검토하는 것을 선호하고, 체크섬 검증 및 파일럿 환경을 통해 설치를 진행하십시오
출력 템플릿
가드레일 세트를 제안할 때는 항상 다음 형식으로 응답하십시오:
## 가드레일 요약
<보호 중인 항목에 대한 간단한 요약>
## 정책
- 거부: <완전히 차단된 작업>
- 확인 필요: <명시적인 사용자 확인이 필요한 작업>
- 모니터링: <기록되고 표시되지만 차단되지 않는 작업>
## 생성 또는 업데이트할 파일
- `<경로>`: <이 파일의 목적>
## 한계
<이 가드레일이 적용하지 않는 사항 — 추가적인 샌드박싱 또는 엔드포인트 제어가 필요한 부분>