bmad-plus 0.1.0

package/src/bmad-plus/data/role-triggers.yaml

@@ -0,0 +1,209 @@
+# BMAD+ Auto-Activation Role Triggers
+# These rules define when agents automatically switch roles based on context.
+# Users can always override with "skip" or explicitly request a role change.
+
+strategist:
+  default_role: pm
+  auto_triggers:
+    analyst:
+      # Level 1 — Pattern matching (keywords in user request)
+      patterns:
+        - "analyse"
+        - "analyze"
+        - "recherche"
+        - "research"
+        - "marché"
+        - "market"
+        - "benchmark"
+        - "requirements"
+        - "domain"
+        - "competitive"
+        - "SWOT"
+        - "stakeholder"
+      # Level 2 — Contextual (situations detected during work)
+      contexts:
+        - "new_project"
+        - "pivot"
+        - "competitor_mention"
+        - "unknown_domain"
+      # Level 3 — Reasoning chain (discoveries during execution)
+      reasoning:
+        - "user_need_unclear"
+        - "market_assumption_unvalidated"
+
+    pm:
+      patterns:
+        - "PRD"
+        - "product brief"
+        - "roadmap"
+        - "priorisation"
+        - "MVP"
+        - "user story"
+        - "personas"
+        - "brief"
+      contexts:
+        - "post_research"
+        - "planning_phase"
+        - "scope_definition"
+      reasoning:
+        - "research_complete_needs_specification"
+
+architect-dev:
+  default_role: dev
+  auto_triggers:
+    architect:
+      patterns:
+        - "architecture"
+        - "design"
+        - "API"
+        - "schema"
+        - "structure"
+        - "stack"
+        - "scalab"
+        - "infrastructure"
+        - "database"
+        - "migration"
+      contexts:
+        - "multi_file_change_gt_5"
+        - "new_module"
+        - "security_domain"
+        - "performance_critical"
+        - "new_integration"
+      reasoning:
+        - "implementation_exposes_architectural_issue"
+        - "dependency_conflict_detected"
+        - "scale_concern_during_coding"
+
+    dev:
+      patterns:
+        - "implement"
+        - "implémente"
+        - "code"
+        - "build"
+        - "fix"
+        - "refactor"
+        - "develop"
+        - "créer"
+      contexts:
+        - "post_architecture"
+        - "story_assigned"
+        - "bug_fix"
+      reasoning:
+        - "architecture_approved_ready_to_code"
+
+    tech-writer:
+      patterns:
+        - "document"
+        - "README"
+        - "changelog"
+        - "explain"
+        - "documente"
+        - "API doc"
+        - "mermaid"
+      contexts:
+        - "post_implementation"
+        - "version_release"
+        - "onboarding_needed"
+      reasoning:
+        - "complex_feature_needs_explanation"
+        - "public_api_changed"
+
+quality:
+  default_role: qa
+  auto_triggers:
+    qa:
+      patterns:
+        - "test"
+        - "QA"
+        - "review"
+        - "bug"
+        - "edge case"
+        - "coverage"
+        - "valide"
+        - "vérifie"
+      contexts:
+        - "post_implementation"
+        - "financial_calculations"
+        - "security_sensitive"
+        - "user_data_handling"
+      reasoning:
+        - "critical_logic_detected"
+        - "regression_risk"
+        - "complex_state_management"
+
+    ux-review:
+      patterns:
+        - "UX"
+        - "interface"
+        - "utilisateur"
+        - "responsive"
+        - "accessibilité"
+        - "accessibility"
+        - "design"
+        - "usability"
+      contexts:
+        - "frontend_changes"
+        - "new_component"
+        - "new_page"
+        - "mobile_layout"
+      reasoning:
+        - "user_facing_feature_delivered"
+        - "interaction_pattern_changed"
+
+orchestrator:
+  default_role: scrum-master
+  auto_triggers:
+    scrum-master:
+      patterns:
+        - "sprint"
+        - "planning"
+        - "story"
+        - "retro"
+        - "backlog"
+        - "epic"
+        - "velocity"
+      contexts:
+        - "phase_transition"
+        - "milestone_reached"
+        - "team_sync"
+
+    quick-flow:
+      patterns:
+        - "rapide"
+        - "quick"
+        - "hotfix"
+        - "petit fix"
+        - "simple"
+        - "fast"
+        - "patch"
+      contexts:
+        - "single_file_change"
+        - "bug_report"
+        - "minor_feature"
+
+    autopilot:
+      patterns:
+        - "autopilot"
+        - "gère tout"
+        - "lance le projet"
+        - "full pipeline"
+        - "tout automatique"
+        - "from scratch"
+      contexts:
+        - "new_project_idea"
+        - "execution_mode_autopilot"
+
+    parallel-supervisor:
+      patterns:
+        - "parallèle"
+        - "parallel"
+        - "simultané"
+        - "concurrent"
+        - "batch"
+      contexts:
+        - "independent_stories_detected"
+        - "multi_task_queue"
+        - "parallel_execution_enabled"
+      reasoning:
+        - "stories_have_no_shared_dependencies"
+        - "workload_can_be_distributed"

