로컬 설정

Failproof AI는 저장소에 커밋할 수 있는 항목(훅 연결, 정책 파라미터, 사용자 정의 정책)과 자격 증명, 설치된 팩, 데몬과 같은 머신 상태를 분리하여 관리합니다.

범위 선택

범위는 훅이 연결되는 위치와 파라미터 및 사용자 정의 정책 경로를 기록하는 설정 파일을 결정합니다:

User: 이 머신의 모든 프로젝트에 적용됩니다.
Project: 저장소에 속하며 커밋할 수 있습니다.
Local: 특정 프로젝트를 특정 사용자에게만 재정의하며, gitignore에 추가해야 합니다.

failproofai policies --install --cli claude --scope project   # 이 저장소에 훅 연결
failproofai policies --install --cli claude --scope user      # 또는 이 머신의 모든 프로젝트에 연결
failproofai policies

모든 하네스가 로컬 범위를 지원하는 것은 아닙니다. 선택한 하네스가 해당 범위를 표현할 수 없으면 CLI가 거부합니다. 팩 정책의 활성화 여부는 범위와 무관합니다. 이 설정은 설치된 팩에 함께 기록되므로, failproofai policies add <name>은 --scope 값에 관계없이 머신 전체에서 정책을 활성화합니다.

범위	정책 설정 파일
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

정책 파라미터는 해당 정책에 대한 파라미터를 정의하는 첫 번째 범위를 사용하며, 우선순위는 project → local → user 순입니다. 명시적인 사용자 정의 정책 경로도 이를 정의하는 첫 번째 범위를 사용합니다.

정책 파라미터 설정

대시보드
CLI

로컬 대시보드에서 정책을 열고, 지원되는 파라미터를 수정한 후 선택한 범위에 저장합니다. 일치하는 에이전트 작업과 일치하지 않는 에이전트 작업을 각각 실행한 후, Observe → policy에서 결정 내역을 확인합니다.

선택한 범위의 policies-config.json을 직접 편집한 후 failproofai policies를 실행합니다. 설치된 팩에 없는 정책을 policyParams 항목에 지정하면 경고가 표시됩니다. 항목 내부의 키는 검사하지 않으므로, 아래 표를 참고하여 철자를 직접 확인하세요.

{
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

Failproof AI 정책이 허용하는 파라미터

각 정책은 자체적으로 파라미터 타입을 검증합니다.

정책	파라미터	타입 및 기본값
`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"`

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

머신 파일 구조 이해

~/.failproofai는 신뢰 경계에 따라 파일을 분리하여 관리합니다:

경로	용도
`config.json`	비밀이 아닌 데몬, 감사, 텔레메트리 설정
`credentials.json`	클라우드 자격 증명; 소유자 전용 권한으로 저장
`policies-config.json`	사용자 범위 파라미터 및 명시적 사용자 정의 정책 경로
`policies/`	사용자 컨벤션 정책, 설치된 팩과 활성화된 정책 목록, Cloud 관리 정책 아티팩트
`hook-activity/`	로컬 정책 결정 로그
`state/`	데몬 스풀, 상태 점검, 일시 정지, 런타임 상태

컨테이너나 격리된 테스트 환경을 위해 전체 머신 레이아웃을 이전하려면 FAILPROOFAI_HOME을 사용하세요. 개별 상태 디렉터리를 독립적으로 이전하지 마세요.

credentials.json은 절대 커밋하지 마세요. 프로젝트 정책 설정과 프로젝트 컨벤션 정책은 강제 실행 코드로서 충분히 검토한 후에만 커밋하세요.

Connect your agents

Reference

범위 선택

정책 파라미터 설정

Failproof AI 정책이 허용하는 파라미터

머신 파일 구조 이해

​범위 선택

​정책 파라미터 설정

​Failproof AI 정책이 허용하는 파라미터

​머신 파일 구조 이해

범위 선택

정책 파라미터 설정

Failproof AI 정책이 허용하는 파라미터

머신 파일 구조 이해