Skip to content

Repository files navigation

BA-Kit Logo

Version 3.5.044 Agents3 PlatformsCMMI Level 5 Enabler831 Knowledge EntriesJira + Confluence14 Templates48 Prompts

E2E Skills Test

BA-Kit

Agent Squad for Requirements Engineering


What is BA-Kit?

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

It replaces the single-chatbot approach with 44 specialists — each with a defined role, toolset, System 2 Reflective Loop, and anti-rationalization guardrails — running across three platforms:

PlatformRuntimeBest For
Antigravity IDE (Google DeepMind)Agent Skills + MCPPower users, full toolchain
Claude Code (Anthropic)CLI, Git, CI/CDEngineers, project-level reasoning
Claude CoWork (Anthropic)DesktopNon-technical BAs, document synthesis

How It Works

User Request
│
▼
@ba-master ──── Triage + Route ──────────────────────────────┐
│ │
▼ ▼
Specialist Agent Context Handoff
(e.g. @ba-writing) (shared continuity)
│
├── System 1: Draft Output
│
├── System 2: STOP & REFLECT
│ ├── Did I hallucinate?
│ └── Verify via grep / python / web
│
└── Verified Output → Handoff to Next Agent

Each agent also ships an anti-rationalization guardrail (v3.2/3.3): explicit "When NOT to Use", common rationalizations with rebuttals, red flags, and verification exit criteria — to prevent skill-skipping under pressure.


The Agent Squad (44 Agents)

Orchestrator (1)
AgentRoleCapability
@ba-masterDispatcherStrategy, Routing, Context Management
Core (3) — The Foundation
AgentRoleCapability
@ba-identityChief of StaffStakeholder Mapping, RACI, Competency Grid
@ba-elicitationJournalistFunnel Questioning, Colombo Method
@ba-writingArchitectVisual UI Scan, Gherkin Drafting (BDD)
Specialized (8) — The Experts
AgentRoleCapability
@ba-validationQA LeadVisual QA, Edge Case Detection
@ba-traceabilityCCB SecretaryGrep Verification, No Hallucinations
@ba-nfrSRE ArchitectWeb-Validated ISO 25010 Standards
@ba-processLean MasterWhiteboard Vision, BPMN Waste Analysis
@ba-prioritizationProduct ManagerMoSCoW, RICE, WSJF Frameworks
@ba-solutionInvestorPython-Verified ROI & NPV Math
@ba-conflictMediatorHarvard Negotiation, ADR Drafting
@ba-exportPublisherCompliance Check, Pandoc Formatting
Advanced (3)
AgentRoleCapability
@ba-metricsData ScientistSPC Charts, Defect Density, Cpk Stats
@ba-root-causeInvestigator5 Whys, Fishbone, Pareto Analysis
@ba-innovationR&D ScientistA/B Testing, Hypothesis Designs
Strategic (4)
AgentRoleCapability
@ba-strategyStrategistPESTLE, SWOT, Business Model Canvas, Porter's 5 Forces
@ba-facilitationFacilitatorWorkshop Design, ODEC Framework, Group Dynamics
@ba-systemsSystems AnalystStocks & Flows, Leverage Points, System Archetypes
@ba-agileAgile AnalystUser Story Mapping, MVP Definition, Hypothesis-Driven
Quality & Audit (4)
AgentRoleCapability
@ba-test-genQA ArchitectAC → 7-category Test Cases (BVA, Decision Tables, State Transitions)
@ba-quality-gateQuality Officer8-dimension scoring, 5 gates: PASS / CONDITIONAL / REJECT
@ba-consistencyIntegration AuditorCross-artifact alignment: US ↔ API ↔ DB ↔ BRD
@ba-auditorChief AuditorFull project health dashboard + action plan
Lifecycle (7)
AgentRoleCapability
@ba-questioningMaster InterviewerContext-Free Questions, Interview Prep, Assumption Surfacing
@ba-communicationCommunicatorAudience Adaptation, Status Reports, Executive Summaries
@ba-uxUX ResearcherPersona, Journey Map, Empathy Map, JTBD, Usability Testing
@ba-dataData ArchitectERD, Data Dictionary, DFD, Data Mapping, Migration Planning
@ba-changeChange AgentADKAR, Readiness Assessment, Training Plans, Go-Live
@ba-business-rulesRules EngineDecision Tables, Decision Trees, Rule Catalog, Conflict Detection
@ba-diagramVisualizerMermaid v11 (24+ types), BA artifact→diagram, Confluence export
Integration (2) + Knowledge (1)
AgentRoleCapability
@ba-jiraJira BridgeStory→Ticket Transport, Sprint Planning, Transport Gate Reflection
@ba-confluenceConfluence BridgeMarkdown→XHTML Publishing, Document Import, Version Tracking
@ba-wikiKnowledge Curator2-tier knowledge ingest, wiki query, living docs, glossary management

