BMAD-ODOO-DEV: Odoo Development Expansion Pack

Các AI agents chuyên biệt cho phát triển Odoo ERP sử dụng framework BMAD-METHOD với các mẫu cộng đồng OCA.

Overview

BMAD-ODOO-DEV extends the powerful BMAD-METHOD framework with comprehensive Odoo-specific expertise, transforming your AI agents into specialized Odoo development consultants. Perfect for brownfield projects, addon development, and enterprise Odoo customizations.

Key Features

🎯 Odoo-Specialized AI Agents

• Odoo Analyst: Business process analysis and requirements gathering
• Odoo Architect: System architecture and technical design
• Odoo Developer: Implementation and coding guidance
• Odoo PM: Project management and planning
• Odoo QA: Quality assurance and testing
• Odoo SM: Scrum master and agile coordination

🔧 Comprehensive Workflows

• Addon Creation: From business requirement to deployable addon
• System Enhancement: Extending existing Odoo installations safely
• Migration Planning: Structured approach to version upgrades
• Epic Creation: Large-scale feature planning
• Story Sharding: Breaking down complex requirements
• Quick Deploy: Triển khai nhanh Odoo

📋 Odoo-Specific Templates

• Odoo PRD Template: Business process focused requirements
• Odoo Architecture Template: Technical specifications for modules
• Odoo Story Template: Development task templates
• Odoo Epic Template: Large feature planning
• Quick Addon Template: Rapid addon creation

🏗️ Tích Hợp OCA

• OCA (Odoo Community Association) best practices and guidelines
• Multi-database, multi-company environment support
• Community addon integration and contribution workflows

Quick Start

Prerequisites

• Node.js v16+ (BMAD-METHOD core will be installed automatically)
• Existing Odoo project (recommended) or new project setup

Installation

# Install the expansion pack
npm install bmad-odoo-dev

# Install into BMAD-METHOD
npx bmad-odoo install

That's it! This single command will:

• Detect your existing BMAD-METHOD project
• Install BMAD-METHOD core if needed
• Integrate 6+ Odoo agents into .bmad-core/agents/
• Add 9 Odoo tasks to .bmad-core/tasks/
• Add 5 Odoo templates to .bmad-core/templates/
• Update configuration in core-config.yaml

Usage

1. Agent Integration (Automatic)

After installation, Odoo agents are automatically available in your BMAD-METHOD project:

Available Agents:

• *odoo-analyst - Business process analysis and requirements
• *odoo-architect - System architecture and technical design
• *odoo-developer - Implementation and coding guidance
• *odoo-pm - Project management and planning
• *odoo-qa - Quality assurance and testing
• *odoo-sm - Scrum master and agile coordination

2. Development Workflow

The expansion pack fully supports Odoo addon development with specialized tasks:

Available through *BMadOdooDev slash prefix:

• *BMadOdooDev create-addon - Complete addon generation from business requirements
• *BMadOdooDev enhance-existing - Brownfield system enhancements
• *BMadOdooDev plan-migration - Version upgrade planning
• *BMadOdooDev create-epic - Large feature planning
• *BMadOdooDev quick-addon - Rapid addon creation

Supported Odoo Environments

✅ Fully Supported

• Docker-based deployments
• OCA community addons integration
• Multi-database environments (production pattern)
• Odoo versions: 13.0, 14.0, 15.0, 16.0, 17.0, 18.0

🎯 Specialized For

• Brownfield projects - Existing Odoo installations
• Enterprise customizations - Complex business requirements
• Multi-company setups - Operating unit management
• Community contributions - OCA-compliant addon development

CLI Commands

# Install expansion pack
npx bmad-odoo install

# Validate installation
npx bmad-odoo validate

# List available agents
npx bmad-odoo agents

# List team files
npx bmad-odoo team-files

Architecture Integration

With BMAD-METHOD Core

BMAD-ODOO-DEV seamlessly integrates with the core framework:

• Inherits all core BMAD agents (PM, QA, SM)
• Extends planning and development workflows with Odoo expertise
• Maintains compatibility with core BMAD updates
• Preserves existing BMAD project configurations

Odoo Environment Integration

Works perfectly with your existing Odoo setup:

• Detects Odoo project structure automatically
• Integrates with invoke task workflows
• Supports multiple database environments
• Follows OCA development patterns

Best Practices

For Odoo Development

• Always use inheritance over direct modification
• Follow OCA patterns for community compatibility
• Test in isolated environments before production
• Document business logic in functional specifications

For BMAD Integration

• Start with PRD creation using Odoo Analyst
• Use architecture phase for complex integrations
• Leverage story sharding for development organization
• Follow BMAD development cycle for consistency

Troubleshooting

Common Issues

Expansion pack not recognized:

# Ensure proper installation
npm list bmad-odoo-dev
npx bmad-odoo validate

Odoo commands not available:

# Check slash prefix configuration
grep -r "BMadOdooDev" node_modules/bmad-odoo-dev/

Deployment integration issues:

# Verify project structure
ls -la docker-compose.yml common.yaml repos.yaml

Contributing

We welcome contributions to improve Odoo development workflows:

1. Fork the repository
2. Create feature branch: git checkout -b feature/odoo-enhancement
3. Add Odoo-specific agents/tasks/templates
4. Test with real Odoo projects
5. Submit pull request

License

MIT License - see LICENSE for details.

Credits & Acknowledgments

This expansion pack extends and builds upon several amazing open-source projects:

Core Framework

• BMAD-METHOD by Brian (BMad) Madison - The foundational AI-driven development framework

Odoo Ecosystem

• Odoo by Odoo SA - The comprehensive open-source ERP platform
• Odoo Community Association (OCA) - Community-driven best practices

Built with ❤️ for the Odoo development community, extending the powerful BMAD-METHOD framework