Skip to main content
베타 기능. 초기 피드백을 수집하는 동안 감사 기능은 베타로 제공됩니다. 다음 안정 버전 출시 전까지 감지기 카탈로그와 리포트 형식이 변경될 수 있습니다. 이상한 점이 있으면 이슈를 열어 주세요.
감사 기능은 과거 에이전트 CLI 트랜스크립트를 failproofai의 정책 엔진으로 재실행하여, /audit 대시보드 페이지에 공유 가능한 시각적 리포트를 렌더링합니다. 에이전트의 아키타입, 0~100점 점수, 그리고 어떤 정책이 무엇을 잡아냈을지 구체적으로 보여줍니다.

​
실행 방법

세 가지 방법이 있으며, 모두 동일한 /audit 리포트로 연결됩니다.

설치 불필요

npx -y failproofai audit는 failproofai를 가져와 스캔을 실행하고 대시보드를 열어줍니다 — 사전 설치가 필요 없습니다.

CLI에서 실행

failproofai audit는 터미널에서 스캔을 실행한 뒤, 완료되면 자동으로 localhost:8020/audit를 엽니다.

대시보드에서 실행

failproofai를 실행하고 내비게이션 바의 Audit을 클릭하거나(Policies와 Projects 사이), /audit을 직접 여세요.
failproofai audit -h (또는 --help)를 실행하면 사용법을 확인할 수 있습니다. 감사는 완전히 오프라인으로 실행되며 — 계정이나 네트워크가 필요 없습니다 — Ctrl+C로 중지할 때까지 대시보드가 계속 서비스됩니다.
대시보드는 이 머신에 있는 과거 에이전트 CLI 트랜스크립트(Claude Code, Codex, Copilot, Cursor, OpenCode, Pi, Gemini)를 스캔하여, failproofai가 차단하도록 설계된 행동들 — 환경 변수 확인, 강제 푸시, 불필요한 cd <cwd> 접두사, sleep 폴링 루프, 방금 편집한 파일 재읽기 등 — 이 얼마나 자주 발생했는지 보고합니다. 각 트랜스크립트에서 모든 툴 사용 이벤트는 39개의 내장 정책과 런타임 정책으로 아직 다루지 않는 패턴을 잡아내는 8개의 감사 전용 감지기를 통해 재실행됩니다. 카운트는 모든 세션에 걸쳐 정책/감지기별로 집계됩니다.

​
결과물

/audit 페이지는 단일 화면의 공유 가능한 포스터와 그 아래 네 개의 섹션으로 구성됩니다.
  1. 포스터 — 에이전트의 정체성을 한눈에: 아키타입(8가지 중 하나 — optimist, cowboy, explorer, goldfish, paranoid architect, precision builder, hammer, ghost), 페르소나 키워드, 해당 아키타입의 희귀도, 그리고 등급 밴드(S부터 bottom tier)가 포함된 0~100점 점수. 공유용으로 제작 — X나 LinkedIn에 게시하거나 PNG로 다운로드하세요.
  2. // strengths — 에이전트가 이미 잘하는 것들을 스캔의 실제 수치로 표시 (예: 클린 툴 호출 %, 0회의 main 푸시 시도). 해당 정책이 깨끗한 기록을 가진 경우에만 표시됩니다.
  3. // quirks — 놓친 것들: failproofai가 잡아냈을 행동의 순위 테이블 — 마지막 발생 시점, 놓친 내용(및 차단했을 내장 정책), 심각도, 그리고 발생 빈도(new / recurring / N× seen).
  4. // how to improve — 처방된 수정 목록: 복사-붙여넣기 가능한 failproofai policy add <slug>가 포함된 정책별 행, 모든 권장 사항을 한 번에 활성화하는 install all 버튼, 그리고 실행 시의 예상 점수.
  5. // come back better — 습관 만들기: 재감사 이메일 알림 설정(3d / 7d / 14d / 30d) 또는 즉시 재감사, 친구 초대로 본인의 감사 실행 유도 (failproof.ai에서 발송, 수신자 참조로 귀하에게 전달). 알림 및 초대는 로그인이 필요합니다 — failproofai auth를 참조하세요.

​
감사 전용 감지기

이는 실시간으로 (아직) 적용되지 않는 “비효율적 행동” 패턴을 감지합니다. 감사 중에만 실행되며 라이브 툴 호출을 절대 차단하지 않습니다.

​
캐시

  • ~/.failproofai/cache/audit/<sha1>.json의 트랜스크립트별 캐시 — (mtime, size, engineVersion, detectorVersion)을 키로 하며, 트랜스크립트나 정책/감지기 코드가 변경되면 자동으로 무효화됩니다. 각 항목에는 TTL 메타데이터로 cachedAt 타임스탬프가 저장됩니다(캐시 키의 일부가 아님). 7일이 지난 항목은 읽기 시 거부되어 오래된 결과가 진화하는 감지기 의도를 벗어나지 않도록 합니다.
  • ~/.failproofai/audit-dashboard.json의 전체 결과 캐시 (모드 0600). 내비게이션 시 재실행 없이 대시보드를 즉시 렌더링할 수 있게 해줍니다. 7일 TTL이 지나면 읽기 시 거부되며, /audit는 빈 상태로 돌아가 새 실행을 안내합니다. 리포트 하단의 [ re-audit now ]를 클릭하면 새로고침됩니다 — 재감사는 noCache: true를 전송하여 트랜스크립트별 캐시를 우회하고 캐시된 결과 대신 모든 트랜스크립트를 재스캔합니다. 실행은 상단 고정 스트립을 통해 진행 상황을 스트리밍하고, 성공 시 결과를 제자리에서 교체합니다(페이지 새로고침 없음; 재감사 실패 시 이전 리포트 유지).

​
참고 사항

  • 변경 없음. 감사는 읽기 전용 모드로 재실행됩니다. warn-repeated-tool-calls는 세션별 사이드카가 수정될 수 있으므로 건너뜁니다.
  • 워크플로 정책 건너뜀. require-*-before-stop 정책은 Stop 이벤트에서만 실행되고 라이브 git 상태에 대해 execSync를 수행합니다 — “2025년에 어떤 일이 일어났을까”에 대한 의미 있는 해석이 없으므로 감사 카운트에 나타나지 않습니다.
  • 커스텀 정책 건너뜀. 사용자가 제공한 커스텀 훅은 재실행되지 않습니다(원래 세션 이후 변경되었을 수 있음).