package/src/bmad-plus/module-help.csv

@@ -0,0 +1,10 @@
+skill_name,help_text
+bmad-plus-agent-strategist,"Talk to Atlas — your Strategy & Product Lead. Combines business analysis and product management. Use for brainstorming, market research, product briefs, and PRDs."
+bmad-plus-agent-architect-dev,"Talk to Forge — your Architect & Developer. Designs architectures, implements code, and writes documentation. Use for technical design, story implementation, and code review."
+bmad-plus-agent-quality,"Talk to Sentinel — your Quality & UX Guardian. Tests code, reviews UX, and catches edge cases. Use for QA, code review, and UX validation."
+bmad-plus-agent-orchestrator,"Talk to Nexus — your Orchestrator & Sprint Lead. Manages sprints, runs autopilot pipelines, and coordinates parallel agents. Use for project management, autopilot mode, and parallel execution."
+bmad-plus-autopilot,"Launch autopilot mode — give a project idea and Nexus handles the full pipeline from discovery to delivery with checkpoints for your approval."
+bmad-plus-parallel,"Enable parallel execution for independent tasks. The orchestrator detects parallelizable work and supervises multiple agents simultaneously."
+bmad-plus-agent-shadow,"Talk to Shadow — your OSINT Intelligence Analyst. Investigates people via 55+ Apify actors and 7 search APIs. Produces scored dossiers with psychoprofiles."
+bmad-plus-sync,"Synchronize BMAD+ with upstream BMAD-METHOD. Check for updates, analyze changes via AI, and merge compatible updates. Uses VPS MCP Server for git operations."
+bmad-plus-agent-maker,"Talk to Maker — your Agent Creator. Designs, builds, and packages new BMAD+ compatible agents from a natural language description. Outputs ready-to-integrate packages."

package/src/bmad-plus/module.yaml

