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

​
실행 방법

세 가지 방법 모두 동일한 /audit 보고서로 연결됩니다.

설치 불필요

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

CLI에서 실행

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

대시보드에서 실행

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

​
제공 내용

/audit 페이지는 단일 화면의 공유 가능한 포스터와 그 아래 네 개의 섹션으로 구성됩니다:
  1. 포스터 — 에이전트의 정체성을 한눈에: 아키타입 (8가지 중 하나 — optimist, cowboy, explorer, goldfish, paranoid architect, precision builder, hammer, ghost), 페르소나 키워드, 해당 아키타입의 희귀도, 그리고 등급 밴드가 표시된 0~100 점수 (S부터 bottom tier까지). 공유용으로 설계 — X나 LinkedIn에 게시하거나 PNG로 다운로드하세요.
  2. // strengths — 에이전트가 이미 잘 하고 있는 것을 스캔의 실제 수치로 표시 (예: clean-tool-call %, 0번의 push-to-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에서 발송, Cc를 나에게). 알림과 초대는 로그인이 필요합니다 — 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년에 어떤 일이 일어났을까”에 대한 의미 있는 해석이 없으므로 감사 횟수에 나타나지 않습니다.
  • 커스텀 정책 건너뜀. 사용자 제공 커스텀 훅은 재실행되지 않습니다 (원래 세션 이후 변경되었을 수 있음).