🌀 Sprint Spine Agents (NEW in v3.4 — Gstack Distillation)

AgentPhaseCapability
@ba-as-builtReflectSpec drift detector — compares BRD/SRS/RTM against delivered evidence (UAT reports, release notes, demo notes) to find what was built ≠ what was specified.
@ba-autoreviewValidateStrict-sequential meta: consistency → quality-gate → traceability → auditor, with optional --dual-voice.
@ba-retroReflectTime-windowed sprint retro: gate pass rate, churn, stakeholder responsiveness — primary input is BA-Kit metric streams (no git required).
@ba-learnReflectPer-project JSONL emergent memory (5 types, PII filter, auto-capture API).
@ba-checkpointanySession save/resume for long-running BA work (workshops spanning multiple days).
@ba-challengerValidate5-vector adversarial red team (unstated / incentive / adversarial / scale-break / sunset).
@ba-second-opinionValidateCross-model independent review — Gemini / OpenAI / Ollama / manual (zero-dep urllib).
@ba-baselinePublishCCB baselines with version + signer + date + rationale. Agent prompts BA in plain language; integrity check happens silently.
@ba-guardanyPre-flight change-control alert in BA language: "BRD-HR was edited 2 days after sign-off — was this re-approved?" 3 modes (off / warn / strict).
@ba-shotgunDefineN-variant generator for stories / AC / priority / emails (preference capture to @ba-learn).

📐 Sprint Spine — all 44 agents map into a unified 7-phase loop: Discover → Elicit → Define → Validate → Prioritize → Publish → Reflect. See docs/sprint-spine.md for the full agent → phase mapping.


Quick Start

Antigravity IDE

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

Claude Code

cp -r ba-kit/.agent/skills/*~/.claude/skills/

Claude CoWork

cp -r ba-kit/.agent/skills/*~/Library/Application\ Support/Claude/skills/

One-liner install (auto-detects host):

bash .agent/scripts/setup.sh

Then summon any specialist:

@ba-writing I need a login feature spec.
@ba-solution check the ROI for this initiative.
@ba-master route this request to the right specialist.

System 2 Intelligence

Every agent runs a Reflective Cognitive Loop before responding:

  1. Analyze (System 1) — fast pattern matching
  2. Draft (System 1) — generate initial output
  3. Reflect (System 2) — STOP. Did I hallucinate? Verify with grep / python / web
  4. Output — verified, high-precision answer

This loop reduces hallucinations and surfaces hidden assumptions automatically.


Knowledge Search Engine

831 indexed entries across 23 domains, powered by BM25+.

python3 .agent/scripts/ba_search.py "acceptance criteria gherkin"
python3 .agent/scripts/ba_search.py "GDPR compliance" --domain compliance
python3 .agent/scripts/ba_search.py "stakeholder analysis" --multi-domain
python3 .agent/scripts/ba_search.py --stats

Domains: writingelicitationvalidationnfrprocessprioritizationtraceabilityconflictsolutionsystemsagileidentityworkshopinnovationmetricsmodelingux-researchbusiness-rulesintegrationcompliancecommunicationtestingdata-analytics


Repository Structure

ba-kit/
├── .agent/skills/ # 44 Agent Skills + 2 Connectors + 1 meta
├── .agent/scripts/ # BM25+ Knowledge Search Engine
├── .agent/data/ # 831 Indexed Knowledge Entries (23 domains)
├── .agent/templates/ # 14 Document Templates (BRD, SRS, FRD, PRD, ...)
├── .agent/wiki/ # Living Knowledge Wiki
├── docs/ # Documentation & Guides
│ ├── agent-cheat-sheet.md
│ ├── prompt-library.md # 48 copy-paste prompts by phase
│ └── knowledge_base/
├── ebooks/ # Synthesized Book Knowledge (9 files)
├── README.md
└── README.vi.md

License

CC BY-NC 4.0 — Creative Commons Attribution-NonCommercial 4.0 International.

Free for personal, educational, and non-commercial use. Attribution required.


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

About

Agent Squad for Requirements Engineering — 33 Specialists with System 2 Reflection, BM25+ Knowledge Engine (831 entries), Mermaid Diagramming, Jira + Confluence Integration. Runs on Antigravity IDE, Claude Code, Claude CoWork.

Topics

Resources

Contributing

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages