bmad-plus 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to BMAD+ will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-03-17
+
+### 🎉 Initial Release — Foundation
+
+First release of BMAD+, an augmented fork of BMAD-METHOD v6.2.0.
+
+### Added
+
+#### Core Module (`src/bmad-plus/`)
+- **module.yaml** — Module configuration with execution mode, auto-role activation, parallel execution, and modular pack system
+- **module-help.csv** — Contextual help for all 8 registered skills/agents
+
+#### 5 Multi-Role Agents
+- **Atlas (Strategist)** — Fuses Analyst + PM into 2 switchable roles with auto-activation
+- **Forge (Architect-Dev)** — Fuses Architect + Dev + Tech Writer into 3 switchable roles
+- **Sentinel (Quality)** — Fuses QA + UX Designer into 2 switchable roles
+- **Nexus (Orchestrator)** — Fuses SM + Quick-Flow + new Autopilot Controller + new Parallel Supervisor (4 roles)
+- **Shadow (OSINT)** — Converted from legacy XML agent to BMAD+ v6 format (pack: osint)
+
+#### 3 Custom Skills
+- **bmad-plus-autopilot** — Full pipeline automation (Discovery → Build → Ship) with configurable checkpoints
+- **bmad-plus-parallel** — Multi-agent parallel execution with orchestrator supervision (launch/stop/restart/reallocate/escalate)
+- **bmad-plus-sync** — Upstream synchronization via VPS MCP Server
+
+#### Auto-Activation System
+- **role-triggers.yaml** — 3-level intelligent role switching:
+  - Level 1: Pattern matching (keywords in user requests)
+  - Level 2: Contextual analysis (domain detection during work)
+  - Level 3: Reasoning chains (logical discoveries during execution)
+
+#### Modular Pack System
+- **Core pack** (required) — 4 agents, 3 skills, role-triggers
+- **OSINT pack** (optional) — Shadow agent + OSINT investigation skills
+- **Maker pack** (optional) — Maker meta-agent for creating new BMAD+ compatible agents (4-phase pipeline: Discovery → Design → Generation → Validation)
+- **Audit pack** (coming soon) — Shield agent placeholder
+- Multi-select installer menu with per-pack API key requirements
+
+#### `npx bmad-plus install` CLI
+- Interactive installer with pack selection, IDE auto-detection, user config
+- Contextual post-install guide adapted to installed packs
+- `--packs`, `--yes`, `--tools`, `--directory` flags for non-interactive use
+- Uninstall command: `npx bmad-plus uninstall`
+
+#### Monitoring System (`monitor/`)
+- **weekly-check.py** — Weekly upstream monitoring script (cron)
+- **ai_analyzer.py** — Gemini API-powered diff analysis (compatible/review/breaking)
+- **notifier.py** — WhatsApp notifications via Evolution API + email fallback
+- **mcp_bridge.py** — Bridge to Audit 360° MCP Server for VPS git/github operations
+- **docker-compose.yml** — Evolution API container configuration
+- **config.example.yaml** — Configuration template
+
+#### Multi-IDE Support
+- **CLAUDE.md** — Claude Code configuration
+- **GEMINI.md** — Gemini CLI configuration
+- **AGENTS.md** — Codex CLI / OpenCode configuration
+
+#### Integration
+- Integrated existing **osint-agent-package** (Shadow agent, 55+ Apify actors, 7 APIs)
+- Integrated existing **mcp-server** (Audit 360° with 35 tools) via MCP Bridge
+
+### Upstream Compatibility
+- Based on BMAD-METHOD v6.2.0 (2026-03-15)
+- Compatible with core versions 6.0.0 — 7.0.0
+- Replaces `bmm` module while keeping core skills
+
+---
+
+*For earlier history, see the upstream [BMAD-METHOD CHANGELOG](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CHANGELOG.md).*

package/README.md

