BABOK Analyst - AI-Powered Business Analysis Agent

An AI agent for professional business analysis compliant with BABOK v3 (International Institute of Business Analysis) standard. Guides the analyst step-by-step through 8 stages - from project initialization to business case with ROI calculation.

What is BABOK Analyst?

BABOK Analyst is a set of system prompts for AI models (Claude, ChatGPT, other LLMs) that transforms them into business analysis experts. The agent:

Conducts a structured analysis process in 9 stages (Stage 0 charter gate + Stages 1-8)
Uses Short Rationale + Evidence methodology (concise conclusions with cited evidence)
Requires human approval at each stage (human-in-the-loop)
Generates complete project documentation in Markdown format
Manages project lifecycle with unique Project IDs, save/load, and persistent journal logs
Specializes in IT projects for mid-market companies (€10-100M revenue, 50-500 employees)

Repository Structure

BABOK_ANALYST/
|
|-- BABOK_AGENT/                          # Agent files
|   |-- BABOK_Agent_System_Prompt.md      # Main system prompt (modular, references stage files)
|   |-- BABOK_Agent_Quick_Start_Guide.md  # Quick start guide
|   |-- BABOK_Project_Structure_Template.md # Generic project folder structure template
|   |-- stages/                           # Individual stage instruction files
|   |   |-- BABOK_agent_stage_0.md        # Stage 0: Project Charter
|   |   |-- BABOK_agent_stage_1.md        # Stage 1: Project Initialization
|   |   |-- BABOK_agent_stage_2.md        # Stage 2: Current State Analysis
|   |   |-- BABOK_agent_stage_3.md        # Stage 3: Problem Domain Analysis
|   |   |-- BABOK_agent_stage_4.md        # Stage 4: Solution Requirements
|   |   |-- BABOK_agent_stage_5.md        # Stage 5: Future State Design
|   |   |-- BABOK_agent_stage_6.md        # Stage 6: Gap Analysis & Roadmap
|   |   |-- BABOK_agent_stage_7.md        # Stage 7: Risk Assessment
|   |   |-- BABOK_agent_stage_8.md        # Stage 8: Business Case & ROI
|   |-- LLM_BABOK_AGENT/                  # Standalone prompt for LLM chat
|   |   |-- BABOK_Agent_LLM_Prompt.md     # Self-contained prompt (all stages inline)
|
|-- cli/                                  # Node.js CLI tool
|   |-- bin/babok.js                      # CLI entry point
|   |-- src/commands/                     # Command implementations
|   |-- src/lock.js                       # File-locking for team collaboration (NEW v2.0.1)
|   |-- src/llm.js                        # Multi-provider LLM integration & keystore
|   |-- src/journal.js                    # Project journal management
|   |-- src/project.js                    # Project ID generation
|   |-- src/display.js                    # Terminal output formatting
|   |-- package.json                      # npm package configuration
|   |-- README.md                         # CLI Quick Start Guide
|
|-- babok-mcp/                            # MCP Server (v2.0)
|   |-- bin/babok-mcp.js                  # Entry point (npx babok-mcp)
|   |-- src/server.js                     # MCP server — 10 tools + 9 resources
|   |-- src/lib/project.js                # Project ID & path resolution
|   |-- src/lib/journal.js                # Journal CRUD + stage transitions
|   |-- src/test/smoke.js                 # 10-assertion smoke test suite
|   |-- setup.bat                         # One-click MCP installer (Windows) (NEW v2.0.2)
|   |-- package.json                      # npm package (babok-mcp)
|   |-- README.md                         # Setup guide for Claude/Cursor/VS Code
|   |-- babok-mcp-user-manual.md          # Full user manual (EN) (NEW v2.0.2)
|
|-- setup.bat                             # One-click installer (Windows) (NEW v2.0.1)
|-- setup.sh                              # One-click installer (Linux/macOS) (NEW v2.0.1)
|-- babok-mcp-podrecznik uzytkownika.md   # Full MCP user manual (PL) (NEW v2.0.2)
|-- babok-mcp-user-manual.md              # Full MCP user manual (EN) (NEW v2.0.2)
|
|-- .github/
|   |-- copilot-instructions.md           # Configuration for GitHub Copilot / VS Code
|   |-- workflows/
|   |   |-- lint-prompts.yml              # CI: validates stage files on every push
|
|-- .gitignore                            # Excludes local analysis files
|-- README.md                             # This file

