기본 제공 정책 카탈로그

설치된 패키지가 정책 가용성의 기준입니다. 업그레이드할 때마다 failproofai policies를 실행하세요. 카탈로그 항목과 동작은 패키지 버전에 따라 변경될 수 있습니다.

권장 기준 설정

가이드 설정의 권장 선택 항목은 현재 시크릿 삭제, 환경 보호, 자기 보호, 치명적 명령 차단, 보호 브랜치 안전 기능을 활성화합니다:

sanitize-jwt                 sanitize-api-keys
sanitize-connection-strings sanitize-private-key-content
sanitize-bearer-tokens       protect-env-vars
block-env-files              block-secrets-write
block-failproofai-commands   block-sudo
block-curl-pipe-sh           block-rm-rf
block-push-master            block-force-push

block-failproofai-commands는 항상 활성화되어 있습니다. 완전성을 위해 위에 나열되었지만, 활성화된 목록에 포함 여부와 관계없이 모든 평가 시 등록되며, 비활성화하거나 일시 중지할 수 없습니다. 에이전트가 끌 수 있는 강제 수단은 진정한 보호 수단이 아닙니다. 권장 설정은 의도적으로 전체 활성화보다 좁은 범위로 설정되어 있습니다. 인프라 및 워크플로 정책은 유효한 작업을 방해할 수 있으므로, 해당 정책이 필요한 저장소와 머신에서만 활성화해야 합니다.

시크릿 및 환경

정책	트리거	결과
`sanitize-jwt`	`PostToolUse`	모델이 확인하기 전에 도구 출력에서 JWT를 삭제합니다.
`sanitize-api-keys`	`PostToolUse`	OpenAI, Anthropic, GitHub, AWS, Stripe, Google 등의 일반적인 API 키를 삭제합니다.
`sanitize-connection-strings`	`PostToolUse`	자격 증명이 포함된 데이터베이스 연결 문자열을 삭제합니다.
`sanitize-private-key-content`	`PostToolUse`	PEM 개인 키 본문을 삭제합니다.
`sanitize-bearer-tokens`	`PostToolUse`	Authorization bearer 토큰을 삭제합니다.
`protect-env-vars`	셸 도구에서 `PreToolUse`	환경 변수를 덤프하는 명령을 차단합니다.
`block-env-files`	`PreToolUse`	`.env` 파일의 읽기 및 쓰기를 차단합니다.
`block-read-outside-cwd`	읽기, glob, grep, 셸 도구에서 `PreToolUse`	읽기 작업을 세션 작업 디렉토리 내로 제한합니다.
`block-secrets-write`	쓰기 도구에서 `PreToolUse`	일반적인 시크릿 키 및 자격 증명 파일명에 대한 쓰기를 차단합니다.

위험 명령 및 인프라

정책	트리거	결과
`block-sudo`	`PreToolUse`, `PermissionRequest`	허용 패턴이 일치하지 않는 한 `sudo`를 차단합니다.
`block-curl-pipe-sh`	`PreToolUse`	셸로 직접 파이프되는 다운로드 스크립트를 차단합니다.
`block-rm-rf`	`PreToolUse`	치명적인 재귀 삭제 패턴을 차단합니다.
`block-failproofai-commands`	`PreToolUse`, `PermissionRequest`	항상 활성화, 비활성화 불가. 모든 Failproof AI CLI 호출, 자기 일시 중지, 패키지 매니저 제거를 차단합니다.
`block-kubectl`	`PreToolUse`	Kubernetes 명령을 제어합니다.
`block-terraform`	`PreToolUse`	Terraform 및 OpenTofu 명령을 제어합니다.
`block-aws-cli`	`PreToolUse`	AWS CLI 명령을 제어합니다.
`block-gcloud`	`PreToolUse`	Google Cloud CLI 명령을 제어합니다.
`block-az-cli`	`PreToolUse`	Azure CLI 명령을 제어합니다.
`block-helm`	`PreToolUse`	Helm 명령을 제어합니다.
`block-gh-pipeline`	`PreToolUse`	GitHub CLI의 변경성 워크플로, 실행, 병합, 릴리스, 캐시, 시크릿 작업을 제어합니다.

Git 및 데이터베이스 안전

정책	트리거	결과
`block-push-master`	`PreToolUse`	설정된 보호 브랜치로의 직접 푸시를 차단합니다.
`block-force-push`	`PreToolUse`	강제 푸시를 차단합니다. 현재 구현에서는 `--force-with-lease`는 허용됩니다.
`block-work-on-main`	`PreToolUse`	보호 브랜치에서의 커밋 및 병합을 차단합니다.
`warn-git-amend`	`PreToolUse`	`--amend`로 커밋을 재작성하기 전에 경고합니다.
`warn-git-stash-drop`	`PreToolUse`	스태시를 영구적으로 삭제하거나 초기화하기 전에 경고합니다.
`warn-all-files-staged`	`PreToolUse`	광범위한 `git add -A`, `git add .`, `git add --all` 사용 시 경고합니다.
`warn-destructive-sql`	`PreToolUse`	인식된 데이터베이스 클라이언트를 통해 `WHERE` 절 없이 `DROP`, `TRUNCATE`, `DELETE` 사용 시 경고합니다.
`warn-schema-alteration`	`PreToolUse`	인식된 `ALTER TABLE` 컬럼 및 이름 변경 작업 시 경고합니다.

패키지, 시스템 동작, 에이전트 루프

정책	트리거	결과
`warn-package-publish`	`PreToolUse`	패키지 레지스트리에 게시하기 전에 경고합니다.
`warn-global-package-install`	`PreToolUse`	전역 패키지 설치 전에 경고합니다.
`prefer-package-manager`	`PreToolUse`	허용된 패키지 매니저를 사용하도록 에이전트에게 지시합니다.
`warn-large-file-write`	쓰기 도구에서 `PreToolUse`	설정된 파일 크기 임계값을 초과하면 경고합니다.
`warn-background-process`	`PreToolUse`	분리되거나 장기 실행되는 백그라운드 프로세스 패턴 시 경고합니다.
`warn-repeated-tool-calls`	`PreToolUse`	동일한 도구 호출이 세 번 이상 반복되면 경고합니다.

작업 종료 워크플로

이 정책들은 호환되는 Stop 이벤트를 발생시키는 하네스가 필요합니다.

정책	결과
`require-commit-before-stop`	추적된 작업이 커밋되지 않은 상태에서 완료를 거부합니다.
`require-push-before-stop`	커밋이 로컬에만 존재하는 상태에서 완료를 거부합니다.
`require-pr-before-stop`	현재 브랜치에 대한 풀 리퀘스트를 요구합니다.
`require-no-conflicts-before-stop`	설정된 베이스 브랜치에 대해 충돌 없는 병합을 요구합니다.
`require-ci-green-before-stop`	현재 HEAD의 CI 검사가 성공적으로 완료될 것을 요구합니다.

파라미터 참조

선택된 스코프의 policyParams 객체 아래에서 파라미터를 설정합니다. 각 정책에 의해 타입이 검증됩니다.

정책	파라미터	타입 및 기본값
`sanitize-api-keys`	`additionalPatterns`	`pattern[]`, `[]`; 항목에 `regex` 및 `label` 포함
`block-read-outside-cwd`	`allowPaths`	`string[]`, `[]`
`block-sudo`	`allowPatterns`	`string[]`, `[]`
`block-rm-rf`	`allowPaths`	`string[]`, `[]`
인프라 차단 정책	`allowPatterns`	`string[]`, `[]`
`block-secrets-write`	`additionalPatterns`	`string[]`, `[]`
`block-push-master`	`protectedBranches`	`string[]`, `["main", "master"]`
`block-work-on-main`	`protectedBranches`	`string[]`, `["main", "master"]`
`prefer-package-manager`	`allowed`, `blocked`	`string[]`, `[]`
`warn-large-file-write`	`thresholdKb`	`number`, `1024`
`require-push-before-stop`	`remote`, `baseBranch`	`string`, `"origin"`; `string`, `"main"`
`require-pr-before-stop`	`baseBranch`	`string`, `"main"`
`require-no-conflicts-before-stop`	`baseBranch`	`string`, `"main"`

{
  "enabledPolicies": ["block-sudo", "block-push-master"],
  "policyParams": {
    "block-sudo": {
      "allowPatterns": ["sudo systemctl status"]
    },
    "block-push-master": {
      "protectedBranches": ["main", "release"]
    }
  }
}

허용 패턴은 에이전트가 수행할 수 있는 작업의 범위를 넓힙니다. 플릿 전체에 배포하기 전에 대상 하네스에서 정확한 토크나이제이션과 명령 변형을 테스트하세요.

​권장 기준 설정

​시크릿 및 환경

​위험 명령 및 인프라

​Git 및 데이터베이스 안전

​패키지, 시스템 동작, 에이전트 루프

​작업 종료 워크플로

​파라미터 참조

권장 기준 설정

시크릿 및 환경

위험 명령 및 인프라

Git 및 데이터베이스 안전

패키지, 시스템 동작, 에이전트 루프

작업 종료 워크플로

파라미터 참조