bmad-odoo 1.0.9 → 4.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,25 @@
+{
+  "name": "bmad-odoo",
+  "owner": { "name": "Amalik Amriou" },
+  "license": "MIT",
+  "repository": "https://github.com/phamdungtk/bmad-odoo",
+  "keywords": ["bmad", "discovery", "vortex", "product-discovery", "innovation"],
+  "plugins": [
+    {
+      "name": "bmad-odoo-vortex",
+      "source": "./",
+      "description": "Vortex Framework — 7-stream product discovery for IT transformation consultants.",
+      "version": "4.0.0",
+      "author": { "name": "Amalik Amriou" },
+      "skills": [
+        "./_bmad/bme/_vortex/agents/contextualization-expert",
+        "./_bmad/bme/_vortex/agents/discovery-empathy-expert",
+        "./_bmad/bme/_vortex/agents/research-convergence-specialist",
+        "./_bmad/bme/_vortex/agents/hypothesis-engineer",
+        "./_bmad/bme/_vortex/agents/lean-experiments-specialist",
+        "./_bmad/bme/_vortex/agents/production-intelligence-specialist",
+        "./_bmad/bme/_vortex/agents/learning-decision-expert"
+      ]
+    }
+  ]
+}

package/CHANGELOG.md

@@ -1,61 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.0.3] - 2026-01-02
-
-### Added
-- Integration với `bmad-method@alpha install`
-- Keyword `bmad-module` để auto-detect bởi bmad-method installer
-- Field `bmad` metadata trong package.json cho installer display
-- File `BMAD-METHOD-INTEGRATION.md` hướng dẫn integration
-
-### Changed
-- README.md với comprehensive documentation (Troubleshooting + FAQ)
-- Merge USAGE.md content vào README.md
-- Xóa USAGE.md (consolidate vào README duy nhất)
-
-### Fixed
-- Postinstall script đã được verify hoạt động tự động
-- Auto-setup với default Antigravity IDE khi non-interactive
-
-## [1.0.2] - 2026-01-02
-
-### Added
-- bmad-module keyword for installer detection
-- bmad metadata field
-
-## [1.0.0] - 2026-01-02
-
-### Added
-- 🤖 **10 AI Agents** chuyên biệt cho phát triển Odoo:
-  - Sofia (Business Analyst) - Phân tích quy trình, gap analysis
-  - Antonio (Technical Architect) - Thiết kế kiến trúc module
-  - Carlos (Developer) - Phát triển code Odoo
-  - Maria (Product Manager) - Quản lý sản phẩm, tạo PRD
-  - Diego (Scrum Master) - Quản lý Sprint, story
-  - Elena (Test Architect) - Thiết kế test cases
-  - Sally (UX Designer) - Thiết kế UX cho Odoo views
-  - Barry (Quick Flow Dev) - Phát triển nhanh
-  - Paige (Tech Writer) - Tài liệu hóa module
-  - BMAD-Odoo Master - Điều phối tổng thể
-
-- 📝 **44+ Workflows** bao phủ toàn bộ vòng đời phát triển:
-  - Analysis: analyze-process, gap-analysis, create-product-brief
-  - Planning: create-odoo-addon, create-odoo-epic, create-odoo-prd
-  - Solutioning: create-architecture, create-epics-and-stories
-  - Implementation: dev-story, code-review, sprint-planning
-  - Testing: odoo-test-design, test-review
-  - Documentation: document-odoo, document-project
-
-- 🇻🇳 **Hỗ trợ tiếng Việt** đầy đủ
-- 📚 **Odoo Knowledge Base** tích hợp kiến thức Odoo 16.0/17.0
-- ⚙️ **Post-install script** tự động setup workflows
-
-### Technical
-- Hỗ trợ Odoo 16.0+ và 17.0
-- Tương thích với Cursor, VS Code, và các AI IDE khác
-- Tuân thủ OCA coding standards

package/INSTALLATION.md

