Skip to content

olbboy/BA-Kit

Repository files navigation

BA-Kit Logo

Version 2.9.3 21 Agents 3 Platforms CMMI Level 5 Enabler 786 Knowledge Entries Jira + Confluence

BA-Kit

Agent Squad for Requirements Engineering

21 Agent Specialists for Requirements Engineering
System 2 Reflection • Multi-Platform (Antigravity • Claude Code • Claude CoWork)


🎯 What is BA-Kit?

BA-Kit is not a library of prompts. It is an agent squad for agentic AI platforms.

It replaces the single-chatbot approach with 21 specialists running on:

  • Antigravity IDE (Google DeepMind) — Agent Skills, MCP, System 2
  • Claude Code (Anthropic) — CLI: project-level reasoning, CI/CD, Git
  • Claude CoWork (Anthropic) — Desktop: non-technical BA, document synthesis

Summon specialists: @ba-writing for specs, @ba-strategy for context, @ba-facilitation for workshops.

Each agent uses System 2 Thinking (Reflective Loops) — self-critique before responding to reduce hallucination.


🤖 The Agent Squad (21 Agents)

🔴 The Orchestrator

Agent Role Capability
@ba-master Dispatcher Strategy, Routing, Context Management.

🔵 Core Agents (The Foundation)

Agent Role Capability
@ba-identity Chief of Staff Stakeholder Mapping, RACI, Competency Grid.
@ba-elicitation Journalist Funnel Questioning, "Colombo" Method.
@ba-writing Architect Visual UI Scan, Gherkin Drafting (BDD).

🟡 Specialized Agents (The Experts)

Agent Role Capability
@ba-validation QA Lead Visual QA, Edge Case Detection.
@ba-traceability CCB Secretary Grep Verification (No Hallucinations).
@ba-nfr SRE Architect Web-Validated ISO 25010 Standards.
@ba-process Lean Master Whiteboard Vision, BPMN Waste Analysis.
@ba-prioritization Product Mgr MoSCoW, RICE, WSJF Frameworks.
@ba-solution Investor Python-Verified ROI & NPV Math.
@ba-conflict Mediator Harvard Negotiation, ADR Drafting.
@ba-export Publisher Compliance Check, Pandoc Formatting.

🟣 Advanced Agents

Agent Role Capability
@ba-metrics Data Scientist SPC Charts, Defect Density, Cpk stats.
@ba-root-cause Investigator 5 Whys, Fishbone, Pareto Analysis.
@ba-innovation R&D Scientist A/B Testing, Hypothesis Designs.

🟢 Strategic & eBook-Powered Agents (NEW in v2.7)

Agent Role Capability
@ba-strategy Strategist PESTLE, SWOT, Business Model Canvas, Porter's 5 Forces.
@ba-facilitation Facilitator Workshop Design, ODEC Framework, Group Dynamics.
@ba-systems Systems Analyst Stocks & Flows, Leverage Points, System Archetypes.
@ba-agile Agile Analyst User Story Mapping, MVP Definition, Hypothesis-Driven.

🔗 Integration Agents (NEW in v2.9)

Agent Role Capability
@ba-jira Jira Bridge Story→Ticket Transport, Sprint Planning, Transport Gate Reflection.
@ba-confluence Confluence Bridge Markdown→XHTML Publishing, Document Import, Version Tracking.

🚀 Quick Start

1. Installation

Copy the workflows into your Agent's brain:

cp -r ba-kit/.agent/skills/* ~/.gemini/antigravity/skills/

2. Summoning

In your chat, simply type @ followed by the Agent Name:

User: "@ba-writing I need a login feature."

@ba-writing: "Architect online. I see you want a Login. Shall we use Email/OTP or Social Auth? Let's draft the Happy Path first..."

3. The "Flash Mode"

You can switch agents instantly to handle complex tasks:

User: "This requirement seems risky. @ba-solution check the ROI."

@ba-solution: "Investor here. I'll calculate the NPV using Python..."


🧠 System 2 Intelligence (New in v2.4)

All agents now follow a Reflective Cognitive Loop:

  1. Analysis (System 1): Fast pattern matching.
  2. Action (System 1): Draft content.
  3. Reflection (System 2): STOP & THINK.
    • Critic: "Did I hallucinate that dependency?"
    • Action: Verify with grep or python.
  4. Output: Verified, High-Precision Answer.

📁 Repository Structure

ba-kit/
│
├── .agent/skills/                # 21 Agent Skills (ba-master, ba-writing, ba-jira, ...)
├── .agent/scripts/               # BM25+ Knowledge Search Engine
├── .agent/data/                  # 786 Indexed Knowledge Entries (23 domains)
│
├── docs/                         # Documentation & Guides
│   ├── README.md                 # Documentation index
│   ├── agent-cheat-sheet.md      # All 21 agents at a glance
│   ├── prompt-library.md         # 28 copy-paste prompts by phase
│   ├── ai-foundation-for-ba.md   # AI Foundation primer (bilingual)
│   ├── ai-tools-guide.md         # Tool selection matrix
│   ├── design-prototype-guide.md # Stitch MCP, Figma, vibe coding
│   ├── antigravity-protocol.md   # Runtime specification
│   ├── architecture-decisions.md # Naming, identity, CMMI
│   ├── junior-start.md           # 4-week onboarding for new BAs
│   └── knowledge_base/           # Core & specialized BA knowledge
│
├── templates/                    # Document Templates
│   ├── prd-template.md           # Product Requirements Document
│   ├── brd-template.md           # Business Requirements Document
│   ├── srs-template.md           # Software Requirements Spec (IEEE 29148)
│   ├── frd-template.md           # Functional Requirements Document
│   └── ...                       # + 6 more templates
│
├── ebooks/                       # Synthesized eBook Knowledge (6 files)
│
├── AGENT.MD                      # Squad configuration (Antigravity runtime)
├── QUICK-START.md                # 2-minute setup
├── USAGE-GUIDE.md                # How the squad works
├── WORKFLOW-COOKBOOK.md           # 23 real-world scenario recipes
└── README.md                     # This file

🔍 Knowledge Search Engine (New in v2.8)

BA-Kit now includes a BM25+ Knowledge Search Engine with 786 indexed entries across 23 domains.

# Search for any BA concept
python3 .agent/scripts/ba_search.py "acceptance criteria gherkin"

# Search specific domain
python3 .agent/scripts/ba_search.py "GDPR compliance" --domain compliance

# Search across all domains
python3 .agent/scripts/ba_search.py "stakeholder analysis" --multi-domain

# View statistics
python3 .agent/scripts/ba_search.py --stats

23 Domains: writing, elicitation, validation, nfr, process, prioritization, traceability, conflict, solution, systems, agile, identity, workshop, innovation, metrics, modeling, ux-research, business-rules, integration, compliance, communication, testing, data-analytics.


📄 License

MIT License. Free to use for personal and enterprise projects.


Antigravity • Claude Code • Claude CoWork
Code Less. Think More.