@@ -0,0 +1,482 @@
+# 🚀 BMAD+ — Augmented AI-Driven Development Framework
+
+[![Version](https://img.shields.io/badge/version-0.1.0-blue.svg)](CHANGELOG.md)
+[![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
+[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
+
+<div align="center">
+  🌐 <b>English</b> | <a href="readme-international/README.fr.md">Français</a> | <a href="readme-international/README.es.md">Español</a> | <a href="readme-international/README.de.md">Deutsch</a>
+</div>
+
+> Smart fork of [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6.2.0 — Multi-role self-activating agents, Autopilot mode, supervised parallel execution, and WhatsApp upstream monitoring.
+
+---
+
+## 📋 Table of Contents
+
+- [Why BMAD+?](#-why-bmad-)
+- [Quick Start](#-quick-start)
+- [Architecture](#-architecture)
+- [The 5 Agents](#-the-5-agents)
+- [Pack System](#-pack-system)
+- [Innovations](#-innovations)
+- [Supported IDEs](#-supported-ides)
+- [Upstream Monitoring](#-upstream-monitoring)
+- [Project Structure](#-project-structure)
+- [Configuration](#-configuration)
+- [Version History](#-version-history)
+- [License](#-license)
+
+---
+
+## 💡 Why BMAD+?
+
+BMAD-METHOD is an excellent framework with 9 specialized agents. But for a solo developer or a small team, 9 agents is too fragmented. BMAD+ solves this problem:
+
+| BMAD-METHOD | BMAD+ |
+|---|---|
+| 9 specialized agents | **5 multi-role agents** (11 roles total) |
+| Manual activation only | **Intelligent auto-activation** at 3 levels |
+| No automated pipeline | **Autopilot Mode**: idea → delivery |
+| Sequential execution | **Supervised parallelism** |
+| No upstream tracking | **Weekly monitoring** with WhatsApp |
+| 1-2 IDEs supported | **5 IDEs** with auto-detection |
+
+---
+
+## ⚡ Quick Start
+
+### Installation in an existing project
+
+```bash
+npx bmad-plus install
+```
+
+The installer:
+1. Automatically detects installed IDEs (Claude Code, Gemini CLI, Codex, etc.)
+2. Offers packs to install (Core, OSINT, Maker, Audit)
+3. Generates adapted configuration files
+4. Creates artifact folders
+
+### Usage after installation
+
+#### 💬 Who to talk to?
+
+| You want to... | Talk to | Example |
+|---|---|---|
+| Discuss a project idea | **Atlas** 🎯 | `Atlas, I have a project idea: a billing SaaS` |
+| Create a PRD / Product Brief | **Atlas** 🎯 | `Atlas, create the PRD for my project` |
+| Design the technical architecture | **Forge** 🏗️ | `Forge, propose an architecture for the app` |
+| Implement code | **Forge** 🏗️ | `Forge, implement story AUTH-001` |
+| Write documentation | **Forge** 🏗️ | `Forge, document the API` |
+| Test / do a code review | **Sentinel** 🔍 | `Sentinel, review the auth module` |
+| Plan a sprint | **Nexus** 🎼 | `Nexus, create epics and stories for the MVP` |
+| Automate everything from A to Z | **Nexus** 🎼 | `autopilot` then describe your project |
+| Investigate a person (OSINT) | **Shadow** 🔍 | `Shadow, investigate John Doe` |
+| Create a new BMAD+ agent | **Maker** 🧬 | `Maker, create a customer support agent` |
+
+#### 🚀 Typical Workflow (manual mode)
+
+```
+1. "Atlas, brainstorm on my [project] idea"
+   → Atlas analyzes, asks questions, proposes angles
+
+2. "Atlas, create the product brief"
+   → Deliverable: _bmad-output/discovery/product-brief.md
+
+3. "Atlas, write the PRD"
+   → Deliverable: _bmad-output/discovery/prd.md
+
+4. "Forge, propose the architecture"
+   → Deliverable: _bmad-output/discovery/architecture.md
+
+5. "Nexus, break down into epics and stories"
+   → Deliverable: _bmad-output/build/stories/
+
+6. "Forge, implement story [X]"
+   → Code generated + tests
+
+7. "Sentinel, test and review"
+   → QA report + suggestions
+```
+
+#### ⚡ Automatic Workflow (autopilot mode)
+
+```
+> autopilot
+> "A billing SaaS for SMBs with quote management"
+```
+
+Nexus automatically orchestrates everything with checkpoints for your approval.
+
+#### 🔑 Key Commands
+
+| Command | Description |
+|----------|-------------|
+| `bmad-help` | View all available agents and skills |
+| `autopilot` | Nexus takes control of the complete pipeline |
+| `parallel` | Launch multi-agent execution in parallel |
+
+---
+
+## 🏗️ Architecture
+
+```mermaid
+graph TB
+    subgraph Core["⚙️ Core Pack"]
+        AT[Atlas 🎯<br/>Strategist]
+        FG[Forge 🏗️<br/>Architect-Dev]
+        SN[Sentinel 🔍<br/>Quality]
+        NX[Nexus 🎼<br/>Orchestrator]
+    end
+
+    subgraph OSINT["🔍 OSINT Pack"]
+        SH[Shadow 🔍<br/>OSINT Intel]
+    end
+
+    subgraph Audit["🛡️ Audit Pack"]
+        SD["Shield 🛡️<br/>(coming soon)"]
+    end
+
+    NX -->|orchestrates| AT
+    NX -->|orchestrates| FG
+    NX -->|orchestrates| SN
+    NX -->|can invoke| SH
+
+    subgraph Skills["Custom Skills"]
+        AP[Autopilot]
+        PL[Parallel]
+        SY[Sync]
+    end
+
+    NX --> AP
+    NX --> PL
+    NX --> SY
+
+    subgraph VPS["VPS Infrastructure"]
+        MCP[MCP Server<br/>35 tools]
+        EVO[Evolution API<br/>WhatsApp]
+        MON[Weekly Monitor]
+    end
+
+    SY --> MCP
+    MON --> EVO
+    MON --> MCP
+```
+
+---
+
+## 🎭 The 5 Agents
+
+### Atlas — Strategist 🎯
+
+**Fuses:** Analyst (Mary) + Product Manager (John)
+
+| Role | Specialty | Auto-activation |
+|------|-----------|-----------------|
+| **Analyst** | Market research, SWOT, benchmarks, domain expertise | "analyze", "market", "benchmark", new project |
+| **Product Manager** | PRD, product briefs, user stories, roadmaps | "PRD", "roadmap", "MVP", planning phase |
+
+**Capabilities:** Brainstorming (BP), Market Research (MR), Domain Research (DR), Technical Research (TR), Product Brief (CB), PRD (PR), UX Design (CU), Document Project (DP)
+
+---
+
+### Forge — Architect-Dev 🏗️
+
+**Fuses:** Architect (Winston) + Developer (Amelia) + Tech Writer (Paige)
+
+| Role | Specialty | Auto-activation |
+|------|-----------|-----------------|
+| **Architect** | Technical design, API, scalability, stack choice | "architecture", "API", "schema", +5 files modified |
+| **Developer** | TDD implementation, code review, story execution | "implement", "code", "fix", post-architecture |
+| **Tech Writer** | Documentation, Mermaid diagrams, changelogs | "document", "README", post-implementation |
+
+**Capabilities:** Architecture (CA), Implementation Readiness (IR), Dev Story (DS), Code Review (CR), Quick Spec (QS), Quick Dev (QD), Document Project (DP)
+
+**Critical actions (Dev role):**
+- Read the ENTIRE story BEFORE implementation
+- Execute tasks IN ORDER
+- 100% passing tests BEFORE moving on
+- NEVER lie about tests
+
+---
+
+### Sentinel — Quality 🔍
+
+**Fuses:** QA Engineer (Quinn) + UX Designer (Sally)
+
+| Role | Specialty | Auto-activation |
+|------|-----------|-----------------|
+| **QA Engineer** | API/E2E tests, edge cases, coverage, code review | "test", "QA", "bug", post-implementation |
+| **UX Reviewer** | UX evaluation, accessibility, interaction design | "UX", "interface", "responsive", frontend changes |
+
+**Capabilities:** QA Tests (QA), Code Review (CR), UX Design (CU)
+
+---
+
+### Nexus — Orchestrator 🎼
+
+**Fuses:** Scrum Master (Bob) + Quick-Flow Solo Dev (Barry) + **Autopilot** (new) + **Parallel Supervisor** (new)
+
+| Role | Specialty | Auto-activation |
+|------|-----------|-----------------|
+| **Scrum Master** | Sprint planning, stories, retros, course correction | "sprint", "planning", "backlog" |
+| **Quick Flow** | Quick specs, hotfixes, minimum ceremony | "quick", "hotfix", "small fix" |
+| **Autopilot** | Pipeline automated idea→delivery with checkpoints | "autopilot", "manage everything", autopilot mode |
+| **Parallel Supervisor** | Concurrent multi-agent, conflict detection, reallocation | "parallel", independent tasks detected |
+
+**Capabilities:** Sprint Planning (SP), Create Story (CS), Epics & Stories (ES), Retrospective (ER), Course Correction (CC), Sprint Status (SS), Quick Spec (QS), Quick Dev (QD), **Autopilot (AP)**, **Parallel (PL)**
+
+---
+
+### Shadow — OSINT Intelligence 🔍 *(OSINT Pack)*
+
+**Complete OSINT investigation agent.**
+
+| Capability | Description |
+|-----------|-------------|
+| **INV** | Complete investigation Phase 0→6 with scored dossier |
+| **QS** | Quick multi-engine search |
+| **LI/IG/FB** | LinkedIn, Instagram, Facebook scraping |
+| **PP** | MBTI / Big Five psychoprofile |
+| **CE** | Contact enrichment (email, phone) |
+| **DG** | Diagnostic of available tools/APIs |
+
+**Stack:** 55+ Apify actors, 7 search APIs, 100% Python stdlib, confidence grades A/B/C/D
+
+---
+
+### Maker — Agent Creator 🧬 *(Maker Pack)*
+
+**Meta-agent that creates other agents.** Give it a description → it generates a complete package.
+
+| Code | Description |
+|------|-------------|
+| **CA** | Create Agent — guided creation in 4 phases |
+| **QA** | Quick Agent — fast creation with sensible defaults |
+| **EA** | Edit Agent — modify an existing SKILL.md |
+| **VA** | Validate Agent — check BMAD+ compliance |
+| **PA** | Package Agent — generate the integration folder |
+
+**Pipeline:** Discovery → Design (user validation) → Generation → Validation
+**Output:** `_bmad-output/ready-to-integrate/` — ready to copy into BMAD+
+
+---
+
+## 📦 Pack System
+
+BMAD+ uses a modular pack system. Core is always installed, additional packs are optional.
+
+```
+npx bmad-plus install
+
+🎛️  Which packs to install?
+   Core (Atlas, Forge, Sentinel, Nexus) is always included.
+
+   🔍 OSINT — Shadow (investigation, scraping, psychoprofiling)
+   🧬 Agent Creator — Maker (design, build, package)
+   🛡️ Security Audit — Shield (vulnerability scan) [soon]
+   🤖 Install everything
+   None — Core only
+```
+
+| Pack | Agents | Skills | Status |
+|------|--------|--------|--------|
+| ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | autopilot, parallel, sync | ✅ Stable |
+| 🔍 **OSINT** | Shadow | bmad-osint-investigate | ✅ Stable |
+| 🧬 **Maker** | Maker | — | ✅ Stable |
+| 🛡️ **Audit** | Shield | bmad-audit-scan, bmad-audit-report | 🔜 Coming soon |
+
+Each pack defines:
+- Its agents and skills
+- Its required/optional API keys
+- Its external package (if applicable)
+
+---
+
+## ✨ Innovations
+
+### 1. 3-Level Intelligent Auto-Activation
+
+Each agent can **automatically** switch roles when the context requires it:
+
+| Level | Mechanism | Example |
+|--------|-----------|---------|
+| 🔤 **Pattern** | Keywords in the request | "review" → QA activated |
+| 🌐 **Contextual** | Domain detected during work | Financial calculations → QA auto-activated after code |
+| 🧠 **Reasoning** | Logic chain during execution | Architecture inconsistency → Architect auto-activated |
+
+The agent **announces** its auto-activations: *"💡 I'm switching to QA mode — financial calculations detected. Say 'skip' to stay in current mode."*
+
+Configuration: `src/bmad-plus/data/role-triggers.yaml`
+
+### 2. Autopilot Mode
+
+Give a project idea → Nexus orchestrates the complete pipeline:
+
+```
+📋 Discovery (Atlas)
+  └→ Brainstorming → Product Brief → PRD → UX Design
+  🔴 CHECKPOINT: PRD Approval
+
+🏗️ Build (Forge + Sentinel)
+  └→ Architecture → Epics → Stories → Sprint
+  🔴 CHECKPOINT: Architecture Approval
+  └→ For each story: Code → Tests → (retry if failed, max 3)
+  🟡 NOTIFY: Story status
+
+🚀 Ship (Sentinel + Forge)
+  └→ Code Review → UX Review → Documentation → Retro
+  🔴 CHECKPOINT: Final approval
+```
+
+**Configurable checkpoints:**
+- `require_approval` (🔴) — Pause, WhatsApp notification, wait
+- `notify_only` (🟡) — Notification, continues unless intervened
+- `auto` (🟢) — Continues automatically
+
+### 3. Supervised Parallel Execution
+
+The Orchestrator detects independent tasks and launches them in parallel:
+
+| Parallelizable ✅ | Sequential 🚫 |
+|---|---|
+| Stories without dependencies | Same file modified |
+| Research + tech audit | Story B depends on Story A |
+| Tests + documentation | Architecture before code |
+
+**Supervision actions:** Launch, Monitor, Stop, Restart, Reallocate, Escalate (3 failures → human notification)
+
+---
+
+## 🖥️ Supported IDEs
+
+The installer automatically detects IDEs and generates configs:
+
+| IDE | Config File | Detection |
+|-----|---------------|-----------|
+| Claude Code | `CLAUDE.md` | `.claude/` folder |
+| Gemini CLI | `GEMINI.md` | `.gemini/` folder |
+| Antigravity | `.gemini/` + `.agents/` | Antigravity Extension |
+| Codex CLI | `AGENTS.md` | `.codex/` folder |
+| OpenCode | `OPENCODE.md` | opencode config |
+
+---
+
+## 📡 Upstream Monitoring
+
+### Weekly pipeline (cron VPS, Monday 9am)
+
+```
+1. git fetch upstream BMAD-METHOD
+2. Diff analysis (commits, modified files)
+3. AI analysis via Gemini API → classification
+   🟢 Compatible | 🟡 To check | 🔴 Breaking
+4. WhatsApp Notification via Evolution API
+5. Auto-PR if changes are compatible
+```
+
+### Stack
+- **weekly-check.py** — Main script (cron)
+- **ai_analyzer.py** — AI Classification (Gemini 2.0 Flash)
+- **notifier.py** — WhatsApp (Evolution API self-hosted) + email fallback
+- **mcp_bridge.py** — Bridge to Audit 360° MCP Server (git/github ops)
+
+---
+
+## 📁 Project Structure
+
+```
+BMAD+/
+├── README.md                      ← This file (English)
+├── readme-international/          ← Translated READMEs (fr, es, de)
+├── CHANGELOG.md                   ← Version history
+├── CLAUDE.md                      ← Claude Code Config
+├── GEMINI.md                      ← Gemini CLI Config
+├── AGENTS.md                      ← Codex CLI / OpenCode Config
+├── .gitignore
+│
+├── src/
+│   └── bmad-plus/                 ⭐ CUSTOM MODULE
+│       ├── module.yaml            ← Module + packs config
+│       ├── module-help.csv        ← Contextual help
+│       ├── agents/
+│       │   ├── agent-strategist/  ← Atlas (analyst + pm)
+│       │   ├── agent-architect-dev/ ← Forge (architect + dev + tw)
+│       │   ├── agent-quality/     ← Sentinel (qa + ux)
+│       │   ├── agent-orchestrator/ ← Nexus (sm + qf + autopilot + parallel)
+│       │   ├── agent-maker/       ← Maker (meta-agent) [pack: maker]
+│       │   └── agent-shadow/      ← Shadow (osint) [pack: osint]
+│       ├── skills/
+│       │   ├── bmad-plus-autopilot/ ← Automated pipeline
+│       │   ├── bmad-plus-parallel/  ← Parallel execution
+│       │   └── bmad-plus-sync/      ← Upstream sync
+│       └── data/
+│           └── role-triggers.yaml ← Auto-activation rules
+│
+├── monitor/                       🤖 VPS SURVEILLANCE
+│   ├── weekly-check.py            ← Main script (cron)
+│   ├── ai_analyzer.py             ← AI Analysis (Gemini API)
+│   ├── notifier.py                ← WhatsApp + email
+│   ├── mcp_bridge.py              ← Bridge to MCP Server
+│   ├── config.example.yaml        ← Configuration template
+│   └── docker-compose.yml         ← Evolution API
+│
+├── mcp-server/                    🛡️ AUDIT 360° MCP
+│   ├── server.py                  ← 35 tools, 7 modules
+│   └── tools/                     ← git_ops, github_ops, etc.
+│
+├── osint-agent-package/           🔍 OSINT PACKAGE
+│   ├── agents/                    ← Shadow Agent (original)
+│   ├── skills/                    ← 55+ Apify actors
+│   └── install.ps1                ← Installation script
+│
+└── upstream/                      📦 UPSTREAM REFERENCE
+    └── (clone of BMAD-METHOD)     ← Excluded from repo (.gitignore)
+```
+
+---
+
+## ⚙️ Configuration
+
+### Module variables (`module.yaml`)
+
+| Variable | Description | Values |
+|----------|-------------|---------|
+| `project_name` | Project name | Auto-detected |
+| `user_skill_level` | Dev level | beginner, intermediate, expert |
+| `execution_mode` | Execution mode | manual, autopilot, hybrid |
+| `auto_role_activation` | Role auto-switch| true, false |
+| `parallel_execution` | Parallelism | true, false |
+| `install_packs` | Installed packs | core, osint, maker, audit, all |
+
+### API Keys (depending on packs)
+
+| Key | Pack | Usage |
+|-----|------|-------|
+| `GEMINI_API_KEY` | Monitor | AI Analysis of upstream diffs |
+| `EVOLUTION_API_KEY` | Monitor | WhatsApp Notifications |
+| `APIFY_API_TOKEN` | OSINT | Social media scraping |
+| `PERPLEXITY_API_KEY` | OSINT | Enriched search |
+
+---
+
+## 📜 Version History
+
+| Version | Date | Description |
+|---------|------|-------------|
+| **0.1.0** | 2026-03-17 | 🎉 Foundation — 6 agents (Atlas, Forge, Sentinel, Nexus, Shadow, Maker), 3 skills, pack system, monitoring, multi-IDE support |
+
+See [CHANGELOG.md](CHANGELOG.md) for full details.
+
+---
+
+## 📄 License
+
+MIT — Based on [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT)
+
+### Credits
+
+- **BMAD-METHOD** by [bmad-code-org](https://github.com/bmad-code-org) — Base framework
+- **OSINT Pipeline** based on [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
+- **Apify Actor Runner** integrated from [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)

package/osint-agent-package/README.md

@@ -0,0 +1,88 @@
+# 🔍 OSINT Agent Package — BMAD Compatible
+
+Agent d'intelligence OSINT pour les installations BMAD. De un nom ou pseudo à un dossier complet avec psychoprofil, parcours professionnel et grades de confiance.
+
+## Features
+- 🔎 Investigation complète Phase 0→6 (recherche → dossier formaté)
+- 🧠 Psychoprofile MBTI / Big Five
+- 📊 55+ Apify actors (Instagram, LinkedIn, Facebook, TikTok, YouTube...)
+- 🌐 7 APIs de recherche (Perplexity, Exa, Tavily, Jina, Parallel, BrightData)
+- ⚡ Recherche parallèle multi-moteurs
+- 🐍 **100% Python stdlib** — zéro dépendance externe
+- 🖥️ **Cross-platform** — Windows, macOS, Linux
+
+## Prérequis
+- Python 3.10+
+- BMAD Method installé
+- Au minimum 1 clé API (voir [SETUP_KEYS.md](SETUP_KEYS.md))
+
+## Installation rapide
+
+### Option 1 : Script automatique (Windows)
+```powershell
+.\install.ps1
+```
+
+### Option 2 : Manuel
+1. Copier l'agent dans BMAD :
+```
+agents/osint-investigator.md  →  {project}/_bmad/bmm/agents/
+```
+
+2. Copier les 2 skills :
+```
+skills/bmad-osint-investigator/  →  {project}/.agents/skills/
+skills/bmad-osint-investigate/   →  {project}/.agents/skills/
+```
+
+3. Configurer les clés API (voir [SETUP_KEYS.md](SETUP_KEYS.md))
+
+4. Tester :
+```
+python skills/bmad-osint-investigate/osint/scripts/diagnose.py
+```
+
+## Utilisation
+1. Invoquer le skill `bmad-osint-investigator` dans votre AI agent
+2. L'agent "Shadow" s'active avec son menu :
+   - `[INV]` Investigation complète
+   - `[QS]` Recherche rapide
+   - `[LI]` Scrape LinkedIn
+   - `[IG]` Scrape Instagram
+   - `[PP]` Psychoprofile
+   - `[CE]` Enrichissement contact
+   - `[DG]` Diagnostic outils
+
+## Structure du package
+```
+osint-agent-package/
+├── README.md               ← Ce fichier
+├── SETUP_KEYS.md            ← Guide de configuration des clés API
+├── install.ps1              ← Script d'installation (Windows)
+├── install.sh               ← Script d'installation (macOS/Linux)
+├── agents/
+│   └── osint-investigator.md   ← Agent BMAD "Shadow"
+└── skills/
+    ├── bmad-osint-investigator/
+    │   └── SKILL.md            ← Point d'entrée agent
+    └── bmad-osint-investigate/
+        ├── SKILL.md            ← Skill d'investigation
+        └── osint/
+            ├── SKILL.md        ← Pipeline complet (452 lignes)
+            ├── assets/         ← Template dossier
+            ├── references/     ← Docs plateformes, outils, psycho
+            └── scripts/        ← 10 scripts Python (stdlib only)
+```
+
+## Sécurité
+- ✅ Audit de sécurité complet réalisé (14 fichiers analysés)
+- ✅ Aucun trojan, backdoor, ou code malveillant
+- ✅ Zéro dépendance externe — uniquement Python stdlib
+- ✅ Les clés API restent locales (variables d'environnement)
+
+## Crédits
+- Pipeline OSINT basé sur [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT License)
+- Apify Actor Runner intégré de [apify/agent-skills](https://github.com/apify/agent-skills) (MIT License)
+
+## Licence
+MIT