@@ -0,0 +1,174 @@
+code: bmad-plus
+name: "BMAD+ Streamlined AI-Driven Development"
+description: "Augmented BMAD framework with multi-role agents, autopilot mode, and parallel execution"
+default_selected: true
+
+# Compatibility with upstream
+extends: bmm
+compatibility:
+  min_core_version: "6.0.0"
+  max_core_version: "7.0.0"
+  replaces_modules: ["bmm"]
+  keeps_core_skills: true
+
+# ═══════════════════════════════════════════
+# MODULAR PACK SYSTEM
+# Core is always installed. Additional packs
+# add specialized agents and skills.
+# ═══════════════════════════════════════════
+
+packs:
+  core:
+    name: "Core Development"
+    icon: "⚙️"
+    description: "4 multi-role agents for full development lifecycle"
+    required: true   # Always installed
+    agents:
+      - agent-strategist
+      - agent-architect-dev
+      - agent-quality
+      - agent-orchestrator
+    skills:
+      - bmad-plus-autopilot
+      - bmad-plus-parallel
+      - bmad-plus-sync
+    data:
+      - role-triggers.yaml
+
+  osint:
+    name: "OSINT Intelligence"
+    icon: "🔍"
+    description: "Investigation, scraping, psychoprofiling (55+ Apify actors, 7 APIs)"
+    required: false
+    agents:
+      - agent-shadow
+    skills:
+      - bmad-osint-investigate
+    external_package: "osint-agent-package"
+    required_keys:
+      - APIFY_API_TOKEN
+    optional_keys:
+      - PERPLEXITY_API_KEY
+      - EXA_API_KEY
+      - TAVILY_API_KEY
+      - JINA_API_KEY
+
+  maker:
+    name: "Agent Creator"
+    icon: "🧬"
+    description: "Créer de nouveaux agents BMAD+ compatibles: design, build, package"
+    required: false
+    agents:
+      - agent-maker
+    skills: []
+
+  audit:
+    name: "Audit Sécurité"
+    icon: "🛡️"
+    description: "Scan vulnérabilités, audit code, compliance check (bientôt)"
+    required: false
+    status: coming_soon
+    agents:
+      - agent-shield
+    skills:
+      - bmad-audit-scan
+      - bmad-audit-report
+
+install_packs:
+  prompt:
+    - "Quels packs additionnels souhaites-tu installer ?"
+    - "Core (Atlas, Forge, Sentinel, Nexus) est toujours inclus."
+  default: "none"
+  result: "{value}"
+  multi-select:
+    - value: "osint"
+      label: "🔍 OSINT — Agent Shadow (investigation, scraping, psychoprofil)"
+    - value: "maker"
+      label: "🧬 Agent Creator — Créer de nouveaux agents BMAD+ compatibles"
+    - value: "audit"
+      label: "🛡️ Audit Sécurité — Agent Shield (scan vulnérabilités) [bientôt]"
+      disabled: true
+    - value: "all"
+      label: "🤖 Tout installer"
+    - value: "none"
+      label: "Aucun — Core uniquement"
+
+# Variables from Core Config inserted:
+## user_name
+## communication_language
+## document_output_language
+## output_folder
+
+project_name:
+  prompt: "What is your project called?"
+  default: "{directory_name}"
+  result: "{value}"
+
+user_skill_level:
+  prompt:
+    - "What is your development experience level?"
+    - "This affects how agents explain concepts in chat."
+  default: "expert"
+  result: "{value}"
+  single-select:
+    - value: "beginner"
+      label: "Beginner - Explain things clearly"
+    - value: "intermediate"
+      label: "Intermediate - Balance detail with speed"
+    - value: "expert"
+      label: "Expert - Be direct and technical"
+
+execution_mode:
+  prompt:
+    - "How do you want to work with BMAD+ agents?"
+    - "Manual: you call agents when needed. Autopilot: orchestrator manages everything."
+  default: "manual"
+  result: "{value}"
+  single-select:
+    - value: "manual"
+      label: "Manual - Call agents yourself"
+    - value: "autopilot"
+      label: "Autopilot - Orchestrator manages the pipeline"
+    - value: "hybrid"
+      label: "Hybrid - Autopilot with frequent checkpoints"
+
+auto_role_activation:
+  prompt: "Enable intelligent auto-activation of agent roles based on context?"
+  default: "true"
+  result: "{value}"
+  single-select:
+    - value: "true"
+      label: "Yes - Agents auto-switch roles when context demands it"
+    - value: "false"
+      label: "No - Only switch roles when I explicitly ask"
+
+parallel_execution:
+  prompt: "Enable parallel multi-agent execution for independent tasks?"
+  default: "true"
+  result: "{value}"
+  single-select:
+    - value: "true"
+      label: "Yes - Run independent tasks in parallel"
+    - value: "false"
+      label: "No - Sequential execution only"
+
+planning_artifacts:
+  prompt: "Where should planning artifacts be stored? (Discovery phase output)"
+  default: "{output_folder}/discovery"
+  result: "{project-root}/{value}"
+
+implementation_artifacts:
+  prompt: "Where should implementation artifacts be stored? (Build & Ship phase output)"
+  default: "{output_folder}/build"
+  result: "{project-root}/{value}"
+
+project_knowledge:
+  prompt: "Where should long-term project knowledge be stored?"
+  default: "docs"
+  result: "{project-root}/{value}"
+
+# Directories to create during installation
+directories:
+  - "{planning_artifacts}"
+  - "{implementation_artifacts}"
+  - "{project_knowledge}"

