उदाहरण

सामान्य परिदृश्यों के लिए तुरंत उपयोग के लिए तैयार उदाहरण। प्रत्येक दिखाता है कि कैसे इंस्टॉल करें और क्या उम्मीद करनी चाहिए।

Claude Code के लिए hooks सेट अप करना

Failproof AI Claude Code के साथ इसके hooks system के माध्यम से एकीकृत होता है। जब आप failproofai policies --install चलाते हैं, तो यह Claude Code के settings.json में hook कमांड्स को रजिस्टर करता है जो हर tool कॉल पर चलते हैं।

failproofai इंस्टॉल करें

npm install -g failproofai

सभी built-in policies सक्षम करें

failproofai policies --install

Hooks रजिस्टर हैं यह सत्यापित करें

cat ~/.claude/settings.json | grep failproofai

आपको PreToolUse, PostToolUse, Notification, और Stop events के लिए hook entries दिखाई देने चाहिए।

Claude Code चलाएं

claude

Policies अब हर tool कॉल पर स्वचालित रूप से चलते हैं। Claude से sudo rm -rf / चलाने के लिए कहने का प्रयास करें - यह ब्लॉक किया जाएगा।

Agents SDK के लिए hooks सेट अप करना

यदि आप Agents SDK के साथ निर्माण कर रहे हैं, तो आप समान hook system को प्रोग्रामेटिक रूप से उपयोग कर सकते हैं।

अपने प्रोजेक्ट में failproofai इंस्टॉल करें

npm install failproofai

अपने agent में hooks कॉन्फ़िगर करें

अपने agent process को बनाते समय hook कमांड्स पास करें। Hooks Claude Code की तरह ही काम करते हैं - stdin/stdout JSON के माध्यम से:

failproofai --hook PreToolUse   # प्रत्येक tool से पहले कॉल किया जाता है
failproofai --hook PostToolUse  # प्रत्येक tool के बाद कॉल किया जाता है

अपने agent के लिए एक custom policy लिखें

import { customPolicies, allow, deny } from "failproofai";

customPolicies.add({
  name: "limit-to-project-dir",
  description: "Agent को प्रोजेक्ट डायरेक्टरी के अंदर रखें",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    const path = String(ctx.toolInput?.file_path ?? "");
    if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
      return deny("Agent प्रोजेक्ट डायरेक्टरी तक सीमित है");
    }
    return allow();
  },
});

Custom policy इंस्टॉल करें

failproofai policies --install --custom ./my-agent-policies.js

विनाशकारी कमांड्स को ब्लॉक करें

सबसे सामान्य सेटअप - agents को अपरिवर्तनीय नुकसान से बचाएं।

failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh

यह क्या करता है:

block-sudo - सभी sudo कमांड्स को ब्लॉक करता है
block-rm-rf - recursive file deletion को ब्लॉक करता है
block-force-push - git push --force को ब्लॉक करता है
block-curl-pipe-sh - दूरस्थ scripts को shell में piping करने को ब्लॉक करता है

Secret leakage को रोकें

Agents को tool output में credentials को देखने या leak करने से रोकें।

failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens

ये PostToolUse पर चलते हैं - एक tool के चलने के बाद, वे output को agent से देखने से पहले साफ करते हैं।

जब agents को ध्यान की आवश्यकता हो तो Slack alerts प्राप्त करें

Notification hook का उपयोग करके idle alerts को Slack में भेजें।

import { customPolicies, allow, instruct } from "failproofai";

customPolicies.add({
  name: "slack-on-idle",
  description: "जब agent input के लिए प्रतीक्षा कर रहा हो तो Slack को alert करें",
  match: { events: ["Notification"] },
  fn: async (ctx) => {
    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
    if (!webhookUrl) return allow();

    const message = String(ctx.payload?.message ?? "Agent प्रतीक्षा कर रहा है");
    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 तक नहीं पहुंचा जा सकता तो कभी भी agent को ब्लॉक न करें
    }

    return allow();
  },
});

इसे इंस्टॉल करें:

SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js

Agents को एक branch पर रखें

Agents को branches को switch करने या protected branches में push करने से रोकें।

import { customPolicies, allow, deny } from "failproofai";

customPolicies.add({
  name: "stay-on-branch",
  description: "Agent को अन्य branches को checkout करने से रोकें",
  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("वर्तमान branch पर रहें। यदि आवश्यक हो तो -b के साथ एक नई branch बनाएं।");
    }
    return allow();
  },
});

