failproofai 0.0.2 → 0.0.3

package/.next/standalone/docs/ko/dashboard.mdx

@@ -0,0 +1,142 @@
+---
+title: 대시보드
+description: "에이전트 세션 모니터링, 툴 호출 검토, 정책 관리"
+icon: chart-line
+---
+
+failproofai 대시보드는 AI 에이전트 세션을 모니터링하고 정책을 관리하기 위한 로컬 웹 애플리케이션입니다. 자리를 비운 사이 에이전트가 무엇을 했는지 확인하세요.
+
+---
+
+## 대시보드 시작하기
+
+```bash
+failproofai
+```
+
+`http://localhost:8020`에서 열립니다.
+
+대시보드는 파일시스템에서 직접 데이터를 읽습니다 — Claude Code 프로젝트 폴더와 failproofai 설정 파일을 참조하며, 외부 서비스에는 아무것도 전송되지 않습니다.
+
+---
+
+## 페이지
+
+### 프로젝트
+
+사용자 머신에서 발견된 모든 Claude Code 프로젝트를 나열합니다. 프로젝트는 `~/.claude/projects/` 경로(또는 `CLAUDE_PROJECTS_PATH`로 설정된 경로)에서 검색됩니다.
+
+각 프로젝트에 표시되는 정보:
+- 프로젝트 이름 (폴더 경로에서 파생)
+- 세션 수
+- 가장 최근 세션 활동 날짜
+
+프로젝트를 클릭하면 해당 세션 목록을 볼 수 있습니다.
+
+### 세션
+
+프로젝트 내 모든 세션을 나열합니다. 각 세션에 표시되는 정보:
+- 세션 ID
+- 시작 및 종료 타임스탬프
+- 툴 호출 수
+- 훅 활동 횟수 (실행된 정책 수)
+
+날짜 범위 필터와 세션 ID 검색을 사용해 목록을 좁힐 수 있습니다. 세션은 페이지네이션으로 표시됩니다.
+
+세션을 클릭하면 세션 뷰어가 열립니다.
+
+### 세션 뷰어
+
+세션 뷰어는 자율 에이전트에 대한 핵심 질문에 답합니다: 에이전트가 무엇을 했으며, 올바른 방향으로 동작했는가? 세션에서 발생한 모든 일의 타임라인을 보여줍니다:
+
+- **메시지** - Claude의 텍스트 응답과 사용자 프롬프트
+- **툴 호출** - Claude가 실행한 모든 툴과 입력 및 출력 내용
+- **정책 활동** - 각 툴 호출에 대해 어떤 정책이 실행되었고 어떤 결정을 내렸는지
+
+상단의 통계 바에는 세션 지속 시간, 총 툴 호출 수, 훅 결정 요약(allow / deny / instruct 횟수)이 표시됩니다.
+
+다운로드 버튼을 사용해 세션을 ZIP 또는 JSONL 파일로 내보낼 수 있습니다.
+
+### 정책
+
+정책 관리와 활동 검토를 위한 두 탭 페이지입니다.
+
+<Tabs>
+  <Tab title="정책 탭">
+  - 클릭 한 번으로 개별 정책을 켜거나 끄기 (`~/.failproofai/policies-config.json`에 저장됨)
+  - 정책을 펼쳐 파라미터 설정 (`policyParams`를 지원하는 정책의 경우)
+  - 지정된 스코프에 훅 설치 또는 제거
+  - 커스텀 정책 파일 경로 설정
+  </Tab>
+  <Tab title="활동 탭">
+  - 모든 세션에 걸쳐 실행된 모든 훅 이벤트의 전체 페이지네이션 히스토리
+  - 정책 이름, 세션 ID, 툴 이름, 결정으로 검색
+  - 각 행에 표시되는 정보: 타임스탬프, 정책 이름, 결정, 툴 이름, 세션 ID, deny/instruct 결정의 이유
+  </Tab>
+</Tabs>
+
+---
+
+## 자동 새로고침
+
+대시보드 상단 네비게이션에 자동 새로고침 토글이 있습니다. 활성화하면 현재 페이지가 주기적으로 새로고침되어 새로운 세션과 정책 활동이 나타나는 즉시 확인할 수 있습니다. 장시간 실행되는 자율 에이전트 세션을 모니터링할 때 필수적인 기능입니다.
+
+---
+
+## 페이지 비활성화
+
+대시보드의 일부 기능만 필요한 경우, `FAILPROOFAI_DISABLE_PAGES`에 비활성화할 페이지 이름을 쉼표로 구분하여 설정하세요:
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+유효한 값: `policies`, `projects`.
+
+---
+
+## 테마
+
+대시보드는 라이트 모드와 다크 모드를 지원합니다. 네비게이션 바의 버튼으로 전환할 수 있습니다. 설정은 브라우저의 로컬 스토리지에 저장됩니다.
+
+---
+
+## 프로젝트 경로 설정
+
+기본적으로 대시보드는 표준 Claude Code 프로젝트 디렉토리에서 읽습니다. 커스텀 설정이 필요한 경우 경로를 재정의하세요:
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## localhost가 아닌 호스트에서 접근하기
+
+**개발 모드**(`npm run dev`)로 대시보드를 실행하면서 `localhost`가 아닌 호스트 — 예를 들어 커스텀 도메인, 원격 IP, 또는 터널링된 URL — 에서 접근하면 다음과 같은 경고가 표시될 수 있습니다:
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+이는 Next.js가 HMR(핫 모듈 리로드) 웹소켓에 대한 교차 출처 접근을 차단한 것으로, 개발 모드에서만 사용되는 기능입니다. 특정 호스트를 허용하려면 `--allowed-origins` 플래그를 사용하세요:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+여러 호스트 또는 IP를 허용하려면 쉼표로 구분된 목록을 전달하세요:
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+또는 `FAILPROOFAI_ALLOWED_DEV_ORIGINS` 환경 변수를 설정할 수도 있습니다:
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+이 설정은 개발 모드에서만 적용됩니다. `failproofai`(프로덕션 모드)로 실행할 때는 HMR 웹소켓이 없으므로 교차 출처 개발 리소스 문제가 발생하지 않습니다.
+</Note>

