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

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

@@ -69,7 +69,7 @@ Former `/workflow:plan --research`. Focus on research, exploration and constrain
 | Market | Existing solutions? Competitors? Industry best practices? Emerging trends? |
 | Technical | Candidate technologies? Integrations? Scalability? Security / compliance? |
 
-If MCP Context7 is configured, use it for up-to-date technical documentation (`/common:research-context7` for deep research).
+If MCP Context7 is configured, use it for up-to-date technical documentation (`/deep-research` for deep web research; outside claude.ai, the `@research-assistant` agent).
 
 **Constraints**: document technical (existing backend, database), business (budget, timeline, backward compatibility), regulatory (GDPR, PCI DSS) and resource (team size, no DevOps) constraints.
 
@@ -213,4 +213,3 @@ If interrupted, `/workflow:plan --continue` detects what exists (PRD complete, b
 - `/workflow:status` - Check progress
 - `/project:backlog` - Add, list, edit and move stories afterwards
 - `/gate:check` - Validate the backlog
-- `/common:research-context7` - Deep research with Context7 MCP

package/Dev/i18n/es/Common/agents/devops-engineer.md

@@ -7,20 +7,6 @@ maxTurns: 8
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
 permissionMode: default
 skills: [git-workflow, security]
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(kubectl delete:*)"
-  - "Bash(helm uninstall:*)"
-  - "Bash(terraform destroy:*)"
-  - "Bash(tofu destroy:*)"
-  - "Bash(docker system prune -a*)"
-  - "Bash(docker volume rm:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
-  - "Bash(git push --force*)"
-  - "Bash(git push -f*)"
 ---
 
 # Agente Ingeniero DevOps
@@ -232,3 +218,22 @@ strategy:
 3. Configurar health checks
 4. Preparar rollback
 5. Monitorear despliegue
+
+## Protección de comandos destructivos
+
+Un agente no puede bloquear un comando concreto: `disallowedTools: Bash(...)` retira todo Bash. Estos comandos pasan por el prompt de permiso — pedir siempre una confirmación explícita antes de ejecutarlos. Para bloquearlos en un proyecto, añadir a su `.claude/settings.json` (las reglas también se aplican a los subagentes):
+
+```json
+{
+  "permissions": {
+    "deny": [
+      "Bash(kubectl delete:*)",
+      "Bash(helm uninstall:*)",
+      "Bash(terraform destroy:*)",
+      "Bash(tofu destroy:*)",
+      "Bash(docker volume rm:*)",
+      "Bash(docker system prune -a*)"
+    ]
+  }
+}
+```

package/Dev/i18n/es/Common/agents/migration-specialist.md

@@ -6,22 +6,13 @@ maxTurns: 6
 effort: xhigh
 memory: user
 tools: [Read, Glob, Grep, Bash, WebFetch, WebSearch]
-# Audit 2026-05-18 QW-15 — migrations touch shared/prod databases. Block
-# destructive shell verbs and database drop/truncate. Investigate-then-output
-# is fine; actual destructive execution must require an explicit user opt-in.
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(DROP DATABASE:*)"
-  - "Bash(DROP TABLE:*)"
-  - "Bash(TRUNCATE:*)"
-  - "Bash(pg_dump:*)"
-  - "Bash(mysqldump:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 permissionMode: default
+hooks:
+  PreToolUse:
+    - matcher: "Bash"
+      hooks:
+        - type: command
+          command: "grep -qiE '(^|[^A-Za-z_])(DROP[[:space:]]+(DATABASE|SCHEMA|TABLE)|TRUNCATE)([^A-Za-z_]|$)' && { echo \"BLOQUEADO: SQL destructivo (DROP DATABASE/SCHEMA/TABLE, TRUNCATE). Proponer el comando al usuario para que lo ejecute él mismo.\" >&2; exit 2; } || exit 0"
 ---
 
 # Agente Migration Specialist
@@ -140,3 +131,7 @@ Eres un **Migration Specialist Senior** con más de 12 años de experiencia en m
 - [Stripe - Online migrations at scale](https://stripe.com/blog/online-migrations)
 - [Shopify - Sharding playbook](https://shopify.engineering/learnings-from-shopifys-largest-database-sharding-project)
 - [Strangler Fig - Martin Fowler](https://martinfowler.com/bliki/StranglerFigApplication.html)
+
+## Protección contra SQL destructivo
+
+Un hook `PreToolUse` declarado en el frontmatter bloquea, mientras este agente se ejecuta, todo comando Bash que contenga `DROP DATABASE`, `DROP SCHEMA`, `DROP TABLE` o `TRUNCATE` (por ejemplo `psql -c "DROP TABLE …"`): proponer entonces el comando al usuario. Los archivos de migración escritos con Edit/Write no se ven afectados. Límites: el hook solo se ejecuta tras aceptar la confianza de la carpeta (workspace trust) y se ignora cuando el agente se carga desde un plugin.

package/Dev/i18n/es/Common/agents/mlops-engineer.md

@@ -6,21 +6,6 @@ maxTurns: 6
 effort: medium
 memory: user
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
-# Audit 2026-05-18 QW-15 — MLOps touches feature stores, model registries
-# and inference endpoints (often production). Block destructive verbs on
-# data/model artefacts and on the underlying infra.
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(kubectl delete:*)"
-  - "Bash(helm uninstall:*)"
-  - "Bash(mlflow models delete:*)"
-  - "Bash(mlflow registered-models delete:*)"
-  - "Bash(aws s3 rm:*)"
-  - "Bash(gsutil rm:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 permissionMode: default
 ---
 
@@ -262,3 +247,22 @@ if report.as_dict()["metrics"][0]["result"]["dataset_drift"]:
 - [Google MLOps Guide](https://cloud.google.com/architecture/mlops-continuous-delivery-and-automation-pipelines-in-machine-learning)
 - [Book: Introducing MLOps](https://www.oreilly.com/library/view/introducing-mlops/9781492083283/)
 - [ML Model Governance](https://learn.microsoft.com/en-us/azure/machine-learning/concept-model-management-and-deployment)
+
+## Protección de comandos destructivos
+
+Un agente no puede bloquear un comando concreto: `disallowedTools: Bash(...)` retira todo Bash. Estos comandos pasan por el prompt de permiso — pedir siempre una confirmación explícita antes de ejecutarlos. Para bloquearlos en un proyecto, añadir a su `.claude/settings.json` (las reglas también se aplican a los subagentes):
+
+```json
+{
+  "permissions": {
+    "deny": [
+      "Bash(kubectl delete:*)",
+      "Bash(helm uninstall:*)",
+      "Bash(mlflow models delete:*)",
+      "Bash(mlflow registered-models delete:*)",
+      "Bash(aws s3 rm:*)",
+      "Bash(gsutil rm:*)"
+    ]
+  }
+}
+```

package/Dev/i18n/es/Common/agents/ralph-conductor.md

@@ -5,17 +5,6 @@ model: opus
 effort: xhigh
 maxTurns: 10
 memory: user
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
-  - "Bash(git push --force*)"
-  - "Bash(git push -f*)"
 ---
 
 # Agente Ralph Conductor v2.0
@@ -186,11 +175,11 @@ Summary:
 
 ## Modo de Coordinación de Equipos de Agentes
 
-Cuando opera en modo Agent Teams (activado mediante `--ralph-mode` en `/team:sprint`), el conductor asume el rol de **team lead** y coordina a un compañero desarrollador a través de la API Claude Code Agent Teams en lugar de la gestión de procesos bash.
+Cuando opera en modo Agent Teams (activado mediante `--ralph-mode` en `/team:sprint --engine=teams`), el conductor asume el rol de **team lead** y coordina a un compañero desarrollador a través de la API Claude Code Agent Teams en lugar de la gestión de procesos bash.
 
 ### Prerequisitos
 
-- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
+- Variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` (solo requerida por `/team:sprint --engine=teams`)
 - Claude Code v2.1.32+
 - Librería adaptadora: `Tools/AgentTeams/lib/ralph-teams-adapter.sh`
 
@@ -227,8 +216,8 @@ El conductor ejecuta comprobaciones de salud periódicas a través de `teams_wat
 ### Mantenimiento del Modo Bash Intacto
 
 Toda la orquestación en modo bash existente permanece sin cambios. El modo Agent Teams se activa únicamente cuando:
-1. La bandera `--ralph-mode` se pasa a `/team:sprint`
-2. La variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está definida
+1. La bandera `--ralph-mode` se pasa a `/team:sprint --engine=teams`
+2. La variable de entorno `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` está definida (solo requerida por `/team:sprint --engine=teams`)
 3. La librería adaptadora está disponible
 
 Sin estas condiciones, el conductor opera exactamente como antes.

package/Dev/i18n/es/Common/agents/refactoring-specialist.md

@@ -7,15 +7,6 @@ maxTurns: 8
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
 permissionMode: default
 skills: [solid-principles, kiss-dry-yagni, testing]
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 ---
 
 # Agente Especialista en Refactoring

package/Dev/i18n/es/Common/agents/tdd-coach.md

@@ -7,15 +7,6 @@ maxTurns: 8
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
 permissionMode: default
 skills: [testing, solid-principles]
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 ---
 
 # Agente Coach TDD/BDD

package/Dev/i18n/es/Common/agents/uiux-orchestrator.md

@@ -6,15 +6,6 @@ effort: medium
 maxTurns: 10
 tools: [Read, Glob, Grep, Edit, Write, Bash, Agent, WebFetch, WebSearch]
 permissionMode: default
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 ---
 
 # Agente Orquestador UI/UX

package/Dev/i18n/es/Common/commands/ralph-run.md

@@ -51,6 +51,12 @@ Ejecuta Claude en un bucle continuo hasta que la tarea esté completa o se cumpl
    - Establecer máximo de iteraciones, timeouts y criterios DoD
    - Inicializar hooks si están habilitados
 
+#### Aislamiento de sesiones y workers paralelos
+
+- **Sesión de Claude explícita**: cada sesión de Ralph fija su propio identificador de conversación de Claude — `claude --session-id <uuid>` en la primera iteración y luego `claude --resume <uuid>`. El UUID se guarda en `.ralph/sessions/<session>/claude_session_id`, de modo que `--continue=<session>` reanuda la conversación correcta. Ralph ya no usa `claude --continue`, que reanudaba «la conversación más reciente del directorio» (compartida entre workers, o incluso con la sesión interactiva del usuario).
+- **Un worktree de git por worker** (modo paralelo, `lib/parallel-manager.sh`): cada historia se ejecuta en un worktree dedicado `.ralph/parallel/worktrees/<session>` sobre la rama `ralph/<session>`, con su estado de Ralph en `.ralph/parallel/sessions/<session>/ralph/`. Al final de la ejecución, los cambios pendientes se confirman como `wip(ralph): <story>` en esa rama y después se elimina el worktree (`git worktree remove`). Si ese commit falla, el worktree se conserva (sin pérdida de datos) y se indica en `output.log`. El trabajo se recupera fusionando las ramas `ralph/*`.
+- **Fuera de un repositorio git**: sin worktree; el worker se ejecuta en el directorio actual (se muestra un aviso) y el aislamiento de sesiones de Claude se mantiene.
+
 ### 2. Bucle Principal con Dashboard
 
 ```
@@ -76,6 +82,35 @@ El sistema DoD valida la finalización a través de múltiples criterios:
 | `hook` | Ejecutar un hook de Claude existente |
 | `human` | Validación humana interactiva |
 
+#### Límite del validador `command` → usar `type: hook`
+
+`type: command` solo ejecuta los comandos que pasan la lista blanca de `Tools/Ralph/lib/dod-validator.sh`: letras, dígitos, espacio y `_ . / " ' -`. Cualquier comando que contenga `=`, `|`, `&` o `:` (así como `;`, `>`, `$`, etc.) se rechaza con `ERROR: Invalid command`: el criterio **nunca** se valida y el bucle se ejecuta hasta que salta el circuit breaker.
+
+| Comando rechazado | Carácter culpable |
+|-------------------|-------------------|
+| `dotnet build /p:TreatWarningsAsErrors=true` | `:` y `=` |
+| `npm test && npm run lint` | `&` |
+| `pytest \| tee out.log` | `\|` |
+
+En estos casos, colocar el comando en un script y declararlo como `type: hook`:
+
+```yaml
+definition_of_done:
+  checklist:
+    - id: build
+      type: hook
+      script: ".ralph/dod/build.sh"
+      required: true
+```
+
+```bash
+#!/usr/bin/env bash
+# .ralph/dod/build.sh — recibe {"cwd": ..., "output": ...} en JSON por stdin
+dotnet build /p:TreatWarningsAsErrors=true || exit 2
+```
+
+El script devuelve `0` (criterio cumplido) o `2` (criterio fallido). Claves leídas por tipo: `command` → `command:`, `output_contains` y `file_changed` → `pattern:`, `hook` → `script:`, `human` → `prompt:`.
+
 ### 4. Circuit Breaker Adaptativo (v2.0)
 
 Selecciona automáticamente el perfil basándose en palabras clave de la tarea:
@@ -100,6 +135,23 @@ Claude trabaja...
 Stop → stop-dod-gate.sh → Bloquear si DoD no satisfecho (exit 2)
 ```
 
+## ¿/goal (interactivo) o Ralph (autónomo/CI)?
+
+`/goal` es un comando nativo de Claude Code que se escribe dentro de una sesión: no es una opción de `ralph.sh`, que no ofrece ninguna para ello y nunca genera un `/goal`. Ambas herramientas son complementarias:
+
+| Criterio | `/goal` (nativo) | Ralph (`ralph.sh`) |
+|----------|------------------|--------------------|
+| Criterio de fin | Juicio LLM: un modelo pequeño y rápido evalúa, tras cada turno, lo que es visible en la conversación — no ejecuta ningún comando ni lee ningún archivo | Determinista: comandos, patrones y hooks ejecutados por `dod-validator.sh` |
+| Límite de iteraciones | Sin límite fijo: termina cuando la condición se cumple o se juzga imposible, con `/goal clear`, o si Claude encadena varios turnos sin herramientas; se puede escribir un límite en la condición | `max_iterations` + circuit breaker adaptativo |
+| Headless / CI | `claude -p "/goal ..."` itera hasta el final en una sola invocación; uso en CI no documentado | Diseñado para ello: ejecución autónoma (`--autonomous`, `--overnight`), dashboard `headless` |
+| `disableAllHooks: true` | No disponible: `/goal` envuelve un Stop hook de sesión (igual con `allowManagedHooksOnly`) | El bucle y la DoD se ejecutan dentro de `ralph.sh`; solo se desactiva la integración de hooks (`stop-dod-gate.sh`) |
+| Configuración | Ninguna; un único goal por sesión, borrado por `/clear` | `ralph.yml` |
+
+- **Elegir `/goal`** para una tarea interactiva cuyo fin se constata en la conversación (mostrar la salida de los tests: el evaluador no los ejecuta).
+- **Elegir Ralph** cuando el fin debe demostrarse con comandos, con un límite de iteraciones, de forma autónoma o en CI.
+
+Referencia: [documentación de `/goal`](https://code.claude.com/docs/en/goal).
+
 ## Ejemplos de Inicio Rápido
 
 ```bash

package/Dev/i18n/es/Common/commands/research-context7.md

@@ -1,257 +1,9 @@
 ---
-description: Investigación con Context7 y Web
-argument-hint: [arguments]
+description: "Obsoleto (se elimina en 9.0): usa el MCP context7 o /deep-research"
+deprecated: true
+replaced-by: mcp:context7
 ---
 
-# Investigación con Context7 y Web
+> ⚠️ `/common:research-context7` está obsoleto y se eliminará en 9.0. Usa el MCP context7 o `/deep-research`.
 
-Eres un asistente de investigación experto. Debes utilizar MCP Context7 para acceder a documentación de bibliotecas y búsqueda web para encontrar información actualizada sobre un tema técnico.
-
-## Argumentos
-$ARGUMENTS
-
-Argumentos:
-- Tema de investigación o pregunta técnica
-- (Opcional) Bibliotecas específicas a consultar
-
-Ejemplo: `/common:research-context7 "Cómo implementar autenticación OAuth2 con NextAuth.js"` o `/common:research-context7 "Mejores prácticas React 19" react,nextjs`
-
-## 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:
-- Tema principal de investigación
-- Tecnologías/bibliotecas involucradas
-- Nivel de detalle requerido
-- Preguntas específicas a responder
-
-### Paso 2: Usar Context7 (MCP)
-
-**Context7 proporciona acceso a documentación actualizada de bibliotecas.**
-
-#### Buscar documentación
-
-```
-Usar herramienta MCP context7 para:
-1. Buscar documentación oficial de bibliotecas
-2. Obtener ejemplos de código actualizados
-3. Consultar guías y tutoriales oficiales
-4. Verificar APIs disponibles
-```
-
-#### Bibliotecas soportadas por Context7
-
-Context7 indexa documentación de muchas bibliotecas populares:
-- React, Next.js, Vue, Nuxt, Svelte
-- Node.js, Express, Fastify, NestJS
-- Python (Django, FastAPI, Flask)
-- TypeScript, Tailwind CSS
-- Y muchas otras...
-
-#### Formato de consulta Context7
-
-Para usar Context7, debo:
-1. Identificar la biblioteca exacta
-2. Formular una consulta precisa
-3. Solicitar ejemplos de código si es relevante
-
-### Paso 3: Búsqueda Web Complementaria
-
-**Usar búsqueda web para:**
-
-1. **Información reciente** (después de la fecha de corte de Context7)
-   - Nuevas versiones
-   - Cambios importantes
-   - Anuncios oficiales
-
-2. **Discusiones de la comunidad**
-   - Issues de GitHub
-   - Discusiones en Stack Overflow
-   - Artículos de blog de expertos
-
-3. **Comparaciones y alternativas**
-   - Benchmarks
-   - Comparaciones de soluciones
-   - Retroalimentación de experiencias
-
-4. **Casos de uso específicos**
-   - Ejemplos de producción
-   - Patrones avanzados
-   - Soluciones a problemas comunes
-
-### Paso 4: Sintetizar Resultados
-
-#### Formato de Respuesta
-
-```
-══════════════════════════════════════════════════════════════
-🔍 INVESTIGACIÓN: [Tema]
-══════════════════════════════════════════════════════════════
-
-──────────────────────────────────────────────────────────────
-📚 DOCUMENTACIÓN OFICIAL (Context7)
-──────────────────────────────────────────────────────────────
-
-### [Biblioteca 1]
-
-**Versión actual**: X.Y.Z
-
-**Resumen**:
-[Resumen de información encontrada]
-
-**Ejemplo de código**:
-```[lenguaje]
-// Código de ejemplo de documentación
-```
-
-**Enlaces útiles**:
-- [Enlace 1]
-- [Enlace 2]
-
-### [Biblioteca 2]
-...
-
-──────────────────────────────────────────────────────────────
-🌐 BÚSQUEDA WEB
-──────────────────────────────────────────────────────────────
-
-### Información Reciente
-
-- [Fecha]: [Información encontrada]
-- [Fecha]: [Información encontrada]
-
-### Artículos Relevantes
-
-1. **[Título del artículo]**
-   - Fuente: [URL]
-   - Resumen: [Puntos clave]
-
-2. **[Título del artículo]**
-   ...
-
-### Discusiones de la Comunidad
-
-- **GitHub Issue**: [Enlace] - [Resumen]
-- **Stack Overflow**: [Enlace] - [Resumen]
-
-──────────────────────────────────────────────────────────────
-💡 SÍNTESIS Y RECOMENDACIONES
-──────────────────────────────────────────────────────────────
-
-### Respuesta a la Pregunta
-
-[Respuesta sintética basada en la investigación]
-
-### Enfoque Recomendado
-
-1. [Paso 1]
-2. [Paso 2]
-3. [Paso 3]
-
-### Puntos de Atención
-
-- ⚠️ [Punto de atención 1]
-- ⚠️ [Punto de atención 2]
-
-### Ejemplo de Código Completo
-
-```[lenguaje]
-// Código de ejemplo compilando mejores prácticas encontradas
-```
-
-──────────────────────────────────────────────────────────────
-📋 FUENTES
-──────────────────────────────────────────────────────────────
-
-Documentación:
-- [Fuente 1]
-- [Fuente 2]
-
-Web:
-- [Fuente 1]
-- [Fuente 2]
-```
-
-### Paso 5: Validación
-
-#### Verificar Calidad de las Fuentes
-
-- [ ] Fuentes oficiales priorizadas
-- [ ] Información actualizada (< 1 año idealmente)
-- [ ] Consistencia entre fuentes
-- [ ] Ejemplos de código verificables
-
-#### Verificar Relevancia
-
-- [ ] Responde a la pregunta inicial
-- [ ] Nivel de detalle apropiado
-- [ ] Ejemplos prácticos proporcionados
-- [ ] Alternativas mencionadas si es relevante
-
-### Casos de Uso Típicos
-
-#### 1. Nueva Biblioteca
-
-```
-Pregunta: "¿Cómo usar [nueva biblioteca]?"
-
-→ Context7: Documentación, API, ejemplos básicos
-→ Web: Tutoriales, retroalimentación, gotchas
-```
-
-#### 2. Problema Técnico
-
-```
-Pregunta: "¿Por qué [error] con [biblioteca]?"
-
-→ Context7: Documentación del error, solución de problemas
-→ Web: Issues de GitHub, Stack Overflow, foros
-```
-
-#### 3. Comparación
-
-```
-Pregunta: "[Lib A] vs [Lib B] para [caso de uso]?"
-
-→ Context7: Características de cada biblioteca
-→ Web: Benchmarks, comparaciones, opiniones de expertos
-```
-
-#### 4. Mejores Prácticas
-
-```
-Pregunta: "Mejores prácticas para [tema]?"
-
-→ Context7: Directrices oficiales
-→ Web: Artículos de expertos, patrones populares
-```
-
-#### 5. Migración
-
-```
-Pregunta: "Migrar de [v1] a [v2]?"
-
-→ Context7: Guía oficial de migración
-→ Web: Retroalimentación de experiencias, cambios reales
-```
-
-### Directrices Importantes
-
-1. **Siempre citar fuentes** - Nunca inventar información
-2. **Priorizar documentación oficial** - Context7 primero
-3. **Verificar fecha de información** - Web puede tener contenido obsoleto
-4. **Proporcionar código verificable** - Los ejemplos deben funcionar
-5. **Ser honesto sobre limitaciones** - Si no se encuentra información, decirlo
-
-### En Caso de Duda
-
-Si no encuentro la información:
-- Indicar claramente qué no se encontró
-- Proponer caminos alternativos
-- Sugerir dónde buscar manualmente
-- NUNCA inventar o alucinar información
+Para «$ARGUMENTS»: documentación vía el MCP context7 (`resolve-library-id` y luego `query-docs`), investigación web vía `/deep-research`; fuera de claude.ai, WebSearch/WebFetch o el agente `@research-assistant`.

package/Dev/i18n/es/Common/rules/12-context-management.md

@@ -352,13 +352,15 @@ El comando `/context` proporciona sugerencias accionables para optimizar el uso
 
 Ajustar el nivel de esfuerzo del modelo según la complejidad de la tarea:
 
-| Comando | Modelo | Uso |
+| Comando | Efecto | Uso |
 |---------|--------|-----|
-| `/effort low` | Haiku 5.5 | Tareas simples, lookups, clasificación |
-| `/effort medium` | Sonnet 5.5 | Implementación estándar |
-| `/effort high` | Opus 5.5 | Razonamiento complejo, arquitectura |
-| `/effort xhigh` | Opus 5.5 (extended thinking) | Decisiones críticas, migraciones complejas, ADR |
-| `/effort ultracode` | Opus 5.5 (toggle separado desde v2.1.284, Dynamic Workflows) | Modo máximo de código — pipelines automatizados, generación masiva |
+| `/effort low` | Razonamiento mínimo, respuestas rápidas | Tareas simples, lookups, clasificación |
+| `/effort medium` | Profundidad estándar | Implementación estándar |
+| `/effort high` | Razonamiento profundo | Razonamiento complejo, arquitectura |
+| `/effort xhigh` | Adaptive thinking al máximo | Decisiones críticas, migraciones complejas, ADR |
+| `/effort ultracode` | Toggle separado (v2.1.284+), Dynamic Workflows | Máximo rendimiento de código — pipelines automatizados, generación masiva |
+
+> **El esfuerzo no cambia de modelo:** ajusta la profundidad de razonamiento del modelo actual; el modelo se elige con `/model`. Combinaciones recomendadas: `low` con Haiku 5.5, `medium` con Sonnet 5.5, `high`/`xhigh` con Opus 5.5.
 
 > **Esfuerzo por defecto según el modelo:** medium en Opus 5.5 y Haiku 5.5; high en Sonnet 5.5, Fable 5.1 y los modelos legacy.
 > **Fable 5.1** (`claude-fable-5-1`, $10/$50 por Mtok) es un modelo actual, adecuado para agentes creativos/narrativos. **Mythos** tiene disponibilidad limitada (solo Cyber Verification Program).
@@ -493,7 +495,7 @@ Durante la compactacion, siempre preservar:
 | Variable | Descripción |
 |----------|-------------|
 | `CLAUDE_CODE_SUBAGENT_MODEL` | Modelo **por defecto** para sub-agentes sin tipo (ej: `sonnet`). **Desde Claude Code 2.1.251**, el frontmatter `model:` de un agente tiene precedencia: los 11 reviewers con `model: haiku` permanecen en Haiku. **Antes de 2.1.251 era al revés** — esta variable sobrescribía el frontmatter. |
-| `CLAUDE_CODE_FORK_SUBAGENT` | `1` para aislar el contexto de los sub-agentes (forked subagents, v2.1.117+) |
+| `CLAUDE_CODE_FORK_SUBAGENT` | `1` para aislar el contexto de los sub-agentes (forked subagents, v2.1.117+); activo por defecto en `-p`, el SDK, desktop y VS Code desde 2.1.302, `0` para desactivarlo |
 | `ENABLE_PROMPT_CACHING_1H` / `FORCE_PROMPT_CACHING_5M` | Ampliar/forzar el prompt caching (−40 % en sesiones repetitivas) |
 | `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Poner a `1` para desactivar la memoria automática |
 

package/Dev/i18n/es/Common/templates/settings.json.template

@@ -25,6 +25,10 @@
     ],
     "deny": [
       "Bash(rm -rf:*)",
+      "Bash(dd:*)",
+      "Bash(mkfs:*)",
+      "Bash(git push --force*)",
+      "Bash(git push -f*)",
       "Bash(sudo:*)",
       "Bash(chmod 777:*)",
       "Bash(curl | sh:*)",

package/Dev/i18n/es/Python/skills/coding-standards/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: coding-standards
-description: Regla 03: Estándares de Codificación. Use when reviewing code style or formatting.
+description: "Regla 03: Estándares de Codificación. Use when reviewing code style or formatting."
 ---
 
 # Regla 03: Estándares de Codificación

package/Dev/i18n/es/Python/skills/testing-python/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: testing-python
-description: Regla 07: Pruebas. Use when writing tests, reviewing test coverage, or setting up testing.
+description: "Regla 07: Pruebas. Use when writing tests, reviewing test coverage, or setting up testing."
 ---
 
 # Regla 07: Pruebas

package/Dev/i18n/es/Python/skills/tooling/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tooling
-description: Regla 06: Herramientas. Use when working with tooling.
+description: "Regla 06: Herramientas. Use when working with tooling."
 ---
 
 # Regla 06: Herramientas