Skip to main content
팩은 GitHub 릴리스로 배포되는 정책 모음입니다. 명령어 하나로 설치할 수 있으며, 실행 전에 릴리스의 체크섬이 검증되고 다이제스트가 기록됩니다. 기록 이후에는 팩이 변조되더라도 머신에서 감지됩니다. 모든 팩과 각 팩에 포함된 모든 정책은 정책 허브에서 확인할 수 있습니다. 두 가지 종류가 있습니다:
  • Failproof AI 정책 팩 — 사전 정의된 사용 사례를 위한 완성형 팩입니다. 연결하는 즉시 작동합니다. 코딩 에이전트 정책 팩이 현재 제공되며, 더 많은 사용 사례를 위한 팩이 곧 출시될 예정입니다.
  • 커뮤니티 정책 팩 — 개발자들이 자신의 사용 사례를 위해 작성하고 공개한 정책입니다.

Failproof AI 정책 팩

코딩 에이전트 정책 팩

이 팩에는 38개의 정책이 포함되어 있으며, 매니페스트에서 무인 실행에 안전하다고 표시된 10개가 기본으로 활성화됩니다. 나머지는 목록으로 제공되어 직접 선택할 수 있습니다. 가장 많이 사용되는 정책과 policies add 명령만으로 활성화되는지 여부는 다음과 같습니다: 비활성화된 정책은 이름으로 켤 수 있습니다 — failproofai policies add block-rm-rf — 또는 --all을 사용해 팩 전체를 가져올 수 있습니다. 카테고리별로 그룹화된 모든 정책 보기:

커뮤니티 정책 팩

개발자들은 자신이 경험한 사용 사례를 위한 팩을 배포하며, 정책 허브에서 목록을 확인할 수 있습니다. 커뮤니티 팩은 작성자가 직접 배포하며 Failproof AI의 감사를 거치지 않으므로, 설치 전에 포함된 내용을 먼저 확인하세요:
이 명령은 팩에 포함된 모든 정책을 카테고리별로 나열하고, 작성자가 기본으로 활성화한 항목을 표시합니다. 매니페스트만 읽으며 — 진입 아티팩트는 다운로드되거나 임포트되지 않으므로, 낯선 팩을 조회해도 낯선 코드가 실행되지 않습니다. 매니페스트는 릴리스의 SHA256SUMS에 대해 검증되므로, 확인한 내용이 실제 설치될 내용과 동일합니다. 그런 다음 설치하세요:
다음 형식 중 어느 것이든 사용할 수 있습니다: 태그를 지정하지 않으면 최신 릴리스를 설치하고 고정한 뒤 선택된 태그를 알려줍니다. 항상 정확히 하나의 릴리스가 기록되므로 재설치 시 버전이 달라지지 않습니다.

팩의 일부만 가져오기

기본적으로 팩에 포함된 전체 내용이 아닌, 작성자가 무인 실행에 안전하다고 표시한 팩의 기본 정책만 적용됩니다.
--category와 --policy는 합집합으로 결합됩니다(--only는 --policy의 동의어로 사용 가능). 팩이 이미 설치된 경우 이 플래그들은 기존 선택에 추가되며, 플래그 없이 비대화식으로 재추가하면(예: 업그레이드 시) 기존 선택이 유지됩니다. 터미널에서 플래그 없이 실행하면 add는 작성자의 기본값이 미리 선택된 피커를 열고, 선택한 항목이 기존 선택을 대체합니다.

활성화 상태 관리

팩 정책의 활성화 또는 비활성화는 머신 전체에 적용됩니다. --scope와 관계없이 해당 설정은 프로젝트 구성이 아닌 설치된 팩과 함께 기록됩니다. 슬래시가 없는 이름은 정책이고, 슬래시가 있는 이름은 팩 소스입니다. 슬래시 없는 이름은 해당 정책을 선언한 설치된 팩으로 해석됩니다. 설치된 두 팩이 동일한 이름을 선언하는 경우, 대상을 명확히 지정하세요:
스코프, 파라미터, 이 명령들이 작성하는 파일에 대한 내용은 로컬 구성에서 다룹니다.

무결성 보장의 범위

SHA256SUMS는 아티팩트와 동일한 릴리스에 포함되므로 서명이 아니며 게시자에 대한 증명이 아닙니다. 다만 바이트가 해당 릴리스에서 배포된 것임을 증명합니다. 팩을 추가할 때 다이제스트가 기록되고 임포트 전마다 재검증되므로, 이후 팩이 변조될 수 없습니다. 리포지토리가 태그를 변경하거나 에셋을 교체하면 조용히 다른 것을 실행하는 대신 로딩이 중단됩니다. 설치 시 팩은 한 번 임포트되어 자체 매니페스트와 대조 검증됩니다. 아티팩트 파싱에 실패하거나 선언된 것과 다른 항목을 등록하려는 팩은 아무것도 활성화되기 전에 거부됩니다. 깔끔하게 설치된 후 다음 도구 호출 시 실패하는 대신, 미리 차단됩니다.

팩이 로드되지 않을 때

이 머신에서 적용하도록 설정된 팩이 실행되지 않을 경우, 누락된 정책이 다루던 이벤트는 조용히 허용되는 대신 거부됩니다 — pack/failproofai-pack-unavailable으로 처리되며, 이는 로드된 정책들보다 우선순위가 높아 거부가 우연히 먼저 실행된 가드가 아닌 누락된 팩에 귀속됩니다. 단, UserPromptSubmit는 예외로 거부 대신 지시를 내립니다. 여기서 거부하면 문제를 해결하는 데 필요한 에이전트 자체에서 잠겨버릴 수 있기 때문입니다. 오류 동작을 참고하세요.

오프라인 및 미러

자신의 정책을 이 방식으로 공유하려면 정책 팩 배포하기를 참고하세요.