package/src/bmad-plus/skills/bmad-plus-autopilot/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: bmad-plus-autopilot
+description: Launch autopilot mode — Nexus orchestrates the full pipeline from project idea to delivery with configurable checkpoints.
+---
+
+# BMAD+ Autopilot
+
+## Overview
+
+This skill enables full autopilot mode where the Orchestrator (Nexus) manages the entire development pipeline from a project idea to final delivery. The user provides a project concept, and Nexus sequences all agents through Discovery → Build → Ship phases with configurable checkpoints.
+
+## How It Works
+
+### Input
+A project idea or brief description. Examples:
+- "A SaaS for invoice management for SMBs"
+- "Add a notification system to the existing app"
+- "Refactor the authentication module to use OAuth2"
+
+### Pipeline
+
+The autopilot executes the following pipeline:
+
+#### Phase 1: Discovery
+1. **Strategist (Analyst role)** → Brainstorming & domain research
+2. **Strategist (PM role)** → Product brief
+3. **Strategist (PM role)** → PRD creation
+4. **Quality (UX role)** → UX design spec
+5. 🔴 **CHECKPOINT** → User reviews PRD + UX spec
+
+#### Phase 2: Build
+6. **Architect-Dev (Architect role)** → Architecture document
+7. 🔴 **CHECKPOINT** → User reviews architecture
+8. **Orchestrator (SM role)** → Epics & stories breakdown
+9. **Orchestrator (SM role)** → Sprint planning
+10. **For each story (parallelizable if independent):**
+    - **Architect-Dev (Dev role)** → Implement story
+    - **Quality (QA role)** → Test story
+    - If tests fail → loop back to Dev (max 3 retries)
+    - 🟡 **NOTIFY** → Story completion status
+
+#### Phase 3: Ship
+11. **Quality (QA role)** → Full code review
+12. **Quality (UX role)** → UX review
+13. **Architect-Dev (Tech Writer role)** → Documentation
+14. **Orchestrator (SM role)** → Retrospective
+15. 🔴 **CHECKPOINT** → User reviews final deliverable
+
+### Checkpoint Behavior
+
+Checkpoints are configurable via `module.yaml`:
+
+- **require_approval** (🔴 STOP): Pause execution, send WhatsApp notification, wait for user approval.
+- **notify_only** (🟡 INFO): Send notification, continue unless user intervenes.
+- **auto** (🟢 AUTO): Continue automatically. Log for audit trail.
+
+### State Management
+
+Autopilot state is persisted in `.bmad-plus/orchestrator-state.yaml`:
+
+```yaml
+pipeline:
+  project: "Invoice SaaS"
+  started: "2026-03-17T12:00:00Z"
+  current_phase: build
+  current_step: 10
+  status: running
+  
+completed_steps:
+  - step: 1
+    agent: strategist
+    role: analyst
+    output: brainstorming-report.md
+    completed: "2026-03-17T12:05:00Z"
+  # ...
+
+parallel_tasks:
+  - story: auth-api
+    status: completed
+  - story: dashboard
+    status: running
+```
+
+This enables `bmad-plus-autopilot --resume` to pick up where it left off.
+
+## Invocation
+
+```
+bmad-plus-autopilot
+```
+
+Or via the Orchestrator capabilities menu: `AP`
+
+## Error Handling
+
+- **Test failure**: Auto-retry up to 3 times, then escalate to user
+- **Agent error**: Log error, notify user, skip to next step if non-critical
+- **Conflict in parallel execution**: Pause conflicting agent, resolve, restart
+- **User timeout at checkpoint**: Send reminder after 24h, pause pipeline

package/src/bmad-plus/skills/bmad-plus-parallel/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: bmad-plus-parallel
+description: Enable parallel multi-agent execution for independent tasks. The orchestrator detects and supervises parallelizable work.
+---
+
+# BMAD+ Parallel Execution
+
+## Overview
+
+This skill enables the Orchestrator (Nexus) to detect independent tasks and execute them in parallel using multiple agent instances. The Parallel Supervisor monitors all running agents, handles conflicts, and manages workload reallocation.
+
+## Parallelization Detection
+
+The Parallel Supervisor analyzes the task queue and identifies parallelizable work based on these rules:
+
+### Parallelizable ✅
+- Stories with no shared file dependencies
+- Independent research tasks (market + technical)  
+- Tests running while documentation is being written
+- Changes to separate modules/packages
+
+### Sequential Only 🚫
+- Stories that modify the same files
+- Tasks where output B depends on output A
+- Architecture decisions before implementation
+- Code review after implementation
+
+## Execution Model
+
+```
+Orchestrator (Parallel Supervisor role)
+├── Detects 3 independent stories
+├── Launches Agent Instance 1 → Story A
+├── Launches Agent Instance 2 → Story B
+├── Launches Agent Instance 3 → Story C
+├── Monitors all instances via orchestrator-state.yaml
+├── Story A completes → launches QA for Story A
+├── Story C fails → pauses, analyzes, restarts with fix
+├── Story B completes → launches QA for Story B
+└── All complete → sync point, proceed to next phase
+```
+
+## Supervision Actions
+
+| Action | Trigger | Behavior |
+|--------|---------|----------|
+| **Launch** | Independent tasks detected | Start parallel agent sessions |
+| **Monitor** | Continuous | Track progress via state file |
+| **Pause** | Conflict detected | Stop conflicting agent |
+| **Restart** | After conflict resolution | Resume with merged context |
+| **Reallocate** | Agent finishes early | Assign next queued task |
+| **Escalate** | 3 consecutive failures | Notify human, pause pipeline |
+
+## State File
+
+All parallel execution state is tracked in `.bmad-plus/orchestrator-state.yaml`:
+
+```yaml
+parallel_tasks:
+  - id: task-001
+    agent: architect-dev
+    role: dev
+    story: story-auth-api.md
+    status: completed
+    started: "2026-03-17T12:00:00Z"
+    completed: "2026-03-17T12:15:00Z"
+    output_files: ["src/auth/api.js", "src/auth/api.test.js"]
+    
+  - id: task-002  
+    agent: architect-dev
+    role: dev
+    story: story-dashboard.md
+    status: running
+    started: "2026-03-17T12:00:00Z"
+    
+  - id: task-003
+    agent: architect-dev
+    role: dev
+    story: story-invoices.md
+    status: restarted
+    attempt: 2
+    restart_reason: "Conflict with task-001 on shared model file"
+```
+
+## Invocation
+
+```
+bmad-plus-parallel
+```
+
+Or via the Orchestrator capabilities menu: `PL`
+
+This skill is automatically invoked by the Autopilot when `{parallel_execution}` is enabled and independent tasks are detected.

