@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/Python/checklists/pre-commit.md

@@ -0,0 +1,358 @@
+# Checklist Pre-Commit
+
+## Antes de Cada Commit
+
+### 1. Calidad del Código
+
+- [ ] **Linting** - El código sigue los estándares
+  ```bash
+  make lint
+  # o
+  ruff check src/ tests/
+  ```
+
+- [ ] **Formato** - El código está formateado correctamente
+  ```bash
+  make format-check
+  # o
+  black --check src/ tests/
+  isort --check src/ tests/
+  ```
+
+- [ ] **Verificación de Tipos** - Sin errores de tipo
+  ```bash
+  make type-check
+  # o
+  mypy src/
+  ```
+
+- [ ] **Seguridad** - Sin vulnerabilidades obvias
+  ```bash
+  make security-check
+  # o
+  bandit -r src/ -ll
+  ```
+
+### 2. Pruebas
+
+- [ ] **Todas las pruebas pasan**
+  ```bash
+  make test
+  # o
+  pytest tests/
+  ```
+
+- [ ] **Nuevas pruebas escritas** para código nuevo
+  - [ ] Pruebas unitarias para nueva lógica
+  - [ ] Pruebas de integración si es necesario
+  - [ ] Pruebas E2E si flujo crítico
+
+- [ ] **Cobertura mantenida** (> 80%)
+  ```bash
+  make test-cov
+  # o
+  pytest --cov=src --cov-report=term
+  ```
+
+- [ ] **Pruebas relevantes** para bugs corregidos
+  - [ ] Prueba reproduce bug (debe fallar antes de corrección)
+  - [ ] Prueba pasa después de corrección
+
+### 3. Estándares de Código
+
+- [ ] **PEP 8** respetado
+  - [ ] Línea máx 88 caracteres
+  - [ ] Importaciones organizadas (stdlib, third-party, local)
+  - [ ] Sin espacios en blanco al final
+
+- [ ] **Anotaciones de tipo** en todas las funciones públicas
+  ```python
+  def my_function(param: str) -> int:
+      """Docstring."""
+      pass
+  ```
+
+- [ ] **Docstrings** estilo Google
+  ```python
+  def function(arg1: str, arg2: int) -> bool:
+      """
+      Línea de resumen.
+
+      Args:
+          arg1: Descripción
+          arg2: Descripción
+
+      Returns:
+          Descripción
+
+      Raises:
+          ValueError: Si condición
+      """
+      pass
+  ```
+
+- [ ] **Convenciones de nomenclatura**
+  - [ ] Clases: PascalCase
+  - [ ] Funciones/variables: snake_case
+  - [ ] Constantes: UPPER_CASE
+  - [ ] Privado: _prefijo
+
+### 4. Arquitectura
+
+- [ ] **Clean Architecture** respetada
+  - [ ] El dominio no depende de nada
+  - [ ] Las dependencias apuntan hacia adentro
+  - [ ] Protocols para abstracciones
+
+- [ ] **SOLID** aplicado
+  - [ ] Responsabilidad Única
+  - [ ] Abierto/Cerrado
+  - [ ] Sustitución de Liskov
+  - [ ] Segregación de Interfaces
+  - [ ] Inversión de Dependencias
+
+- [ ] **KISS, DRY, YAGNI**
+  - [ ] Solución simple
+  - [ ] Sin duplicación
+  - [ ] Sin código innecesario
+
+### 5. Seguridad
+
+- [ ] **Sin secretos** codificados en duro en el código
+  - [ ] Sin contraseñas
+  - [ ] Sin claves API
+  - [ ] Sin tokens
+
+- [ ] **Variables de entorno**
+  - [ ] Agregadas a `.env.example` si son nuevas
+  - [ ] Documentadas en README si es necesario
+
+- [ ] **Validación de entrada**
+  - [ ] Todas las entradas validadas (Pydantic)
+  - [ ] Sin inyección SQL (consultas parametrizadas)
+  - [ ] Sin inyección XSS
+
+- [ ] **Datos sensibles**
+  - [ ] Contraseñas hasheadas (bcrypt)
+  - [ ] PII protegida
+  - [ ] Los logs no contienen datos sensibles
+
+### 6. Base de Datos
+
+- [ ] **Migración** creada si hay cambio de schema
+  ```bash
+  make db-migrate msg="Descripción"
+  # o
+  alembic revision --autogenerate -m "Descripción"
+  ```
+
+- [ ] **Migración probada**
+  - [ ] Upgrade funciona
+  - [ ] Downgrade funciona
+  - [ ] Sin pérdida de datos
+
+- [ ] **Índices** agregados si es necesario
+  - [ ] En columnas frecuentemente buscadas
+  - [ ] En claves foráneas
+
+### 7. Rendimiento
+
+- [ ] **Consultas N+1** evitadas
+  - [ ] Uso de joinedload/selectinload si es necesario
+  - [ ] Sin consultas en bucles
+
+- [ ] **Paginación** para listas grandes
+  - [ ] Limit/offset implementado
+  - [ ] Sin cargar miles de items
+
+- [ ] **Caché** si es apropiado
+  - [ ] Caché para datos frecuentemente accedidos
+  - [ ] Invalidación de caché gestionada
+
+### 8. Logging & Monitoreo
+
+- [ ] **Logging apropiado**
+  - [ ] Nivel correcto (DEBUG, INFO, WARNING, ERROR)
+  - [ ] Mensajes claros e informativos
+  - [ ] Contexto agregado (user_id, request_id, etc.)
+
+- [ ] **Sin print()** - usar logger
+  ```python
+  # ❌ Malo
+  print(f"Usuario {user_id} creado")
+
+  # ✅ Bueno
+  logger.info(f"Usuario creado", extra={"user_id": user_id})
+  ```
+
+- [ ] **Excepciones registradas**
+  ```python
+  try:
+      risky_operation()
+  except Exception as e:
+      logger.error(f"Operación falló: {e}", exc_info=True)
+      raise
+  ```
+
+### 9. Documentación
+
+- [ ] **Comentarios de código** para lógica compleja
+  - [ ] Sin comentarios obvios
+  - [ ] Explicación del "por qué", no del "qué"
+
+- [ ] **README** actualizado si es necesario
+  - [ ] Nuevas funcionalidades documentadas
+  - [ ] Instrucciones de setup actualizadas
+  - [ ] Variables de entorno documentadas
+
+- [ ] **Docs de API** actualizados
+  - [ ] Nuevos endpoints documentados
+  - [ ] Ejemplos proporcionados
+  - [ ] Errores documentados
+
+### 10. Git
+
+- [ ] **Mensaje de commit** sigue Conventional Commits
+  ```
+  tipo(scope): asunto
+
+  cuerpo
+
+  pie de página
+  ```
+  - Tipos: feat, fix, docs, style, refactor, test, chore
+  - Asunto: imperativo, minúsculas, sin punto
+  - Cuerpo: opcional, detalles del cambio
+  - Pie: breaking changes, closes issues
+
+- [ ] **Commit atómico**
+  - [ ] Un commit = un cambio lógico
+  - [ ] Sin commits gigantes
+  - [ ] Sin commits "WIP" o "fix"
+
+- [ ] **Archivos temporales** no incluidos
+  - [ ] Sin .pyc, __pycache__
+  - [ ] Sin .env (solo .env.example)
+  - [ ] Sin archivos de IDE
+
+### 11. Dependencias
+
+- [ ] **Nuevas dependencias** justificadas
+  - [ ] ¿Realmente necesaria?
+  - [ ] ¿No hay alternativa en deps existentes?
+  - [ ] ¿Librería mantenida y segura?
+
+- [ ] **Archivo lock** actualizado
+  ```bash
+  poetry lock
+  # o
+  uv lock
+  ```
+
+- [ ] **Versión fijada** correctamente
+  - [ ] No versiones demasiado amplias (`*`)
+  - [ ] Compatible con otras deps
+
+### 12. Limpieza
+
+- [ ] **Código muerto** eliminado
+  - [ ] Sin código comentado
+  - [ ] Sin funciones no usadas
+  - [ ] Sin importaciones no usadas
+
+- [ ] **Código de debug** eliminado
+  - [ ] Sin breakpoint()
+  - [ ] Sin prints de debug
+  - [ ] Sin TODO/FIXME (o crear issue)
+
+- [ ] **Logs de consola** eliminados
+  - [ ] Sin print() de debug
+  - [ ] Logs apropiados usados
+
+## Comando de Verificación Rápida
+
+```bash
+# One-liner para verificar todo
+make quality && make test-cov
+```
+
+## Hook Pre-commit
+
+Para automatizar, usar hooks pre-commit:
+
+```bash
+# .pre-commit-config.yaml ya configurado
+pre-commit install
+
+# Ejecutar manualmente
+pre-commit run --all-files
+```
+
+## Si Algo Falla
+
+### Errores de Linting
+
+```bash
+# Auto-corregir lo que se pueda
+make lint-fix
+# o
+ruff check --fix src/ tests/
+```
+
+### Errores de Formato
+
+```bash
+# Auto-formatear
+make format
+# o
+black src/ tests/
+isort src/ tests/
+```
+
+### Pruebas Fallando
+
+```bash
+# Ejecutar pruebas en verbose para debug
+pytest -vv tests/
+
+# Ejecutar prueba específica
+pytest tests/path/to/test.py::test_function -vv
+
+# Ver stdout/stderr
+pytest -s tests/
+```
+
+### Errores de Tipo
+
+```bash
+# Ver errores detallados
+mypy src/ --show-error-codes
+
+# Ignorar temporalmente (¡evitar!)
+# type: ignore[error-code]
+```
+
+## Excepciones
+
+### Hotfix Urgente
+
+Si hotfix de producción urgente:
+- [ ] Pruebas mínimas pasan
+- [ ] Corrección verificada manualmente
+- [ ] PR creado inmediatamente después
+- [ ] TODO creado para mejorar pruebas
+
+### Commit WIP
+
+Si realmente es necesario (evitar):
+- [ ] Commit en rama separada
+- [ ] Con prefijo `WIP:`
+- [ ] Squash antes de merge a main
+
+## Checklist Rápido (Mínimo)
+
+- [ ] `make lint` ✅
+- [ ] `make type-check` ✅
+- [ ] `make test` ✅
+- [ ] Mensaje de commit válido ✅
+- [ ] Sin secretos ✅

