baolinhtb/BMAD-Odoo-Skills

BMAD + Odoo Setup

Bootstraps a complete BMAD-METHOD + Odoo workflow into an existing Odoo project with a single command. Fresh upstream pieces (BMAD core, Odoo knowledge skills) are pulled at install time so they are always the latest/optimal; the integration glue (BA skill, subagents, agent overrides, Visual-QC) is bundled in this repo.

What it installs

1. BMAD METHOD (bmm module, claude-code tools, Vietnamese) — pulled fresh via npx bmad-method@latest.
2. Odoo agent-skills — odoo-17/odoo-18/odoo-19, payment-integration, dtg-base, mcp-builder, ai-vibe-slides — pulled fresh via npx skills add unclecatvn/agent-skills.
3. odoo-ba-smartcore BA skill (/srs, /use-case, /gap-analysis, /user-story, /bpmn, /mockup, /to-bmad) — bundled.
4. Subagents planner, odoo-code-review, odoo-code-tracer → .claude/agents/ — bundled.
5. BMAD overrides (_bmad/custom/*.toml) wiring the Odoo knowledge base + BA artifacts into analyst (Mary), architect (Winston), dev (Amelia), pm (John), ux (Sally), plus create-story / dev-story / quick-dev workflows — bundled.
6. Visual-QC engine (_bmad/scripts/visualqc/) + bmad-qa-visual-review skill — bundled.
7. docs/project-context.md + .odoo-version pin + docs/analysis & docs/mockups scaffolding.

How to run

From the root of the target Odoo project, run one of:

# A) curl one-liner (self-clones bundled assets)
curl -fsSL https://raw.githubusercontent.com/baolinhtb/BMAD-Odoo-Skills/main/install.sh | bash

# B) clone then run (offline-friendly, lets you inspect first)
git clone --depth 1 https://github.com/baolinhtb/BMAD-Odoo-Skills.git /tmp/bmad-odoo-kit
bash /tmp/bmad-odoo-kit/install.sh /path/to/odoo-project

When invoked as a skill, default to A with $PWD as the project dir, unless the user names a different directory. Confirm the target directory with the user first if it is not obviously an Odoo project (no addons/ or __manifest__.py nearby).

Options (env vars, prepend to the command)

Var	Default	Purpose
ODOO_VERSION	19	Odoo major to pin (17/18/19); rewrites overrides accordingly
BMAD_LANG	Vietnamese	BMAD communication language
SKIP_BMAD=1	—	skip BMAD installer (re-run safe; auto-skips if _bmad/ exists)
SKIP_SKILLS=1	—	skip the agent-skills pull
SKIP_VISUALQC=1	—	skip Visual-QC engine + npm install

Example: ODOO_VERSION=18 BMAD_LANG=English curl -fsSL .../install.sh | bash

After install

Tell the user the environment is ready and suggest the flow:

1. Analysis — "talk to Mary" (analyst) → /srs, /gap-analysis, /mockup → /to-bmad (emits docs/epics.md, docs/architecture.md, docs/ux.md, updates docs/project-context.md).
2. Planning — BMAD sprint-planning → create-story.
3. Build — dev-story (Amelia) implements with the odoo-19 guides as source of truth; OR menu item runs the odoo-code-review agent.
4. Visual QC — "visual qc " screenshots the running app vs the HTML mockup.

The setup is idempotent: re-running refreshes the bundled glue and re-pulls upstream skills without clobbering _bmad/ or an existing docs/project-context.md.