Commits से पहले tests की आवश्यकता करें

Agents को commit से पहले tests चलाने के लिए याद दिलाएं।

import { customPolicies, allow, instruct } from "failproofai";

customPolicies.add({
  name: "test-before-commit",
  description: "Agent को commit से पहले tests चलाने के लिए याद दिलाएं",
  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("Commit से पहले tests चलाएं। पहले `npm test` या `bun test` का उपयोग करें।");
    }
    return allow();
  },
});

एक production repo को lock down करें

एक project-level config को commit करें ताकि आपकी team के हर developer को समान policies मिलें। अपने repo में .failproofai/policies-config.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"]
    }
  }
}

फिर इसे commit करें:

git add .failproofai/policies-config.json
git commit -m "Add failproofai team policies"

हर team member जिसके पास failproofai इंस्टॉल है, ये rules स्वचालित रूप से pick up करेगा।

Convention policies के साथ एक org-wide quality standard बनाएं

सबसे प्रभावशाली सेटअप: अपने repo में .failproofai/policies/ को commit करें जिसमें आपके project के लिए tailored policies हों। हर team member को वे स्वचालित रूप से मिलते हैं — कोई install कमांड नहीं, कोई config changes नहीं।

डायरेक्टरी बनाएं और policies जोड़ें

mkdir -p .failproofai/policies

// .failproofai/policies/team-policies.mjs
import { customPolicies, allow, deny, instruct } from "failproofai";

// अपनी team की preferred package manager को enforce करें
// (या इसके बजाय built-in prefer-package-manager policy को enable करें)
customPolicies.add({
  name: "enforce-bun",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Bash") return allow();
    const cmd = String(ctx.toolInput?.command ?? "");
    if (/\bnpm\b/.test(cmd)) return deny("npm के बजाय bun का उपयोग करें।");
    return allow();
  },
});

// Agent को commit से पहले tests चलाने के लिए याद दिलाएं
customPolicies.add({
  name: "test-before-commit",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Bash") return allow();
    if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
      return instruct("Commit से पहले tests चलाएं।");
    }
    return allow();
  },
});

Git में commit करें

git add .failproofai/policies/
git commit -m "Add team quality policies"

सुधार करते रहें

जब आपकी team को नई failure modes का सामना करना पड़े, policies जोड़ें और push करें। हर कोई अपने अगले git pull पर update प्राप्त करेगा। ये policies एक living quality standard बन जाते हैं जो आपकी team के साथ बढ़ते हैं।

और उदाहरण

Repo में examples/ डायरेक्टरी में शामिल हैं:

File	यह क्या दिखाता है
`policies-basic.js`	Starter policies - production writes, force-push, piped scripts को block करें
`policies-notification.js`	Idle notifications और session end के लिए Slack alerts
`policies-advanced/index.js`	Transitive imports, async hooks, PostToolUse output scrubbing, Stop event handling

शुरू करें

मूल अवधारणाएँ

CLI

उपकरण

उन्नत

उदाहरण

Claude Code के लिए hooks सेट अप करना

Agents SDK के लिए hooks सेट अप करना

विनाशकारी कमांड्स को ब्लॉक करें

Secret leakage को रोकें

जब agents को ध्यान की आवश्यकता हो तो Slack alerts प्राप्त करें

Agents को एक branch पर रखें

Commits से पहले tests की आवश्यकता करें

एक production repo को lock down करें

Convention policies के साथ एक org-wide quality standard बनाएं

और उदाहरण

​Claude Code के लिए hooks सेट अप करना

​Agents SDK के लिए hooks सेट अप करना

​विनाशकारी कमांड्स को ब्लॉक करें

​Secret leakage को रोकें

​जब agents को ध्यान की आवश्यकता हो तो Slack alerts प्राप्त करें

​Agents को एक branch पर रखें

​Commits से पहले tests की आवश्यकता करें

​एक production repo को lock down करें

​Convention policies के साथ एक org-wide quality standard बनाएं

​और उदाहरण

Claude Code के लिए hooks सेट अप करना

Agents SDK के लिए hooks सेट अप करना

विनाशकारी कमांड्स को ब्लॉक करें

Secret leakage को रोकें

जब agents को ध्यान की आवश्यकता हो तो Slack alerts प्राप्त करें

Agents को एक branch पर रखें

Commits से पहले tests की आवश्यकता करें

एक production repo को lock down करें

Convention policies के साथ एक org-wide quality standard बनाएं

और उदाहरण