@the-bearded-bear/claude-craft 8.26.0 → 8.27.0

package/Dev/i18n/es/Symfony/commands/check-security.md

@@ -55,7 +55,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli cat /app/config/packages/security.yam
 
 ### Paso 3: OWASP Top 10 - Inyección
 
-#### A03:2021 – Injection (SQL, NoSQL, OS, LDAP) (3 puntos)
+#### A05:2025 – Injection (SQL, NoSQL, OS, LDAP) (3 puntos)
 
 ```bash
 # Verificar el uso de consultas preparadas
@@ -79,9 +79,9 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -rE "\"SELECT.*\\..*\$" /app/src
 
 **Puntos obtenidos**: ___/3
 
-### Paso 4: OWASP Top 10 - Broken Authentication
+### Paso 4: OWASP Top 10 - Authentication Failures
 
-#### A07:2021 – Identification and Authentication Failures (3 puntos)
+#### A07:2025 – Authentication Failures (3 puntos)
 
 ```bash
 # Verificar la configuración de contraseñas
@@ -104,9 +104,9 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "RateLimiter" /app/config --i
 
 **Puntos obtenidos**: ___/3
 
-### Paso 5: OWASP Top 10 - Exposición de Datos Sensibles
+### Paso 5: OWASP Top 10 - Fallos Criptográficos
 
-#### A02:2021 – Cryptographic Failures (3 puntos)
+#### A04:2025 – Cryptographic Failures (3 puntos)
 
 ```bash
 # Verificar secretos en el código
@@ -131,7 +131,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "SECURE_SCHEME" /app/.env.exa
 
 ### Paso 6: OWASP Top 10 - Control de Acceso Roto
 
-#### A01:2021 – Broken Access Control (3 puntos)
+#### A01:2025 – Broken Access Control (3 puntos)
 
 ```bash
 # Verificar los Voters
@@ -156,7 +156,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "@IsGranted" /app/src --inclu
 
 ### Paso 7: OWASP Top 10 - XSS y CSRF
 
-#### A03:2021 – XSS (Cross-Site Scripting) (2 puntos)
+#### A05:2025 – Injection : XSS (Cross-Site Scripting) (2 puntos)
 
 ```bash
 # Verificar el auto-escape de Twig
@@ -179,7 +179,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "|raw" /app/templates --inclu
 
 **Puntos obtenidos**: ___/2
 
-#### A08:2021 – CSRF (Cross-Site Request Forgery) (2 puntos)
+#### A01:2025 – Broken Access Control : CSRF (Cross-Site Request Forgery) (2 puntos)
 
 ```bash
 # Verificar la protección CSRF
@@ -201,7 +201,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli grep -r "csrf_protection" /app/config
 
 ### Paso 8: OWASP Top 10 - Otras Vulnerabilidades
 
-#### A05:2021 – Security Misconfiguration (2 puntos)
+#### A02:2025 – Security Misconfiguration (2 puntos)
 
 ```bash
 # Verificar el modo debug
@@ -224,7 +224,7 @@ docker run --rm -v $(pwd):/app php:8.5-cli composer audit
 
 **Puntos obtenidos**: ___/2
 
-#### A06:2021 – Vulnerable and Outdated Components (1 punto)
+#### A03:2025 – Software Supply Chain Failures (1 punto)
 
 ```bash
 # Auditoría de seguridad Composer
@@ -398,16 +398,16 @@ Fixed in: 5.4.25
    OWASP TOP 10 - RESUMEN
 =================================================
 
-A01:2021 - Broken Access Control          : [✅|⚠️|❌]
-A02:2021 - Cryptographic Failures         : [✅|⚠️|❌]
-A03:2021 - Injection                      : [✅|⚠️|❌]
-A04:2021 - Insecure Design                : [✅|⚠️|❌]
-A05:2021 - Security Misconfiguration      : [✅|⚠️|❌]
-A06:2021 - Vulnerable Components          : [✅|⚠️|❌]
-A07:2021 - Authentication Failures        : [✅|⚠️|❌]
-A08:2021 - Software and Data Integrity    : [✅|⚠️|❌]
-A09:2021 - Security Logging Failures      : [✅|⚠️|❌]
-A10:2021 - Server-Side Request Forgery    : [✅|⚠️|❌]
+A01:2025 - Broken Access Control                 : [✅|⚠️|❌]
+A02:2025 - Security Misconfiguration             : [✅|⚠️|❌]
+A03:2025 - Software Supply Chain Failures        : [✅|⚠️|❌]
+A04:2025 - Cryptographic Failures                : [✅|⚠️|❌]
+A05:2025 - Injection                             : [✅|⚠️|❌]
+A06:2025 - Insecure Design                       : [✅|⚠️|❌]
+A07:2025 - Authentication Failures               : [✅|⚠️|❌]
+A08:2025 - Software or Data Integrity Failures   : [✅|⚠️|❌]
+A09:2025 - Logging & Alerting Failures           : [✅|⚠️|❌]
+A10:2025 - Mishandling of Exceptional Conditions : [✅|⚠️|❌]
 
 =================================================
    CONFORMIDAD RGPD