package/Dev/i18n/es/Python/commands/async-check.md

@@ -0,0 +1,84 @@
+---
+description: Verificación de Código Asíncrono Python
+argument-hint: [arguments]
+---
+
+# Verificación de Código Asíncrono Python
+
+## Argumentos
+
+$ARGUMENTS (opcional: ruta a analizar)
+
+## MISIÓN
+
+Analizar el uso de código asíncrono en el proyecto Python e identificar problemas con patrones async/await, llamadas bloqueantes y problemas de rendimiento.
+
+### Paso 1: Identificar Funciones Asíncronas
+
+```bash
+# Encontrar todas las funciones async
+rg "async def" --type py
+
+# Encontrar uso de await
+rg "await " --type py
+```
+
+Verificar:
+- [ ] Funciones async correctamente declaradas
+- [ ] Await usado para llamadas async
+- [ ] Sin código bloqueante en funciones async
+- [ ] Manejo apropiado de excepciones en async
+
+### Paso 2: Detectar Llamadas Bloqueantes
+
+```python
+# Llamadas bloqueantes comunes a evitar en async:
+- time.sleep()        # Usar asyncio.sleep()
+- requests.get()      # Usar httpx o aiohttp
+- open()              # Usar aiofiles
+- db.execute()        # Usar driver async de BD
+```
+
+### Paso 3: Verificar Patrones Async
+
+```python
+# Patrones buenos
+async def fetch_data(url: str) -> dict:
+    async with httpx.AsyncClient() as client:
+        response = await client.get(url)
+        return response.json()
+
+# Verificar:
+- [ ] async with para gestores de contexto
+- [ ] await para operaciones async
+- [ ] asyncio.gather() para tareas concurrentes
+- [ ] Manejo apropiado de errores con try/except
+```
+
+### Paso 4: Generar Reporte
+
+```
+ANÁLISIS DE CÓDIGO ASÍNCRONO
+=====================================
+
+FUNCIONES ASYNC: XX
+SENTENCIAS AWAIT: XX
+LLAMADAS BLOQUEANTES ENCONTRADAS: XX
+
+PROBLEMAS DETECTADOS:
+
+1. Llamada bloqueante en función async
+   Archivo: app/services/user.py:45
+   Problema: Usando time.sleep() en lugar de asyncio.sleep()
+   Corrección: Reemplazar con asyncio.sleep()
+
+2. Await faltante
+   Archivo: app/api/endpoints.py:78
+   Problema: Función async llamada sin await
+   Corrección: Agregar palabra clave await
+
+RECOMENDACIONES:
+- Reemplazar llamadas bloqueantes con alternativas async
+- Usar asyncio.gather() para operaciones concurrentes
+- Agregar manejo apropiado de timeout
+```