package/.next/standalone/docs/ko/examples.mdx

@@ -0,0 +1,253 @@
+---
+title: 예시
+description: "Claude Code 및 Agents SDK를 위한 훅 설정 방법"
+icon: book-open
+---
+
+일반적인 시나리오에 바로 사용할 수 있는 예시 모음입니다. 각 예시에는 설치 방법과 예상 동작이 포함되어 있습니다.
+
+---
+
+## Claude Code용 훅 설정
+
+Failproof AI는 Claude Code의 [훅 시스템](https://docs.anthropic.com/en/docs/claude-code/hooks)을 통해 통합됩니다. `failproofai policies --install`을 실행하면 모든 도구 호출 시 실행되는 훅 명령이 Claude Code의 `settings.json`에 등록됩니다.
+
+<Steps>
+  <Step title="failproofai 설치">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="모든 내장 정책 활성화">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="훅 등록 확인">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    `PreToolUse`, `PostToolUse`, `Notification`, `Stop` 이벤트에 대한 훅 항목이 표시되어야 합니다.
+  </Step>
+  <Step title="Claude Code 실행">
+    ```bash
+    claude
+    ```
+
+    이제 모든 도구 호출 시 정책이 자동으로 실행됩니다. Claude에게 `sudo rm -rf /`를 실행하도록 요청해 보세요 — 차단됩니다.
+  </Step>
+</Steps>
+
+---
+
+## Agents SDK용 훅 설정
+
+[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk)로 개발하는 경우, 동일한 훅 시스템을 프로그래밍 방식으로 사용할 수 있습니다.
+
+<Steps>
+  <Step title="프로젝트에 failproofai 설치">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="에이전트에 훅 설정">
+    에이전트 프로세스를 생성할 때 훅 명령을 전달합니다. 훅은 Claude Code와 동일한 방식으로 — stdin/stdout JSON을 통해 — 실행됩니다:
+
+    ```bash
+    failproofai --hook PreToolUse   # 각 도구 실행 전 호출
+    failproofai --hook PostToolUse  # 각 도구 실행 후 호출
+    ```
+  </Step>
+  <Step title="에이전트용 커스텀 정책 작성">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="커스텀 정책 설치">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## 파괴적 명령 차단
+
+가장 일반적인 설정으로, 에이전트가 되돌릴 수 없는 피해를 입히는 것을 방지합니다.
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+각 정책의 역할:
+- `block-sudo` — 모든 `sudo` 명령 차단
+- `block-rm-rf` — 재귀적 파일 삭제 차단
+- `block-force-push` — `git push --force` 차단
+- `block-curl-pipe-sh` — 원격 스크립트를 셸로 파이핑하는 것 차단
+
+---
+
+## 시크릿 유출 방지
+
+에이전트가 도구 출력에서 자격 증명을 보거나 유출하지 못하도록 차단합니다.
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+이 정책들은 `PostToolUse`에서 실행됩니다 — 도구 실행 후, 에이전트가 출력을 확인하기 전에 민감한 정보를 제거합니다.
+
+---
+
+## 에이전트 대기 시 Slack 알림 받기
+
+알림 훅을 사용하여 유휴 알림을 Slack으로 전달합니다.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // Slack에 연결할 수 없어도 에이전트를 절대 차단하지 않음
+    }
+
+    return allow();
+  },
+});
+```
+
+설치:
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## 에이전트를 특정 브랜치에 고정
+
+에이전트가 브랜치를 전환하거나 보호된 브랜치에 푸시하는 것을 방지합니다.
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## 커밋 전 테스트 실행 요구
+
+에이전트가 커밋하기 전에 테스트를 실행하도록 상기시킵니다.
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## 프로덕션 저장소 잠금
+
+팀의 모든 개발자가 동일한 정책을 적용받도록 프로젝트 수준의 설정을 저장소에 커밋합니다.
+
+저장소에 `.failproofai/policies-config.json`을 생성합니다:
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+커밋합니다:
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+failproofai가 설치된 모든 팀원은 이 규칙을 자동으로 적용받습니다.
+
+---
+
+## 더 많은 예시
+
+저장소의 [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) 디렉토리에는 다음 파일들이 포함되어 있습니다:
+
+| 파일 | 내용 |
+|------|------|
+| `policies-basic.js` | 기본 정책 — 프로덕션 쓰기 차단, force-push 차단, 파이프된 스크립트 차단 |
+| `policies-notification.js` | 유휴 알림 및 세션 종료 시 Slack 알림 |
+| `policies-advanced/index.js` | 전이적 임포트, 비동기 훅, PostToolUse 출력 스크러빙, Stop 이벤트 처리 |

package/.next/standalone/docs/ko/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "에이전트용"
+description: "한 번의 명령으로 코딩 에이전트에 Failproof AI 지식을 추가하세요. Claude Code, Cursor, Windsurf 등과 호환됩니다."
+---
+
+한 번의 명령으로 Failproof AI 전체 레퍼런스를 코딩 에이전트에 추가하세요. Claude Code, Cursor, Windsurf, 그리고 스킬을 지원하는 모든 에이전트와 호환됩니다.
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills`는 설치된 에이전트를 자동으로 감지하고, 각 에이전트에 맞는 형식으로 스킬을 추가합니다.
+
+## 스킬이 다루는 내용
+
+| 영역 | 포함 내용 |
+|------|----------------|
+| Policies | 기본 제공 정책 이름, 이벤트 타입, 파라미터, 활성화/비활성화 |
+| Custom policies | `customPolicies.add()`, 매치 필터, `allow`/`deny`/`instruct` API |
+| Context object | `ctx.eventType`, `ctx.toolName`, `ctx.toolInput`, `ctx.session` |
+| Configuration | `policies-config.json` 구조, 스코프 병합, `policyParams` |
+| CLI | `failproofai policies --install`, `--uninstall`, `--custom`, 스코프 |
+| Dashboard | 세션 뷰어, 정책 활동, 환경 변수 |
+| Architecture | 훅 핸들러 플로우, 종료 코드, stdin/stdout 계약 |
+
+## 스킬이 완전한가요?
+
+Mintlify는 내비게이션의 모든 페이지에서 `llms.txt`를 생성합니다. Failproof AI 문서는 전체 API를 다루고 있으며, 모든 정책, 옵션, 예제가 포함되어 있습니다. 누락된 내용이 발견되면 소스는 `https://docs.befailproof.ai/llms-full.txt`에서 확인할 수 있습니다.
+
+특정 맥락만 필요한 경우, 특정 페이지로 직접 링크할 수 있습니다:
+
+```bash
+# 커스텀 정책 API만 추가
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# 기본 제공 정책만 추가
+npx skills add https://docs.befailproof.ai/built-in-policies
+```

package/.next/standalone/docs/ko/getting-started.mdx

@@ -0,0 +1,134 @@
+---
+title: 시작하기
+description: "failproofai를 설치하고, 정책을 활성화하여 에이전트를 안정적으로 실행하세요"
+icon: rocket
+---
+
+## 요구 사항
+
+- **Node.js** >= 20.9.0
+- **Bun** >= 1.3.0 (선택 사항 - 소스에서 빌드할 때만 필요)
+
+---
+
+## 설치
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+---
+
+## 빠른 시작
+
+<Steps>
+  <Step title="정책 활성화">
+    정책은 에이전트의 모든 도구 호출 전후에 실행되는 규칙입니다. 파괴적인 명령, 시크릿 유출, 그 밖의 장애 상황이 실제 피해를 일으키기 전에 미리 차단합니다.
+
+    ```bash
+    failproofai policies --install
+    ```
+
+    이 명령은 Claude Code의 `settings.json`에 훅 항목을 작성합니다. 단일 프로젝트에만 설치하거나 특정 정책을 선택할 수도 있습니다:
+
+    ```bash
+    failproofai policies --install --scope project
+    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
+    ```
+  </Step>
+  <Step title="확인">
+    ```bash
+    failproofai policies
+    ```
+
+    모든 정책의 활성화 여부와 설정된 파라미터를 표시합니다.
+  </Step>
+  <Step title="대시보드 실행">
+    ```bash
+    failproofai
+    ```
+
+    `http://localhost:8020`에 로컬 대시보드를 열어 세션 조회, 도구 호출 검사, 정책 관리를 할 수 있습니다.
+  </Step>
+  <Step title="에이전트 실행">
+    평소처럼 Claude Code를 시작하세요. 에이전트가 위험한 작업을 시도하면 failproofai가 자동으로 이를 차단합니다. 에이전트를 무인 상태로 실행하고, 대시보드에서 이후에 발생한 내용을 검토하세요.
+  </Step>
+</Steps>
+
+---
+
+## 정책 동작 방식
+
+에이전트가 도구를 실행할 때마다 Claude Code는 failproofai를 서브프로세스로 호출합니다:
+
+```text
+Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
+                                                 evaluates policies
+                                                 writes decision to stdout
+```
+
+각 정책은 다음 세 가지 결정 중 하나를 반환합니다:
+
+- **allow** - 에이전트가 정상적으로 진행됩니다
+- **deny** - 작업이 차단되고, 에이전트에게 차단 이유가 전달됩니다
+- **instruct** - 에이전트의 프롬프트에 추가 컨텍스트가 삽입됩니다
+
+<Note>
+정책은 로컬 프로세스에서 실행됩니다. 원격 서비스로 전송되는 데이터는 없습니다.
+</Note>
+
+---
+
+## 데이터 저장
+
+모든 설정 및 로그는 로컬 머신에 저장됩니다:
+
+| 경로 | 저장 내용 |
+|------|----------------|
+| `~/.failproofai/policies-config.json` | 전역 정책 설정 |
+| `~/.failproofai/hook-activity.jsonl` | 훅 실행 기록 |
+| `~/.failproofai/hook.log` | 커스텀 훅 오류 디버그 로그 |
+| `.failproofai/policies-config.json` | 프로젝트별 설정 (커밋됨) |
+| `.failproofai/policies-config.local.json` | 개인 재정의 설정 (gitignore 처리됨) |
+
+---
+
+## 제거
+
+```bash
+failproofai policies --uninstall
+```
+
+`~/.claude/settings.json`에서 훅 항목을 제거합니다. `~/.failproofai/`의 설정 파일은 유지됩니다.
+
+---
+
+## 다음 단계
+
+<CardGroup cols={2}>
+
+<Card title="설정" icon="gear" href="/ko/configuration">
+  스코프 및 설정 파일 형식
+</Card>
+
+<Card title="기본 제공 정책" icon="shield" href="/ko/built-in-policies">
+  파라미터를 포함한 26가지 정책 전체 목록
+</Card>
+
+<Card title="커스텀 정책" icon="code" href="/ko/custom-policies">
+  JavaScript로 나만의 정책 작성하기
+</Card>
+
+<Card title="에이전트 모니터" icon="chart-line" href="/ko/dashboard">
+  세션 모니터링 및 정책 활동 검토
+</Card>
+
+</CardGroup>