package/Dev/i18n/es/Symfony/skills/aggregates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: aggregates
-description: Regla 05: Aggregates y Aggregate Roots. Use when implementing DDD patterns.
+description: "Regla 05: Aggregates y Aggregate Roots. Use when implementing DDD patterns."
 ---
 
 # Regla 05: Aggregates y Aggregate Roots

package/Dev/i18n/es/Symfony/skills/async/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: async
-description: Regla 10: Async-First con Symfony Messenger. Use when working with async.
+description: "Regla 10: Async-First con Symfony Messenger. Use when working with async."
 ---
 
 # Regla 10: Async-First con Symfony Messenger

package/Dev/i18n/es/Symfony/skills/cqrs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cqrs
-description: Regla 07: CQRS - Command Query Responsibility Segregation. Use when implementing DDD patterns.
+description: "Regla 07: CQRS - Command Query Responsibility Segregation. Use when implementing DDD patterns."
 ---
 
 # Regla 07: CQRS - Command Query Responsibility Segregation

package/Dev/i18n/es/Symfony/skills/domain-events/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: domain-events
-description: Regla 06: Domain Events. Use when implementing DDD patterns.
+description: "Regla 06: Domain Events. Use when implementing DDD patterns."
 ---
 
 # Regla 06: Domain Events

package/Dev/i18n/es/Symfony/skills/i18n/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: i18n
-description: Regla 09: Internacionalización (i18n). Use when implementing internationalization.
+description: "Regla 09: Internacionalización (i18n). Use when implementing internationalization."
 ---
 
 # Regla 09: Internacionalización (i18n)

package/Dev/i18n/es/Symfony/skills/multitenant/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: multitenant
-description: Regla 08: Multitenant - Aislamiento y Seguridad. Use when working with multitenant.
+description: "Regla 08: Multitenant - Aislamiento y Seguridad. Use when working with multitenant."
 ---
 
 # Regla 08: Multitenant - Aislamiento y Seguridad

package/Dev/i18n/es/Symfony/skills/value-objects/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: value-objects
-description: Regla 04: Value Objects. Use when implementing DDD patterns.
+description: "Regla 04: Value Objects. Use when implementing DDD patterns."
 ---
 
 # Regla 04: Value Objects

package/Dev/i18n/es/Team/commands/audit.md

@@ -1,6 +1,6 @@
 ---
-description: "Equipo de Auditoria Completa - Auditoria paralela multi-tecnologia usando Agent Teams"
-argument-hint: "[--techs=auto|tech1,tech2] [--max-workers=4]"
+description: "Equipo de Auditoria Completa - Auditoria paralela multi-tecnologia con subagentes (Agent Teams opcional)"
+argument-hint: "[--techs=auto|tech1,tech2] [--max-workers=4] [--engine=subagents|teams]"
 ---
 
 # Equipo de Auditoria Completa - Auditoria Paralela Multi-Tecnologia
@@ -13,6 +13,7 @@ $ARGUMENTS
 
 - `--techs=auto`: Auto-detectar tecnologias (por defecto). O especificar separadas por comas: `--techs=symfony,react`
 - `--max-workers=4`: Maximo de auditores paralelos (por defecto: 4, max: 4)
+- `--engine=subagents`: Motor de ejecución (por defecto: `subagents`). Opciones: `subagents` (delegación a subagentes mediante la herramienta `Agent`, sin requisitos previos), `teams` (Agent Teams experimental). Ver «Motor de ejecución»
 - `--output-dir=<path>`: Directorio de salida personalizado para resultados de auditoria
 - `--max-cost=<dollars>`: Presupuesto maximo en dolares. Si el costo paralelo estimado supera este umbral, la ejecucion se bloquea con un mensaje OVER BUDGET
 - `--dry-run`: Mostrar composicion del equipo y costo estimado sin ejecutar
@@ -23,10 +24,34 @@ $ARGUMENTS
 
 > El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
+## Motor de ejecución (`--engine`)
+
+El motor por defecto no depende de ninguna funcionalidad experimental: el comando funciona aunque `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no esté definida.
+
+| Motor | Activación | Requisitos previos | Comportamiento |
+|-------|------------|--------------------|----------------|
+| `subagents` (por defecto) | sin flag o `--engine=subagents` | Ninguno (herramienta `Agent` nativa) | La sesión actual actúa como líder y delega cada tarea de worker a un subagente mediante la herramienta `Agent` (modelo del worker pasado con el parámetro `model`). Los subagentes independientes se lanzan en un mismo mensaje para ejecutarse en paralelo; cada uno escribe su resultado en su directorio aislado y solo devuelve un resumen breve. Los workers no se comunican entre sí: el líder hace de relevo. Funciona en modo interactivo, con `claude -p` y en CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipo Agent Teams: workers persistentes coordinados mediante `TaskCreate` / `TaskList` / `SendMessage`, mensajería directa entre compañeros, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Repliegue**: si se pide `--engine=teams` y `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no está definida, no fallar — mostrar `ℹ️ Agent Teams no disponible: repliegue a --engine=subagents` y continuar con el motor `subagents`.
+
+**Límites del motor `teams`**: sin modo no interactivo (`claude -p`) ni ejecución en CI; un solo equipo por sesión (terminar el equipo en curso antes de lanzar otro); API en research preview, sujeta a cambios.
+
+El proceso siguiente se describe con las primitivas de Agent Teams. Con `--engine=subagents`, aplicar esta correspondencia:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lanzamiento de un worker | Una llamada a la herramienta `Agent` cuyo prompt retoma la descripción de la tarea |
+| Polling de `TaskList` / barrera de sincronización | Esperar el retorno de todas las llamadas `Agent` del lote |
+| `SendMessage` a un worker | Reanudar el subagente (`SendMessage` a su ID) o nueva llamada `Agent` con el contexto necesario |
+| `shutdown_request` | Innecesario: un subagente termina al devolver su resultado |
+
+**Específico de la auditoría**: un subagente por stack, con el prompt de la plantilla de lanzamiento del paso 4. `--sequential` sigue disponible para procesarlo todo en la sesión actual, sin delegación.
+
 ## Prerequisitos
 
-- Claude Code v2.1.32+ con soporte de Agent Teams
-- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada
+- Claude Code v2.1.32+ con soporte de Agent Teams — solo con `--engine=teams`
+- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada — solo con `--engine=teams`
 - Proyecto con 2+ stacks tecnologicos detectados (proyectos de un solo stack deben usar el flag `--sequential`)
 - `Tools/AgentTeams/lib/compatibility-check.sh` disponible
 - `Tools/AgentTeams/lib/result-aggregator.sh` disponible

package/Dev/i18n/es/Team/commands/delivery.md

@@ -1,6 +1,6 @@
 ---
-description: Equipo de Entrega - Ciclo de vida completo del sprint (redaccion + implementacion) usando Agent Teams
-argument-hint: <sprint-name|prd-path> [--phase=all|writing|implementation] [--max-workers=3]
+description: Equipo de Entrega - Ciclo de vida completo del sprint (redaccion + implementacion) con subagentes (Agent Teams opcional)
+argument-hint: <sprint-name|prd-path> [--phase=all|writing|implementation] [--max-workers=3] [--engine=subagents|teams]
 ---
 
 # Equipo de Entrega - Ciclo de Vida Completo del Sprint (Redaccion + Implementacion)
@@ -14,6 +14,7 @@ $ARGUMENTS
 - `<sprint-name|prd-path>`: Nombre/ID del sprint o ruta al documento PRD
 - `--phase=all`: Fase a ejecutar (por defecto: `all`). Opciones: `all`, `writing`, `implementation`
 - `--max-workers=3`: Maximo de workers paralelos por fase (por defecto: 3, max: 3)
+- `--engine=subagents`: Motor de ejecución (por defecto: `subagents`). Opciones: `subagents` (delegación a subagentes mediante la herramienta `Agent`, sin requisitos previos), `teams` (Agent Teams experimental). Ver «Motor de ejecución»
 - `--overnight`: Ejecutar en modo nocturno (limitado, se detiene a las 6am)
 - `--supervised`: Pausar antes de cada story para confirmacion humana
 - `--max-stories=10`: Maximo de stories a procesar (por defecto: 10)
@@ -27,10 +28,34 @@ $ARGUMENTS
 
 > El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
+## Motor de ejecución (`--engine`)
+
+El motor por defecto no depende de ninguna funcionalidad experimental: el comando funciona aunque `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no esté definida.
+
+| Motor | Activación | Requisitos previos | Comportamiento |
+|-------|------------|--------------------|----------------|
+| `subagents` (por defecto) | sin flag o `--engine=subagents` | Ninguno (herramienta `Agent` nativa) | La sesión actual actúa como líder y delega cada tarea de worker a un subagente mediante la herramienta `Agent` (modelo del worker pasado con el parámetro `model`). Los subagentes independientes se lanzan en un mismo mensaje para ejecutarse en paralelo; cada uno escribe su resultado en su directorio aislado y solo devuelve un resumen breve. Los workers no se comunican entre sí: el líder hace de relevo. Funciona en modo interactivo, con `claude -p` y en CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipo Agent Teams: workers persistentes coordinados mediante `TaskCreate` / `TaskList` / `SendMessage`, mensajería directa entre compañeros, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Repliegue**: si se pide `--engine=teams` y `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no está definida, no fallar — mostrar `ℹ️ Agent Teams no disponible: repliegue a --engine=subagents` y continuar con el motor `subagents`.
+
+**Límites del motor `teams`**: sin modo no interactivo (`claude -p`) ni ejecución en CI; un solo equipo por sesión (terminar el equipo en curso antes de lanzar otro); API en research preview, sujeta a cambios.
+
+El proceso siguiente se describe con las primitivas de Agent Teams. Con `--engine=subagents`, aplicar esta correspondencia:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lanzamiento de un worker | Una llamada a la herramienta `Agent` cuyo prompt retoma la descripción de la tarea |
+| Polling de `TaskList` / barrera de sincronización | Esperar el retorno de todas las llamadas `Agent` del lote |
+| `SendMessage` a un worker | Reanudar el subagente (`SendMessage` a su ID) o nueva llamada `Agent` con el contexto necesario |
+| `shutdown_request` | Innecesario: un subagente termina al devolver su resultado |
+
+**Específico de la entrega**: en la Fase 1, la revisión cruzada pasa por el líder, que entrega el artefacto redactado a un subagente revisor y devuelve sus comentarios al redactor. En la Fase 2, lanzar cada worker desarrollador con `isolation: "worktree"`.
+
 ## Prerequisitos
 
-- Claude Code v2.1.32+ con soporte de Agent Teams
-- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada
+- Claude Code v2.1.32+ con soporte de Agent Teams — solo con `--engine=teams`
+- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada — solo con `--engine=teams`
 - PRD o tech spec disponible (para Fase 1) o backlog de sprint BMAD con stories `ready-for-dev` (solo para Fase 2)
 - Metadatos del sprint en `.bmad/sprint-status.yaml`
 - `Tools/AgentTeams/lib/compatibility-check.sh` disponible

package/Dev/i18n/es/Team/commands/security.md

@@ -1,6 +1,6 @@
 ---
-description: "Equipo de Revision de Seguridad - Auditoria de seguridad paralela multi-dimension usando Agent Teams"
-argument-hint: "[--scope=full|code|deps|infra] [--max-workers=3]"
+description: "Equipo de Revision de Seguridad - Auditoria de seguridad paralela multi-dimension con subagentes (Agent Teams opcional)"
+argument-hint: "[--scope=full|code|deps|infra] [--max-workers=3] [--engine=subagents|teams]"
 ---
 
 # Equipo de Revision de Seguridad - Auditoria de Seguridad Paralela Multi-Dimension
@@ -13,6 +13,7 @@ $ARGUMENTS
 
 - `--scope=full`: Alcance de la auditoria (por defecto: `full`). Opciones: `full`, `code`, `deps`, `infra`
 - `--max-workers=3`: Maximo de revisores paralelos (por defecto: 3, max: 3)
+- `--engine=subagents`: Motor de ejecución (por defecto: `subagents`). Opciones: `subagents` (delegación a subagentes mediante la herramienta `Agent`, sin requisitos previos), `teams` (Agent Teams experimental). Ver «Motor de ejecución»
 - `--severity=medium`: Severidad minima a reportar: `low`, `medium`, `high`, `critical`
 - `--output-dir=<path>`: Directorio de salida personalizado para resultados de seguridad
 - `--dry-run`: Mostrar composicion del equipo y plan de escaneo sin ejecutar
@@ -23,10 +24,36 @@ $ARGUMENTS
 
 > El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
+## Motor de ejecución (`--engine`)
+
+El motor por defecto no depende de ninguna funcionalidad experimental: el comando funciona aunque `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no esté definida.
+
+| Motor | Activación | Requisitos previos | Comportamiento |
+|-------|------------|--------------------|----------------|
+| `subagents` (por defecto) | sin flag o `--engine=subagents` | Ninguno (herramienta `Agent` nativa) | La sesión actual actúa como líder y delega cada tarea de worker a un subagente mediante la herramienta `Agent` (modelo del worker pasado con el parámetro `model`). Los subagentes independientes se lanzan en un mismo mensaje para ejecutarse en paralelo; cada uno escribe su resultado en su directorio aislado y solo devuelve un resumen breve. Los workers no se comunican entre sí: el líder hace de relevo. Funciona en modo interactivo, con `claude -p` y en CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipo Agent Teams: workers persistentes coordinados mediante `TaskCreate` / `TaskList` / `SendMessage`, mensajería directa entre compañeros, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Repliegue**: si se pide `--engine=teams` y `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no está definida, no fallar — mostrar `ℹ️ Agent Teams no disponible: repliegue a --engine=subagents` y continuar con el motor `subagents`.
+
+**Límites del motor `teams`**: sin modo no interactivo (`claude -p`) ni ejecución en CI; un solo equipo por sesión (terminar el equipo en curso antes de lanzar otro); API en research preview, sujeta a cambios.
+
+El proceso siguiente se describe con las primitivas de Agent Teams. Con `--engine=subagents`, aplicar esta correspondencia:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lanzamiento de un worker | Una llamada a la herramienta `Agent` cuyo prompt retoma la descripción de la tarea |
+| Polling de `TaskList` / barrera de sincronización | Esperar el retorno de todas las llamadas `Agent` del lote |
+| `SendMessage` a un worker | Reanudar el subagente (`SendMessage` a su ID) o nueva llamada `Agent` con el contexto necesario |
+| `shutdown_request` | Innecesario: un subagente termina al devolver su resultado |
+
+**Alcance**: `--scope=full|code|deps|infra` se aplica a ambos motores (`full` = 3 reviewers en paralelo, un alcance único = un solo reviewer).
+
+**Diferencia con `/security-review` nativo**: el comando integrado `/security-review` de Claude Code solo analiza el diff (cambios pendientes de la rama actual). `/team:security` audita todo el repositorio según el alcance elegido (código, dependencias, infraestructura). Usar `/security-review` antes de un commit o una PR, `/team:security` para una auditoría completa.
+
 ## Prerequisitos
 
-- Claude Code v2.1.32+ con soporte de Agent Teams
-- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada
+- Claude Code v2.1.32+ con soporte de Agent Teams — solo con `--engine=teams`
+- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada — solo con `--engine=teams`
 - Docker disponible para ejecutar escaneadores de seguridad
 - `Tools/AgentTeams/lib/compatibility-check.sh` disponible
 - `Tools/AgentTeams/lib/result-aggregator.sh` disponible

package/Dev/i18n/es/Team/commands/sprint.md

@@ -1,6 +1,6 @@
 ---
-description: Equipo de Desarrollo de Sprint - Implementacion paralela de stories usando Agent Teams
-argument-hint: <sprint-name> [--max-workers=3] [--overnight]
+description: Equipo de Desarrollo de Sprint - Implementacion paralela de stories con subagentes (Agent Teams opcional)
+argument-hint: <sprint-name> [--max-workers=3] [--overnight] [--engine=subagents|teams]
 ---
 
 # Equipo de Desarrollo de Sprint - Implementacion Paralela de Stories
@@ -13,22 +13,47 @@ $ARGUMENTS
 
 - `<sprint-name>`: Nombre o ID del sprint a procesar
 - `--max-workers=3`: Maximo de dev workers paralelos (por defecto: 2, max: 3)
+- `--engine=subagents`: Motor de ejecución (por defecto: `subagents`). Opciones: `subagents` (delegación a subagentes mediante la herramienta `Agent`, sin requisitos previos), `teams` (Agent Teams experimental). Ver «Motor de ejecución»
 - `--overnight`: Ejecutar en modo nocturno (limitado, se detiene a las 6am)
 - `--supervised`: Pausar antes de cada story para confirmacion humana
 - `--max-stories=10`: Maximo de stories a procesar (por defecto: 10)
 - `--timeout=12`: Tiempo maximo de ejecucion en horas (por defecto: 12)
 - `--dry-run`: Mostrar composicion del equipo y asignacion de stories sin ejecutar
 - `--max-cost=<dollars>`: Presupuesto maximo en dolares. Si el costo paralelo estimado supera este umbral, la ejecucion se bloquea con un mensaje OVER BUDGET
-- `--ralph-mode`: Habilitar motor de recuperacion Ralph (clasificacion de errores, auto-reintento, servicio de escalamiento) junto con la paralelizacion de Agent Teams.
+- `--ralph-mode`: Habilitar motor de recuperacion Ralph (clasificacion de errores, auto-reintento, servicio de escalamiento) junto con la paralelizacion de Agent Teams. Requiere `--engine=teams`: el adaptador Ralph Teams se basa en `TaskCreate` / `SendMessage`.
 
 ## Modo Plan
 
 > El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
 
