bmad-plus 0.12.0 → 0.12.2

package/readme-international/README.es.md

@@ -1,606 +1,613 @@
-# 🚀 BMAD+ — Framework Multi-Agente IA Aumentado
-
-[![Version](https://img.shields.io/badge/version-0.9.0-blue.svg)](../CHANGELOG.md)
-[![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
-[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
-
-<div align="center">
-  <a href="../README.md">English</a> | <a href="README.fr.md">Français</a> | 🌐 <b>Español</b> | <a href="README.de.md">Deutsch</a>
-</div>
-
-> **56+ agentes multirrol · 9 packs modulares · Modo Autopilot · Ejecución paralela · 143 tests**
-> Fork inteligente de [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — Agentes auto-activables con detección contextual en 3 niveles, cumplimiento GRC (Shield), pipeline SDLC completo (Dev Studio), inteligencia OSINT, auditoría SEO, memoria persistente cross-session e instalador CLI en 10 idiomas.
-
----
-
-## 📋 Tabla de contenidos
-
-- [¿Por qué BMAD+?](#-por-qué-bmad-)
-- [Inicio Rápido](#-inicio-rápido)
-- [Arquitectura](#-arquitectura)
-- [Los 56+ Agentes](#los-56-agentes)
-- [Sistema de Packs](#-sistema-de-packs)
-- [Innovaciones](#-innovaciones)
-- [IDE Soportados](#-ide-soportados)
-- [Monitorización Upstream](#-monitorización-upstream)
-- [Estructura del Proyecto](#-estructura-del-proyecto)
-- [Configuración](#-configuración)
-- [Historial de Versiones](#-historial-de-versiones)
-- [Licencia](#-licencia)
-
----
-
-## 💡 ¿Por qué BMAD+?
-
-BMAD-METHOD es un excelente framework con 9 agentes especializados. Pero para un desarrollador en solitario o un equipo pequeño, 9 agentes está demasiado fragmentado. BMAD+ resuelve este problema:
-
-| BMAD-METHOD | BMAD+ |
-|---|---|
-| 9 agentes especializados | **56+ agentes** (12 roles en total) |
-| Activación manual únicamente | **Auto-activación inteligente** en 3 niveles |
-| Sin pipeline automatizado | **Modo Autopilot**: idea → entrega |
-| Ejecución secuencial | **Paralelismo supervisado** |
-| Sin seguimiento upstream | **Monitorización semanal** con WhatsApp |
-| 1-2 IDEs soportados | **5 IDEs** con auto-detección |
-
----
-
-## ⚡ Inicio Rápido
-
-### Instalación en un proyecto existente
-
-```bash
-npx bmad-plus install
-```
-
-El instalador:
-1. Detecta automáticamente los IDE instalados (Claude Code, Gemini CLI, Codex, etc.)
-2. Ofrece los packs a instalar (Core, OSINT, Maker, Audit)
-3. Genera los archivos de configuración adaptados
-4. Crea las carpetas de artefactos
-
-### Uso después de la instalación
-
-#### 💬 ¿Con quién hablar?
-
-**📊 Estrategia & Descubrimiento**
-
-| Quieres... | Habla con | Ejemplo |
-|---|---|---|
-| Brainstorming de una idea | **Atlas** 🎯 | `Atlas, tengo una idea de proyecto: un SaaS de facturación` |
-| Investigación de mercado/dominio | **Atlas** 🎯 | `Atlas, analiza el mercado de apps de notas con IA` |
-| Crear un PRD / Product Brief | **Atlas** 🎯 | `Atlas, crea el PRD para mi proyecto` |
-| Diseñar wireframes UX | **Atlas** 🎯 | `Atlas, diseña la UX del flujo de onboarding` |
-
-**🏗️ Arquitectura & Desarrollo**
-
-| Quieres... | Habla con | Ejemplo |
-|---|---|---|
-| Diseñar arquitectura técnica | **Forge** 🏗️ | `Forge, propón una arquitectura para la app` |
-| Implementar una user story | **Forge** 🏗️ | `Forge, implementa la historia AUTH-001` |
-| Escribir/actualizar documentación | **Forge** 🏗️ | `Forge, documenta la API` |
-| Hotfix rápido o cambio pequeño | **Forge** 🏗️ | `Forge, quick dev: agrega un spinner de carga` |
-
-**🔍 Calidad & Revisión**
-
-| Quieres... | Habla con | Ejemplo |
-|---|---|---|
-| Revisión de código | **Sentinel** 🔍 | `Sentinel, revisa el módulo auth` |
-| Escribir tests (unit/E2E) | **Sentinel** 🔍 | `Sentinel, escribe tests E2E para el checkout` |
-| Auditoría UX / accesibilidad | **Sentinel** 🔍 | `Sentinel, revisa la UX del dashboard` |
-
-**🎼 Gestión de Proyecto**
-
-| Quieres... | Habla con | Ejemplo |
-|---|---|---|
-| Planificar un sprint | **Nexus** 🎼 | `Nexus, crea épicas e historias para el MVP` |
-| Automatizar todo (A a Z) | **Nexus** 🎼 | `autopilot` luego describe tu proyecto |
-| Ejecutar tareas en paralelo | **Nexus** 🎼 | `parallel` — detecta auto tareas independientes |
-| Retrospectiva de sprint | **Nexus** 🎼 | `Nexus, ejecuta una retro del Sprint 3` |
-
-**🕵️ Inteligencia & Packs Especializados**
-
-| Quieres... | Habla con | Ejemplo |
-|---|---|---|
-| Investigar a una persona (OSINT) | **Shadow** 🕵️ | `Shadow, investiga a John Doe` |
-| Crear un nuevo agente BMAD+ | **Maker** 🧬 | `Maker, crea un agente de soporte al cliente` |
-| Recordar decisiones pasadas | **Zecher** 🧠 | `Zecher, ¿qué decidimos sobre la estrategia de auth?` |
-| Resumen de sesión (handoff) | **Zecher** 🧠 | `Zecher, crea un handoff para la próxima sesión` |
-
-#### 🚀 Flujo de trabajo típico (modo manual)
-
-```
-1. "Atlas, haz una lluvia de ideas sobre mi [proyecto]"
-   → Atlas analiza, hace preguntas, propone enfoques
-
-2. "Atlas, crea el product brief"
-   → Entregable: _bmad-output/discovery/product-brief.md
-
-3. "Atlas, redacta el PRD"
-   → Entregable: _bmad-output/discovery/prd.md
-
-4. "Forge, propón la arquitectura"
-   → Entregable: _bmad-output/discovery/architecture.md
-
-5. "Nexus, divide en épicas e historias"
-   → Entregable: _bmad-output/build/stories/
-
-6. "Forge, implementa la historia [X]"
-   → Código generado + pruebas
-
-7. "Sentinel, prueba y revisa"
-   → Informe de QA + sugerencias
-```
-
-#### ⚡ Flujo de trabajo automático (modo autopilot)
-
-```
-> autopilot
-> "Un SaaS de facturación para pymes con gestión de presupuestos"
-```
-
-Nexus orquesta todo automáticamente con puntos de control (checkpoints) para tu aprobación.
-
-#### 💬 Comandos clave
-
-| Comando | Descripción |
-|----------|-------------|
-| `bmad-help` | Ver todos los agentes y habilidades disponibles |
-| `autopilot` | Nexus toma el control del pipeline completo |
-| `parallel` | Iniciar ejecución multi-agente en paralelo |
-
-
-#### 🔧 Comandos CLI
-
-| Comando | Descripción |
-|---------|-------------|
-| `npx bmad-plus install` | Instalador interactivo con selección de packs y detección IDE |
-| `npx bmad-plus scan [ruta]` | Descubrir e indexar proyectos en el cerebro global |
-| `npx bmad-plus memory status` | Informe de salud de memoria (proyecto + cerebro global) |
-| `npx bmad-plus memory export` | Exportar cerebro como archivo Markdown portable |
-| `npx bmad-plus doctor` | Verificar integridad de la instalación |
-| `npx bmad-plus update` | Actualizar agentes y skills (preserva la config) |
-| `npx bmad-plus uninstall` | Eliminar BMAD+ del proyecto actual |
-| `npx bmad-plus autoconfig` | Bootstrap inteligente — detección auto, instalación y configuración |
-
-#### 🔬 Opciones de instalación avanzadas
-
-```bash
-# Instalación no-interactiva — todos los packs, auto-detección IDE
-npx bmad-plus install --packs all --yes
-
-# Instalar sin sobrescribir configs IDE (CLAUDE.md, GEMINI.md, etc.)
-npx bmad-plus install --tools none
-
-# Instalar packs específicos
-npx bmad-plus install --packs core,memory,osint
-
-# Instalar en otro directorio
-npx bmad-plus install --directory /ruta/al/proyecto
-```
-
-> **💡 Consejo dogfooding:** Usa `--tools none` cuando BMAD+ se instala en un proyecto que ya tiene configs IDE manuales. Instala agentes, skills y memoria sin sobrescribir tus `CLAUDE.md`, `GEMINI.md` o `AGENTS.md`.
-
-#### 🔍 Opciones de scan
-
-```bash
-# Escanear un disco o directorio
-npx bmad-plus scan D:\DEV
-
-# Umbrales personalizados para el estado del proyecto
-npx bmad-plus scan . --active-days 7 --paused-days 90
-
-# Auto-indexar todo sin confirmación
-npx bmad-plus scan D:\DEV --yes --depth 6
-```
-
-> Leyenda de estados: 🟢 **activo** (modificado < 30 días), 🟡 **en pausa** (30–180 días), ⚪ **archivado** (> 180 días). Umbrales personalizables con `--active-days` y `--paused-days`.
-
----
-
-## 🏗️ Arquitectura
-
-```mermaid
-graph TB
-    subgraph Core["⚙️ Core Pack"]
-        AT["Atlas 🎯"]
-        FG["Forge 🏗️"]
-        SN["Sentinel 🔍"]
-        NX["Nexus 🎼"]
-    end
-
-    subgraph Packs["📦 Modular Packs"]
-        SH["Shadow 🕵️ OSINT"]
-        MK["Maker 🧬"]
-        ZC["Zecher 🧠 Memory"]
-        SD["Shield 🛡️ GRC 38 agents"]
-        DS["Dev Studio 🏗️ SDLC 6 agents"]
-        SEO["SEO Engine 🔎 3 agents"]
-        BK["Backup 🗂️"]
-        AN["Animated 🎬"]
-    end
-
-    subgraph Skills["⚡ Core Skills"]
-        AP[Autopilot]
-        PL[Parallel]
-    end
-
-    NX -->|orchestrates| AT
-    NX -->|orchestrates| FG
-    NX -->|orchestrates| SN
-    NX -->|invokes| SH
-    NX -->|invokes| MK
-    NX --> AP
-    NX --> PL
-    ZC -.->|context| NX
-```
-
----
-
-## 🎭 Los 56+ Agentes
-
-### Atlas — Strategist 🎯
-
-**Fusiona:** Analyst (Mary) + Product Manager (John)
-
-| Rol | Especialidad | Auto-activación |
-|------|-----------|-----------------|
-| **Analyst** | Investigación de mercado, FODA, benchmarks | "analiza", "mercado", "benchmark", nuevo proyecto |
-| **Product Manager** | PRD, product briefs, historias de usuario, roadmaps | "PRD", "roadmap", "MVP", fase de planificación |
-
-**Capacidades:** 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 🏗️
-
-**Fusiona:** Architect (Winston) + Developer (Amelia) + Tech Writer (Paige)
-
-| Rol | Especialidad | Auto-activación |
-|------|-----------|-----------------|
-| **Architect** | Diseño técnico, API, escalabilidad, elección de stack | "arquitectura", "API", "schema", +5 archivos modificados |
-| **Developer** | Implementación TDD, revisión de código, historias | "implementa", "código", "fix", post-arquitectura |
-| **Tech Writer** | Documentación, diagramas Mermaid, changelogs | "documenta", "README", post-implementación |
-
-**Capacidades:** Architecture (CA), Implementation Readiness (IR), Dev Story (DS), Code Review (CR), Quick Spec (QS), Quick Dev (QD), Document Project (DP)
-
-**Acciones críticas (rol Dev):**
-- Leer TODA la historia ANTES de implementar
-- Ejecutar las tareas EN ORDEN
-- 100% pruebas aprobadas ANTES de avanzar
-- NUNCA mentir sobre las pruebas
-
----
-
-### Sentinel — Quality 🔍
-
-**Fusiona:** QA Engineer (Quinn) + UX Designer (Sally)
-
-| Rol | Especialidad | Auto-activación |
-|------|-----------|-----------------|
-| **QA Engineer** | Pruebas API/E2E, edge cases, cobertura, revisión de código | "prueba", "QA", "bug", post-implementación |
-| **UX Reviewer** | Evaluación de UX, accesibilidad, diseño de interacción | "UX", "interfaz", "responsive", cambios frontend |
-
-**Capacidades:** QA Tests (QA), Code Review (CR), UX Design (CU)
-
----
-
-### Nexus — Orchestrator 🎼
-
-**Fusiona:** Scrum Master (Bob) + Quick-Flow Solo Dev (Barry) + **Autopilot** (nuevo) + **Parallel Supervisor** (nuevo)
-
-| Rol | Especialidad | Auto-activación |
-|------|-----------|-----------------|
-| **Scrum Master** | Planificación de sprints, historias, retrospectivas | "sprint", "planificación", "backlog" |
-| **Quick Flow** | Specs rápidas, hotfixes, mínima ceremonia | "rápido", "hotfix", "pequeño fix" |
-| **Autopilot** | Pipeline automatizado idea→entrega con checkpoints | "autopilot", "gestiona todo", modo autopilot |
-| **Parallel Supervisor** | Múltiples agentes en concurrencia, reasignación | "paralelo", tareas independientes detectadas |
-
-**Capacidades:** 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 🔍 *(Pack OSINT)*
-
-**Agente completo de investigación OSINT.**
-
-| Capacidad | Descripción |
-|-----------|-------------|
-| **INV** | Investigación completa Fase 0→6 con informe puntuado |
-| **QS** | Búsqueda rápida multi-motor |
-| **LI/IG/FB** | Scraping de LinkedIn, Instagram, Facebook |
-| **PP** | Psicoperfil MBTI / Big Five |
-| **CE** | Enriquecimiento de contactos (email, teléfono) |
-| **DG** | Diagnóstico de herramientas/APIs disponibles |
-
-**Tecnología:** MÁS de 55 actores de Apify, 7 APIs de búsqueda, python estándar 100%, grados A/B/C/D
-
----
-
-### Maker — Agent Creator 🧬 *(Pack Maker)*
-
-**Meta-agente que crea otros agentes.** Dale una descripción → genera un paquete completo.
-
-| Capacidad | Descripción |
-|------|-------------|
-| **CA** | Create Agent — creación guiada en 4 fases |
-| **QA** | Quick Agent — creación rápida con valores por defecto con sentido |
-| **EA** | Edit Agent — modificar un SKILL.md existente |
-| **VA** | Validate Agent — verificar cumplimiento BMAD+ |
-| **PA** | Package Agent — generar carpeta de integración |
-
-**Pipeline:** Discovery → Design (aprobación del usuario) → Generación → Validación
-**Salida:** `_bmad-output/ready-to-integrate/` — listo para copiar a BMAD+
-
----
-
-### Zecher — Guardián de la Memoria 🧠 *(Pack Memory)*
-
-**Agente de memoria persistente cross-session.** Mantiene el conocimiento del proyecto entre conversaciones.
-
-| Capacidad | Descripción |
-|-----------|-------------|
-| **Session Handoff** | Crea automáticamente resúmenes de sesión con decisiones, patrones y lecciones |
-| **Context Recall** | Recupera decisiones/patrones relevantes al inicio de cada conversación |
-| **Brain Health** | Monitorea la integridad de los archivos de memoria y detecta obsolescencia |
-| **Cross-Project** | Vincula la memoria del proyecto al cerebro global (`~/.bmad-plus/brain/`) |
-| **Karpathy Guardrails** | Previene memorias alucinadas — cada entrada necesita evidencia fuente |
-
-**Archivos de memoria:** `decisions.md`, `lessons.md`, `patterns.md`, `context.md`, `sessions/`
-
-## 📦 Sistema de Packs
-
-BMAD+ utiliza un sistema modular por packs. El Core siempre está instalado, y los demás packs son opcionales.
-
-```
-npx bmad-plus install
-
-🎛️  ¿Qué packs instalar?
-   Core (Atlas, Forge, Sentinel, Nexus) siempre incluido.
-
-   🔍 OSINT — Shadow (investigación, scraping, psicoperfil)
-   🧬 Agent Creator — Maker (diseño, desarrollo, empaque)
-   🛡️ Shield GRC — 38 agentes de cumplimiento (GDPR, ISO 27001, SOC 2, HIPAA...)
-   🏗️ Dev Studio — 6 agentes SDLC (ciclo de vida completo: diseño a despliegue)
-   🔎 SEO — Scout, Chief, Judge (auditoría 6 fases, PageSpeed)
-   🧠 Memory — Zecher (cerebro persistente, handoff sessions)
-   🗂️ Backup — Archivo inteligente con versionado
-   🎬 Animated — Sitios web animados scroll-driven
-   🤖 Instalar todo
-   Ninguno — Solo Core
-```
-
-| Pack | Agentes | Descripción | Estado |
-|------|--------|-------------|--------|
-| ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | Ciclo de vida dev completo: estrategia → arquitectura → código → QA | ✅ Estable |
-| 🔍 **OSINT** | Shadow | Investigación, scraping social, psicoperfil (55+ actores Apify) | ✅ Estable |
-| 🧬 **Maker** | Maker | Diseñar, construir, validar y empaquetar nuevos agentes BMAD+ | ✅ Estable |
-| 🛡️ **Shield** | 38 agentes de cumplimiento | GRC en 25+ frameworks: GDPR, ISO 27001, SOC 2, HIPAA, PCI DSS, EU AI Act, DORA, NIS2 | ✅ Estable |
-| 🏗️ **Dev Studio** | 6 agentes specialized SDLC | SDLC completo: brainstorm → PRD → arquitectura → TDD → review (30 workflows) | ✅ Estable |
-| 🔍 **SEO** | Scout, Chief, Judge | Auditoría SEO 6 fases, bucle PageSpeed, APIs Google, benchmark competitivo | ✅ Estable |
-| 🗂️ **Backup** | Backup Agent | ZIP con marca de tiempo y exclusiones inteligentes | ✅ Estable |
-| 🎬 **Animated** | Animated Website Agent | Sitio web lujoso scroll-driven desde video | ✅ Estable |
-| 🧠 **Memory** | Zecher | Cerebro cross-session, scanner de proyectos, guardrails Karpathy | ✅ Estable |
-
-Cada pack define:
-- Sus agentes, habilidades y workflows
-- Llaves de API obligatorias/opcionales
-- Paquete externo (si aplica)
-- Reglas de cohabitación con otros packs
-
----
-
-## ✨ Innovaciones
-
-### 1. Auto-Activación Inteligente a 3 Niveles
-
-Cada agente puede **automáticamente** cambiar de rol según el contexto:
-
-| Nivel | Mecanismo | Ejemplo |
-|--------|-----------|---------|
-| 🔤 **Patrón** | Palabras clave en el pedido | "revisa" → QA activado |
-| 🌐 **Contexto** | Detecta el tipo de tarea | Cálculos financieros detectados → QA auto-activado tras escribir código |
-| 🧠 **Razonamiento** | Cadena lógica | Inconsistencia de arquitectura → Architect auto-activado |
-
-El agente **anuncia** el cambio: *"💡 I'm switching to QA mode — financial calculations detected. Say 'skip' to stay in current mode."*
-
-Configuración: `src/bmad-plus/data/role-triggers.yaml`
-
-### 2. Modo Autopilot
-
-Introduce una idea → Nexus gestionará todo:
-
-```
-📋 Discovery (Atlas)
-  └→ Brainstorming → Product Brief → PRD → UX Design
-  🔴 CHECKPOINT: Aprobación del PRD
-
-🏗️ Build (Forge + Sentinel)
-  └→ Arquitectura → Épicas → Historias → Sprint
-  🔴 CHECKPOINT: Aprobación de Arquitectura
-  └→ Por historia: Código → Pruebas → (reintentos si falla, máximo 3)
-  🟡 NOTIFY: Estado de la historia
-
-🚀 Ship (Sentinel + Forge)
-  └→ Revisión de Código → UX → Documentación → Retrospectiva
-  🔴 CHECKPOINT: Aprobación final
-```
-
-**Puntos de control (checkpoints) configurables:**
-- `require_approval` (🔴) — Pausa, notifica por WhatsApp, espera
-- `notify_only` (🟡) — Notifica, continúa (a menos que el usuario intervenga)
-- `auto` (🟢) — Totalmente automático
-
-### 3. Ejecución Paralela Supervisada
-
-El orquestador divide las tareas asíncronas para ejecutarlas de forma paralela:
-
-| Proceso paralelo ✅ | Proceso secuencial 🚫 |
-|---|---|
-| Múltiples historias sin dependencia | Tareas en el mismo archivo |
-| Research + revisión técnica de arquitectura | Historia B depende de A |
-| Tests QA + documentación en docs | Arquitectura antes que el código |
-
-**Supervisión en ejecución:** Iniciar, Detener, Reiniciar, Escalar (si un agente falla más de 3 veces, avisa al desarrollador)
-
----
-
-## 🖥️ IDE Soportados
-
-El instalador detecta automáticamente el IDE actual para generar la configuración nativa que conecte a BMAD+:
-
-| IDE | Archivo de Config. | Detección (carpeta) |
-|-----|---------------|-----------|
-| Claude Code | `CLAUDE.md` | `.claude/` |
-| Gemini CLI | `GEMINI.md` | `.gemini/` |
-| Antigravity | `.gemini/` + `.agents/` | Antigravity Extensión |
-| Codex CLI | `AGENTS.md` | `.codex/` |
-| OpenCode | `OPENCODE.md` | Opciones de opencode |
-
----
-
-## 📡 Monitorización Upstream
-
-### Pipeline semanal (cron VPS, lunes 9 AM)
-
-```
-1. Obtiene actualizaciones del proyecto raíz BMAD-METHOD
-2. Análisis "diff" sobre los archivos locales
-3. Procesado por Inteligencia Artificial "Gemini API"
-   🟢 Compatible | 🟡 Revisar manualmente | 🔴 Incompatible o "Breaking Change"
-4. Envía la actualización usando el WhatsApp registrado (Evolution API)
-5. Auto-PR en GH
-```
-
-### Stack
-- **weekly-check.py** — Archivo base usado mediante cron semanal
-- **ai_analyzer.py** — LLM de análisis (Gemini 2.0 Flash)
-- **notifier.py** — WhatsApp (API Evolution auto-hosteado) / fallback a correo local
-- **mcp_bridge.py** — Acceso Server para las API operativas.
-
----
-
-## 📁 Estructura del Proyecto
-
-```
-BMAD+/
-├── README.md                      ← Este archivo (Inglés)
-├── readme-international/          ← Versiones traducidas (es, fr, de)
-├── CHANGELOG.md                   ← Versiones de proyecto
-├── CLAUDE.md                      ← Config IDE: Claude
-├── GEMINI.md                      ← Config IDE: Gemini
-├── AGENTS.md                      ← Config IDE: Codex / Opencode
-├── .gitignore
-│
-├── src/
-│   └── bmad-plus/                 ⭐ MODULO PERSONALIZADO
-│       ├── module.yaml            ← Packs de entorno BMAD
-│       ├── module-help.csv        ← Ayuda rápida base de datos
-│       ├── 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-agente creativo) [pack: maker]
-│       │   └── agent-shadow/      ← Shadow (osint) [pack: osint]
-│       ├── skills/
-│       │   ├── bmad-plus-autopilot/ ← Orquestación completa
-│       │   ├── bmad-plus-parallel/  ← Supervisión concurrente
-│       │   └── bmad-plus-sync/      ← Sincronización automatizada código
-│       └── data/
-│           └── role-triggers.yaml ← Lógica de variables y keywords
-│
-├── monitor/                       🤖 CONTROL PARA VPS DE CAMBIOS DE BMAD-METHOD
-│   ├── weekly-check.py            ← Base Cron
-│   ├── ai_analyzer.py             ← IA Análisis (Gemini API)
-│   ├── notifier.py                ← WhatsApp (Evolution API) y correos
-│   ├── mcp_bridge.py              ← Puerto de servidor
-│   ├── config.example.yaml        ← Base de las contraseñas
-│   └── docker-compose.yml         ← Config para arrancar Evolution API
-│
-├── mcp-server/                    🛡️ AUDITOR / MCP BRIDGE
-│   ├── server.py                  ← Acceso general y de herramientas.
-│   └── tools/                     ← git, github operations
-│
-├── osint-agent-package/           🔍 MODULO INDEPENDIENTE DE OSINT
-│   ├── agents/                    ← Agente Shadow (version root)
-│   ├── skills/                    ← Apify actores 55+
-│   └── install.ps1                ← Script de instalación
-│
-└── upstream/                      📦 CLONE ORIGINAL (EXCLUIDO DEL REGISTRO LOCAL)
-    └── (BMAD-METHOD original)
-```
-
----
-
-## ⚙️ Configuración Módulo Central
-
-### Archivo principal (`module.yaml`)
-
-| Variable | Descripción | Valores Disponibles |
-|----------|-------------|---------|
-| `project_name` | Nombre del proyecto | Autodetectado |
-| `user_skill_level` | Nivel del equipo/persona | beginner, intermediate, expert |
-| `execution_mode` | Modo de uso general | manual, autopilot, hybrid |
-| `auto_role_activation` | Cambio al predecir contexto | true, false |
-| `parallel_execution` | Trabajos Multiagente | true, false |
-| `install_packs` | Packs Seleccionados a Integrar | core, osint, maker, audit, all |
-
-### Integración Personalizada (Apikey/Hooks)
-
-| KEY Sistema | Entorno / Pack | Actuación |
-|-----|------|-------|
-| `GEMINI_API_KEY` | Monitor | Comparación lógica de ramas Upstream |
-| `EVOLUTION_API_KEY` | Monitor | Sistema WhatsApp Notifier Server |
-| `APIFY_API_TOKEN` | OSINT | Extracción, Web Mining |
-| `PERPLEXITY_API_KEY` | OSINT | Buscador Complejo AI |
-
----
-
-## 📜 Historial de Versiones
-
-| Versión | Fecha | Descripción |
-|---------|------|-------------|
-| **0.1.0** | 2026-03-17 | 🎉 Fundación base de proyecto (6 agentes / 3 entornos de skills / Auto-detección IDEs locales). Se incorporó el Maker y paquete OSINT |
-| **0.2.0** | 2026-03-18 | 🔀 Fusión Oveanet — 3 nuevos packs utilitarios: SEO Audit 360, Universal Backup, Animated Website |
-| **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 agentes multirrol, 4 scripts Python, flujo 6 fases, bucle PageSpeed, análisis GEO |
-| **0.4.0** | 2026-03-19 | 🏢 SEO Engine v2.1 — Orquestador SKILL.md, APIs Google, informes HTML, benchmark competitivo, 50 tests, extensiones GSC + GA4 |
-| **0.4.1** | 2026-03-19 | 🌐 CLI 10 idiomas, pipeline CI/CD, `.npmignore`, endurecimiento de seguridad |
-| **0.4.2** | 2026-03-19 | 📦 Packs públicos — SEO/Backup/Animated en npm |
-| **0.4.3** | 2026-05-17 | 🔧 Comandos update + doctor, i18n completa, corrección de créditos |
-| **0.4.4** | 2026-05-17 | 🔧 Corrección codificación UTF-8, i18n completa 10 idiomas, 62 tests unitarios |
-| **0.5.0** | 2026-05-17 | 🛡️ **Pack Shield** — 38 agentes de cumplimiento GRC, 7 categorías, 25+ frameworks (GDPR, ISO 27001, SOC 2, EU AI Act...) |
-| **0.6.0** | 2026-05-17 | 🏗️ **Pack Dev Studio** — 6 agentes SDLC (Miriam, Yosef, Bezalel...) + 30 flujos de trabajo SDLC, BWML DSL |
-| **0.9.0** | 2026-06-24 | 🚀 **Aumentado & Seguro** — 3 nuevos packs (animated, backup, seo), corrección P0 seguridad, 143/143 tests |
-| **0.8.0** | 2026-06-24 | 🚀 **Aumentado & Seguro** — 3 nuevos packs (animated, backup, seo), corrección P0 seguridad, 143/143 tests |
-
-Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
-
----
-
-## 📄 Licencias Integradas
-
-Proyecto BMAD+ (Adaptación: MIT)
-
-Basado nativamente en el repositorio: [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT LIC)
-
-### Reconocimientos
-
-**Creador**
-- **BMAD+** Creado por [Laurent Rochetta](https://github.com/lrochetta) ([LinkedIn](https://www.linkedin.com/in/laurentrochetta/))
-
-**Packs Originales** (creados por Laurent Rochetta)
-- **Dev Studio** — 6 agentes SDLC especializados: Miriam (analista de negocios), Huldah (redactora técnica), Yosef (gerente de producto), Rachel (diseñadora UX), Bezalel (arquitecto de sistemas), Oholiab (ingeniero senior) — 44 workflows que cubren todo el ciclo de vida desde la lluvia de ideas hasta el despliegue
-- **SEO Engine** — 3 agentes (Scout, Chief, Judge), pipeline de auditoría de 6 fases, bucle PageSpeed, integraciones con Google Search Console y GA4
-- **Memory Pack** — Agente Zecher para cerebro persistente cross-session con escáner de proyectos
-
-**Fuentes Externas e Inspiraciones**
-- **BMAD-METHOD** por [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — Metodología multi-agente original (MIT)
-- **Shield GRC** — 38 agentes de cumplimiento basados en textos regulatorios públicos (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, etc.)
-- **OSINT Pipeline** basado en [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
-- **Apify Actor Runner** integrado desde [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)
-- **Karpathy Guardrails** adaptado de [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) — Reglas de comportamiento para Memory Pack
-
-**Herramientas e Infraestructura**
-- [Evolution API](https://github.com/EvolutionAPI/evolution-api) — Notificaciones WhatsApp para monitoreo upstream
-- [Gemini API](https://ai.google.dev/) — Análisis IA para clasificación de cambios upstream
+# 🚀 BMAD+ — Framework Multi-Agente IA Aumentado
+
+[![Version](https://img.shields.io/badge/version-0.12.2-blue.svg)](../CHANGELOG.md)
+[![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
+[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
+
+<div align="center">
+  <a href="../README.md">English</a> | <a href="README.fr.md">Français</a> | 🌐 <b>Español</b> | <a href="README.de.md">Deutsch</a>
+</div>
+
+> **Agentes multirrol · 9 packs modulares · Modo Autopilot · Ejecución paralela**
+> Fork inteligente de [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) — Agentes auto-activables con detección contextual en 3 niveles, cumplimiento GRC (Shield), pipeline SDLC completo (Dev Studio), inteligencia OSINT, auditoría SEO, memoria persistente cross-session e instalador CLI en 10 idiomas.
+
+---
+
+## 📋 Tabla de contenidos
+
+- [¿Por qué BMAD+?](#-por-qué-bmad-)
+- [Inicio Rápido](#-inicio-rápido)
+- [Arquitectura](#-arquitectura)
+- [Los 47 Agentes](#los-47-agentes)
+- [Sistema de Packs](#-sistema-de-packs)
+- [Innovaciones](#-innovaciones)
+- [IDE Soportados](#-ide-soportados)
+- [Monitorización Upstream](#-monitorización-upstream)
+- [Estructura del Proyecto](#-estructura-del-proyecto)
+- [Configuración](#-configuración)
+- [Historial de Versiones](#-historial-de-versiones)
+- [Licencia](#-licencia)
+
+---
+
+## 💡 ¿Por qué BMAD+?
+
+BMAD-METHOD es un excelente framework con 9 agentes especializados. Pero para un desarrollador en solitario o un equipo pequeño, 9 agentes está demasiado fragmentado. BMAD+ resuelve este problema:
+
+| BMAD-METHOD | BMAD+ |
+|---|---|
+| 9 agentes especializados | **47 agentes** en 9 packs |
+| Activación manual únicamente | **Auto-activación inteligente** en 3 niveles |
+| Sin pipeline automatizado | **Modo Autopilot**: idea → entrega |
+| Ejecución secuencial | **Paralelismo supervisado** |
+| Sin seguimiento upstream | **Monitorización semanal** con WhatsApp |
+| 1-2 IDEs soportados | **5 IDEs** con auto-detección |
+
+---
+
+## ⚡ Inicio Rápido
+
+### Instalación en un proyecto existente
+
+```bash
+npx bmad-plus install
+```
+
+El instalador:
+1. Detecta automáticamente los IDE instalados (Claude Code, Gemini CLI, Codex, etc.)
+2. Ofrece los packs a instalar (Core, OSINT, Maker, Audit)
+3. Genera los archivos de configuración adaptados
+4. Crea las carpetas de artefactos
+
+### Uso después de la instalación
+
+#### 💬 ¿Con quién hablar?
+
+**📊 Estrategia & Descubrimiento**
+
+| Quieres... | Habla con | Ejemplo |
+|---|---|---|
+| Brainstorming de una idea | **Atlas** 🎯 | `Atlas, tengo una idea de proyecto: un SaaS de facturación` |
+| Investigación de mercado/dominio | **Atlas** 🎯 | `Atlas, analiza el mercado de apps de notas con IA` |
+| Crear un PRD / Product Brief | **Atlas** 🎯 | `Atlas, crea el PRD para mi proyecto` |
+| Diseñar wireframes UX | **Atlas** 🎯 | `Atlas, diseña la UX del flujo de onboarding` |
+
+**🏗️ Arquitectura & Desarrollo**
+
+| Quieres... | Habla con | Ejemplo |
+|---|---|---|
+| Diseñar arquitectura técnica | **Forge** 🏗️ | `Forge, propón una arquitectura para la app` |
+| Implementar una user story | **Forge** 🏗️ | `Forge, implementa la historia AUTH-001` |
+| Escribir/actualizar documentación | **Forge** 🏗️ | `Forge, documenta la API` |
+| Hotfix rápido o cambio pequeño | **Forge** 🏗️ | `Forge, quick dev: agrega un spinner de carga` |
+
+**🔍 Calidad & Revisión**
+
+| Quieres... | Habla con | Ejemplo |
+|---|---|---|
+| Revisión de código | **Sentinel** 🔍 | `Sentinel, revisa el módulo auth` |
+| Escribir tests (unit/E2E) | **Sentinel** 🔍 | `Sentinel, escribe tests E2E para el checkout` |
+| Auditoría UX / accesibilidad | **Sentinel** 🔍 | `Sentinel, revisa la UX del dashboard` |
+
+**🎼 Gestión de Proyecto**
+
+| Quieres... | Habla con | Ejemplo |
+|---|---|---|
+| Planificar un sprint | **Nexus** 🎼 | `Nexus, crea épicas e historias para el MVP` |
+| Automatizar todo (A a Z) | **Nexus** 🎼 | `autopilot` luego describe tu proyecto |
+| Ejecutar tareas en paralelo | **Nexus** 🎼 | `parallel` — detecta auto tareas independientes |
+| Retrospectiva de sprint | **Nexus** 🎼 | `Nexus, ejecuta una retro del Sprint 3` |
+
+**🕵️ Inteligencia & Packs Especializados**
+
+| Quieres... | Habla con | Ejemplo |
+|---|---|---|
+| Investigar a una persona (OSINT) | **Shadow** 🕵️ | `Shadow, investiga a John Doe` |
+| Crear un nuevo agente BMAD+ | **Maker** 🧬 | `Maker, crea un agente de soporte al cliente` |
+| Recordar decisiones pasadas | **Zecher** 🧠 | `Zecher, ¿qué decidimos sobre la estrategia de auth?` |
+| Resumen de sesión (handoff) | **Zecher** 🧠 | `Zecher, crea un handoff para la próxima sesión` |
+
+#### 🚀 Flujo de trabajo típico (modo manual)
+
+```
+1. "Atlas, haz una lluvia de ideas sobre mi [proyecto]"
+   → Atlas analiza, hace preguntas, propone enfoques
+
+2. "Atlas, crea el product brief"
+   → Entregable: _bmad-output/discovery/product-brief.md
+
+3. "Atlas, redacta el PRD"
+   → Entregable: _bmad-output/discovery/prd.md
+
+4. "Forge, propón la arquitectura"
+   → Entregable: _bmad-output/discovery/architecture.md
+
+5. "Nexus, divide en épicas e historias"
+   → Entregable: _bmad-output/build/stories/
+
+6. "Forge, implementa la historia [X]"
+   → Código generado + pruebas
+
+7. "Sentinel, prueba y revisa"
+   → Informe de QA + sugerencias
+```
+
+#### ⚡ Flujo de trabajo automático (modo autopilot)
+
+```
+> autopilot
+> "Un SaaS de facturación para pymes con gestión de presupuestos"
+```
+
+Nexus orquesta todo automáticamente con puntos de control (checkpoints) para tu aprobación.
+
+#### 💬 Comandos clave
+
+| Comando | Descripción |
+|----------|-------------|
+| `bmad-help` | Ver todos los agentes y habilidades disponibles |
+| `autopilot` | Nexus toma el control del pipeline completo |
+| `parallel` | Iniciar ejecución multi-agente en paralelo |
+
+
+#### 🔧 Comandos CLI
+
+| Comando | Descripción |
+|---------|-------------|
+| `npx bmad-plus install` | Instalador interactivo con selección de packs y detección IDE |
+| `npx bmad-plus scan [ruta]` | Descubrir e indexar proyectos en el cerebro global |
+| `npx bmad-plus memory status` | Informe de salud de memoria (proyecto + cerebro global) |
+| `npx bmad-plus memory export` | Exportar cerebro como archivo Markdown portable |
+| `npx bmad-plus doctor` | Verificar integridad de la instalación |
+| `npx bmad-plus update` | Actualizar agentes y skills (preserva la config) |
+| `npx bmad-plus uninstall` | Eliminar BMAD+ del proyecto actual |
+| `npx bmad-plus autoconfig` | Bootstrap inteligente — detección auto, instalación y configuración |
+
+#### 🔬 Opciones de instalación avanzadas
+
+```bash
+# Instalación no-interactiva — todos los packs, auto-detección IDE
+npx bmad-plus install --packs all --yes
+
+# Instalar sin sobrescribir configs IDE (CLAUDE.md, GEMINI.md, etc.)
+npx bmad-plus install --tools none
+
+# Instalar packs específicos
+npx bmad-plus install --packs core,memory,osint
+
+# Instalar en otro directorio
+npx bmad-plus install --directory /ruta/al/proyecto
+```
+
+> **💡 Consejo dogfooding:** Usa `--tools none` cuando BMAD+ se instala en un proyecto que ya tiene configs IDE manuales. Instala agentes, skills y memoria sin sobrescribir tus `CLAUDE.md`, `GEMINI.md` o `AGENTS.md`.
+
+#### 🔍 Opciones de scan
+
+```bash
+# Escanear un disco o directorio
+npx bmad-plus scan D:\DEV
+
+# Umbrales personalizados para el estado del proyecto
+npx bmad-plus scan . --active-days 7 --paused-days 90
+
+# Auto-indexar todo sin confirmación
+npx bmad-plus scan D:\DEV --yes --depth 6
+```
+
+> Leyenda de estados: 🟢 **activo** (modificado < 30 días), 🟡 **en pausa** (30–180 días), ⚪ **archivado** (> 180 días). Umbrales personalizables con `--active-days` y `--paused-days`.
+
+---
+
+## 🏗️ Arquitectura
+
+```mermaid
+graph TB
+    subgraph Core["⚙️ Core Pack"]
+        AT["Atlas 🎯"]
+        FG["Forge 🏗️"]
+        SN["Sentinel 🔍"]
+        NX["Nexus 🎼"]
+    end
+
+    subgraph Packs["📦 Modular Packs"]
+        SH["Shadow 🕵️ OSINT"]
+        MK["Maker 🧬"]
+        ZC["Zecher 🧠 Memory"]
+        SD["Shield 🛡️ GRC 27 agents"]
+        DS["Dev Studio 🏗️ SDLC 6 agents"]
+        SEO["SEO Engine 🔎 3 agents"]
+        BK["Backup 🗂️"]
+        AN["Animated 🎬"]
+    end
+
+    subgraph Skills["⚡ Core Skills"]
+        AP[Autopilot]
+        PL[Parallel]
+    end
+
+    NX -->|orchestrates| AT
+    NX -->|orchestrates| FG
+    NX -->|orchestrates| SN
+    NX -->|invokes| SH
+    NX -->|invokes| MK
+    NX --> AP
+    NX --> PL
+    ZC -.->|context| NX
+```
+
+---
+
+## 🎭 Los 47 Agentes
+
+### Atlas — Strategist 🎯
+
+**Fusiona:** Analyst (Mary) + Product Manager (John)
+
+| Rol | Especialidad | Auto-activación |
+|------|-----------|-----------------|
+| **Analyst** | Investigación de mercado, FODA, benchmarks | "analiza", "mercado", "benchmark", nuevo proyecto |
+| **Product Manager** | PRD, product briefs, historias de usuario, roadmaps | "PRD", "roadmap", "MVP", fase de planificación |
+
+**Capacidades:** 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 🏗️
+
+**Fusiona:** Architect (Winston) + Developer (Amelia) + Tech Writer (Paige)
+
+| Rol | Especialidad | Auto-activación |
+|------|-----------|-----------------|
+| **Architect** | Diseño técnico, API, escalabilidad, elección de stack | "arquitectura", "API", "schema", +5 archivos modificados |
+| **Developer** | Implementación TDD, revisión de código, historias | "implementa", "código", "fix", post-arquitectura |
+| **Tech Writer** | Documentación, diagramas Mermaid, changelogs | "documenta", "README", post-implementación |
+
+**Capacidades:** Architecture (CA), Implementation Readiness (IR), Dev Story (DS), Code Review (CR), Quick Spec (QS), Quick Dev (QD), Document Project (DP)
+
+**Acciones críticas (rol Dev):**
+- Leer TODA la historia ANTES de implementar
+- Ejecutar las tareas EN ORDEN
+- 100% pruebas aprobadas ANTES de avanzar
+- NUNCA mentir sobre las pruebas
+
+---
+
+### Sentinel — Quality 🔍
+
+**Fusiona:** QA Engineer (Quinn) + UX Designer (Sally)
+
+| Rol | Especialidad | Auto-activación |
+|------|-----------|-----------------|
+| **QA Engineer** | Pruebas API/E2E, edge cases, cobertura, revisión de código | "prueba", "QA", "bug", post-implementación |
+| **UX Reviewer** | Evaluación de UX, accesibilidad, diseño de interacción | "UX", "interfaz", "responsive", cambios frontend |
+
+**Capacidades:** QA Tests (QA), Code Review (CR), UX Design (CU)
+
+---
+
+### Nexus — Orchestrator 🎼
+
+**Fusiona:** Scrum Master (Bob) + Quick-Flow Solo Dev (Barry) + **Autopilot** (nuevo) + **Parallel Supervisor** (nuevo)
+
+| Rol | Especialidad | Auto-activación |
+|------|-----------|-----------------|
+| **Scrum Master** | Planificación de sprints, historias, retrospectivas | "sprint", "planificación", "backlog" |
+| **Quick Flow** | Specs rápidas, hotfixes, mínima ceremonia | "rápido", "hotfix", "pequeño fix" |
+| **Autopilot** | Pipeline automatizado idea→entrega con checkpoints | "autopilot", "gestiona todo", modo autopilot |
+| **Parallel Supervisor** | Múltiples agentes en concurrencia, reasignación | "paralelo", tareas independientes detectadas |
+
+**Capacidades:** 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 🔍 *(Pack OSINT)*
+
+**Agente completo de investigación OSINT.**
+
+| Capacidad | Descripción |
+|-----------|-------------|
+| **INV** | Investigación completa Fase 0→6 con informe puntuado |
+| **QS** | Búsqueda rápida multi-motor |
+| **LI/IG/FB** | Scraping de LinkedIn, Instagram, Facebook |
+| **PP** | Psicoperfil MBTI / Big Five |
+| **CE** | Enriquecimiento de contactos (email, teléfono) |
+| **DG** | Diagnóstico de herramientas/APIs disponibles |
+
+**Tecnología:** MÁS de 55 actores de Apify, 7 APIs de búsqueda, python estándar 100%, grados A/B/C/D
+
+---
+
+### Maker — Agent Creator 🧬 *(Pack Maker)*
+
+**Meta-agente que crea otros agentes.** Dale una descripción → genera un paquete completo.
+
+| Capacidad | Descripción |
+|------|-------------|
+| **CA** | Create Agent — creación guiada en 4 fases |
+| **QA** | Quick Agent — creación rápida con valores por defecto con sentido |
+| **EA** | Edit Agent — modificar un SKILL.md existente |
+| **VA** | Validate Agent — verificar cumplimiento BMAD+ |
+| **PA** | Package Agent — generar carpeta de integración |
+
+**Pipeline:** Discovery → Design (aprobación del usuario) → Generación → Validación
+**Salida:** `_bmad-output/ready-to-integrate/` — listo para copiar a BMAD+
+
+---
+
+### Zecher — Guardián de la Memoria 🧠 *(Pack Memory)*
+
+**Agente de memoria persistente cross-session.** Mantiene el conocimiento del proyecto entre conversaciones.
+
+| Capacidad | Descripción |
+|-----------|-------------|
+| **Session Handoff** | Crea automáticamente resúmenes de sesión con decisiones, patrones y lecciones |
+| **Context Recall** | Recupera decisiones/patrones relevantes al inicio de cada conversación |
+| **Brain Health** | Monitorea la integridad de los archivos de memoria y detecta obsolescencia |
+| **Cross-Project** | Vincula la memoria del proyecto al cerebro global (`~/.bmad-plus/brain/`) |
+| **Karpathy Guardrails** | Previene memorias alucinadas — cada entrada necesita evidencia fuente |
+
+**Archivos de memoria:** `decisions.md`, `lessons.md`, `patterns.md`, `context.md`, `sessions/`
+
+## 📦 Sistema de Packs
+
+BMAD+ utiliza un sistema modular por packs. El Core siempre está instalado, y los demás packs son opcionales.
+
+```
+npx bmad-plus install
+
+🎛️  ¿Qué packs instalar?
+   Core (Atlas, Forge, Sentinel, Nexus) siempre incluido.
+
+   🔍 OSINT — Shadow (investigación, scraping, psicoperfil)
+   🧬 Agent Creator — Maker (diseño, desarrollo, empaque)
+   🛡️ Shield GRC — 27 agentes de cumplimiento + 11 workflows (GDPR, ISO 27001, SOC 2, HIPAA...)
+   🏗️ Dev Studio — 6 agentes SDLC (ciclo de vida completo: diseño a despliegue)
+   🔎 SEO — Scout, Chief, Judge (auditoría 6 fases, PageSpeed)
+   🧠 Memory — Zecher (cerebro persistente, handoff sessions)
+   🗂️ Backup — Archivo inteligente con versionado
+   🎬 Animated — Sitios web animados scroll-driven
+   🤖 Instalar todo
+   Ninguno — Solo Core
+```
+
+| Pack | Agentes | Descripción | Estado |
+|------|--------|-------------|--------|
+| ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | Ciclo de vida dev completo: estrategia → arquitectura → código → QA | ✅ Estable |
+| 🔍 **OSINT** | Shadow | Investigación, scraping social, psicoperfil (55+ actores Apify) | ✅ Estable |
+| 🧬 **Maker** | Maker | Diseñar, construir, validar y empaquetar nuevos agentes BMAD+ | ✅ Estable |
+| 🛡️ **Shield** | 27 agentes de cumplimiento + 11 workflows | GRC en 25+ frameworks: GDPR, ISO 27001, SOC 2, HIPAA, PCI DSS, EU AI Act, DORA, NIS2 | ✅ Estable |
+| 🏗️ **Dev Studio** | 6 agentes specialized SDLC | SDLC completo: brainstorm → PRD → arquitectura → TDD → review (38 workflows) | ✅ Estable |
+| 🔍 **SEO** | Scout, Chief, Judge | Auditoría SEO 6 fases, bucle PageSpeed, APIs Google, benchmark competitivo | ✅ Estable |
+| 🗂️ **Backup** | Backup Agent | ZIP con marca de tiempo y exclusiones inteligentes | ✅ Estable |
+| 🎬 **Animated** | Animated Website Agent | Sitio web lujoso scroll-driven desde video | ✅ Estable |
+| 🧠 **Memory** | Zecher | Cerebro cross-session, scanner de proyectos, guardrails Karpathy | ✅ Estable |
+
+Cada pack define:
+- Sus agentes, habilidades y workflows
+- Llaves de API obligatorias/opcionales
+- Paquete externo (si aplica)
+- Reglas de cohabitación con otros packs
+
+---
+
+## ✨ Innovaciones
+
+### 1. Auto-Activación Inteligente a 3 Niveles
+
+Cada agente puede **automáticamente** cambiar de rol según el contexto:
+
+| Nivel | Mecanismo | Ejemplo |
+|--------|-----------|---------|
+| 🔤 **Patrón** | Palabras clave en el pedido | "revisa" → QA activado |
+| 🌐 **Contexto** | Detecta el tipo de tarea | Cálculos financieros detectados → QA auto-activado tras escribir código |
+| 🧠 **Razonamiento** | Cadena lógica | Inconsistencia de arquitectura → Architect auto-activado |
+
+El agente **anuncia** el cambio: *"💡 I'm switching to QA mode — financial calculations detected. Say 'skip' to stay in current mode."*
+
+Configuración: `src/bmad-plus/data/role-triggers.yaml`
+
+### 2. Modo Autopilot
+
+Introduce una idea → Nexus gestionará todo:
+
+```
+📋 Discovery (Atlas)
+  └→ Brainstorming → Product Brief → PRD → UX Design
+  🔴 CHECKPOINT: Aprobación del PRD
+
+🏗️ Build (Forge + Sentinel)
+  └→ Arquitectura → Épicas → Historias → Sprint
+  🔴 CHECKPOINT: Aprobación de Arquitectura
+  └→ Por historia: Código → Pruebas → (reintentos si falla, máximo 3)
+  🟡 NOTIFY: Estado de la historia
+
+🚀 Ship (Sentinel + Forge)
+  └→ Revisión de Código → UX → Documentación → Retrospectiva
+  🔴 CHECKPOINT: Aprobación final
+```
+
+**Puntos de control (checkpoints) configurables:**
+- `require_approval` (🔴) — Pausa, notifica por WhatsApp, espera
+- `notify_only` (🟡) — Notifica, continúa (a menos que el usuario intervenga)
+- `auto` (🟢) — Totalmente automático
+
+### 3. Ejecución Paralela Supervisada
+
+El orquestador divide las tareas asíncronas para ejecutarlas de forma paralela:
+
+| Proceso paralelo ✅ | Proceso secuencial 🚫 |
+|---|---|
+| Múltiples historias sin dependencia | Tareas en el mismo archivo |
+| Research + revisión técnica de arquitectura | Historia B depende de A |
+| Tests QA + documentación en docs | Arquitectura antes que el código |
+
+**Supervisión en ejecución:** Iniciar, Detener, Reiniciar, Escalar (si un agente falla más de 3 veces, avisa al desarrollador)
+
+---
+
+## 🖥️ IDE Soportados
+
+El instalador detecta automáticamente el IDE actual para generar la configuración nativa que conecte a BMAD+:
+
+| IDE | Archivo de Config. | Detección (carpeta) |
+|-----|---------------|-----------|
+| Claude Code | `CLAUDE.md` | `.claude/` |
+| Gemini CLI | `GEMINI.md` | `.gemini/` |
+| Antigravity | `.gemini/` + `.agents/` | Antigravity Extensión |
+| Codex CLI | `AGENTS.md` | `.codex/` |
+| OpenCode | `OPENCODE.md` | Opciones de opencode |
+
+---
+
+## 📡 Monitorización Upstream
+
+### Pipeline semanal (cron VPS, lunes 9 AM)
+
+```
+1. Obtiene actualizaciones del proyecto raíz BMAD-METHOD
+2. Análisis "diff" sobre los archivos locales
+3. Procesado por Inteligencia Artificial "Gemini API"
+   🟢 Compatible | 🟡 Revisar manualmente | 🔴 Incompatible o "Breaking Change"
+4. Envía la actualización usando el WhatsApp registrado (Evolution API)
+5. Auto-PR en GH
+```
+
+### Stack
+- **weekly-check.py** — Archivo base usado mediante cron semanal
+- **ai_analyzer.py** — LLM de análisis (Gemini 2.0 Flash)
+- **notifier.py** — WhatsApp (API Evolution auto-hosteado) / fallback a correo local
+- **mcp_bridge.py** — Acceso Server para las API operativas.
+
+---
+
+## 📁 Estructura del Proyecto
+
+```
+BMAD+/
+├── README.md                      ← Este archivo (Inglés)
+├── readme-international/          ← Versiones traducidas (es, fr, de)
+├── CHANGELOG.md                   ← Versiones de proyecto
+├── CLAUDE.md                      ← Config IDE: Claude
+├── GEMINI.md                      ← Config IDE: Gemini
+├── AGENTS.md                      ← Config IDE: Codex / Opencode
+├── .gitignore
+│
+├── src/
+│   └── bmad-plus/                 ⭐ MODULO PERSONALIZADO
+│       ├── module.yaml            ← Packs de entorno BMAD
+│       ├── module-help.csv        ← Ayuda rápida base de datos
+│       ├── 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-agente creativo) [pack: maker]
+│       │   └── agent-shadow/      ← Shadow (osint) [pack: osint]
+│       ├── skills/
+│       │   ├── bmad-plus-autopilot/ ← Orquestación completa
+│       │   ├── bmad-plus-parallel/  ← Supervisión concurrente
+│       │   └── bmad-plus-sync/      ← Sincronización automatizada código
+│       └── data/
+│           └── role-triggers.yaml ← Lógica de variables y keywords
+│
+├── monitor/                       🤖 CONTROL PARA VPS DE CAMBIOS DE BMAD-METHOD
+│   ├── weekly-check.py            ← Base Cron
+│   ├── ai_analyzer.py             ← IA Análisis (Gemini API)
+│   ├── notifier.py                ← WhatsApp (Evolution API) y correos
+│   ├── mcp_bridge.py              ← Puerto de servidor
+│   ├── config.example.yaml        ← Base de las contraseñas
+│   └── docker-compose.yml         ← Config para arrancar Evolution API
+│
+├── mcp-server/                    🛡️ AUDITOR / MCP BRIDGE
+│   ├── server.py                  ← Acceso general y de herramientas.
+│   └── tools/                     ← git, github operations
+│
+├── osint-agent-package/           🔍 MODULO INDEPENDIENTE DE OSINT
+│   ├── agents/                    ← Agente Shadow (version root)
+│   ├── skills/                    ← Apify actores 55+
+│   └── install.ps1                ← Script de instalación
+│
+└── upstream/                      📦 CLONE ORIGINAL (EXCLUIDO DEL REGISTRO LOCAL)
+    └── (BMAD-METHOD original)
+```
+
+---
+
+## ⚙️ Configuración Módulo Central
+
+### Archivo principal (`module.yaml`)
+
+| Variable | Descripción | Valores Disponibles |
+|----------|-------------|---------|
+| `project_name` | Nombre del proyecto | Autodetectado |
+| `user_skill_level` | Nivel del equipo/persona | beginner, intermediate, expert |
+| `execution_mode` | Modo de uso general | manual, autopilot, hybrid |
+| `auto_role_activation` | Cambio al predecir contexto | true, false |
+| `parallel_execution` | Trabajos Multiagente | true, false |
+| `install_packs` | Packs Seleccionados a Integrar | core, osint, maker, audit, all |
+
+### Integración Personalizada (Apikey/Hooks)
+
+| KEY Sistema | Entorno / Pack | Actuación |
+|-----|------|-------|
+| `GEMINI_API_KEY` | Monitor | Comparación lógica de ramas Upstream |
+| `EVOLUTION_API_KEY` | Monitor | Sistema WhatsApp Notifier Server |
+| `APIFY_API_TOKEN` | OSINT | Extracción, Web Mining |
+| `PERPLEXITY_API_KEY` | OSINT | Buscador Complejo AI |
+
+---
+
+## 📜 Historial de Versiones
+
+| Versión | Fecha | Descripción |
+|---------|------|-------------|
+| **0.1.0** | 2026-03-17 | 🎉 Fundación base de proyecto (6 agentes / 3 entornos de skills / Auto-detección IDEs locales). Se incorporó el Maker y paquete OSINT |
+| **0.2.0** | 2026-03-18 | 🔀 Fusión Oveanet — 3 nuevos packs utilitarios: SEO Audit 360, Universal Backup, Animated Website |
+| **0.3.0** | 2026-03-19 | 🚀 SEO Engine v2.0 — 3 agentes multirrol, 4 scripts Python, flujo 6 fases, bucle PageSpeed, análisis GEO |
+| **0.4.0** | 2026-03-19 | 🏢 SEO Engine v2.1 — Orquestador SKILL.md, APIs Google, informes HTML, benchmark competitivo, 50 tests, extensiones GSC + GA4 |
+| **0.4.1** | 2026-03-19 | 🌐 CLI 10 idiomas, pipeline CI/CD, `.npmignore`, endurecimiento de seguridad |
+| **0.4.2** | 2026-03-19 | 📦 Packs públicos — SEO/Backup/Animated en npm |
+| **0.4.3** | 2026-05-17 | 🔧 Comandos update + doctor, i18n completa, corrección de créditos |
+| **0.4.4** | 2026-05-17 | 🔧 Corrección codificación UTF-8, i18n completa 10 idiomas, 62 tests unitarios |
+| **0.5.0** | 2026-05-17 | 🛡️ **Pack Shield** — 27 agentes de cumplimiento GRC + 11 workflows, 6 categorías, 25+ frameworks (GDPR, ISO 27001, SOC 2, EU AI Act...) |
+| **0.6.0** | 2026-05-17 | 🏗️ **Pack Dev Studio** — 6 agentes SDLC (Miriam, Yosef, Bezalel...) + 30 flujos de trabajo SDLC, BWML DSL |
+| **0.8.0** | 2026-06-24 | 🚀 **Aumentado** — 3 nuevos packs (animated, backup, seo), pase de remediación de seguridad, sync i18n |
+| **0.9.0** | 2026-06-24 | 🔒 **Seguro** — ciclo de remediación de auditoría, npm audit limpio, registro de packs compartido (`lib/packs.js`) |
+| **0.9.1** | 2026-07-01 | ✅ **Credibilidad** — CI real en push/PR, arnés Jest ESM reparado, config ESLint flat, badges falsos retirados |
+| **0.9.2** | 2026-07-01 | 🔐 **Seguridad** — RCE (allowlist ci_cd), SSRF, XSS almacenado/DOM, XXE, bumps CVE Python (~30 hallazgos) |
+| **0.10.0** | 2026-07-02 | 🧭 **Columna vertebral de plataforma** — SSOT `registry.yaml` (`packs.js` generado + gate anti-drift en CI), provisioning Python, fundaciones eval + memoria |
+| **0.11.0** | 2026-07-02 | 🧠 **Bucle Karpathy** — `bmad mem` recall/write/reinforce, generador de adapters multi-CLI, gate de base legal OSINT (CG-02) |
+| **0.12.0** | 2026-07-02 | 🏛️ **Load-bearing** — adapters raíz adoptados desde el registry, memoria vía MCP, gateway eval multi-proveedor; 333 tests |
+| **0.12.1** | 2026-07-12 | 🧩 **Cerebro portfolio** — fix de detección de cerebro memory-init, monitor migrado al SDK google-genai, sincronización de versión |
+| **0.12.2** | 2026-07-16 | 🚚 **Capacidades entregadas** — toolkit SEO embarcado in-pack (funciona desde npm), gate de base legal OSINT en cada ruta, monitor reconstruible, SSRF del crawler cerrado, cobertura de tests mcp-server + CLI; 483 tests |
+
+Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
+
+---
+
+## 📄 Licencias Integradas
+
+Proyecto BMAD+ (Adaptación: MIT)
+
+Basado nativamente en el repositorio: [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT LIC)
+
+### Reconocimientos
+
+**Creador**
+- **BMAD+** Creado por [Laurent Rochetta](https://github.com/lrochetta) ([LinkedIn](https://www.linkedin.com/in/laurentrochetta/))
+
+**Packs Originales** (creados por Laurent Rochetta)
+- **Dev Studio** — 6 agentes SDLC especializados: Miriam (analista de negocios), Huldah (redactora técnica), Yosef (gerente de producto), Rachel (diseñadora UX), Bezalel (arquitecto de sistemas), Oholiab (ingeniero senior) — 38 workflows que cubren todo el ciclo de vida desde la lluvia de ideas hasta el despliegue
+- **SEO Engine** — 3 agentes (Scout, Chief, Judge), pipeline de auditoría de 6 fases, bucle PageSpeed, integraciones con Google Search Console y GA4
+- **Memory Pack** — Agente Zecher para cerebro persistente cross-session con escáner de proyectos
+
+**Fuentes Externas e Inspiraciones**
+- **BMAD-METHOD** por [bmad-code-org](https://github.com/bmad-code-org/BMAD-METHOD) — Metodología multi-agente original (MIT)
+- **Shield GRC** — 27 agentes de cumplimiento + 11 workflows basados en textos regulatorios públicos (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIST, CMMC, etc.)
+- **OSINT Pipeline** basado en [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT)
+- **Apify Actor Runner** integrado desde [apify/agent-skills](https://github.com/apify/agent-skills) (MIT)
+- **Karpathy Guardrails** adaptado de [Andrej Karpathy](https://github.com/multica-ai/andrej-karpathy-skills) (MIT) — Reglas de comportamiento para Memory Pack
+
+**Herramientas e Infraestructura**
+- [Evolution API](https://github.com/EvolutionAPI/evolution-api) — Notificaciones WhatsApp para monitoreo upstream
+- [Gemini API](https://ai.google.dev/) — Análisis IA para clasificación de cambios upstream