@@ -0,0 +1,253 @@
+# Installation Guide
+
+Complete guide to installing BMAD Odoo agent teams into your project.
+
+- **Package:** `bmad-odoo`
+- **Version:** 3.0.0
+- **Last Updated:** 2026-03-24
+
+---
+
+## Prerequisites
+
+- Node.js 18+ or Bun
+- Git
+- Claude Code or Claude.ai
+
+BMAD Odoo works **standalone** or as an extension to [BMAD Method](https://github.com/bmadhub/bmad). No prior BMAD installation required.
+
+---
+
+## Quick Install
+
+**Everything (Vortex + Gyre + Enhance):**
+
+```bash
+npm install bmad-odoo && npx -p bmad-odoo bmad-install
+```
+
+All 11 agents (7 Vortex + 4 Gyre), the Enhance module, and all supporting files are installed and ready to use.
+
+**Vortex only** (product discovery):
+
+```bash
+npm install bmad-odoo && npx -p bmad-odoo bmad-install-vortex
+```
+
+**Gyre only** (production readiness):
+
+```bash
+npm install bmad-odoo && npx -p bmad-odoo bmad-install-gyre
+```
+
+---
+
+## Installation Options
+
+### Option 1: Install from npm (Recommended)
+
+```bash
+# Install into your project
+npm install bmad-odoo
+
+# Install everything
+npx -p bmad-odoo bmad-install
+
+# Or install individual teams
+npx -p bmad-odoo bmad-install-vortex   # Product Discovery (7 agents)
+npx -p bmad-odoo bmad-install-gyre     # Production Readiness (4 agents)
+```
+
+### Option 2: Clone from Source (Contributors Only)
+
+For contributors or developers who want to modify agents or contribute to the project. This sets up a development environment — not an end-user installation.
+
+```bash
+git clone https://github.com/phamdungtk/bmad-odoo.git
+cd bmad-odoo
+npm install
+```
+
+Agents are pre-installed in the repository for development. Note that this does not create the same output directory structure as the npm install path — use Option 1 for project installations.
+
+---
+
+## What Gets Installed
+
+### Directory Structure
+
+```
+your-project/
+├── _bmad/bme/
+│   ├── _vortex/              # Team: Product Discovery
+│   │   ├── agents/           # 7 agent definition files
+│   │   ├── workflows/        # 22 workflows
+│   │   ├── contracts/        # Handoff contracts (HC1-HC5 artifact, HC6-HC10 routing)
+│   │   ├── guides/           # User guides (all 7 agents)
+│   │   └── config.yaml       # Configuration
+│   ├── _gyre/                # Team: Production Readiness
+│   │   ├── agents/           # 4 agent definition files
+│   │   ├── workflows/        # 7 workflows
+│   │   ├── contracts/        # Artifact contract schemas (GC1-GC4)
+│   │   ├── guides/           # User guides (all 4 agents)
+│   │   └── config.yaml       # Configuration
+│   └── _enhance/             # Skill: Agent Capability Upgrades
+│       ├── workflows/        # Skill workflows (initiatives-backlog)
+│       ├── extensions/       # Agent menu patch descriptors
+│       ├── guides/           # Module author guide
+│       └── config.yaml       # Configuration
+├── .claude/skills/           # Claude Code skill wrappers (auto-generated)
+├── _bmad/_config/
+│   └── agent-manifest.csv    # Agent registry
+└── _bmad-output/
+    ├── vortex-artifacts/     # Vortex generated artifacts
+    └── gyre-artifacts/       # Gyre generated artifacts
+```
+
+### Summary
+
+| Module | Contents |
+|--------|----------|
+| **Vortex** | 7 agents, 22 workflows, 10 handoff contracts (HC1-HC5 artifact, HC6-HC10 routing), 7 user guides |
+| **Gyre** | 4 agents, 7 workflows, 4 contract schemas (GC1-GC4), 4 user guides |
+| **Enhance** | Skill workflows, menu patch descriptors, module author guide |
+| **Skills** | Claude Code skill wrappers in `.claude/skills/` for all 11 agents |
+
+---
+
+## Configuration
+
+Each team installer creates a `config.yaml` in its module directory. The key fields you'll want to customize:
+
+```yaml
+# _bmad/bme/_vortex/config.yaml (or _gyre/config.yaml)
+user_name: "{user}"                # Your name (used in agent greetings)
+communication_language: "en"       # Language for agent communication
+```
+
+The config also includes auto-generated fields (`submodule_name`, `module`, `version`, `agents`, `workflows`) that you typically don't need to edit — the installer and update system manage those.
+
+---
+
+## Verification
+
+After installation, run diagnostics to confirm everything is in place:
+
+```bash
+npx -p bmad-odoo bmad-doctor
+```
+
+Doctor validates all installed modules: agent files, skill wrappers, config files, and manifest entries — with actionable fix suggestions for each issue.
+
+Then activate an agent to confirm it works:
+
+```bash
+# Vortex
+cat _bmad/bme/_vortex/agents/contextualization-expert.md    # Emma
+
+# Gyre
+cat _bmad/bme/_gyre/agents/stack-detective.md               # Scout
+```
+
+**Expected result:** The agent greets you by name and displays a numbered menu. If you see raw markdown instead, re-run `bmad-doctor` to diagnose.
+
+---
+
+## Troubleshooting
+
+Start with diagnostics — it catches most issues:
+
+```bash
+npx -p bmad-odoo bmad-doctor
+```
+
+### Permission denied errors
+
+```bash
+chmod +x scripts/*.js
+npx -p bmad-odoo bmad-install-vortex
+```
+
+### Config file already exists
+
+The installer preserves your custom settings and only adds missing entries. To force a clean installation:
+
+```bash
+rm -rf _bmad/bme/_vortex/    # or _gyre/ for Gyre
+npx -p bmad-odoo bmad-install-vortex   # or bmad-install-gyre
+```
+
+### Installation succeeds but agents don't activate
+
+Check that files are in place:
+
+```bash
+npx -p bmad-odoo bmad-doctor
+ls -la _bmad/bme/_vortex/agents/
+ls -la _bmad/bme/_gyre/agents/
+```
+
+### Agent skill not appearing in Claude Code
+
+Skills are installed to `.claude/skills/bmad-agent-bme-{id}/SKILL.md`. Verify they exist:
+
+```bash
+ls .claude/skills/bmad-agent-bme-*/SKILL.md
+```
+
+If missing, re-run the installer — it regenerates skill wrappers on every run.
+
+---
+
+## BMAD Method Compatibility
+
+BMAD Odoo works standalone — no BMAD Method installation is required.
+
+If the BMAD Method is already installed in your project, the installer detects it automatically and logs confirmation. Both packages coexist in the `_bmad/` directory without conflict.
+
+See [BMAD-METHOD-COMPATIBILITY.md](docs/BMAD-METHOD-COMPATIBILITY.md) for the full compatibility matrix.
+
+---
+
+## Next Steps
+
+1. **Personalize** — edit the config.yaml for your chosen team and replace `{user}` with your name
+2. **Pick a starting point:**
+   - **Vortex:** Activate Emma → select **Lean Persona** from the menu → follow the guided steps
+   - **Gyre:** Activate Scout → select **Full Analysis** from the menu → walk through the pipeline
+3. **Find your artifacts** — outputs are saved in `_bmad-output/vortex-artifacts/` or `.gyre/`
+4. **Check updates** — run `npx -p bmad-odoo bmad-version` periodically
+
+See the [Agent Guide](docs/agents.md) for detailed workflow descriptions. User guides are available for all 11 agents in their respective `guides/` directories.
+
+---
+
+## Uninstallation
+
+BMAD Odoo doesn't provide an uninstall command. To remove:
+
+```bash
+# 1. Back up your generated artifacts first
+cp -r _bmad-output/vortex-artifacts/ ~/my-backup/
+cp -r .gyre/ ~/my-backup/
+
+# 2. Remove agent files, workflows, and skills
+rm -rf _bmad/bme/_vortex/
+rm -rf _bmad/bme/_gyre/
+rm -rf _bmad/bme/_enhance/
+rm -rf .claude/skills/bmad-agent-bme-*/
+rm -rf .claude/skills/bmad-enhance-*/
+
+# 3. Remove generated artifacts
+rm -rf _bmad-output/vortex-artifacts/
+rm -rf _bmad-output/gyre-artifacts/
+
+# 4. Uninstall npm package
+npm uninstall bmad-odoo
+```
+
+Your BMAD Method files (if any) remain untouched.
+
+---
+
+[Back to README](README.md) | [Update Guide](UPDATE-GUIDE.md) | [Agent Guide](docs/agents.md)

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Dũng Xuân
+Copyright (c) 2026 Bmad Odoo Contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal