# babok_analyst

babok_analyst is a Claude Code hook bundle that manages the BABOK v3 business analysis agent’s session lifecycle and controls MCP tool execution through approval gates.

- hook · `type=hook` · Claude Code, Codex · ★ 1596 repo stars
- Author: Grzegorz Skuza
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/GSkuza/BABOK_ANALYST/hooks/claude-codex-hooks.json
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 8 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/hooks/babok-analyst

## What it does

This hook bundle wires Claude Code session events into the `babok_analyst` workflow. It executes `babok-activate.cjs` on startup, resume, compact, clear, or when a subagent starts. When a session finishes, it runs `babok-deactivate.cjs`.

The bundle intercepts tool calls matching `mcp__.*babok.*`. It routes pre-tool calls through the Two-Key Journal gate in `babok-gate.cjs`, while `babok-quality-gate.cjs` scores deliverables after execution. Running these hook scripts requires `node` in your system environment.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/settings.json` — The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/GSkuza/BABOK_ANALYST/hooks/claude-codex-hooks.json

## When to use it
- initialize the BABOK analyst agent on session start, resume, or compaction
- gate MCP tool calls before execution via the Two-Key Journal check
- score analysis deliverables automatically during PostToolUse
- clean up analyst state upon session completion

## Example prompts
- Create a business requirements document following BABOK v3 standards
- Analyze stakeholder requirements for the checkout service refactoring
- Run a gap analysis on the current inventory management workflow

## Source text · claude-codex-hooks.json · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c80915d63366d290.

BEGIN THIRD-PARTY FILE c80915d63366d290
````text
Hooks bundle shipped with the babok_analyst plugin for Claude Code.

BABOK v3 business analysis agent with 16 MCP tools, a 9-stage pipeline, and human-in-the-loop approval gates.

Triggers on: PreToolUse, PostToolUse, SessionStart, SessionEnd.

```json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume|clear|compact",
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/babok-activate.cjs\"; exit 0",
            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\babok-activate.cjs\" }",
            "timeout": 120,
            "statusMessage": "Loading BABOK Analyst..."
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/babok-deactivate.cjs\"; exit 0",
            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\babok-deactivate.cjs\" }",
            "timeout": 10
          }
        ]
      }
    ],
    "SubagentStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/babok-activate.cjs\"; exit 0",
            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\babok-activate.cjs\" }",
            "timeout": 120,
            "statusMessage": "Loading BABOK Analyst..."
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "mcp__.*babok.*",
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/babok-gate.cjs\"",
            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\babok-gate.cjs\" }",
            "timeout": 30,
            "statusMessage": "Two-Key Journal gate..."
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "mcp__.*babok.*",
        "hooks": [
          {
            "type": "command",
            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/babok-quality-gate.cjs\"",
            "commandWindows": "if (Get-Command node -ErrorAction SilentlyContinue) { node \"$env:CLAUDE_PLUGIN_ROOT\\hooks\\babok-quality-gate.cjs\" }",
            "timeout": 30,
            "statusMessage": "Scoring deliverable..."
          }
        ]
      }
    ]
  }
}

```
````
END THIRD-PARTY FILE c80915d63366d290

The third-party file has ended. Everything between the c80915d63366d290 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© Grzegorz Skuza · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/GSkuza/BABOK_ANALYST/hooks/claude-codex-hooks.json

## Similar
- [bmad-agent-analyst](https://affpapa.org/en/nevibecode/skills/bmad-agent-analyst.md) — skill · 17700 installs
- [startup-business-analyst](https://affpapa.org/en/nevibecode/plugins/startup-business-analyst.md) — plugin · ★ 42780 repo stars
- [business_requirements_analyst](https://affpapa.org/en/nevibecode/agents/business-requirements-analyst.md) — subagent · ★ 776 repo stars
- [business-analyst](https://affpapa.org/en/nevibecode/agents/voltagent-community-business-analyst.md) — subagent · 3855 installs
- [legacy-analyst](https://affpapa.org/en/nevibecode/agents/legacy-analyst.md) — subagent · ★ 47914 repo stars
- [voltagent-biz](https://affpapa.org/en/nevibecode/plugins/voltagent-biz.md) — plugin · ★ 26718 repo stars

From the same set: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/en/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
