Communitygithub.com

회사 에이전트 가드레일

Keshet 전반의 AI 코딩 에이전트에 대해 실질적인 안전 가드레일을 정의하고 적용합니다. 위험한 작업에 대한 가시적이고 인간이 확인하는 제어를 제공합니다.

회사 에이전트 가드레일란 무엇인가요?

회사 에이전트 가드레일(Company Agent Guardrails)은 AI 코딩 에이전트가 안전하게 작동하도록 돕는 실용적인 보호 정책입니다. 샌드박스 수준의 완전한 격리를 제공하는 것이 아니라, 위험한 작업(예: 시크릿 유출, 파괴적 셸 명령, 무단 git push)을 '거부(Deny)', '확인 필요(Ask)', 또는 '모니터링(Monitor)' 범주로 분류하여 에이전트의 행동을 안내합니다. Claude Code, Cowork, 그리고 Claude를 사용하는 모든 파이프라인 및 자동화에서 활성화됩니다. 이 스킬은 개인 설정과 프로젝트 공유 설정 모두에 적용 가능하며, 정책 파일은 각 앱의 기본 위치에 저장됩니다. 명확한 규칙 선호, 생산성 보존, 그리고 가드레일의 한계(예: 완전한 OS 샌드박스는 아님)를 명시적으로 언급하는 것을 첫 번째 원칙으로 삼습니다. 제안된 가드레일 세트는 'Guardrail Summary', 'Policies', 'Files To Create Or Update', 'Limitations' 섹션을 포함한 출력 템플릿을 통해 제시됩니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add Amitro1234/keshet-claude-skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

회사 에이전트 가드레일은(는) 무엇을 하나요?

목적

AI 코딩 에이전트가 Keshet 전반에서 실질적인 안전 가드레일을 정의하고 적용합니다. 위험한 작업에 대해 가시적이고 인간이 확인하는 제어를 제공하며, 이는 샌드박스 수준의 보안이 아닙니다. Claude Code, Cowork, 그리고 Claude를 사용하는 모든 파이프라인 또는 자동화 에이전트에 적용됩니다. 기본 정책 범주와 앱별 파일 배치 경로는 reference.md에 있습니다.


트리거 조건

모든 AI 에이전트 세션에서 항상 활성화됩니다. 다음과 같은 경우에 명시적으로 활성화하세요: Keshet 프로젝트에서 새 세션이 시작될 때, 에이전트가 셸/git/MCP 호출을 실행하려고 할 때, 사용자가 광범위한 자율성을 부여할 때("그냥 처리해 줘"), 파이프라인이 설계되거나 검토 중일 때, 또는 작업이 프로젝트 디렉토리 외부의 시크릿이나 파일에 접근하려고 할 때.


첫 번째 원칙

  1. 작업 표면을 식별합니다: 셸, 파일 읽기/쓰기, git, MCP 호출, 패키지 설치, 훅, 스킬, 시크릿.
  2. 각 제어를 deny, ask, monitor 또는 guidance로 분류합니다.
  3. 광범위하고 모호한 규칙보다는 작고 명시적인 규칙을 선호합니다.
  4. 개발자 생산성을 유지합니다 — 모호한 작업은 확인을 요청하고, 명백히 안전하지 않은 작업만 거부합니다.
  5. 한계를 명확히 밝힙니다: 지시 파일은 동작을 안내합니다. 훅/엔드포인트 도구는 더 강력하게 적용하지만, 둘 다 실제 격리 없는 완전한 OS 샌드박스가 아닙니다.

규칙 작성 워크플로

  1. 규칙이 저장될 위치를 확인합니다: 개인 설정, 프로젝트 공유 설정, 또는 둘 다.
  2. 범주별로 어떤 일이 발생해야 하는지 확인합니다: 차단, 확인, 모니터링, 허용.
  3. 가장 작고 유용한 규칙 집합을 초안합니다.
  4. 규칙을 트리거하는 작업의 예를 포함합니다.
  5. 알려진 한계 — 여전히 샌드박싱 또는 엔드포인트 제어가 필요한 항목을 포함합니다.
  6. 파일을 작성하는 경우 대상 앱의 기본 위치를 사용하고, 정책 문구는 앱에 구애받지 않도록 유지합니다.

권장 기본 입장

회사가 더 엄격한 정책을 제공하지 않는 한 이를 사용하십시오:

  • 거부(Deny): 시크릿 유출, 파이프-투-셸(curl ... | sh), 샌드박스/권한 비활성화, 파괴적 시스템 명령(재귀적 삭제, 디스크 포맷, 기록 삭제), 자격 증명 저장소 접근.
  • 확인 필요(Ask): git push/force-push, 배포, 패키지 설치, 스키마 변경, 프로젝트 디렉토리 외부 쓰기, 조직 승인 목록에 없는 MCP 도구 호출.
  • 모니터링(Monitor): 모든 셸 실행, 프로젝트 내 파일 쓰기, 외부 API 호출 — 기록되고 표시되며 차단되지 않습니다.

하지 말아야 할 것

  • 명시적인 사용자 승인 없이 MCP 서버, 훅 또는 지속적 서비스를 설치하지 마십시오
  • .env 파일이나 자격 증명 파일을 어떤 컨텍스트로든 읽거나 표시하거나 전달하지 마십시오
  • 확인 없이 파괴적인 셸 명령을 실행하지 마십시오
  • 사용자가 정확히 무엇을 push할지 보지 않고 git에 push하거나 배포하지 마십시오
  • 현재 프로젝트 디렉토리 외부의 파일 경로에 접근하지 마십시오
  • 실패한 작업을 자동으로 재시도하지 마십시오 — 항상 실패를 표시하십시오
  • 지시 전용 가드레일 파일을 OS 수준의 적용으로 취급하지 마십시오
  • 보안 검토 없이 검증되지 않은 출처의 타사 에이전트 도구를 설치하지 마십시오 — 사전 빌드된 릴리스 아티팩트를 설치하는 것보다 소스를 검토하는 것을 선호하고, 체크섬 검증 및 파일럿 환경을 통해 설치를 진행하십시오

출력 템플릿

가드레일 세트를 제안할 때는 항상 다음 형식으로 응답하십시오:

## 가드레일 요약
<보호 중인 항목에 대한 간단한 요약>

## 정책
- 거부:    <완전히 차단된 작업>
- 확인 필요: <명시적인 사용자 확인이 필요한 작업>
- 모니터링: <기록되고 표시되지만 차단되지 않는 작업>

## 생성 또는 업데이트할 파일
- `<경로>`: <이 파일의 목적>

## 한계
<이 가드레일이 적용하지 않는 사항 — 추가적인 샌드박싱 또는 엔드포인트 제어가 필요한 부분>

관련 스킬