Stages

Stage	Name	What You Get
Stage 0 ⭐	Project Charter	Business trigger, sponsor sign-off, scope boundary, Go/No-Go gate
Stage 1	Project Initialization & Stakeholder Mapping	Project scope, stakeholder register, success criteria
Stage 2	Current State Analysis (AS-IS)	Process maps, cost baseline, system analysis
Stage 3	Problem Domain Analysis	Problem categorization, root cause analysis, prioritization
Stage 4	Solution Requirements Definition	Functional/non-functional requirements, user stories, MoSCoW
Stage 5	Future State Design (TO-BE)	Target architecture, TO-BE processes
Stage 6	Gap Analysis & Implementation Roadmap	Gap analysis, implementation roadmap
Stage 7	Risk Assessment & Mitigation Strategy	Risk register, mitigation plans
Stage 8	Business Case & ROI Model	Financial model, ROI, NPV, payback period

Modular Architecture (v2.0)

The agent system uses a modular architecture where each analysis stage has its own detailed instruction file:

BABOK_AGENT/
|-- BABOK_Agent_System_Prompt.md          # Core prompt (references stage files)
|-- stages/
|   |-- BABOK_agent_stage_0.md            # Stage 0: Project Charter gate
|   |-- BABOK_agent_stage_1.md            # Detailed Stage 1 instructions
|   |-- BABOK_agent_stage_2.md            # Detailed Stage 2 instructions
|   |-- ...                               # Stages 3-7
|   |-- BABOK_agent_stage_8.md            # Detailed Stage 8 instructions
|-- LLM_BABOK_AGENT/
|   |-- BABOK_Agent_LLM_Prompt.md         # All-in-one prompt for LLM chat windows

Two usage variants:

Variant	File	Use When
Modular	`BABOK_Agent_System_Prompt.md` + `stages/*.md`	VS Code, Claude Code, IDE-based workflows (agent can load stage files as needed)
Standalone	`LLM_BABOK_AGENT/BABOK_Agent_LLM_Prompt.md`	Direct paste into LLM chat (Claude.ai, ChatGPT, etc.) — all stages inline, self-contained

Each stage file contains: step-by-step process, questions for human, deliverable template, quality checklist, and CLI command references.

How to Get Started

Quick Start (non-technical users) — NEW in v2.0.1

Windows:

setup.bat

Linux / macOS:

chmod +x setup.sh && ./setup.sh

The setup script automatically:

checks for Node.js (with download link if missing)
runs npm install
optionally adds babok to PATH
launches the interactive setup wizard (babok setup) for API key entry and language selection — no JSON editing required

Method 1: Claude.ai (Projects)

Clone or download the repository (see section below)
Go to claude.ai and create a new Project
In project settings, click "Project Instructions" (Custom Instructions)
Copy the entire content of BABOK_AGENT/LLM_BABOK_AGENT/BABOK_Agent_LLM_Prompt.md file and paste it into the Project Instructions field
Start a new conversation in the project and type:
```
BEGIN NEW PROJECT
```

Method 2: VS Code with Claude Code (CLI)

Clone the repository:

git clone https://github.com/GSkuza/BABOK_ANALYST.git
cd BABOK_ANALYST

Install Claude Code (requires Node.js 18+):
```
npm install -g @anthropic-ai/claude-code
```
Launch Claude Code in the project directory:
```
claude
```
Claude will automatically load the configuration from .github/copilot-instructions.md
Type:
```
BEGIN NEW PROJECT
```

Method 3: VS Code with GitHub Copilot Chat

Clone the repository and open in VS Code:

git clone https://github.com/GSkuza/BABOK_ANALYST.git
code BABOK_ANALYST

Make sure you have the GitHub Copilot Chat extension installed
Copilot will automatically load instructions from .github/copilot-instructions.md
Open Copilot Chat (Ctrl+Shift+I) and type:
```
BEGIN NEW PROJECT
```

Method 4: ChatGPT or other LLM

