@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/Common/commands/release-checklist.md

@@ -0,0 +1,245 @@
+---
+description: Lista de Verificación de Release
+argument-hint: [arguments]
+---
+
+# Lista de Verificación de Release
+
+Eres un Release Manager experto. Debes guiar al equipo a través de todos los pasos de un release de calidad, verificando cada punto crítico.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Versión (ej: `1.2.0`, `2.0.0-beta.1`)
+- Tipo (patch, minor, major)
+
+Ejemplo: `/common:release-checklist 1.2.0 minor`
+
+## MISIÓN
+
+### Paso 1: Validación Pre-Release
+
+#### 1.1 Estado del Código
+```bash
+# Verificar en rama correcta
+git branch --show-current  # Debe ser main/master o release/*
+
+# Verificar sin cambios sin commit
+git status
+
+# Verificar que todas las pruebas pasan
+# [Ejecutar pruebas según tecnología]
+```
+
+#### 1.2 Changelog
+```bash
+# Verificar CHANGELOG.md actualizado
+cat CHANGELOG.md | head -50
+
+# Generar changelog desde último tag
+git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"- %s"
+```
+
+#### 1.3 Archivos de Versión
+```bash
+# Verificar/actualizar archivos de versión
+# PHP: composer.json
+# Python: pyproject.toml, __version__.py
+# Node: package.json
+# Flutter: pubspec.yaml
+# iOS: Info.plist
+# Android: build.gradle
+```
+
+### Paso 2: Pruebas Exhaustivas
+
+```bash
+# Pruebas unitarias
+# Pruebas de integración
+# Pruebas E2E
+# Pruebas de rendimiento
+# Pruebas de seguridad
+```
+
+### Paso 3: Documentación
+
+```bash
+# Verificar documentación
+# - README actualizado
+# - Docs API generadas
+# - Guía de migración (si hay cambios breaking)
+```
+
+### Paso 4: Generar Lista de Verificación Interactiva
+
+```
+══════════════════════════════════════════════════════════════
+🚀 LISTA DE VERIFICACIÓN RELEASE - v{VERSION}
+══════════════════════════════════════════════════════════════
+
+Tipo: {TYPE} (patch/minor/major)
+Fecha: AAAA-MM-DD
+Rama: main
+
+══════════════════════════════════════════════════════════════
+📋 PRE-RELEASE
+══════════════════════════════════════════════════════════════
+
+## Calidad de Código
+- [ ] Todas las pruebas pasan (unit, integration, e2e)
+- [ ] Cobertura de pruebas ≥ 80%
+- [ ] Análisis estático sin errores
+- [ ] Code review completado en todos los PRs
+- [ ] Sin TODO/FIXME bloqueantes
+
+## Seguridad
+- [ ] Auditoría de dependencias (sin CVEs críticos)
+- [ ] Sin secretos en código
+- [ ] Pruebas de seguridad pasadas (OWASP)
+- [ ] Certificados SSL válidos
+
+## Documentación
+- [ ] CHANGELOG.md actualizado
+- [ ] README.md actualizado
+- [ ] Documentación API generada
+- [ ] Guía de migración (si hay cambios breaking)
+- [ ] Notas de release escritas
+
+## Versionado
+- [ ] Número de versión incrementado
+- [ ] Tags git preparados
+- [ ] Ramas de release creadas (si aplica)
+
+══════════════════════════════════════════════════════════════
+📦 BUILD & PACKAGE
+══════════════════════════════════════════════════════════════
+
+## Backend
+- [ ] Build de producción exitoso
+- [ ] Assets compilados y minificados
+- [ ] Migraciones BD preparadas
+- [ ] Variables de entorno documentadas
+
+## Frontend Web
+- [ ] Bundle optimizado (code splitting, tree shaking)
+- [ ] Assets listos para CDN
+- [ ] Service worker actualizado
+- [ ] Sourcemaps generados (pero no desplegados a prod)
+
+## Mobile (si aplica)
+- [ ] Build iOS firmado
+- [ ] Build Android firmado
+- [ ] Screenshots de tienda actualizados
+- [ ] Metadata de tienda lista
+
+══════════════════════════════════════════════════════════════
+🔧 VALIDACIÓN EN STAGING
+══════════════════════════════════════════════════════════════
+
+- [ ] Despliegue en staging exitoso
+- [ ] Migraciones BD ejecutadas exitosamente
+- [ ] Pruebas manuales de humo OK
+- [ ] Pruebas de regresión pasadas
+- [ ] Rendimiento aceptable (< umbrales definidos)
+- [ ] Monitoreo funciona (logs, métricas)
+- [ ] Rollback probado
+
+══════════════════════════════════════════════════════════════
+🚀 DESPLIEGUE EN PRODUCCIÓN
+══════════════════════════════════════════════════════════════
+
+## Pre-Deploy
+- [ ] Modo mantenimiento activado (si necesario)
+- [ ] Backup de base de datos realizado
+- [ ] Comunicación a equipo de soporte
+- [ ] Ventana de despliegue validada
+
+## Deploy
+- [ ] Despliegue en producción lanzado
+- [ ] Migraciones BD ejecutadas
+- [ ] Health checks pasan
+- [ ] Modo mantenimiento desactivado
+
+## Post-Deploy
+- [ ] Pruebas de humo en producción OK
+- [ ] Monitoreo verificado (sin errores)
+- [ ] Rendimiento nominal
+- [ ] Tag git creado y pusheado
+- [ ] Release GitHub/GitLab creado
+
+══════════════════════════════════════════════════════════════
+📢 COMUNICACIÓN
+══════════════════════════════════════════════════════════════
+
+- [ ] Notas de release publicadas
+- [ ] Equipo de soporte informado
+- [ ] Clientes notificados (si aplica)
+- [ ] Documentación pública actualizada
+- [ ] Anuncio blog/redes sociales (si aplica)
+
+══════════════════════════════════════════════════════════════
+🔙 PLAN DE ROLLBACK
+══════════════════════════════════════════════════════════════
+
+En caso de problema crítico:
+
+1. Identificar problema
+   - Logs: [URL monitoreo]
+   - Alertas: [URL alerting]
+
+2. Decisión de rollback
+   - Umbral: > 5% errores 5xx por 5 min
+   - Decisor: [Nombre]
+
+3. Ejecutar rollback
+   ```bash
+   # Comando de rollback
+   [Adaptar según infraestructura]
+   ```
+
+4. Rollback BD (si necesario)
+   ```bash
+   # Migraciones down
+   [Adaptar según ORM]
+   ```
+
+5. Comunicación
+   - Notificar equipo
+   - Abrir incidente
+   - Post-mortem
+
+══════════════════════════════════════════════════════════════
+✅ VALIDACIÓN FINAL
+══════════════════════════════════════════════════════════════
+
+[ ] Todas las casillas marcadas
+[ ] Release validado por: _______________
+[ ] Fecha/hora release: _______________
+
+Notas:
+_________________________________________________
+_________________________________________________
+```
+
+## Comandos Útiles
+
+```bash
+# Crear tag
+git tag -a v{VERSION} -m "Release v{VERSION}"
+git push origin v{VERSION}
+
+# Crear release GitHub
+gh release create v{VERSION} --title "v{VERSION}" --notes-file RELEASE_NOTES.md
+
+# Generar changelog automático
+git-cliff --unreleased --tag v{VERSION} > CHANGELOG.md
+```
+
+## Recordatorio Semantic Versioning
+
+| Tipo | Cuándo | Ejemplo |
+|------|-------|---------|
+| MAJOR | Cambios breaking | 1.0.0 → 2.0.0 |
+| MINOR | Nueva funcionalidad | 1.0.0 → 1.1.0 |
+| PATCH | Corrección de bug | 1.0.0 → 1.0.1 |

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

@@ -0,0 +1,253 @@
+---
+description: Investigación con Context7 y Web
+argument-hint: [arguments]
+---
+
+# Investigación con Context7 y Web
+
+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`
+
+## 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