bmad-plus 0.5.0 → 0.7.0

package/readme-international/README.es.md

@@ -1,141 +1,141 @@
-# 🚀 BMAD+ — Framework de Desarrollo Impulsado por IA Aumentada
+# ?? BMAD+ � Framework de Desarrollo Impulsado por IA Aumentada
 
-[![Version](https://img.shields.io/badge/version-0.5.0-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.7.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">
-  <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>
+  <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>
 
-> Fork inteligente de [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6.2.0 — Agentes multirrol con auto-activación, modo Autopilot, ejecución paralela supervisada y monitorización upstream por WhatsApp.
+> Fork inteligente de [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) v6.2.0 � Agentes multirrol con auto-activaci�n, modo Autopilot, ejecuci�n paralela supervisada y monitorizaci�n upstream por WhatsApp.
 
 ---
 
-## 📋 Tabla de contenidos
+## ?? Tabla de contenidos
 
-- [¿Por qué BMAD+?](#-por-qué-bmad-)
-- [Inicio Rápido](#-inicio-rápido)
+- [�Por qu� BMAD+?](#-por-qu�-bmad-)
+- [Inicio R�pido](#-inicio-r�pido)
 - [Arquitectura](#-arquitectura)
 - [Los 5 Agentes](#-los-5-agentes)
 - [Sistema de Packs](#-sistema-de-packs)
 - [Innovaciones](#-innovaciones)
 - [IDE Soportados](#-ide-soportados)
-- [Monitorización Upstream](#-monitorización-upstream)
+- [Monitorizaci�n Upstream](#-monitorizaci�n-upstream)
 - [Estructura del Proyecto](#-estructura-del-proyecto)
-- [Configuración](#-configuración)
+- [Configuraci�n](#-configuraci�n)
 - [Historial de Versiones](#-historial-de-versiones)
 - [Licencia](#-licencia)
 
 ---
 
-## 💡 ¿Por qué BMAD+?
+## ?? �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 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 | **5 agentes multirrol** (11 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 |
+| 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
+## ? Inicio R�pido
 
-### Instalación en un proyecto existente
+### 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.)
+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
+3. Genera los archivos de configuraci�n adaptados
 4. Crea las carpetas de artefactos
 
-### Uso después de la instalación
+### Uso despu�s de la instalaci�n
 
-#### 💬 ¿Con quién hablar?
+#### ?? �Con qui�n hablar?
 
 | Quieres... | Habla con | Ejemplo |
 |---|---|---|
-| Discutir una idea de proyecto | **Atlas** 🎯 | `Atlas, tengo una idea de proyecto: un SaaS de facturación` |
-| Crear un PRD / Product Brief | **Atlas** 🎯 | `Atlas, crea el PRD para mi proyecto` |
-| Diseñar la arquitectura técnica | **Forge** 🏗️ | `Forge, propón una arquitectura para la app` |
-| Implementar código | **Forge** 🏗️ | `Forge, implementa la historia AUTH-001` |
-| Redactar documentación | **Forge** 🏗️ | `Forge, documenta la API` |
-| Probar / realizar revisión de código | **Sentinel** 🔍 | `Sentinel, revisa el módulo auth` |
-| Planificar un sprint | **Nexus** 🎼 | `Nexus, crea épicas e historias para el MVP` |
-| Automatizar todo de la A a la Z | **Nexus** 🎼 | `autopilot` luego describe tu proyecto |
-| 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` |
-
-#### 🚀 Flujo de trabajo típico (modo manual)
+| Discutir una idea de proyecto | **Atlas** ?? | `Atlas, tengo una idea de proyecto: un SaaS de facturaci�n` |
+| Crear un PRD / Product Brief | **Atlas** ?? | `Atlas, crea el PRD para mi proyecto` |
+| Dise�ar la arquitectura t�cnica | **Forge** ??? | `Forge, prop�n una arquitectura para la app` |
+| Implementar c�digo | **Forge** ??? | `Forge, implementa la historia AUTH-001` |
+| Redactar documentaci�n | **Forge** ??? | `Forge, documenta la API` |
+| Probar / realizar revisi�n de c�digo | **Sentinel** ?? | `Sentinel, revisa el m�dulo auth` |
+| Planificar un sprint | **Nexus** ?? | `Nexus, crea �picas e historias para el MVP` |
+| Automatizar todo de la A a la Z | **Nexus** ?? | `autopilot` luego describe tu proyecto |
+| 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` |
+
+#### ?? Flujo de trabajo t�pico (modo manual)
 
 ```
 1. "Atlas, haz una lluvia de ideas sobre mi [proyecto]"
-   → Atlas analiza, hace preguntas, propone enfoques
+   ? Atlas analiza, hace preguntas, propone enfoques
 
 2. "Atlas, crea el product brief"
-   → Entregable: _bmad-output/discovery/product-brief.md
+   ? Entregable: _bmad-output/discovery/product-brief.md
 
 3. "Atlas, redacta el PRD"
-   → Entregable: _bmad-output/discovery/prd.md
+   ? Entregable: _bmad-output/discovery/prd.md
 
-4. "Forge, propón la arquitectura"
-   → Entregable: _bmad-output/discovery/architecture.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/
+5. "Nexus, divide en �picas e historias"
+   ? Entregable: _bmad-output/build/stories/
 
 6. "Forge, implementa la historia [X]"
-   → Código generado + pruebas
+   ? C�digo generado + pruebas
 
 7. "Sentinel, prueba y revisa"
-   → Informe de QA + sugerencias
+   ? Informe de QA + sugerencias
 ```
 
-#### ⚡ Flujo de trabajo automático (modo autopilot)
+#### ? Flujo de trabajo autom�tico (modo autopilot)
 
 ```
 > autopilot
-> "Un SaaS de facturación para pymes con gestión de presupuestos"
+> "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.
+Nexus orquesta todo autom�ticamente con puntos de control (checkpoints) para tu aprobaci�n.
 
-#### 🔑 Comandos clave
+#### ?? Comandos clave
 
-| Comando | Descripción |
+| 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 |
+| `parallel` | Iniciar ejecuci�n multi-agente en paralelo |
 
 ---
 
-## 🏗️ Arquitectura
+## ??? Arquitectura
 
 ```mermaid
 graph TB
-    subgraph Core["⚙️ Core Pack"]
-        AT[Atlas 🎯<br/>Strategist]
-        FG[Forge 🏗️<br/>Architect-Dev]
-        SN[Sentinel 🔍<br/>Quality]
-        NX[Nexus 🎼<br/>Orchestrator]
+    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]
+    subgraph OSINT["?? OSINT Pack"]
+        SH[Shadow ??<br/>OSINT Intel]
     end
 
-    subgraph Audit["🛡️ Audit Pack"]
-        SD["Shield 🛡️<br/>(muy pronto)"]
+    subgraph Audit["??? Audit Pack"]
+        SD["Shield ???<br/>(muy pronto)"]
     end
 
     NX -->|orquesta| AT
@@ -166,34 +166,34 @@ graph TB
 
 ---
 
-## 🎭 Los 5 Agentes
+## ?? Los 5 Agentes
 
-### Atlas — Strategist 🎯
+### Atlas � Strategist ??
 
 **Fusiona:** Analyst (Mary) + Product Manager (John)
 
-| Rol | Especialidad | Auto-activación |
+| 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 |
+| **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 🏗️
+### Forge � Architect-Dev ???
 
 **Fusiona:** Architect (Winston) + Developer (Amelia) + Tech Writer (Paige)
 
-| Rol | Especialidad | Auto-activación |
+| 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 |
+| **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):**
+**Acciones cr�ticas (rol Dev):**
 - Leer TODA la historia ANTES de implementar
 - Ejecutar las tareas EN ORDEN
 - 100% pruebas aprobadas ANTES de avanzar
@@ -201,91 +201,91 @@ graph TB
 
 ---
 
-### Sentinel — Quality 🔍
+### Sentinel � Quality ??
 
 **Fusiona:** QA Engineer (Quinn) + UX Designer (Sally)
 
-| Rol | Especialidad | Auto-activación |
+| 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 |
+| **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 🎼
+### Nexus � Orchestrator ??
 
 **Fusiona:** Scrum Master (Bob) + Quick-Flow Solo Dev (Barry) + **Autopilot** (nuevo) + **Parallel Supervisor** (nuevo)
 
-| Rol | Especialidad | Auto-activación |
+| 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 |
+| **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)*
+### Shadow � OSINT Intelligence ?? *(Pack OSINT)*
 
-**Agente completo de investigación OSINT.**
+**Agente completo de investigaci�n OSINT.**
 
-| Capacidad | Descripción |
+| Capacidad | Descripci�n |
 |-----------|-------------|
-| **INV** | Investigación completa Fase 0→6 con informe puntuado |
-| **QS** | Búsqueda rápida multi-motor |
+| **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 |
+| **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
+**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)*
+### Maker � Agent Creator ?? *(Pack Maker)*
 
-**Meta-agente que crea otros agentes.** Dale una descripción → genera un paquete completo.
+**Meta-agente que crea otros agentes.** Dale una descripci�n ? genera un paquete completo.
 
-| Capacidad | Descripción |
+| 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 |
+| **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+
+**Pipeline:** Discovery ? Design (aprobaci�n del usuario) ? Generaci�n ? Validaci�n
+**Salida:** `_bmad-output/ready-to-integrate/` � listo para copiar a BMAD+
 
 ---
 
-## 📦 Sistema de Packs
+## ?? Sistema de Packs
 
-BMAD+ utiliza un sistema modular por packs. El Core siempre está instalado, y los demás packs son opcionales.
+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?
+???  �Qu� packs instalar?
    Core (Atlas, Forge, Sentinel, Nexus) siempre incluido.
 
-   🔍 OSINT — Shadow (investigación, scraping, psicoperfil)
-   🧬 Agent Creator — Maker (diseño, desarrollo, empaque)
-   🛡️ Auditoría de Seguridad — Shield (muy pronto)
-   🤖 Instalar todo
-   Ninguno — Solo Core
+   ?? OSINT � Shadow (investigaci�n, scraping, psicoperfil)
+   ?? Agent Creator � Maker (dise�o, desarrollo, empaque)
+   ??? Auditor�a de Seguridad � Shield (muy pronto)
+   ?? Instalar todo
+   Ninguno � Solo Core
 ```
 
 | Pack | Agentes | Habilidades | Estado |
 |------|--------|--------|--------|
-| ⚙️ **Core** | Atlas, Forge, Sentinel, Nexus | autopilot, parallel, sync | ✅ Estable |
-| 🔍 **OSINT** | Shadow | bmad-osint-investigate | ✅ Estable |
-| 🧬 **Maker** | Maker | — | ✅ Estable |
-| 🛡️ **Audit** | Shield | bmad-audit-scan, bmad-audit-report | 🔜 Muy pronto |
+| ?? **Core** | Atlas, Forge, Sentinel, Nexus | autopilot, parallel, sync | ? Estable |
+| ?? **OSINT** | Shadow | bmad-osint-investigate | ? Estable |
+| ?? **Maker** | Maker | � | ? Estable |
+| ??? **Audit** | Shield | bmad-audit-scan, bmad-audit-report | ?? Muy pronto |
 
 Cada pack define:
 - Sus agentes y habilidades
@@ -294,154 +294,154 @@ Cada pack define:
 
 ---
 
-## ✨ Innovaciones
+## ? Innovaciones
 
-### 1. Auto-Activación Inteligente a 3 Niveles
+### 1. Auto-Activaci�n Inteligente a 3 Niveles
 
-Cada agente puede **automáticamente** cambiar de rol según el contexto:
+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 → Architec auto-activado |
+| ?? **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 ? Architec auto-activado |
 
-El agente **anuncia** el cambio: *"💡 I'm switching to QA mode — financial calculations detected. Say 'skip' to stay in current mode."*
+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`
+Configuraci�n: `src/bmad-plus/data/role-triggers.yaml`
 
 ### 2. Modo Autopilot
 
-Introduce una idea → Nexus gestionará todo:
+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
+?? 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
+- `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
+### 3. Ejecuci�n Paralela Supervisada
 
-El orquestador divide las tareas asíncronas para ejecutarlas de forma paralela:
+El orquestador divide las tareas as�ncronas para ejecutarlas de forma paralela:
 
-| Proceso paralelo ✅ | Proceso secuencial 🚫 |
+| 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 |
+| 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)
+**Supervisi�n en ejecuci�n:** Iniciar, Detener, Reiniciar, Escalar (si un agente falla m�s de 3 veces, avisa al desarrollador)
 
 ---
 
-## 🖥️ IDE Soportados
+## ??? IDE Soportados
 
-El instalador detecta automáticamente el IDE actual para generar la configuración nativa que conecte a BMAD+:
+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) |
+| IDE | Archivo de Config. | Detecci�n (carpeta) |
 |-----|---------------|-----------|
 | Claude Code | `CLAUDE.md` | `.claude/` |
 | Gemini CLI | `GEMINI.md` | `.gemini/` |
-| Antigravity | `.gemini/` + `.agents/` | Antigravity Extensión |
+| Antigravity | `.gemini/` + `.agents/` | Antigravity Extensi�n |
 | Codex CLI | `AGENTS.md` | `.codex/` |
 | OpenCode | `OPENCODE.md` | Opciones de opencode |
 
 ---
 
-## 📡 Monitorización Upstream
+## ?? 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
+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)
+   ?? 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.
+- **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
+## ?? 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/      ← Sicronizació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)
++-- 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/      ? Sicronizaci�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
+## ?? Configuraci�n M�dulo Central
 
 ### Archivo principal (`module.yaml`)
 
-| Variable | Descripción | Valores Disponibles |
+| Variable | Descripci�n | Valores Disponibles |
 |----------|-------------|---------|
 | `project_name` | Nombre el proyecto | Autodetectado |
 | `user_skill_level` | Nivel del equipo/persona | beginner, intermediate, expert |
@@ -450,35 +450,35 @@ BMAD+/
 | `parallel_execution` | Trabajos Multiagente | true, false |
 | `install_packs` | Packs Seleccionados a Integrar | core, osint, maker, audit, all |
 
-### Integración Personalizada (Apikey/Hooks)
+### Integraci�n Personalizada (Apikey/Hooks)
 
-| KEY Sistema | Entorno / Pack | Actuación |
+| KEY Sistema | Entorno / Pack | Actuaci�n |
 |-----|------|-------|
-| `GEMINI_API_KEY` | Monitor | Comparación lógica de ramas Upstream |
+| `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 |
+| `APIFY_API_TOKEN` | OSINT | Extracci�n, Web Mining |
 | `PERPLEXITY_API_KEY` | OSINT | Buscador Complejo AI |
 
 ---
 
-## 📜 Historial de Versiones
+## ?? Historial de Versiones
 
-| Versión | Fecha | Descripción |
+| 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.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 |
 
-Más descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
+M�s descripciones a fondo en el archivo: [CHANGELOG.md](../CHANGELOG.md).
 
 ---
 
-## 📄 Licencias Integradas
+## ?? Licencias Integradas
 
-Proyecto BMAD+ (Adaptación: MIT)
+Proyecto BMAD+ (Adaptaci�n: MIT)
 
 Basado nativamente en el repositorio: [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) (MIT LIC)
 
 ### Reconocimientos especiales
 
-- **BMAD-METHOD Core** por [bmad-code-org](https://github.com/bmad-code-org) — Framework base
-- **OSINT Pipeline Tool** Adaptación de [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT LIC)
+- **BMAD-METHOD Core** por [bmad-code-org](https://github.com/bmad-code-org) � Framework base
+- **OSINT Pipeline Tool** Adaptaci�n de [smixs/osint-skill](https://github.com/smixs/osint-skill) (MIT LIC)
 - **Apify Actor Runner Base** integrado desde el original de [apify/agent-skills](https://github.com/apify/agent-skills) (MIT LIC)