OpenBA

Business Analyst-first spec framework for AI coding assistants.

OpenBA standardizes the BA process — from raw idea to implementation-ready PBIs — grounded in the real codebase, driven by structured challenge.

---

Install

npm install -g @fracox85/openba

Requires Node.js 20+.

---

Setup

Navigate to your project and run:

openba setup

The wizard will ask:

1. Which AI tool you use (GitHub Copilot, Claude Code, Cursor, Windsurf, Codex, Gemini CLI, Antigravity)
2. Which skill groups to install (Epic, Feature, PBI)

Skills are copied into the correct folder for your tool automatically.

---

Commands

Command	What it does
openba setup	Interactive wizard — select tool and skills
openba update	Check for new package version and update skill files
openba validate	Verify installed skills are intact and well-formed
openba list	Show installed skills and version
openba add [skill-id]	Add a skill not selected during setup
openba remove [skill-id]	Remove an installed skill

---

Tool Support

Tool	Skills installed to
GitHub Copilot	.github/copilot/skills/
Claude Code	.claude/skills/
Cursor	.cursor/skills/
Windsurf	.windsurf/skills/
Codex (OpenAI)	AGENTS.md
Gemini CLI	GEMINI.md
Antigravity	AGENTS.md

---

Skills

After setup, use these skills in your AI tool:

Core

Skill	What it does
oba-init	Initialize OpenBA workspace in the project
oba-status	Query project status from the registry
oba-bcm	Business Capability Map management

Epic

Skill	What it does
oba-create-epic	Discovery + BACCM + Grill Me → PRD
oba-review-epic	Fresh-eyes PRD review

Feature

Skill	What it does
oba-create-features	Split PRD into features
oba-add-feature	Add a feature to an existing epic
oba-remove-feature	Remove a feature
oba-review-feature	Fresh-eyes feature review

PBI

Skill	What it does
oba-create-pbis	Split feature into INVEST-compliant PBIs
oba-add-pbi	Add a PBI to an existing feature
oba-remove-pbi	Remove a PBI
oba-debate-pbi	Deep structured debate on a single PBI
oba-review-pbi	Fresh-eyes PBI review — APPROVED / REWORK REQUIRED

---

Keeping Skills Updated

When a new version of OpenBA is published:

openba update

openba update checks npm for a newer version, upgrades the global package if needed, then re-copies all skill files into your project. One command does everything.

Run openba validate after an update to verify all skills are intact:

openba validate

---

First Use After Setup

1. Open your project in your AI tool
2. Run oba-init — initializes docs/oba/ workspace
3. Run oba-bcm init — maps your business capabilities
4. Run oba-create-epic — start your first epic

---

License

MIT