Download the content of BABOK_AGENT/LLM_BABOK_AGENT/BABOK_Agent_LLM_Prompt.md file
In ChatGPT: Settings -> "Custom Instructions" or "System Prompt"
Paste the file content as system instructions
Start a new conversation and type:
```
BEGIN NEW PROJECT
```

Method 5: API (Anthropic, OpenAI, others)

Use the content of BABOK_Agent_LLM_Prompt.md as the system parameter in the API call:

import anthropic

client = anthropic.Anthropic()

with open("BABOK_AGENT/LLM_BABOK_AGENT/BABOK_Agent_LLM_Prompt.md") as f:
    system_prompt = f.read()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=8192,
    system=system_prompt,
    messages=[{"role": "user", "content": "BEGIN NEW PROJECT"}]
)

BABOK CLI Tool

The repository includes a cross-platform CLI tool for managing project lifecycle directly from the terminal. The CLI handles project creation, state tracking via journal files, stage management, and interactive AI chat with multiple LLM providers — independently of any specific AI platform.

Installation

Requires Node.js 18+.

Option A — one-click installer (recommended for non-technical users):

# Windows
setup.bat

# Linux / macOS
chmod +x setup.sh && ./setup.sh

Option B — manual:

git clone https://github.com/GSkuza/BABOK_ANALYST.git
cd BABOK_ANALYST/cli
npm install
npm link        # Makes 'babok' command available globally

After manual install, run the setup wizard for first-time configuration:

babok setup

CLI Commands

Command	Description
`babok setup`	First-time setup wizard — API keys, language, optional first project (NEW v2.0.1)
`babok new [--name "Name"]`	Create a new project with unique ID and timestamp
`babok list`	List all projects with current status
`babok status [id]`	Show detailed project status (all stages)
`babok load <id>`	Load project context (generates text to paste into AI chat)
`babok save <id>`	Save current project state snapshot
`babok rename <id> [new-name]`	Rename a project (NEW v2.0.1)
`babok delete <id>`	Permanently delete a project with confirmation (NEW v2.0.1)
`babok approve <id> <stage>`	Mark a stage as approved, advance to next (stages 0–8)
`babok reject <id> <stage> -r "reason"`	Reject a stage with reason
`babok diff <id> [--stage N]`	Show stage history and deliverable preview
`babok diff <id1> <id2> [--stage N]`	Line diff between two projects' deliverables
`babok export <id>`	Export project deliverables to output directory
`babok chat <id>`	Interactive AI chat for current stage
`babok run [--context file.json]`	Automated 8-stage pipeline (interactive or `--auto`)
`babok make docx <id>`	Generate DOCX document(s) from stage files
`babok make pdf <id>`	Generate PDF document(s) from stage files
`babok make all <id>`	Generate DOCX + PDF in one run
`babok llm list`	List all available AI models
`babok llm change`	Interactively switch AI provider/model
`babok lang [EN\|PL]`	Set or show interface language

Stage diff

Inspect and compare deliverables directly from the terminal:

# Show stage history + deliverable preview for a single project
babok diff K7M3
babok diff K7M3 --stage 3

# Line-by-line diff between two project versions (e.g. rejected vs reworked)
babok diff K7M3 R9TN
babok diff K7M3 R9TN --stage 4 --context 5

The two-project diff uses LCS to produce colored + / - output — no external tools needed.

Document export (DOCX/PDF)

In addition to raw Markdown exports, the CLI can generate CEO-ready DOCX and PDF documents directly from stage files:

# DOCX only
babok make docx <project_id>
babok make docx <project_id> --stage 1      # only Stage 1

# PDF only
babok make pdf <project_id>

# DOCX + PDF in one run
babok make all <project_id>

Works on STAGE_XX_*.md files generated by the agent
Applies professional corporate styling (tables, headings, headers/footers)
Default output directory: <project_dir>/exports (configurable via --output)

Quick Example

# First-time setup
babok setup

# Create a new project
babok new --name "ERP Integration"
# Output: Project ID: BABOK-20260208-K7M3

# Check all projects
babok list

# Approve Stage 1 after completing it in AI chat
babok approve K7M3 1

# View detailed status
babok status K7M3

# Load context for AI chat (copy & paste the output)
babok load K7M3

# Start interactive AI chat for current stage
babok chat K7M3

# Rename a project
babok rename K7M3 "ERP Integration v2"

# Delete a project (prompts confirmation)
babok delete K7M3

# Export deliverables when done
babok export K7M3

Partial IDs work — babok status K7M3 matches BABOK-20260208-K7M3.

For the full CLI guide, see: cli/README.md

Team Collaboration & File Locking — NEW in v2.0.1

When multiple analysts work on the same project directory (e.g. on a shared network drive), concurrent edits to the same stage can overwrite each other. v2.0.1 introduces automatic file locking:

When babok chat or babok run starts working on a stage, a lock file is created: <project_dir>/.stage_N.lock
The lock file records: locked_by, hostname, pid, locked_at

If another user tries to open the same stage, they get a clear error:

⛔ Stage 3 is currently locked by another user:
   anna@WORKSTATION-02 (PID 14872), locked 12 min ago

Locks older than 2 hours are automatically treated as stale and removed
Lock files are excluded from git (.gitignore)

Recommendation: Store the projects/ directory on a shared network drive or sync folder for team use. Each analyst works on separate stages to avoid contention.

MCP Server — `babok-mcp` (v2.0)

The biggest differentiator. Claude and other MCP-compatible AI assistants can now manage your BABOK project lifecycle without leaving the chat interface.

The babok-mcp package is a Model Context Protocol server that exposes 10 tools and 9 resources to any compatible AI client.

Setup (Claude Desktop / Claude Code)

Windows (one-click):

cd BABOK_ANALYST/babok-mcp
setup.bat

Manual:

cd BABOK_ANALYST/babok-mcp
npm install

Add to claude_desktop_config.json (or .claude/mcp.json for Claude Code):

{
  "mcpServers": {
    "babok": {
      "command": "node",
      "args": ["D:/BABOK_ANALYST/babok-mcp/bin/babok-mcp.js"],
      "env": {
        "BABOK_PROJECTS_DIR": "D:/BABOK_ANALYST/projects",
        "BABOK_AGENT_DIR": "D:/BABOK_ANALYST/BABOK_AGENT/stages"
      }
    }
  }
}

Restart Claude Desktop — a 🔧 tool icon confirms the server is connected.

Available Tools

Tool	What it does
`babok_new_project`	Create a new project, get ID
`babok_list_projects`	List all projects with stage + status
`babok_get_stage`	Full stage context: prompt + journal + existing deliverable
`babok_approve_stage`	Approve stage, advance to next
`babok_get_deliverable`	Read a completed stage MD file
`babok_save_deliverable`	Persist AI-generated content to project dir
`babok_search`	Full-text search across all project files
`babok_export`	Copy all deliverables to an export directory
`babok_rename_project`	Rename a project (NEW v2.0.1)
`babok_delete_project`	Delete a project with explicit confirmation (NEW v2.0.1)

Example flow in Claude

You:    "Start a new BABOK project for SAP integration at Acme Corp"

Claude: [babok_new_project → BABOK-20260316-K7M3]
        [babok_get_stage stage_n=0 → loads Stage 0 Charter prompt]
        → asks 3 questions about business trigger, sponsor, scope

You:    [answers]

Claude: [babok_save_deliverable stage_n=0 content="..."]
        [babok_approve_stage stage_n=0]
        → "Stage 0 approved. Moving to Stage 1: Stakeholder Mapping."

For the full MCP guide, see: babok-mcp/README.md

AI Chat in Terminal (`babok chat`)

The babok chat command starts an interactive AI conversation in the terminal, contextually aware of your project stage. It supports 5 LLM providers — choose the one you prefer.

Supported Providers

Provider	Models	Get API Key
Google Gemini	`gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-1.5-flash`	aistudio.google.com
OpenAI	`gpt-4.1`, `gpt-4.1-mini`, `gpt-4o`, `gpt-4o-mini`, `o3-mini`	platform.openai.com
Anthropic Claude	`claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-haiku`, `claude-3-opus`	console.anthropic.com
Hugging Face	`Qwen2.5-72B`, `Llama-3.3-70B`, `DeepSeek-R1`, `Bielik-11B`	huggingface.co
Google Vertex AI	`gemini-2.5-pro-exp`, `gemini-2.0-flash`	cloud.google.com