package/.next/standalone/docs/ko/introduction.mdx

@@ -0,0 +1,57 @@
+---
+title: Failproof AI
+description: "AI 에이전트를 안정적으로 자율 운영할 수 있도록 훅과 정책을 관리합니다"
+---
+
+[![npm weekly downloads](https://img.shields.io/npm/dw/failproofai?style=flat-square&color=2ea44f)](https://www.npmjs.com/package/failproofai)
+
+**Claude Code** 및 **Agents SDK**를 위한 훅과 정책으로 AI 에이전트를 안정적으로 자율 운영하세요.
+
+AI 에이전트는 예측 가능한 방식으로 실패합니다. 파괴적인 명령을 실행하거나, 시크릿을 유출하거나, 작업 범위를 벗어나거나, 루프에 빠지거나, main 브랜치에 직접 푸시하기도 합니다. 방치하면 작은 실패가 연쇄적으로 커집니다.
+
+Failproof AI는 **정책(policies)** 으로 이 문제를 해결합니다. 정책은 에이전트의 모든 도구 호출에 훅으로 연결되어 **장애를 감지**하고, **완화 조치**(차단, 지시, 정제)를 취하며, 주의가 필요한 상황이 발생하면 **알림을 보냅니다**. 로컬 대시보드에서 이후에 모든 내용을 검토할 수 있습니다.
+
+모든 처리는 로컬에서 이루어집니다. 데이터가 외부로 전송되지 않습니다.
+
+## 시작하기
+
+<CardGroup cols={2}>
+
+<Card title="26개의 내장 정책" icon="shield" href="/ko/built-in-policies">
+  파괴적인 명령 차단, 시크릿 유출 방지, 에이전트를 프로젝트 범위 내로 제한하는 등 다양한 기능을 즉시 사용할 수 있습니다.
+</Card>
+
+<Card title="커스텀 정책" icon="code" href="/ko/custom-policies">
+  간단한 allow / deny / instruct API를 사용해 JavaScript로 나만의 규칙을 작성하세요.
+</Card>
+
+<Card title="에이전트 모니터" icon="chart-line" href="/ko/dashboard">
+  자리를 비운 사이 에이전트가 무엇을 했는지 확인하세요. 세션을 탐색하고, 도구 호출을 검사하며, 정책이 발동된 지점을 검토할 수 있습니다.
+</Card>
+
+<Card title="간편한 설정" icon="gear" href="/ko/configuration">
+  코드 없이 모든 정책을 조정하세요. 프로젝트별 또는 전역으로 허용 목록, 보호 브랜치, 임계값을 설정할 수 있습니다.
+</Card>
+
+</CardGroup>
+
+## 빠른 시작
+
+<CodeGroup>
+
+```bash npm
+npm install -g failproofai
+```
+
+```bash bun
+bun add -g failproofai
+```
+
+</CodeGroup>
+
+```bash
+failproofai policies --install   # 정책 활성화
+failproofai                      # 대시보드 실행
+```
+
+전체 안내는 [시작 가이드](/ko/getting-started)를 참고하세요.