package/Dev/i18n/es/Python/commands/check-architecture.md

@@ -0,0 +1,138 @@
+---
+description: Verificar Arquitectura Python
+argument-hint: [arguments]
+---
+
+# Verificar Arquitectura Python
+
+## Argumentos
+
+$ARGUMENTS (opcional: ruta al proyecto a analizar)
+
+## MISIÓN
+
+Realizar una auditoría completa de arquitectura del proyecto Python siguiendo los principios de Clean Architecture y Arquitectura Hexagonal definidos en las reglas del proyecto.
+
+### Paso 1: Analizar Estructura del Proyecto
+
+Examinar estructura de directorios e identificar:
+- [ ] Presencia de capas Dominio/Aplicación/Infraestructura/Presentación
+- [ ] Separación clara entre capas (sin dependencias invertidas)
+- [ ] Organización de módulos por dominio de negocio
+- [ ] Estructura de paquetes consistente con reglas de arquitectura
+
+**Referencia**: `rules/02-architecture.md` secciones "Clean Architecture" y "Arquitectura Hexagonal"
+
+### Paso 2: Verificar Dependencias Entre Capas
+
+Analizar importaciones y dependencias:
+- [ ] El dominio no depende de ninguna otra capa
+- [ ] La aplicación depende solo del dominio
+- [ ] La infraestructura depende solo del dominio y aplicación
+- [ ] La presentación no contiene lógica de negocio
+- [ ] Regla de dependencias respetada (solo hacia adentro)
+
+**Verificar**: Sin importaciones de capas externas en Dominio/Aplicación
+
+### Paso 3: Interfaces y Puertos
+
+Verificar implementación de puertos y adaptadores:
+- [ ] Interfaces (ports) definidas en Dominio/Aplicación
+- [ ] Implementaciones (adapters) en Infraestructura
+- [ ] Uso de inyección de dependencias
+- [ ] Sin acoplamiento fuerte con frameworks externos
+
+**Referencia**: `rules/02-architecture.md` sección "Ports and Adapters"
+
+### Paso 4: Entidades y Value Objects
+
+Verificar modelado de dominio:
+- [ ] Entidades ricas con lógica de negocio encapsulada
+- [ ] Value objects inmutables
+- [ ] Agregados correctamente delimitados
+- [ ] Domain Events si aplica
+- [ ] Sin lógica de infraestructura en entidades
+
+**Referencia**: `rules/02-architecture.md` sección "Capa de Dominio"
+
+### Paso 5: Servicios y Casos de Uso
+
+Analizar organización de lógica de aplicación:
+- [ ] Casos de Uso/Servicios de Aplicación claramente identificados
+- [ ] Un Caso de Uso = Una acción de negocio
+- [ ] Servicios de Dominio para lógica de negocio compleja
+- [ ] Sin lógica de negocio en controllers/handlers
+- [ ] Transacciones gestionadas a nivel de Aplicación
+
+**Referencia**: `rules/02-architecture.md` sección "Capa de Aplicación"
+
+### Paso 6: Principios SOLID
+
+Verificar aplicación de principios SOLID:
+- [ ] Responsabilidad Única: Una clase = Una razón para cambiar
+- [ ] Abierto/Cerrado: Extensión por herencia/composición, no modificación
+- [ ] Sustitución de Liskov: Los subtipos son sustituibles
+- [ ] Segregación de Interfaces: Interfaces específicas y mínimas
+- [ ] Inversión de Dependencias: Dependencia de abstracciones
+
+**Referencia**: `rules/04-solid-principles.md`
+
+### Paso 7: Calcular Puntuación
+
+Atribución de puntos (sobre 25):
+- Estructura y separación de capas: 6 puntos
+- Respeto de dependencias: 6 puntos
+- Ports and Adapters: 4 puntos
+- Modelado de dominio: 4 puntos
+- Casos de Uso y Servicios: 3 puntos
+- Principios SOLID: 2 puntos
+
+## FORMATO DE SALIDA
+
+```
+AUDITORÍA DE ARQUITECTURA PYTHON
+================================
+
+PUNTUACIÓN GENERAL: XX/25
+
+FORTALEZAS:
+- [Lista de puntos positivos identificados]
+
+MEJORAS:
+- [Lista de mejoras menores]
+
+PROBLEMAS CRÍTICOS:
+- [Lista de violaciones graves de arquitectura]
+
+DETALLES POR CATEGORÍA:
+
+1. ESTRUCTURA Y CAPAS (XX/6)
+   Estado: [Detalles de estructura]
+
+2. DEPENDENCIAS (XX/6)
+   Estado: [Análisis de dependencias]
+
+3. PORTS AND ADAPTERS (XX/4)
+   Estado: [Implementación de interfaces]
+
+4. MODELADO DE DOMINIO (XX/4)
+   Estado: [Calidad de entidades y VOs]
+
+5. CASOS DE USO (XX/3)
+   Estado: [Organización de lógica de aplicación]
+
+6. PRINCIPIOS SOLID (XX/2)
+   Estado: [Aplicación de principios SOLID]
+
+TOP 3 ACCIONES PRIORITARIAS:
+1. [Acción más crítica con impacto estimado]
+2. [Segunda acción prioritaria]
+3. [Tercera acción prioritaria]
+```
+
+## NOTAS
+
+- Usar `grep`, `find` y análisis de código para detectar violaciones
+- Proporcionar ejemplos concretos de archivos/clases problemáticas
+- Sugerir refactorizaciones precisas para cada problema identificado
+- Priorizar acciones según impacto en mantenibilidad