@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/Common/commands/generate-changelog.md

@@ -0,0 +1,237 @@
+---
+description: Generación Automática de Changelog
+argument-hint: [arguments]
+---
+
+# Generación Automática de Changelog
+
+Eres un asistente de documentación. Debes analizar commits de git y generar un changelog formateado siguiendo las convenciones de Conventional Commits y Keep a Changelog.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos:
+- Versión objetivo (ej: `1.2.0`)
+- Desde (tag anterior, predeterminado: último tag)
+
+Ejemplo: `/common:generate-changelog 1.2.0 v1.1.0`
+
+## MISIÓN
+
+### Paso 1: Recuperar Commits
+
+```bash
+# Identificar último tag
+LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+# Listar commits desde último tag
+if [ -z "$LAST_TAG" ]; then
+    git log --pretty=format:"%H|%s|%an|%ad" --date=short
+else
+    git log ${LAST_TAG}..HEAD --pretty=format:"%H|%s|%an|%ad" --date=short
+fi
+```
+
+### Paso 2: Parsear Commits (Conventional Commits)
+
+Formato esperado: `type(scope): description`
+
+| Tipo | Categoría Changelog |
+|------|---------------------|
+| feat | Added |
+| fix | Fixed |
+| docs | Documentation |
+| style | (ignorado) |
+| refactor | Changed |
+| perf | Performance |
+| test | (ignorado) |
+| chore | (ignorado) |
+| build | Build |
+| ci | (ignorado) |
+| revert | Removed |
+| BREAKING CHANGE | Breaking Changes |
+
+### Paso 3: Analizar PRs (si disponibles)
+
+```bash
+# Recuperar PRs fusionados
+gh pr list --state merged --base main --json number,title,labels,author
+```
+
+### Paso 4: Generar Changelog
+
+Formato Keep a Changelog:
+
+```markdown
+# Changelog
+
+Todos los cambios notables de este proyecto se documentarán en este archivo.
+
+El formato está basado en [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+y este proyecto adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [{VERSION}] - {FECHA}
+
+### Breaking Changes
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Added
+- **{scope}**: {descripción} ({autor}) - #{PR}
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Changed
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Deprecated
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Removed
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Fixed
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Security
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+### Performance
+- **{scope}**: {descripción} ({autor}) - #{PR}
+
+## [{PREVIOUS_VERSION}] - {FECHA}
+...
+
+[Unreleased]: https://github.com/{owner}/{repo}/compare/v{VERSION}...HEAD
+[{VERSION}]: https://github.com/{owner}/{repo}/compare/v{PREVIOUS_VERSION}...v{VERSION}
+```
+
+### Paso 5: Ejemplo de Salida
+
+```markdown
+## [1.2.0] - 2024-01-15
+
+### Breaking Changes
+- **api**: Cambiado autenticación de sesión a JWT (#123) - @john
+
+### Added
+- **auth**: Agregar soporte login social OAuth2 (#145) - @jane
+- **users**: Agregar carga de foto de perfil usuario (#142) - @john
+- **dashboard**: Agregar notificaciones en tiempo real (#138) - @alice
+
+### Changed
+- **api**: Actualizar API Platform a v3.2 (#150) - @bob
+- **ui**: Migrar a TailwindCSS v3 (#148) - @jane
+
+### Fixed
+- **auth**: Corregir email de restablecimiento contraseña no enviado (#141) - @john
+- **orders**: Corregir cálculo de total con descuentos (#139) - @alice
+- **mobile**: Corregir crash en iOS 17 (#137) - @bob
+
+### Security
+- **deps**: Actualizar symfony/http-kernel para CVE-2024-1234 (#146) - @security-bot
+
+### Performance
+- **api**: Agregar caché Redis para sesiones usuario (#144) - @alice
+- **db**: Optimizar consultas N+1 en lista órdenes (#140) - @bob
+
+---
+
+**Changelog Completo**: https://github.com/org/repo/compare/v1.1.0...v1.2.0
+
+### Colaboradores
+- @john (4 commits)
+- @jane (3 commits)
+- @alice (3 commits)
+- @bob (3 commits)
+
+### Estadísticas
+- Commits: 13
+- Archivos cambiados: 87
+- Líneas agregadas: +2,345
+- Líneas eliminadas: -876
+```
+
+### Paso 6: Acciones Sugeridas
+
+```
+══════════════════════════════════════════════════════════════
+📝 CHANGELOG GENERADO
+══════════════════════════════════════════════════════════════
+
+Versión: 1.2.0
+Período: 2024-01-01 → 2024-01-15
+Commits analizados: 13
+
+──────────────────────────────────────────────────────────────
+📊 RESUMEN POR CATEGORÍA
+──────────────────────────────────────────────────────────────
+
+| Categoría | Cantidad |
+|-----------|--------|
+| Added | 3 |
+| Changed | 2 |
+| Fixed | 3 |
+| Security | 1 |
+| Performance | 2 |
+| Breaking | 1 |
+
+──────────────────────────────────────────────────────────────
+⚠️ PUNTOS DE ATENCIÓN
+──────────────────────────────────────────────────────────────
+
+1. ⚠️ BREAKING CHANGE detectado - ¿requiere versión MAJOR?
+2. 🔒 1 corrección de seguridad - mencionar en notas release
+3. 📝 5 commits sin formato convencional (a mejorar)
+
+──────────────────────────────────────────────────────────────
+🎯 PRÓXIMOS PASOS
+──────────────────────────────────────────────────────────────
+
+1. Verificar y editar changelog generado
+2. Crear o actualizar archivo CHANGELOG.md
+3. Commit: git commit -am "docs: actualizar changelog para v1.2.0"
+4. Crear tag: git tag -a v1.2.0 -m "Release v1.2.0"
+```
+
+## Comandos Asociados
+
+```bash
+# Guardar el changelog
+# El contenido se mostrará, puedes copiarlo a CHANGELOG.md
+
+# Herramientas recomendadas para automatización
+# - git-cliff: https://github.com/orhun/git-cliff
+# - conventional-changelog: https://github.com/conventional-changelog/conventional-changelog
+# - release-please: https://github.com/googleapis/release-please
+```
+
+## Recordatorio Conventional Commits
+
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+
+# Tipos estándar
+feat:     Nueva funcionalidad
+fix:      Corrección de bug
+docs:     Solo documentación
+style:    Formateo (sin cambio código)
+refactor: Refactorización (sin nueva funcionalidad o corrección)
+perf:     Mejora de rendimiento
+test:     Agregar/modificar pruebas
+chore:    Mantenimiento (deps, config, etc.)
+build:    Sistema build, deps externas
+ci:       Configuración CI/CD
+revert:   Revertir commit anterior
+
+# Cambio breaking
+feat!: descripción
+# o
+feat: descripción
+
+BREAKING CHANGE: explicación del cambio breaking
+```

package/Dev/i18n/es/Common/commands/pre-commit-check.md

@@ -0,0 +1,205 @@
+---
+description: Verificación Pre-Commit
+argument-hint: [arguments]
+---
+
+# Verificación Pre-Commit
+
+Eres un asistente de calidad de código. Debes realizar todas las verificaciones necesarias ANTES de crear un commit, para asegurar que el código cumple los estándares del proyecto.
+
+## Argumentos
+$ARGUMENTS
+
+Opciones:
+- `--fix`: Corregir automáticamente problemas corregibles
+- `--staged`: Verificar solo archivos staged
+
+## MISIÓN
+
+### Paso 1: Identificar Archivos Modificados
+
+```bash
+# Archivos staged
+git diff --cached --name-only
+
+# Archivos modificados (unstaged)
+git diff --name-only
+```
+
+### Paso 2: Detectar Tecnología por Archivo
+
+| Extensión | Tecnología | Herramientas |
+|-----------|-------------|--------|
+| `.php` | PHP/Symfony | php-cs-fixer, phpstan |
+| `.dart` | Flutter | dart format, dart analyze |
+| `.py` | Python | ruff, mypy |
+| `.ts`, `.tsx` | React/RN | eslint, prettier |
+| `.js`, `.jsx` | React/RN | eslint, prettier |
+
+### Paso 3: Ejecutar Verificaciones
+
+#### Para archivos PHP
+```bash
+# Formateo
+docker compose exec php vendor/bin/php-cs-fixer fix --dry-run --diff [archivos]
+
+# Análisis estático
+docker compose exec php vendor/bin/phpstan analyse [archivos]
+
+# Sintaxis Twig (si modificados)
+docker compose exec php php bin/console lint:twig templates/
+
+# Contenedor Symfony
+docker compose exec php php bin/console lint:container
+```
+
+#### Para archivos Dart/Flutter
+```bash
+# Formateo
+docker run --rm -v $(pwd):/app -w /app dart dart format --set-exit-if-changed [archivos]
+
+# Análisis
+docker run --rm -v $(pwd):/app -w /app dart dart analyze [archivos]
+
+# Pruebas afectadas
+docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
+```
+
+#### Para archivos Python
+```bash
+# Linting + formateo
+docker compose exec app ruff check [archivos]
+docker compose exec app ruff format --check [archivos]
+
+# Tipos
+docker compose exec app mypy [archivos]
+```
+
+#### Para archivos JS/TS
+```bash
+# Linting
+docker compose exec node npx eslint [archivos]
+
+# Formateo
+docker compose exec node npx prettier --check [archivos]
+
+# Tipos (si TypeScript)
+docker compose exec node npx tsc --noEmit
+```
+
+### Paso 4: Verificaciones Globales
+
+#### Secretos
+```bash
+# Buscar patrones de secretos
+grep -rE "(password|secret|api_key|token)\s*[:=]\s*['\"][^'\"]+['\"]" --include="*.{php,py,ts,js,dart}" .
+grep -rE "sk_live_|pk_live_|ghp_|gho_|AKIA" .
+```
+
+#### Archivos prohibidos
+```bash
+# Verificar que no hay archivos sensibles
+git diff --cached --name-only | grep -E "\.(env|pem|key|p12)$"
+```
+
+#### Tamaño de archivo
+```bash
+# Archivos > 1MB
+find . -type f -size +1M -name "*.{php,py,ts,js,dart}"
+```
+
+### Paso 5: Generar Reporte
+
+```
+══════════════════════════════════════════════════════════════
+🔍 VERIFICACIÓN PRE-COMMIT
+══════════════════════════════════════════════════════════════
+
+📁 Archivos verificados: X
+📅 Fecha: AAAA-MM-DD HH:MM
+
+──────────────────────────────────────────────────────────────
+✅ VERIFICACIONES EXITOSAS
+──────────────────────────────────────────────────────────────
+
+✅ Formateo PHP (php-cs-fixer)
+✅ Análisis estático PHP (phpstan)
+✅ Formateo TypeScript (prettier)
+✅ Linting TypeScript (eslint)
+✅ Sin secretos detectados
+
+──────────────────────────────────────────────────────────────
+⚠️ PROBLEMAS DETECTADOS
+──────────────────────────────────────────────────────────────
+
+❌ [PHP] src/Controller/UserController.php:45
+   PHPStan: Parameter $id of method __construct() has no type hint
+
+⚠️ [TS] src/components/Button.tsx:12
+   ESLint: 'unused' is defined but never used (no-unused-vars)
+
+──────────────────────────────────────────────────────────────
+📋 RESUMEN
+──────────────────────────────────────────────────────────────
+
+| Categoría | Estado |
+|-----------|--------|
+| Formateo | ✅ OK |
+| Linting   | ⚠️ 1 advertencia |
+| Tipos     | ❌ 1 error |
+| Secretos   | ✅ OK |
+
+──────────────────────────────────────────────────────────────
+🎯 ACCIONES REQUERIDAS
+──────────────────────────────────────────────────────────────
+
+1. Corregir error PHPStan en UserController.php
+2. (Opcional) Corregir advertencia ESLint
+
+Commit autorizado: ❌ NO (1 error bloqueante)
+```
+
+### Opción --fix
+
+Si se pasa `--fix` como argumento:
+
+```bash
+# PHP
+docker compose exec php vendor/bin/php-cs-fixer fix [archivos]
+
+# Dart
+docker run --rm -v $(pwd):/app -w /app dart dart format [archivos]
+
+# Python
+docker compose exec app ruff check --fix [archivos]
+docker compose exec app ruff format [archivos]
+
+# JS/TS
+docker compose exec node npx eslint --fix [archivos]
+docker compose exec node npx prettier --write [archivos]
+```
+
+## Reglas de Bloqueo
+
+### Bloqueantes (commit prohibido)
+- ❌ Errores de sintaxis
+- ❌ Errores PHPStan/mypy/tsc
+- ❌ Secretos detectados
+- ❌ Archivos .env commiteados
+- ❌ Claves privadas/certificados
+
+### No bloqueantes (advertencia)
+- ⚠️ Problemas de formateo
+- ⚠️ Advertencias ESLint
+- ⚠️ Cobertura de pruebas disminuida
+- ⚠️ TODO/FIXME agregados
+
+## Consejo
+
+Para automatizar, configurar un hook pre-commit:
+
+```bash
+# .git/hooks/pre-commit
+#!/bin/sh
+claude-code "/common:pre-commit-check --staged"
+```

package/Dev/i18n/es/Common/commands/pre-merge-check.md

@@ -0,0 +1,237 @@
+---
+description: Verificación Pre-Merge
+argument-hint: [arguments]
+---
+
+# Verificación Pre-Merge
+
+Eres un asistente de calidad de código. Debes realizar todas las verificaciones necesarias ANTES de fusionar una rama, para asegurar la calidad y evitar regresiones.
+
+## Argumentos
+$ARGUMENTS
+
+Argumentos esperados:
+- Rama origen (predeterminado: rama actual)
+- Rama destino (predeterminado: main o master)
+
+Ejemplo: `/common:pre-merge-check feature/auth main`
+
+## MISIÓN
+
+### Paso 1: Analizar el Diff
+
+```bash
+# Identificar ramas
+SOURCE_BRANCH=$(git branch --show-current)
+TARGET_BRANCH=${2:-main}
+
+# Commits a fusionar
+git log $TARGET_BRANCH..$SOURCE_BRANCH --oneline
+
+# Archivos modificados
+git diff $TARGET_BRANCH...$SOURCE_BRANCH --stat
+
+# Líneas agregadas/eliminadas
+git diff $TARGET_BRANCH...$SOURCE_BRANCH --shortstat
+```
+
+### Paso 2: Verificaciones de Calidad
+
+#### 2.1 Pruebas Completas
+```bash
+# Ejecutar TODAS las pruebas
+# Symfony
+docker compose exec php vendor/bin/phpunit --coverage-text
+
+# Flutter
+docker run --rm -v $(pwd):/app -w /app dart flutter test --coverage
+
+# Python
+docker compose exec app pytest --cov --cov-report=term
+
+# React/RN
+docker compose exec node npm run test -- --coverage
+```
+
+#### 2.2 Análisis Estático Completo
+```bash
+# PHPStan (nivel máximo)
+docker compose exec php vendor/bin/phpstan analyse -l max
+
+# Dart Analyzer
+docker run --rm -v $(pwd):/app -w /app dart dart analyze --fatal-infos
+
+# Mypy (strict)
+docker compose exec app mypy --strict .
+
+# TypeScript
+docker compose exec node npx tsc --noEmit
+```
+
+#### 2.3 Verificación de Dependencias
+```bash
+# Auditoría de seguridad
+# PHP
+docker compose exec php composer audit
+
+# Python
+docker compose exec app pip-audit
+
+# Node
+docker compose exec node npm audit
+
+# Flutter
+docker run --rm -v $(pwd):/app -w /app dart dart pub outdated
+```
+
+### Paso 3: Verificaciones Específicas
+
+#### Migraciones BD (si presentes)
+```bash
+# Verificar migraciones Doctrine
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- migrations/
+
+# Si hay migraciones presentes
+docker compose exec php php bin/console doctrine:migrations:diff --no-interaction
+docker compose exec php php bin/console doctrine:schema:validate
+```
+
+#### Cambios Breaking en API
+```bash
+# Comparar specs OpenAPI
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- openapi.yaml docs/api/
+```
+
+#### Cambios de Configuración
+```bash
+# Archivos de config modificados
+git diff $TARGET_BRANCH...$SOURCE_BRANCH -- config/ .env.example docker-compose*.yml
+```
+
+### Paso 4: Análisis de Commits
+
+```bash
+# Verificar mensajes de commit
+git log $TARGET_BRANCH..$SOURCE_BRANCH --pretty=format:"%s" | while read msg; do
+    # Patrón convencional: type(scope): description
+    if ! echo "$msg" | grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .+"; then
+        echo "⚠️ Mensaje no convencional: $msg"
+    fi
+done
+```
+
+### Paso 5: Verificación de Cobertura
+
+```bash
+# Comparar cobertura antes/después
+# La cobertura no debería disminuir
+```
+
+### Paso 6: Generar Reporte
+
+```
+══════════════════════════════════════════════════════════════
+🔀 VERIFICACIÓN PRE-MERGE
+══════════════════════════════════════════════════════════════
+
+📌 Origen: feature/user-auth
+📌 Destino: main
+📅 Fecha: AAAA-MM-DD HH:MM
+
+──────────────────────────────────────────────────────────────
+📊 ESTADÍSTICAS
+──────────────────────────────────────────────────────────────
+
+Commits: 12
+Archivos modificados: 45
+Líneas agregadas: +1,234
+Líneas eliminadas: -567
+
+──────────────────────────────────────────────────────────────
+🧪 PRUEBAS
+──────────────────────────────────────────────────────────────
+
+| Suite | Pruebas | Pasadas | Fallidas | Omitidas |
+|-------|-------|--------|----------|----------|
+| Unit  | 234   | 234    | 0        | 0        |
+| Integ | 45    | 45     | 0        | 0        |
+| E2E   | 12    | 12     | 0        | 0        |
+
+Cobertura: 85.2% (anterior: 84.8%) ✅ +0.4%
+
+──────────────────────────────────────────────────────────────
+🔍 ANÁLISIS ESTÁTICO
+──────────────────────────────────────────────────────────────
+
+| Herramienta | Errores | Advertencias | Estado |
+|-------|---------|----------|--------|
+| PHPStan | 0 | 2 | ✅ |
+| ESLint | 0 | 5 | ⚠️ |
+| Mypy | 0 | 0 | ✅ |
+
+──────────────────────────────────────────────────────────────
+🔒 SEGURIDAD
+──────────────────────────────────────────────────────────────
+
+Auditoría dependencias: ✅ Sin vulnerabilidades
+Secretos detectados: ✅ Ninguno
+Archivos sensibles: ✅ Ninguno
+
+──────────────────────────────────────────────────────────────
+📦 MIGRACIONES
+──────────────────────────────────────────────────────────────
+
+Nuevas migraciones: 2
+  - Version20240115_AddUserRoles.php
+  - Version20240116_CreateAuditLog.php
+
+Validación esquema: ✅ OK
+Rollback posible: ✅ Sí
+
+──────────────────────────────────────────────────────────────
+⚠️ PUNTOS DE ATENCIÓN
+──────────────────────────────────────────────────────────────
+
+1. [MEDIO] 5 advertencias ESLint a corregir
+2. [BAJO] 2 TODOs agregados en código
+3. [INFO] 2 nuevas migraciones - verificar en staging primero
+
+──────────────────────────────────────────────────────────────
+📋 CHECKLIST FINAL
+──────────────────────────────────────────────────────────────
+
+- [x] Todas las pruebas pasan
+- [x] Cobertura mantenida o mejorada
+- [x] Sin errores de análisis estático
+- [x] Sin vulnerabilidades de seguridad
+- [x] Sin secretos commiteados
+- [ ] Code review aprobado (verificar manualmente)
+- [ ] Probado en staging (verificar manualmente)
+
+──────────────────────────────────────────────────────────────
+🎯 VEREDICTO
+──────────────────────────────────────────────────────────────
+
+Merge autorizado: ✅ SÍ
+
+Recomendaciones antes del merge:
+1. Resolver 5 advertencias ESLint
+2. Probar migraciones en staging
+3. Obtener aprobación de code review
+```
+
+## Reglas de Bloqueo
+
+### Bloqueantes (merge prohibido)
+- ❌ Pruebas fallidas
+- ❌ Caída significativa de cobertura (> 2%)
+- ❌ Errores de análisis estático
+- ❌ Vulnerabilidades críticas/altas
+- ❌ Secretos en código
+- ❌ Migraciones no reversibles
+
+### No bloqueantes (advertencia)
+- ⚠️ Advertencias de análisis estático
+- ⚠️ TODO/FIXME agregados
+- ⚠️ Vulnerabilidades bajas/medias
+- ⚠️ Cobertura ligeramente disminuida (< 2%)