Usage

# Interactive provider selection (first run)
babok chat K7M3

# Specify provider and stage
babok chat K7M3 --provider openai --stage 3

# Specify custom model
babok chat K7M3 --provider anthropic --model claude-3-7-sonnet-20250219

# Use Hugging Face
babok chat K7M3 -p huggingface -m "Qwen/Qwen2.5-72B-Instruct"

Chat Commands (inside session)

Command	Description
`/exit`, `/quit`	End chat session (auto-saves, releases stage lock)
`/save`	Save conversation to project
`/clear`	Clear conversation history
`/stage N`	Switch to stage N (1-8)
`/status`	Show project status
`/provider`	Show current provider & model
`/llm`	Change AI provider/model mid-session
`/key`	API key management info
`/key clear [provider]`	Remove stored key(s)
`/help`	Show all commands

Features

Streaming responses — real-time output from LLM
Stage context — system prompt includes project info, stage instructions, decisions, and history
Auto-save — conversation saved every 5 messages and on exit
Conversation history — resume where you left off per stage
Switch stages — /stage N to jump between stages mid-session
File locking — stage locked on start, released on exit (prevents team conflicts)

API Key Security

All API keys are secured and never committed to the repository.

Key Storage Hierarchy

Priority	Source	Security Level
1	Environment variable (`GEMINI_API_KEY`, `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `HF_API_KEY`)	Session-only, in memory
2	`.env` file	Gitignored, plaintext local file
3	`.babok_keystore`	Gitignored, encrypted with machine-specific key
4	`babok setup` wizard	Prompted interactively, saved to keystore

How It Works

First run: run babok setup (or setup.bat / setup.sh) — wizard guides you through provider selection and key entry
Key encryption: The key is XOR-encrypted using a SHA-256 hash derived from hostname + username + working directory — the encrypted file is useless on another machine or repo clone
Gitignored: .babok_keystore, .env, and .env.* are all in .gitignore
No keys in config: agent_config.json (tracked by git) contains zero API keys
Per-provider storage: Each provider's key is stored independently — you can have keys for all 5 providers

Setting Up API Keys

Option A: Setup wizard (recommended)

babok setup
# → Select language → select provider → paste key → test connection

Option B: Environment variables

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-..."
$env:GEMINI_API_KEY = "AI..."
$env:ANTHROPIC_API_KEY = "sk-ant-..."
$env:HF_API_KEY = "hf_..."

# Linux/macOS
export OPENAI_API_KEY="sk-..."

Option C: .env file (gitignored)

GEMINI_API_KEY=AI...
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
HF_API_KEY=hf_...

Removing Stored Keys

# Inside chat session:
/key clear              # Remove all stored keys
/key clear openai       # Remove only OpenAI key

# Or delete the keystore file directly:
# Windows: del .babok_keystore
# Linux:   rm .babok_keystore

Cloning the Repository

Requirements

Git installed on your computer (installation guide)
Optional: VS Code or other code editor

Cloning via HTTPS

git clone https://github.com/GSkuza/BABOK_ANALYST.git

Cloning via SSH

git clone git@github.com:GSkuza/BABOK_ANALYST.git

Cloning via GitHub CLI

gh repo clone GSkuza/BABOK_ANALYST

Download ZIP (without Git)

Go to https://github.com/GSkuza/BABOK_ANALYST
Click the green "Code" button
Select "Download ZIP"
Extract the archive to your chosen location

How to Work with the Agent

Communication Format

The agent asks questions in a structured format:

RATIONALE: [Concise conclusion with key assumptions]
EVIDENCE: [Data source: Stage N, stakeholder input, industry standard]

QUESTIONS FOR HUMAN:
1. [Question 1]
2. [Question 2]
...

WAIT FOR HUMAN INPUT.

Sequential questions

The agent uses a sequential questioning protocol inside each stage:

Questions are asked one-by-one with a progress indicator (e.g. STAGE 1 - QUESTION 1/5, then QUESTION 2/5, etc.)
After each answer the agent shows a short confirmation, e.g. ✅ Answer recorded: [summary]
Before generating the stage deliverable, the agent presents a summary of all your answers for that step/stage

You can control the flow using high-level commands:

Next question – skip current question and move to the next
Previous question – go back to the previous question (within the same step)
Skip questions – show all remaining questions at once (batch mode)

How to Respond

Respond specifically, using question numbering:

1. YES - all documents in scope: invoices, delivery notes, orders
2. ERP: SAP Business One v10.0
3. Accounting: Comarch ERP Optima v2024.1
4. We don't currently have a DMS
5. KSeF deadline: July 1, 2026

If you don't know something:

I DON'T KNOW - I need to check with [person/department]

Control Commands

Command	Action
`BEGIN NEW PROJECT`	Start a new project with unique ID and timestamp
`SAVE PROJECT`	Save project state (available after completing a stage)
`LOAD PROJECT [project_id]`	Resume a saved project at the last active stage
`Approve [N]`	Approve stage N and proceed to next
`Reject [N] [reason]`	Reject stage N with reason
`Status`	Display progress of all stages for current project
`Pause`	Pause current session (auto-saves to journal)
`Export all`	Export all completed stage deliverables
`Deep analysis [topic]`	Activate deep reasoning for critical decisions
`Help`	Show all available commands

Output Files

Each project gets its own directory identified by a unique Project ID (e.g., BABOK-20260208-M3R1). The agent generates Markdown documents for each stage plus a persistent journal log:

BABOK_Analysis/
└── BABOK-20260208-M3R1/                    # Project directory (unique per project)
    ├── PROJECT_JOURNAL_BABOK-20260208-M3R1.json  # State tracking journal
    ├── STAGE_00_Project_Charter.md
    ├── STAGE_01_Project_Initialization.md
    ├── STAGE_02_Current_State_Analysis.md
    ├── STAGE_03_Problem_Domain_Analysis.md
    ├── STAGE_04_Solution_Requirements.md
    ├── STAGE_05_Future_State_Design.md
    ├── STAGE_06_Gap_Analysis_Roadmap.md
    ├── STAGE_07_Risk_Assessment.md
    ├── STAGE_08_Business_Case_ROI.md
    └── FINAL_Complete_Documentation.md

The Project Journal (PROJECT_JOURNAL_*.json) tracks all stage transitions, approvals, decisions, and assumptions — enabling exact state restoration with LOAD PROJECT.

Estimated Timeline

Stage	Work with Agent	Internal Consultations	Total
Stage 1	30-45 min	1-2 days	1-2 days
Stage 2	1-2 hours	3-5 days	~1 week
Stage 3	45-60 min	1-2 days	2-3 days
Stage 4	2-3 hours	3-5 days	~1 week
Stage 5	1-2 hours	2-3 days	3-4 days
Stage 6	1 hour	1 day	1-2 days
Stage 7	45 min	1 day	1-2 days
Stage 8	1-2 hours	2-3 days	3-5 days
TOTAL	8-12 hours	2-3 weeks	3-4 weeks

Most of the time is not spent working with the agent, but gathering data from stakeholders and internal consultations.

Best Practices

Do:

Read RATIONALE + EVIDENCE sections - you'll understand the agent's logic
Be specific - "average 50 invoices/month" instead of "a lot"
Approve sections progressively - you don't have to wait for the entire stage
Correct immediately if the agent makes an error

Don't:

Don't guess - say "I DON'T KNOW" if you don't know the answer
Don't skip questions - each one has a justification
Don't approve documents without reading them
Don't mix stages - complete one before moving to the next

Troubleshooting

Problem	Solution
Agent doesn't understand response	Rephrase more specifically, provide example
Agent asks about something you don't know	Respond "I DON'T KNOW" or mark as OPEN QUESTION
Error in earlier response	`CORRECTION in [Section X.Y]: [error description and fix]`
Document too technical	"Simplify section [X] for non-technical audience"
Change requirement priority	"Change requirement FR-015 from MUST to SHOULD. Reasoning: [...]"
Stage locked by another user	Wait for them to finish, or remove stale lock file after 2 h
`babok` command not found	Run `setup.bat` (Windows) or `npm link` in `cli/`

Security and Privacy

Agent DOES NOT store: passwords, API keys, bank account numbers, personal data (except roles).

Agent MAY store: organizational structure, business processes, aggregated metrics, system names.

The agent is designed in compliance with GDPR, BABOK Code of Conduct, and ISO 27001 principles.

Additional Resources

License

This project is licensed under the MIT License - see the LICENSE file for details.

BABOK® is a registered trademark of the International Institute of Business Analysis (IIBA®). This project is not officially endorsed by IIBA.

Contributing

Contributions are welcome! Please feel free to submit:

Bug reports and feature requests via GitHub Issues
Pull requests for documentation improvements
Sample analysis templates (anonymized)
Translations to other languages

Author

Grzegorz Skuza

GitHub: @GSkuza
Repository: BABOK_ANALYST

Version: 2.1.0 Release Date: March 30, 2026 Last Updated: 2026-03-30

Name		Name	Last commit message	Last commit date
Latest commit History 59 Commits
.github		.github
BABOK_AGENT		BABOK_AGENT
BABOK_Analysis		BABOK_Analysis
babok-mcp		babok-mcp
cli		cli
docs		docs
templates		templates
.gitignore		.gitignore
BABOK ANALYST - podrecznik uzytkownika PL.pdf		BABOK ANALYST - podrecznik uzytkownika PL.pdf
BABOK ANALYST - podrecznik uzytkownika.docx		BABOK ANALYST - podrecznik uzytkownika.docx
BABOK_AGENT_SYSTEM_PROMPT.md		BABOK_AGENT_SYSTEM_PROMPT.md
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LANGUAGE_SUPPORT_IMPLEMENTATION.md		LANGUAGE_SUPPORT_IMPLEMENTATION.md
LICENSE		LICENSE
PODSUMOWANIE_JEZYKI.md		PODSUMOWANIE_JEZYKI.md
README.md		README.md
RELEASE_NOTES.md		RELEASE_NOTES.md
VERSION		VERSION
agent_config.json		agent_config.json
babok-mcp-podrecznik uzytkownika.docx		babok-mcp-podrecznik uzytkownika.docx
babok-mcp-podrecznik uzytkownika.md		babok-mcp-podrecznik uzytkownika.md
babok-mcp-user-manual.docx		babok-mcp-user-manual.docx
babok-mcp-user-manual.md		babok-mcp-user-manual.md
generate_manual.py		generate_manual.py
my_project_context.json		my_project_context.json
setup.bat		setup.bat
setup.sh		setup.sh

Folders and files

Latest commit

History

Repository files navigation

BABOK Analyst - AI-Powered Business Analysis Agent

What is BABOK Analyst?

Repository Structure

Stages

Modular Architecture (v2.0)

How to Get Started

Quick Start (non-technical users) — NEW in v2.0.1

Method 1: Claude.ai (Projects)

Method 2: VS Code with Claude Code (CLI)

Method 3: VS Code with GitHub Copilot Chat

Method 4: ChatGPT or other LLM

Method 5: API (Anthropic, OpenAI, others)

BABOK CLI Tool

Installation

CLI Commands

Stage diff

Document export (DOCX/PDF)

Quick Example

Team Collaboration & File Locking — NEW in v2.0.1

MCP Server — babok-mcp (v2.0)

Setup (Claude Desktop / Claude Code)

Available Tools

Example flow in Claude

AI Chat in Terminal (babok chat)

Supported Providers

Usage

Chat Commands (inside session)

Features

API Key Security

Key Storage Hierarchy

How It Works

Setting Up API Keys

Removing Stored Keys

Cloning the Repository

Requirements

Cloning via HTTPS

Cloning via SSH

Cloning via GitHub CLI

Download ZIP (without Git)

How to Work with the Agent

Communication Format

Sequential questions

How to Respond

Control Commands

Output Files

Estimated Timeline

Best Practices

Troubleshooting

Security and Privacy

Additional Resources

License

Contributing

Author

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 8

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

MCP Server — `babok-mcp` (v2.0)

AI Chat in Terminal (`babok chat`)

Packages