+## Motor de ejecución (`--engine`)
+
+El motor por defecto no depende de ninguna funcionalidad experimental: el comando funciona aunque `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no esté definida.
+
+| Motor | Activación | Requisitos previos | Comportamiento |
+|-------|------------|--------------------|----------------|
+| `subagents` (por defecto) | sin flag o `--engine=subagents` | Ninguno (herramienta `Agent` nativa) | La sesión actual actúa como líder y delega cada tarea de worker a un subagente mediante la herramienta `Agent` (modelo del worker pasado con el parámetro `model`). Los subagentes independientes se lanzan en un mismo mensaje para ejecutarse en paralelo; cada uno escribe su resultado en su directorio aislado y solo devuelve un resumen breve. Los workers no se comunican entre sí: el líder hace de relevo. Funciona en modo interactivo, con `claude -p` y en CI. |
+| `teams` | `--engine=teams` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, Claude Code v2.1.32+ | Equipo Agent Teams: workers persistentes coordinados mediante `TaskCreate` / `TaskList` / `SendMessage`, mensajería directa entre compañeros, hooks `TeammateIdle` / `TaskCompleted`. |
+
+**Repliegue**: si se pide `--engine=teams` y `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` no está definida, no fallar — mostrar `ℹ️ Agent Teams no disponible: repliegue a --engine=subagents` y continuar con el motor `subagents`.
+
+**Límites del motor `teams`**: sin modo no interactivo (`claude -p`) ni ejecución en CI; un solo equipo por sesión (terminar el equipo en curso antes de lanzar otro); API en research preview, sujeta a cambios.
+
+El proceso siguiente se describe con las primitivas de Agent Teams. Con `--engine=subagents`, aplicar esta correspondencia:
+
+| Agent Teams (`teams`) | Subagentes (`subagents`) |
+|------------------------|---------------------------|
+| `TaskCreate` + lanzamiento de un worker | Una llamada a la herramienta `Agent` cuyo prompt retoma la descripción de la tarea |
+| Polling de `TaskList` / barrera de sincronización | Esperar el retorno de todas las llamadas `Agent` del lote |
+| `SendMessage` a un worker | Reanudar el subagente (`SendMessage` a su ID) o nueva llamada `Agent` con el contexto necesario |
+| `shutdown_request` | Innecesario: un subagente termina al devolver su resultado |
+
+**Específico del sprint**: con `subagents`, lanzar cada worker desarrollador con `isolation: "worktree"` para que las stories en paralelo no modifiquen el mismo árbol de trabajo.
+
 ## Prerequisitos
 
-- Claude Code v2.1.32+ con soporte de Agent Teams
-- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada
+- Claude Code v2.1.32+ con soporte de Agent Teams — solo con `--engine=teams`
+- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurada — solo con `--engine=teams`
 - Backlog de sprint BMAD con stories en estado `ready-for-dev`
 - Metadatos del sprint en `.bmad/sprint-status.yaml`
 - Al menos 2 stories independientes (sprints de una sola story usan Ralph secuencial)

package/Dev/i18n/es/UIUX/commands/audit.md

@@ -24,36 +24,7 @@ Ejemplo: `/uiux:audit src/pages/Dashboard.tsx AAA`
 
 ### Paso 1: Auditoría de Accesibilidad (Experto A11y)
 
-#### 1.1 Auditoría automatizada
-```bash
-# Ejecutar si está disponible
-npx axe-cli {URL}
-npx pa11y {URL}
-# O verificar Lighthouse
-```
-
-#### 1.2 Verificación manual WCAG 2.2 AAA
-
-**Perceptible**
-- [ ] Imágenes con texto alt
-- [ ] Estructura semántica (h1-h6, landmarks)
-- [ ] Contraste ≥ 7:1 (AAA)
-- [ ] Reflow a 320px
-
-**Operable**
-- [ ] Navegación completa por teclado
-- [ ] Sin trampa de teclado
-- [ ] Foco visible (≥ 2px)
-- [ ] Objetivos táctiles ≥ 44px
-
-**Comprensible**
-- [ ] lang en html
-- [ ] Labels en inputs
-- [ ] Mensajes de error claros
-
-**Robusto**
-- [ ] ARIA correcto
-- [ ] aria-live para dinámico
+Ejecutar `/uiux:a11y-audit {URL o ruta} {nivel}` y trasladar su informe (puntuación, criterios WCAG no conformes, remediaciones) a la síntesis. No repetir aquí la auditoría automatizada ni la checklist WCAG: `/uiux:a11y-audit` es la fuente única.
 
 ### Paso 2: Auditoría UX/Ergonomía (Experto UX)
 

package/Dev/i18n/es/UIUX/commands/component-spec.md

@@ -41,11 +41,7 @@ Definir lo visual:
 
 ### Paso 3: Especificación A11y (Experto A11y)
 
-Definir accesibilidad:
-- Semántica HTML
-- Atributos ARIA
-- Navegación por teclado
-- Anuncios de lector de pantalla
+Ejecutar `/uiux:a11y-component {NOMBRE}` y trasladar su especificación (semántica HTML, atributos ARIA, navegación por teclado, foco, contraste, anuncios del lector de pantalla) a la sección ♿ de la síntesis. No redefinirla aquí.
 
 ### Paso 4: Síntesis
 

package/Dev/i18n/es/UIUX/commands/orchestrator.md

@@ -1,102 +1,9 @@
 ---
-description: Orquestador UI/UX
-argument-hint: [arguments]
+description: "Obsoleto (se elimina en 9.0): usa el agente @uiux-orchestrator"
+deprecated: true
+replaced-by: "@uiux-orchestrator"
 ---
 
-# Orquestador UI/UX
+> ⚠️ `/uiux:orchestrator` está obsoleto y se eliminará en 9.0. Usa el agente `@uiux-orchestrator`.
 
-Eres el Orquestador UI/UX. Debes coordinar a los 3 expertos para entregar interfaces excepcionales.
-
-## Argumentos
-$ARGUMENTS
-
-Argumentos:
-- Tipo de solicitud: componente, auditoría, flujo, tokens
-- Objetivo o descripción
-
-Ejemplo: `/uiux:orchestrator componente "Selector de fecha"` o `/uiux:orchestrator auditoría "Página de checkout"`
-
-## Modo Plan
-
-> El modo plan se activa automáticamente cuando el alcance abarca varios módulos o requiere una investigación transversal.
-
-## MISIÓN
-
-### Paso 1: Analizar la solicitud
-
-Identificar:
-- Tipo de entregable esperado
-- Experto(s) a involucrar
-- Orden de intervención
-
-### Paso 2: Delegar a los expertos
-
-| Tipo | Expertos | Orden |
-|------|----------|-------|
-| Nuevo componente | UI → UX → A11y | Secuencial |
-| Auditoría | A11y → UX → UI | Secuencial |
-| Flujo de usuario | UX → UI → A11y | Secuencial |
-| Design tokens | UI solamente | Directo |
-
-### Paso 3: Consolidar y arbitrar
-
-En caso de conflicto, aplicar reglas de prioridad:
-1. Accesibilidad AAA (no negociable)
-2. Lighthouse 100/100
-3. UX > Estética
-4. Mobile-first
-5. Coherencia design system
-
-### Paso 4: Entregar síntesis
-
-```
-══════════════════════════════════════════════════════════════
-📋 SÍNTESIS UI/UX: {TEMA}
-══════════════════════════════════════════════════════════════
-
-Tipo: {Componente | Auditoría | Flujo | Tokens}
-Fecha: {fecha}
-
-──────────────────────────────────────────────────────────────
-🧠 UX
-──────────────────────────────────────────────────────────────
-
-{Resumen aportaciones UX}
-
-──────────────────────────────────────────────────────────────
-🎨 UI
-──────────────────────────────────────────────────────────────
-
-{Resumen aportaciones UI}
-
-──────────────────────────────────────────────────────────────
-♿ ACCESIBILIDAD
-──────────────────────────────────────────────────────────────
-
-{Resumen aportaciones A11y}
-
-──────────────────────────────────────────────────────────────
-⚖️ ARBITRAJES
-──────────────────────────────────────────────────────────────
-
-| Conflicto | Decisión | Justificación |
-|-----------|----------|---------------|
-| {conflicto} | {decisión} | {regla aplicada} |
-
-──────────────────────────────────────────────────────────────
-✅ CHECKLIST VALIDACIÓN
-──────────────────────────────────────────────────────────────
-
-- [ ] WCAG 2.2 AAA conforme
-- [ ] Lighthouse 100/100 preservado
-- [ ] Mobile-first respetado
-- [ ] Solo tokens (sin hardcode)
-- [ ] Los 3 expertos consultados
-
-──────────────────────────────────────────────────────────────
-🎯 PRÓXIMOS PASOS
-──────────────────────────────────────────────────────────────
-
-1. {acción prioritaria}
-2. {acción siguiente}
-```
+Delega «$ARGUMENTS» al agente `uiux-orchestrator` (herramienta Agent) y devuelve su respuesta.

package/Dev/i18n/es/Workflow/commands/auto-sprint.md

@@ -1,6 +1,6 @@
 ---
 description: Orquestador de sprint de extremo a extremo (inicio -> descomposición -> validación -> implementación -> PR -> CI -> revisión -> retro -> merge)
-argument-hint: "<N> [--from-prd] [--auto-merge] [--max-fix-attempts=2] [--max-workers=3] [--base=main] [--dry-run] [--overnight]"
+argument-hint: "<N> [--from-prd] [--auto-merge] [--max-fix-attempts=2] [--max-workers=3] [--base=main] [--dry-run] [--overnight] [--engine=subagents|teams]"
 ---
 
 # Auto Sprint — Orquestador de Sprint de Extremo a Extremo
@@ -31,14 +31,15 @@ $ARGUMENTS
   regla 09, y el principio Karpathy de "no auto-merge sin revisión humana").
 - `--max-fix-attempts=2` : Máximo de reintentos de corrección automática por gate fallido antes de abortar (por defecto: 2).
 - `--max-workers=3` : Máximo de workers de desarrollo en paralelo durante la fase de implementación (por defecto: 2, máximo: 3).
+- `--engine=subagents`: Motor de la fase de implementación (por defecto: `subagents`, delegación mediante la herramienta `Agent`). `teams`: Agent Teams experimental, con repliegue a `subagents` si no está disponible. Ver `/team:sprint`, sección «Motor de ejecución»
 - `--base=main` : Rama base para la PR (por defecto: `main`).
 - `--dry-run` : Muestra las 9 fases planificadas y el contexto de sprint resuelto, luego se detiene. **Sin escrituras.**
 - `--overnight` : Se pasa directamente a la fase de implementación (acotada, se detiene a las 6 a.m.).
 
 ## Requisitos previos
 
-- Claude Code v2.1.32+ con soporte de Agent Teams
-- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurado
+- Claude Code v2.1.32+ con soporte de Agent Teams — solo con `--engine=teams`
+- `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` configurado — solo con `--engine=teams`
 - CLI `gh` autenticada (creación de PR / checks / merge)
 - Docker disponible (todos los tests se ejecutan vía Docker — ver CLAUDE.md del proyecto)
 - Proyecto BMAD v6: `/workflow:start` (fase 1) crea `.bmad/sprint-status.yaml` si no existe
@@ -106,6 +107,8 @@ Lanzar un sub-agente aislado:
 
 Asumir directamente el **rol de conductor de `/team:sprint`** (**no** lanzar un Agent Team anidado):
 
+**Motor**: con `--engine=subagents` (por defecto), en el paso 4 lanzar un subagente por story mediante la herramienta `Agent` (`isolation: "worktree"`, todos en un mismo mensaje) en lugar de `TaskCreate`, y en el paso 5 esperar su retorno en lugar de consultar `TaskList` (correspondencia completa en `/team:sprint`, sección «Motor de ejecución»). Con `--engine=teams`, seguir los pasos tal como están escritos.
+
 1. Leer `.bmad/sprint-status.yaml`; filtrar historias en estado `ready-for-dev`.
 2. Analizar la independencia de dominio de archivos (marcar solapamientos de `**/Shared/**`, `**/Common/**`, `**/Utils/**`,
    `**/Helpers/**` → secuenciar en el mismo worker).
@@ -194,7 +197,7 @@ Fase                  | Estado  | Notas
 | Fallo de DoD en historia tras reintentos | Marcar `blocked`, continuar, informar al final |
 | CI en rojo tras reintentos | Abortar con informe del check fallido |
 | Merge bloqueado (protección / scope) | Mostrar el error + flag sugerido, no forzar |
-| Agent Teams no disponible | Abortar la Fase 4 con una pista de configuración (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`) |
+| Agent Teams no disponible con `--engine=teams` | Repliegue a `--engine=subagents` (sin abortar); definir `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` para usar `--engine=teams` |
 
 ## Notas
 

package/Dev/i18n/es/Workflow/commands/plan.md

@@ -69,7 +69,7 @@ Antiguo `/workflow:plan --research`. Investigación, exploración y restriccione
 | Mercado | ¿Soluciones existentes? ¿Competidores? ¿Buenas prácticas del sector? ¿Tendencias emergentes? |
 | Técnica | ¿Tecnologías candidatas? ¿Integraciones? ¿Escalabilidad? ¿Seguridad / cumplimiento? |
 
-Si el MCP Context7 está configurado, usarlo para documentación técnica actualizada (`/common:research-context7` para una investigación profunda).
+Si el MCP Context7 está configurado, usarlo para documentación técnica actualizada (`/deep-research` para una investigación web profunda; fuera de claude.ai, el agente `@research-assistant`).
 
 **Restricciones**: documentar las restricciones técnicas (backend existente, base de datos), de negocio (presupuesto, plazos, retrocompatibilidad), regulatorias (RGPD, PCI DSS) y de recursos (tamaño del equipo, sin DevOps).
 
@@ -213,4 +213,3 @@ Si se interrumpe, `/workflow:plan --continue` detecta lo que existe (PRD complet
 - `/workflow:status` - Comprobar el progreso
 - `/project:backlog` - Añadir, listar, editar y mover stories después
 - `/gate:check` - Validar el backlog
-- `/common:research-context7` - Investigación profunda con Context7 MCP