package/src/bmad-plus/skills/bmad-plus-sync/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: bmad-plus-sync
+description: Synchronize BMAD+ with upstream BMAD-METHOD. Check for updates, analyze changes, and merge compatible updates.
+---
+
+# BMAD+ Upstream Sync
+
+## Overview
+
+This skill manages synchronization between your BMAD+ installation and the upstream BMAD-METHOD repository. It leverages the Audit 360° MCP Server (deployed on your VPS) for git operations, and the Gemini API for intelligent diff analysis.
+
+## Capabilities
+
+### Check for Updates
+```
+bmad-plus-sync check
+```
+Fetches upstream, compares with last sync, and reports:
+- 🟢 Compatible changes — safe to merge
+- 🟡 Review needed — may affect custom agents
+- 🔴 Breaking — requires manual intervention
+
+### Apply Compatible Updates
+```
+bmad-plus-sync apply
+```
+Auto-merges compatible upstream changes into BMAD+ core (leaves `src/bmad-plus/` untouched).
+
+### Full Report
+```
+bmad-plus-sync report
+```
+Generates a detailed report of all upstream changes since last sync, with AI analysis.
+
+## Architecture
+
+```
+bmad-plus-sync
+  ├─ Uses MCP Server (VPS) for:
+  │   ├─ git_clone_repo    — clone upstream on VPS
+  │   ├─ git_pull          — fetch latest changes
+  │   ├─ git_diff          — compare versions
+  │   ├─ git_log           — commit history
+  │   ├─ github_create_pr  — auto-PR for compatible changes
+  │   └─ github_push_files — update BMAD+ repo
+  │
+  ├─ Uses Gemini API for:
+  │   └─ AI-powered change classification
+  │
+  └─ Notifies via:
+      └─ WhatsApp (Evolution API) or Email
+```
+
+## Protected Paths
+
+The sync NEVER modifies these BMAD+ custom paths:
+- `src/bmad-plus/` — custom module (agents, skills, data)
+- `monitor/` — monitoring system  
+- `mcp-server/` — MCP server
+- `osint-agent-package/` — OSINT package
+
+## Invocation
+
+Invoke via the Orchestrator (Nexus) or directly:
+```
+bmad-plus-sync
+```
+
+This skill is also called automatically by the VPS weekly cron job.

package/tools/bmad-plus-npx.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+/**
+ * BMAD+ CLI — npx execution wrapper
+ * Ensures proper execution when run via npx from npm registry
+ */
+
+const { execSync } = require('node:child_process');
+const path = require('node:path');
+const fs = require('node:fs');
+
+const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
+
+if (isNpxExecution) {
+  const args = process.argv.slice(2);
+  const cliPath = path.join(__dirname, 'cli', 'bmad-plus-cli.js');
+
+  if (!fs.existsSync(cliPath)) {
+    console.error('Error: Could not find bmad-plus-cli.js at', cliPath);
+    process.exit(1);
+  }
+
+  try {
+    execSync(`node "${cliPath}" ${args.join(' ')}`, {
+      stdio: 'inherit',
+      cwd: process.cwd(),
+    });
+  } catch (error) {
+    process.exit(error.status || 1);
+  }
+} else {
+  require('./cli/bmad-plus-cli.js');
+}