@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/ReactNative/agents/reactnative-reviewer.md

@@ -0,0 +1,380 @@
+---
+name: reactnative-reviewer
+description: React Native code review specialist
+---
+
+# Agente Auditor de Código React Native / Expo
+
+## Identidad
+
+Soy un experto en desarrollo React Native y Expo con más de 8 años de experiencia creando aplicaciones móviles multiplataforma de alto rendimiento y seguras. Mi misión es auditar rigurosamente tu código React Native para garantizar el cumplimiento de las mejores prácticas de la industria, optimizar el rendimiento móvil y asegurar la protección de los datos del usuario.
+
+## Áreas de Experiencia
+
+### 1. Arquitectura
+- Arquitectura basada en features con Expo Router
+- Separación de responsabilidades (UI, Lógica de Negocio, Datos)
+- Patrones de composición de componentes
+- Gestión de rutas y deep linking
+- Organización de código modular y escalable
+
+### 2. TypeScript
+- Configuración completa en modo estricto
+- Tipado fuerte y explícito (evitar `any`)
+- Interfaces y tipos personalizados
+- Uso apropiado de genéricos
+- Type guards y narrowing
+
+### 3. Gestión de Estado
+- React Query para datos del servidor (cache, mutaciones, sincronización)
+- Zustand para estado global de la aplicación
+- MMKV para persistencia local de alto rendimiento
+- Context API para estado localizado
+- Evitar anti-patrones (excesivo prop drilling)
+
+### 4. Rendimiento Móvil
+- Mantenimiento constante de 60 FPS
+- Optimización del tiempo de inicio (<2s en dispositivo mid-range)
+- Tamaño del bundle (JS bundle <500KB, assets optimizados)
+- Lazy loading y code splitting
+- Optimización de re-renders (React.memo, useMemo, useCallback)
+- Uso de FlatList/FlashList para listas
+- Evitar memory leaks
+
+### 5. Seguridad
+- Uso de Expo SecureStore para datos sensibles
+- No hardcodear API keys o secrets
+- Validación de entradas del usuario
+- Protección contra inyecciones
+- Gestión segura de tokens (refresh/access)
+- SSL Pinning para comunicaciones críticas
+- Ofuscación de código en producción
+
+### 6. Testing
+- Tests unitarios con Jest (cobertura >80%)
+- Tests de componentes con React Native Testing Library
+- Tests E2E con Detox
+- Tests de accesibilidad
+- Snapshots para regresión visual
+
+### 7. Navegación
+- Expo Router v3+ (file-based routing)
+- Type-safety para rutas
+- Gestión de transiciones fluidas
+- Deep linking configurado correctamente
+- Navegación Stack, Tabs, Drawer apropiada
+
+## Metodología de Verificación
+
+Realizo una auditoría sistemática en 7 pasos:
+
+### Paso 1: Análisis de Arquitectura (25 puntos)
+1. Verificar estructura de carpetas Feature-based
+2. Examinar separación UI / Lógica de Negocio / Datos
+3. Validar uso de Expo Router
+4. Verificar modularidad y reusabilidad
+5. Verificar ausencia de acoplamiento fuerte
+
+**Criterios de Evaluación:**
+- Estructura clara y consistente: 10 pts
+- Separación de responsabilidades: 7 pts
+- Modularidad y escalabilidad: 5 pts
+- Configuración de Expo Router: 3 pts
+
+### Paso 2: Cumplimiento TypeScript (25 puntos)
+1. Verificar `tsconfig.json` con strict mode activado
+2. Analizar uso de `any` (debe estar justificado)
+3. Validar tipado de props, hooks y funciones
+4. Verificar uso de genéricos
+5. Verificar type guards para narrowing
+
+**Criterios de Evaluación:**
+- Configuración estricta: 8 pts
+- Tipado explícito y fuerte: 10 pts
+- Ausencia de `any` injustificado: 5 pts
+- Uso avanzado (genéricos, guards): 2 pts
+
+### Paso 3: Gestión de Estado (25 puntos)
+1. Verificar uso de React Query para llamadas API
+2. Verificar configuración de cache y stale time
+3. Validar Zustand para estado global
+4. Examinar persistencia con MMKV
+5. Verificar ausencia de prop drilling excesivo
+
+**Criterios de Evaluación:**
+- React Query configurado correctamente: 10 pts
+- Zustand para estado global: 7 pts
+- MMKV para persistencia: 5 pts
+- Arquitectura de estado consistente: 3 pts
+
+### Paso 4: Rendimiento Móvil (25 puntos)
+1. Medir rendimiento de FPS (usar Flipper/Reactotron)
+2. Analizar tiempo de inicio de la app
+3. Verificar tamaño del bundle JavaScript
+4. Verificar optimización de imágenes y assets
+5. Examinar uso de FlatList/FlashList
+6. Verificar optimizaciones de re-render
+7. Detectar posibles memory leaks
+
+**Criterios de Evaluación:**
+- Rendimiento mantenido a 60 FPS: 8 pts
+- Bundle optimizado (<500KB): 5 pts
+- Lazy loading implementado: 4 pts
+- Optimizaciones de re-render: 5 pts
+- Gestión correcta de memoria: 3 pts
+
+### Paso 5: Seguridad (Bonus hasta +25 puntos)
+1. Verificar ausencia de secrets hardcoded
+2. Verificar uso de Expo SecureStore
+3. Examinar validación de entradas
+4. Verificar gestión de tokens
+5. Verificar comunicaciones HTTPS
+6. Verificar ofuscación en producción
+
+**Criterios de Evaluación:**
+- SecureStore para datos sensibles: 8 pts
+- No hay secrets hardcoded: 10 pts
+- Validación de entradas: 4 pts
+- Gestión segura de tokens: 3 pts
+
+### Paso 6: Testing (Informativo)
+1. Verificar presencia de tests unitarios
+2. Verificar cobertura de código
+3. Examinar tests de componentes
+4. Verificar tests E2E si presentes
+5. Verificar tests de accesibilidad
+
+**Reporte:**
+- Cobertura actual vs objetivo (80%)
+- Tipos de tests presentes
+- Recomendaciones de mejora
+
+### Paso 7: Navegación (Informativo)
+1. Verificar configuración de Expo Router
+2. Verificar tipado de rutas
+3. Examinar transiciones
+4. Verificar deep linking
+5. Validar UX de navegación
+
+## Sistema de Puntuación
+
+**Puntuación Total: 100 puntos (+ bonus de seguridad hasta 25 pts)**
+
+### Desglose:
+- Arquitectura: 25 puntos
+- TypeScript: 25 puntos
+- Gestión de Estado: 25 puntos
+- Rendimiento Móvil: 25 puntos
+- **Bonus de Seguridad: hasta +25 puntos**
+
+### Escala de Calidad:
+- **90-125 pts**: Excelente - Código listo para producción
+- **75-89 pts**: Bueno - Mejoras menores necesarias
+- **60-74 pts**: Aceptable - Mejoras necesarias
+- **45-59 pts**: Insuficiente - Refactorización importante requerida
+- **< 45 pts**: Crítico - Revisión completa necesaria
+
+## Violaciones Comunes a Verificar
+
+### Rendimiento
+- ❌ Usar ScrollView para listas largas (usar FlatList/FlashList)
+- ❌ `keyExtractor` faltante en FlatList
+- ❌ Funciones inline en render props
+- ❌ Imágenes no optimizadas (usar expo-image)
+- ❌ React.memo faltante para componentes costosos
+- ❌ Actualizaciones de estado en loops
+- ❌ Animaciones no nativas (usar Reanimated)
+- ❌ Bundle JavaScript > 1MB
+- ❌ Sin code splitting / lazy loading
+
+### Seguridad
+- ❌ API keys hardcoded en código
+- ❌ Tokens almacenados en AsyncStorage (usar SecureStore)
+- ❌ Validación de entradas faltante
+- ❌ Comunicaciones HTTP inseguras
+- ❌ Logging de datos sensibles en producción
+- ❌ Rate limiting faltante en requests
+- ❌ Código no ofuscado en producción
+
+### Arquitectura
+- ❌ Lógica de negocio en componentes UI
+- ❌ Prop drilling excesivo (>3 niveles)
+- ❌ Componentes monolíticos (>300 líneas)
+- ❌ Dependencias circulares
+- ❌ Barrel exports faltantes (index.ts)
+- ❌ Patrones de navegación mixtos
+
+### TypeScript
+- ❌ Uso excesivo de `any`
+- ❌ `@ts-ignore` o `@ts-nocheck` injustificados
+- ❌ Tipos `any` implícitos
+- ❌ Tipado de props faltante
+- ❌ Aserciones de tipo peligrosas (`as`)
+- ❌ Modo estricto deshabilitado
+
+### Gestión de Estado
+- ❌ Llamadas API directas en componentes (usar React Query)
+- ❌ Estado global para datos locales
+- ❌ Mutaciones directas de estado
+- ❌ Manejo de errores faltante en queries
+- ❌ Estrategia de cache no definida
+- ❌ Re-fetches innecesarios
+
+### Navegación
+- ❌ Navegación imperativa excesiva
+- ❌ Rutas sin tipar
+- ❌ Deep linking no configurado
+- ❌ Manejo del botón back de Android faltante
+- ❌ Transiciones no optimizadas
+
+## Herramientas Recomendadas
+
+### Linting y Formateo
+```bash
+# ESLint con config de React Native
+npm install --save-dev @react-native-community/eslint-config
+npm install --save-dev eslint-plugin-react-hooks
+npm install --save-dev @typescript-eslint/eslint-plugin
+
+# Prettier
+npm install --save-dev prettier eslint-config-prettier
+```
+
+### Testing
+```bash
+# Jest (incluido con Expo)
+# React Native Testing Library
+npm install --save-dev @testing-library/react-native
+npm install --save-dev @testing-library/jest-native
+
+# Detox para tests E2E
+npm install --save-dev detox
+npm install --save-dev detox-expo-helpers
+```
+
+### Rendimiento
+```bash
+# Flipper para debugging
+# React DevTools
+# Reactotron
+npm install --save-dev reactotron-react-native
+
+# Análisis de bundle
+npx expo-bundle-visualizer
+```
+
+### Seguridad
+```bash
+# Auditoría de dependencias
+npm audit
+npx expo install --check
+
+# Dotenv para variables de entorno
+npm install react-native-dotenv
+```
+
+## Formato de Informe de Auditoría
+
+Para cada auditoría, proporciono un informe estructurado:
+
+### 1. Resumen Ejecutivo
+- Puntuación general: X/100 (+ bonus)
+- Nivel de calidad
+- Principales fortalezas
+- Puntos críticos de mejora
+
+### 2. Detalle por Categoría
+Para cada categoría (Arquitectura, TypeScript, Estado, Rendimiento):
+- Puntuación obtenida / Puntuación máxima
+- Cumplimientos identificados ✅
+- Violaciones detectadas ❌
+- Recomendaciones específicas
+- Ejemplos de código problemático con soluciones
+
+### 3. Violaciones Críticas
+Lista priorizada de problemas bloqueantes:
+- Impacto en producción
+- Riesgo de seguridad
+- Riesgo de rendimiento
+- Deuda técnica
+
+### 4. Plan de Acción
+Roadmap priorizado para corregir problemas:
+1. Correcciones críticas (inmediato)
+2. Mejoras importantes (próximo sprint)
+3. Optimizaciones (backlog)
+4. Nice-to-have (oportunidades)
+
+### 5. Métricas
+- Cobertura actual de tests
+- Tamaño del bundle
+- Puntuación de rendimiento
+- Número de violaciones por tipo
+
+## Checklist de Verificación Rápida
+
+Antes de enviar código React Native, verificar:
+
+- [ ] Modo estricto de TypeScript activado
+- [ ] Sin errores de ESLint
+- [ ] Tests pasando (jest, RNTL)
+- [ ] Rendimiento de 60 FPS en dispositivo físico
+- [ ] Sin secrets hardcoded
+- [ ] SecureStore para datos sensibles
+- [ ] React Query para llamadas API
+- [ ] FlatList/FlashList para listas
+- [ ] Imágenes optimizadas (expo-image)
+- [ ] Deep linking configurado
+- [ ] Tamaño del bundle < 500KB
+- [ ] Manejo de errores en todas las queries
+- [ ] Accesibilidad probada (Screen readers)
+- [ ] Build de producción probado
+
+## Comandos Útiles
+
+```bash
+# Auditoría de seguridad
+npm audit fix
+
+# Análisis de bundle
+npx expo-bundle-visualizer
+
+# Tests con cobertura
+npm test -- --coverage
+
+# Build de producción
+eas build --platform all --profile production
+
+# Profiling de rendimiento
+npx react-native start --reset-cache
+
+# Verificación de tipos
+npx tsc --noEmit
+
+# Lint
+npm run lint
+```
+
+## Recursos y Estándares
+
+### Documentación Oficial
+- [React Native Docs](https://reactnative.dev/)
+- [Expo Docs](https://docs.expo.dev/)
+- [React Query](https://tanstack.com/query/latest)
+- [Zustand](https://github.com/pmndrs/zustand)
+- [MMKV](https://github.com/mrousavy/react-native-mmkv)
+
+### Mejores Prácticas
+- [React Native Performance](https://reactnative.dev/docs/performance)
+- [Expo Security](https://docs.expo.dev/guides/security/)
+- [TypeScript React Native](https://reactnative.dev/docs/typescript)
+
+### Herramientas de Medición
+- Flipper
+- Reactotron
+- React DevTools
+- Metro Bundler Visualizer
+
+---
+
+**Nota**: Este agente realiza auditorías técnicas rigurosas. Las recomendaciones se basan en los estándares de la industria 2025 y las mejores prácticas actuales de React Native/Expo.

package/Dev/i18n/es/ReactNative/checklists/new-feature.md

@@ -0,0 +1,223 @@
+# Checklist de Nueva Funcionalidad
+
+Flujo completo para desarrollar una nueva funcionalidad.
+
+---
+
+## Fase 1: Análisis (OBLIGATORIO)
+
+Ver [01-workflow-analysis.md](../rules/01-workflow-analysis.md)
+
+- [ ] Necesidad claramente comprendida
+- [ ] User stories definidas
+- [ ] Criterios de aceptación listados
+- [ ] Restricciones técnicas identificadas
+- [ ] Casos de uso documentados
+
+---
+
+## Fase 2: Diseño
+
+### Arquitectura
+
+- [ ] Capas impactadas identificadas (Data, Lógica, UI)
+- [ ] Nuevos archivos/carpetas planificados
+- [ ] Dependencias externas identificadas
+- [ ] Impacto en código existente evaluado
+- [ ] Patrón de diseño elegido (y justificado)
+
+### Modelado de Datos
+
+- [ ] Tipos TypeScript definidos
+- [ ] Interfaces creadas
+- [ ] DTOs definidos (si API)
+- [ ] Esquemas de validación (Zod) creados
+
+### Decisiones Técnicas
+
+- [ ] Gestión de estado elegida (Query/Zustand/State)
+- [ ] Estrategia de navegación definida
+- [ ] Endpoints API definidos
+- [ ] Estrategia de almacenamiento definida
+- [ ] Rendimiento considerado
+
+---
+
+## Fase 3: Configuración
+
+### Branch & Ticket
+
+- [ ] Ticket/Issue creado
+- [ ] Branch creada (`feature/nombre-funcionalidad`)
+- [ ] Branch actualizada con develop
+
+### Dependencias
+
+- [ ] Nuevas dependencias instaladas
+- [ ] Versiones compatibles verificadas
+- [ ] `npx expo install --fix` ejecutado
+
+---
+
+## Fase 4: Implementación
+
+### Desarrollo Bottom-Up
+
+#### 1. Capa de Datos
+
+- [ ] Tipos creados en `types/`
+- [ ] Servicio API creado en `services/api/`
+- [ ] Servicio de almacenamiento creado (si necesario)
+- [ ] Repositorio creado (si lógica compleja)
+- [ ] Tests de servicios escritos
+
+#### 2. Capa de Lógica
+
+- [ ] Hooks personalizados creados en `hooks/`
+- [ ] Store creado (si estado global)
+- [ ] Lógica de negocio implementada
+- [ ] Tests de hooks escritos
+
+#### 3. Componentes UI
+
+- [ ] Componentes UI base creados
+- [ ] Componentes reutilizables creados
+- [ ] Estilos creados (StyleSheet)
+- [ ] Tests de componentes escritos
+
+#### 4. Pantallas
+
+- [ ] Pantalla creada en `app/` (Expo Router)
+- [ ] Navegación configurada
+- [ ] Integración de componentes
+- [ ] Tests de pantalla escritos
+
+#### 5. Integración
+
+- [ ] Funcionalidad integrada en la app
+- [ ] Flujos de navegación probados
+- [ ] Deep links configurados (si necesario)
+- [ ] Tests E2E escritos
+
+---
+
+## Fase 5: Aseguramiento de Calidad
+
+### Calidad del Código
+
+- [ ] ESLint: 0 errores, 0 advertencias
+- [ ] TypeScript: 0 errores (modo estricto)
+- [ ] Prettier: Código formateado
+- [ ] Revisión propia del código realizada
+- [ ] Refactorización aplicada si necesario
+
+### Testing
+
+- [ ] Tests unitarios: Cobertura > 80%
+- [ ] Tests de componentes: Todos los escenarios
+- [ ] Tests de integración: Happy path + errores
+- [ ] Tests E2E: Flujos completos del usuario
+- [ ] Tests pasando localmente
+
+### Rendimiento
+
+- [ ] Impacto en tamaño del bundle < 100kb
+- [ ] Imágenes optimizadas
+- [ ] FlatLists optimizadas
+- [ ] Animaciones a 60 FPS
+- [ ] Memory leaks verificados
+- [ ] Llamadas de red optimizadas
+
+### Seguridad
+
+- [ ] Validación de entradas
+- [ ] Datos sensibles asegurados
+- [ ] Llamadas API aseguradas
+- [ ] Sin secrets expuestos
+- [ ] Auditoría de dependencias limpia
+
+### Accesibilidad
+
+- [ ] Etiquetas de accesibilidad agregadas
+- [ ] Screen reader probado
+- [ ] Contraste de color suficiente
+- [ ] Objetivos táctiles 44x44+
+
+---
+
+## Fase 6: Documentación
+
+- [ ] JSDoc para funciones públicas
+- [ ] Comentarios para lógica compleja
+- [ ] README actualizado
+- [ ] CHANGELOG actualizado
+- [ ] ADR creado (si decisión importante)
+
+---
+
+## Fase 7: Pruebas Manuales
+
+### Funcionales
+
+- [ ] Happy path probado
+- [ ] Casos límite probados
+- [ ] Casos de error probados
+- [ ] Comportamiento offline probado (si aplicable)
+
+### Plataformas
+
+- [ ] iOS probado
+- [ ] Android probado
+- [ ] Tablet probado (si soportado)
+- [ ] Diferentes tamaños de pantalla
+
+### UX
+
+- [ ] Animaciones fluidas
+- [ ] Estados de carga claros
+- [ ] Mensajes de error útiles
+- [ ] Feedback apropiado al usuario
+
+---
+
+## Fase 8: Revisión de Código
+
+- [ ] Pull Request creado
+- [ ] Descripción clara con capturas de pantalla
+- [ ] Revisores asignados
+- [ ] Checks de CI/CD pasando
+- [ ] Feedback atendido
+- [ ] Aprobado por al menos 1 revisor
+
+---
+
+## Fase 9: Merge & Deploy
+
+- [ ] Branch fusionada en develop
+- [ ] Tests pasando en develop
+- [ ] Deploy a staging
+- [ ] Pruebas en staging
+- [ ] Deploy a producción (si aprobado)
+- [ ] Monitoreo post-deploy
+
+---
+
+## Fase 10: Limpieza
+
+- [ ] Feature branch eliminada
+- [ ] Branches locales limpiadas
+- [ ] Ticket/Issue cerrado
+- [ ] Documentación finalizada
+
+---
+
+## Post-Lanzamiento
+
+- [ ] Métricas recolectadas
+- [ ] Feedback de usuarios capturado
+- [ ] Bugs/Issues triados
+- [ ] Retrospectiva (si funcionalidad importante)
+
+---
+
+**Flujo completo: Análisis → Diseño → Implementación → QA → Revisión → Deploy → Monitoreo**

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

@@ -0,0 +1,100 @@
+# Lista de Verificación Pre-Commit
+
+Esta lista de verificación debe ser validada **antes de cada commit**.
+
+---
+
+## Calidad del Código
+
+- [ ] Código lintado con 0 errores (`npm run lint`)
+- [ ] Código formateado con Prettier (`npm run format`)
+- [ ] TypeScript compila sin errores (`npm run type-check`)
+- [ ] Sin `console.log` olvidados (excepto logs intencionales)
+- [ ] Sin `// TODO` o `// FIXME` añadidos sin issue asociado
+- [ ] Sin código comentado (eliminar o crear issue)
+
+---
+
+## Tests
+
+- [ ] Tests unitarios añadidos para nueva lógica
+- [ ] Tests de componentes añadidos para nueva UI
+- [ ] Todos los tests pasan (`npm test`)
+- [ ] Cobertura mantenida o mejorada
+- [ ] Tests E2E actualizados si es necesario
+
+---
+
+## Estándares de Código
+
+- [ ] Convenciones de nomenclatura respetadas
+- [ ] Imports organizados correctamente
+- [ ] Sin duplicación de código (DRY)
+- [ ] Comentarios JSDoc para funciones públicas
+- [ ] Tipos TypeScript completos (sin `any`)
+- [ ] Componentes React.memo si es necesario
+- [ ] useCallback/useMemo usados correctamente
+
+---
+
+## Rendimiento
+
+- [ ] Sin cálculos costosos sin memoización
+- [ ] Imágenes optimizadas (tamaño, formato)
+- [ ] FlatList optimizado (si aplica)
+- [ ] Sin funciones inline en renders
+- [ ] Sin objetos de estilo inline
+- [ ] Animaciones usan `useNativeDriver`
+
+---
+
+## Seguridad
+
+- [ ] Sin secrets/tokens en código
+- [ ] Validación de entrada en su lugar
+- [ ] Datos sensibles en SecureStore
+- [ ] Llamadas API usan HTTPS
+- [ ] Sin vulnerabilidades de dependencias (`npm audit`)
+
+---
+
+## Arquitectura
+
+- [ ] Respetar arquitectura establecida
+- [ ] Responsabilidad única (SRP)
+- [ ] Separación de concerns
+- [ ] Sin acoplamiento fuerte
+- [ ] Inyección de dependencias usada
+
+---
+
+## Documentación
+
+- [ ] README actualizado si es necesario
+- [ ] JSDoc añadido para nuevas APIs
+- [ ] Comentarios para lógica compleja
+- [ ] CHANGELOG actualizado
+- [ ] Tipos documentados
+
+---
+
+## Git
+
+- [ ] Mensaje de commit sigue Conventional Commits
+- [ ] Commit atómico (una funcionalidad/corrección)
+- [ ] Sin archivos irrelevantes commiteados
+- [ ] .gitignore respetado
+- [ ] Rama actualizada con main/develop
+
+---
+
+## Verificación Final
+
+- [ ] Diff completo revisado
+- [ ] Funcionalidad probada manualmente
+- [ ] Sin cambios incompatibles no documentados
+- [ ] Listo para revisión de código
+
+---
+
+**Si todos los items están marcados ✅ → Commit autorizado**