@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/es/Flutter/INDEX.md

@@ -0,0 +1,392 @@
+# Índice Completo - Reglas de Desarrollo Flutter
+
+## Visión General
+
+Estructura completa de reglas de desarrollo Flutter para Claude Code, inspirada en la estructura Symfony pero adaptada a Flutter/Dart.
+
+**Total**: 26 archivos
+- 1 CLAUDE.md.template principal
+- 1 README guía de uso
+- 14 archivos de reglas (rules/)
+- 5 plantillas de código (templates/)
+- 4 listas de verificación (checklists/)
+- 1 índice (este archivo)
+
+---
+
+## Archivos Principales
+
+### CLAUDE.md.template
+Archivo principal para copiar en cada proyecto Flutter. Contiene:
+- Contexto del proyecto
+- Reglas fundamentales
+- Flujo de trabajo obligatorio
+- Comandos Makefile
+- Instrucciones para Claude
+
+### README.md
+Guía de uso completa:
+- Cómo inicializar un nuevo proyecto
+- Estructura recomendada
+- Flujo de trabajo de desarrollo
+- Configuración de herramientas
+
+---
+
+## Reglas (14 archivos)
+
+### 00-project-context.md.template
+Plantilla de contexto del proyecto con placeholders:
+- Visión general del proyecto
+- Arquitectura global
+- Stack tecnológico
+- Especificidades y convenciones
+- Variables a reemplazar: {{PROJECT_NAME}}, {{TECH_STACK}}, etc.
+
+### 01-workflow-analysis.md (27 KB)
+Metodología obligatoria antes de codificar:
+- Fase 1: Comprensión de la necesidad
+- Fase 2: Exploración del código existente
+- Fase 3: Diseño de la solución
+- Fase 4: Plan de pruebas
+- Fase 5: Estimación y planificación
+- Fase 6: Revisión post-implementación
+- Plantillas de análisis
+- Ejemplos concretos (feature favoritos)
+
+### 02-architecture.md (53 KB)
+Clean Architecture para Flutter:
+- Las 3 capas (Domain, Data, Presentation)
+- Estructura detallada de carpetas
+- Entities, Repositories, Use Cases
+- Models, DataSources
+- Patrón BLoC completo
+- Inyección de Dependencias
+- Ejemplos de código completos
+
+### 03-coding-standards.md (24 KB)
+Estándares de código Dart/Flutter:
+- Convenciones de nomenclatura
+- Formato y estilo
+- Organización del código
+- Widgets Flutter (const, extracción)
+- Tipos e inferencia
+- Documentación (dartdoc)
+- Extensiones Dart
+- Async/await
+- Configuración de linters
+
+### 04-solid-principles.md (38 KB)
+Principios SOLID con ejemplos Flutter:
+- S - Principio de Responsabilidad Única
+- O - Principio Abierto/Cerrado
+- L - Principio de Sustitución de Liskov
+- I - Principio de Segregación de Interfaces
+- D - Principio de Inversión de Dependencias
+- Ejemplos concretos para cada principio
+- Widgets, BLoCs, repositorios
+- Diagramas de dependencias
+
+### 05-kiss-dry-yagni.md (30 KB)
+Principios de simplicidad:
+- KISS: Keep It Simple, Stupid
+- DRY: Don't Repeat Yourself
+- YAGNI: You Aren't Gonna Need It
+- Ejemplos de sobre-complicación vs soluciones simples
+- Gestión de estado adaptada a la complejidad
+- Widgets reutilizables
+- Equilibrio entre principios
+
+### 06-tooling.md (10 KB)
+Herramientas y comandos:
+- Flutter CLI esenciales
+- Comandos Pub
+- Docker para Flutter
+- Makefile completo
+- FVM (Flutter Version Management)
+- Scripts útiles
+- CI/CD (GitHub Actions, GitLab CI)
+- Configuración VS Code
+- DevTools
+
+### 07-testing.md (19 KB)
+Estrategia de pruebas completa:
+- Pirámide de pruebas (70% unit, 20% widget, 10% integration)
+- Pruebas unitarias (entities, use cases, BLoCs)
+- Pruebas de widgets
+- Pruebas de integración
+- Pruebas Golden
+- Mocking con Mocktail
+- Cobertura de pruebas
+- Buenas prácticas (patrón AAA)
+
+### 08-quality-tools.md
+Herramientas de calidad:
+- Dart Analyze
+- DCM (Dart Code Metrics)
+- Very Good Analysis
+- Flutter Lints
+- Reglas de lint personalizadas
+- Integración CI/CD
+- Targets Makefile
+
+### 09-git-workflow.md
+Flujo de trabajo Git:
+- Conventional Commits
+- Estrategia de ramas (GitFlow)
+- Pre-commit hooks
+- CI/CD
+- Comandos Git útiles
+
+### 10-documentation.md
+Estándares de documentación:
+- Formato Dartdoc
+- Estructura README.md
+- CHANGELOG.md
+- Documentación API
+- Ejemplos de documentación completa
+
+### 11-security.md
+Seguridad Flutter:
+- flutter_secure_storage
+- Gestión de API keys
+- Variables de entorno
+- Ofuscación
+- HTTPS y certificate pinning
+- Validación de entradas
+- Autenticación (JWT)
+- Permisos
+- Lista de verificación de seguridad
+
+### 12-performance.md
+Optimización de rendimiento:
+- widgets const
+- Optimización de ListView
+- Imágenes (caching, lazy loading)
+- Evitar rebuilds
+- Profiling con DevTools
+- Lazy loading & code splitting
+- Lista de verificación de rendimiento
+
+### 13-state-management.md
+Patrones de gestión de estado:
+- Árbol de decisión (cuándo usar qué)
+- StatefulWidget
+- ValueNotifier
+- Provider
+- Riverpod (recomendado)
+- BLoC (recomendado para apps complejas)
+- Comparación de patrones
+- Mejores prácticas
+- Recomendaciones por tamaño de proyecto
+
+---
+
+## Plantillas (5 archivos)
+
+### widget.md
+Plantillas de widgets:
+- Stateless Widget
+- Stateful Widget
+- Consumer Widget (BLoC)
+
+### bloc.md
+Plantilla BLoC completa:
+- Events
+- States
+- Clase BLoC
+
+### repository.md
+Plantilla Repository:
+- Interfaz (capa Domain)
+- Implementación (capa Data)
+
+### test-widget.md
+Plantilla de pruebas de widgets:
+- Configuración básica
+- Pruebas de visualización
+- Pruebas de interacciones
+- Pruebas de actualización
+
+### test-unit.md
+Plantilla de pruebas unitarias:
+- Configuración con mocks
+- Pruebas de éxito
+- Pruebas de error
+- Pruebas de validación
+
+---
+
+## Listas de Verificación (4 archivos)
+
+### pre-commit.md
+Lista de verificación pre-commit:
+- Calidad de código
+- Pruebas
+- Documentación
+- Git
+- Arquitectura
+- Rendimiento
+- Seguridad
+
+### new-feature.md
+Lista de verificación nueva funcionalidad:
+- Análisis
+- Capa Domain
+- Capa Data
+- Capa Presentation
+- Integración
+- Documentación
+- Calidad
+
+### refactoring.md
+Lista de verificación refactorización segura:
+- Preparación
+- Durante la refactorización
+- Verificaciones
+- Antes del merge
+
+### security.md
+Lista de verificación auditoría de seguridad:
+- Datos sensibles
+- API & Red
+- Autenticación
+- Validación
+- Permisos
+- Producción
+
+---
+
+## Estadísticas
+
+### Tamaño de archivos
+
+| Archivo | Tamaño | Líneas aprox. |
+|---------|--------|---------------|
+| 01-workflow-analysis.md | 27 KB | ~800 |
+| 02-architecture.md | 53 KB | ~1600 |
+| 03-coding-standards.md | 24 KB | ~700 |
+| 04-solid-principles.md | 38 KB | ~1200 |
+| 05-kiss-dry-yagni.md | 30 KB | ~900 |
+| 06-tooling.md | 10 KB | ~300 |
+| 07-testing.md | 19 KB | ~600 |
+| 08-quality-tools.md | ~5 KB | ~150 |
+| 09-git-workflow.md | ~4 KB | ~120 |
+| 10-documentation.md | ~5 KB | ~150 |
+| 11-security.md | ~6 KB | ~180 |
+| 12-performance.md | ~5 KB | ~150 |
+| 13-state-management.md | ~7 KB | ~210 |
+| **TOTAL Reglas** | **~233 KB** | **~7060 líneas** |
+
+### Cobertura
+
+**Temas cubiertos**:
+- ✅ Arquitectura (Clean Architecture completa)
+- ✅ Estándares de código (Effective Dart)
+- ✅ Principios de diseño (SOLID, KISS, DRY, YAGNI)
+- ✅ Pruebas (Unit, Widget, Integration, Golden)
+- ✅ Herramientas (CLI, Docker, Makefile, CI/CD)
+- ✅ Calidad (Analyze, Linters, Metrics)
+- ✅ Flujo de trabajo Git (Conventional Commits, Branching)
+- ✅ Documentación (Dartdoc, README, CHANGELOG)
+- ✅ Seguridad (Storage, API keys, HTTPS, Auth)
+- ✅ Rendimiento (Optimizaciones, Profiling)
+- ✅ Gestión de estado (BLoC, Riverpod, Provider)
+- ✅ Plantillas de código
+- ✅ Listas de verificación prácticas
+
+---
+
+## Uso
+
+### Para un nuevo proyecto
+
+1. Copiar `CLAUDE.md.template` en `.claude/CLAUDE.md`
+2. Copiar `rules/`, `templates/`, `checklists/` en `.claude/`
+3. Personalizar con información del proyecto
+4. Crear `Makefile` en la raíz
+5. Configurar `analysis_options.yaml`
+6. ¡Seguir las reglas!
+
+### Para Claude Code
+
+Leer `.claude/CLAUDE.md` al inicio de cada sesión para:
+- Comprender la arquitectura del proyecto
+- Conocer las convenciones
+- Aplicar las mejores prácticas
+- Usar las plantillas apropiadas
+- Seguir las listas de verificación
+
+---
+
+## Comparación con Reglas Symfony
+
+### Similitudes
+- Estructura modular (rules/, templates/, checklists/)
+- Flujo de trabajo de análisis obligatorio
+- Principios SOLID
+- Estrategia de pruebas
+- Flujo de trabajo Git
+- Estándares de documentación
+
+### Especificidades Flutter
+- Clean Architecture (en lugar de arquitectura Symfony)
+- Composición de Widgets
+- Gestión de estado (BLoC, Riverpod)
+- Optimizaciones const
+- Profiling con DevTools
+- flutter_secure_storage
+- Material Design / Cupertino
+
+### Mejoras
+- Plantillas de código más detalladas
+- Más ejemplos
+- Listas de verificación más completas
+- Árboles de decisión (gestión de estado, arquitectura)
+- Diagramas de dependencias
+
+---
+
+## Mantenimiento
+
+### Actualización
+
+Actualizar las reglas cuando:
+- Nueva versión de Flutter/Dart
+- Nuevas mejores prácticas
+- Nuevos paquetes importantes
+- Retroalimentación del proyecto
+
+### Versionado
+
+Formato: `MAJOR.MINOR.PATCH`
+- MAJOR: Cambio de arquitectura o principios
+- MINOR: Adición de reglas o plantillas
+- PATCH: Correcciones y aclaraciones
+
+**Versión actual**: 1.0.0
+
+---
+
+## Recursos Adicionales
+
+### Documentación
+- [Flutter Documentation](https://docs.flutter.dev/)
+- [Effective Dart](https://dart.dev/guides/language/effective-dart)
+- [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
+
+### Paquetes Esenciales
+- flutter_bloc: Gestión de estado
+- riverpod: Gestión de estado
+- freezed: Generación de código
+- dartz: Programación funcional
+- get_it: Inyección de dependencias
+- dio: Cliente HTTP
+- mocktail: Pruebas
+
+---
+
+**Creado el**: 2024-12-03
+**Última actualización**: 2024-12-03
+**Versión**: 1.0.0
+**Autor**: Claude Code Assistant

package/Dev/i18n/es/Flutter/README.md

@@ -0,0 +1,330 @@
+# Reglas de Desarrollo Flutter para Claude Code
+
+Estructura completa de reglas de desarrollo Flutter para Claude Code.
+
+## Estructura
+
+```
+Flutter/
+├── CLAUDE.md.template          # Plantilla principal para copiar en cada proyecto
+├── README.md                   # Este archivo
+│
+├── rules/                      # Reglas detalladas (13 archivos)
+│   ├── 00-project-context.md.template
+│   ├── 01-workflow-analysis.md
+│   ├── 02-architecture.md
+│   ├── 03-coding-standards.md
+│   ├── 04-solid-principles.md
+│   ├── 05-kiss-dry-yagni.md
+│   ├── 06-tooling.md
+│   ├── 07-testing.md
+│   ├── 08-quality-tools.md
+│   ├── 09-git-workflow.md
+│   ├── 10-documentation.md
+│   ├── 11-security.md
+│   ├── 12-performance.md
+│   └── 13-state-management.md
+│
+├── templates/                  # Plantillas de código
+│   ├── widget.md
+│   ├── bloc.md
+│   ├── repository.md
+│   ├── test-widget.md
+│   └── test-unit.md
+│
+└── checklists/                 # Listas de verificación
+    ├── pre-commit.md
+    ├── new-feature.md
+    ├── refactoring.md
+    └── security.md
+```
+
+## Uso
+
+### 1. Nuevo Proyecto Flutter
+
+```bash
+# Crear proyecto Flutter
+flutter create mon_projet
+cd mon_projet
+
+# Crear carpeta .claude
+mkdir -p .claude
+
+# Copiar CLAUDE.md.template
+cp /path/to/Flutter/CLAUDE.md.template .claude/CLAUDE.md
+
+# Copiar rules (opcional pero recomendado)
+cp -r /path/to/Flutter/rules .claude/
+cp -r /path/to/Flutter/templates .claude/
+cp -r /path/to/Flutter/checklists .claude/
+```
+
+### 2. Personalizar CLAUDE.md
+
+Reemplazar los placeholders en `.claude/CLAUDE.md`:
+
+- `{{PROJECT_NAME}}`: Nombre del proyecto
+- `{{TECH_STACK}}`: Stack técnico (ej: Flutter 3.16 + Firebase + Stripe)
+- `{{STATE_MANAGEMENT_PATTERN}}`: BLoC / Riverpod / Provider
+- `{{STATE_MANAGEMENT_DEPENDENCIES}}`: Dependencias para gestión de estado
+- `{{LEAD_DEVELOPER}}`: Nombre del líder de desarrollo
+- `{{REPOSITORY_URL}}`: URL del repositorio
+- `{{CI_CD_PLATFORM}}`: GitHub Actions / GitLab CI / etc.
+- `{{DOCS_URL}}`: URL de la documentación
+- `{{UPDATE_DATE}}`: Fecha de última actualización
+
+### 3. Personalizar 00-project-context.md
+
+Copiar `rules/00-project-context.md.template` y completar:
+
+```bash
+cp .claude/rules/00-project-context.md.template .claude/rules/00-project-context.md
+```
+
+Reemplazar los placeholders con información específica del proyecto.
+
+### 4. Estructura de proyecto recomendada
+
+```
+mon_projet/
+├── .claude/
+│   ├── CLAUDE.md               # Reglas principales
+│   ├── rules/                  # Reglas detalladas
+│   ├── templates/              # Plantillas
+│   └── checklists/             # Listas de verificación
+│
+├── lib/
+│   ├── core/
+│   │   ├── constants/
+│   │   ├── errors/
+│   │   ├── extensions/
+│   │   ├── network/
+│   │   ├── theme/
+│   │   ├── utils/
+│   │   └── widgets/
+│   │
+│   ├── features/
+│   │   └── [feature_name]/
+│   │       ├── data/
+│   │       │   ├── datasources/
+│   │       │   ├── models/
+│   │       │   └── repositories/
+│   │       ├── domain/
+│   │       │   ├── entities/
+│   │       │   ├── repositories/
+│   │       │   └── usecases/
+│   │       └── presentation/
+│   │           ├── bloc/
+│   │           ├── pages/
+│   │           └── widgets/
+│   │
+│   ├── dependency_injection.dart
+│   └── main.dart
+│
+├── test/
+│   ├── unit/
+│   ├── widget/
+│   └── integration_test/
+│
+├── Makefile                    # Comandos Docker
+├── Dockerfile.flutter
+├── docker-compose.yml
+├── .env.example
+├── .gitignore
+├── analysis_options.yaml
+├── pubspec.yaml
+└── README.md
+```
+
+## Makefile Estándar
+
+Crear un `Makefile` en la raíz del proyecto:
+
+```makefile
+.PHONY: help setup run test clean analyze format
+
+# Docker Flutter
+FLUTTER := docker run --rm -v $(PWD):/app -w /app ghcr.io/cirruslabs/flutter:stable flutter
+DART := docker run --rm -v $(PWD):/app -w /app ghcr.io/cirruslabs/flutter:stable dart
+
+help: ## Mostrar ayuda
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+setup: ## Instalar dependencias
+	$(FLUTTER) pub get
+
+run: ## Ejecutar app
+	$(FLUTTER) run
+
+test: ## Todas las pruebas
+	$(FLUTTER) test
+
+test-coverage: ## Pruebas con cobertura
+	$(FLUTTER) test --coverage
+
+analyze: ## Analizar código
+	$(FLUTTER) analyze
+
+format: ## Formatear código
+	$(DART) format lib/ test/
+
+generate: ## Generar código
+	$(FLUTTER) pub run build_runner build --delete-conflicting-outputs
+
+clean: ## Limpiar
+	$(FLUTTER) clean
+
+ci: analyze format test ## Pipeline CI
+	@echo "✅ CI passed!"
+```
+
+## Archivos de Configuración
+
+### analysis_options.yaml
+
+```yaml
+include: package:flutter_lints/flutter.yaml
+
+analyzer:
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+
+  errors:
+    invalid_annotation_target: ignore
+
+  language:
+    strict-casts: true
+    strict-inference: true
+
+linter:
+  rules:
+    - always_declare_return_types
+    - always_put_required_named_parameters_first
+    - avoid_print
+    - prefer_const_constructors
+    - prefer_const_declarations
+    - prefer_final_fields
+    - prefer_single_quotes
+    - require_trailing_commas
+```
+
+### .gitignore
+
+```
+# Flutter
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+build/
+flutter_*.png
+
+# IDE
+.idea/
+.vscode/
+*.iml
+*.ipr
+*.iws
+
+# Environment
+.env
+*.env
+
+# Generated
+**/*.g.dart
+**/*.freezed.dart
+
+# Coverage
+coverage/
+
+# Docker
+.dockerignore
+```
+
+## Flujo de Trabajo de Desarrollo
+
+### 1. Nueva Funcionalidad
+
+```bash
+# 1. Crear rama
+git checkout -b feature/ma-feature
+
+# 2. Leer reglas
+cat .claude/rules/01-workflow-analysis.md
+cat .claude/checklists/new-feature.md
+
+# 3. Desarrollar siguiendo Clean Architecture
+# 4. Pruebas en paralelo
+make test
+
+# 5. Verificar calidad
+make ci
+
+# 6. Commit
+git commit -m "feat(feature): add ma feature"
+
+# 7. Push y PR
+git push origin feature/ma-feature
+```
+
+### 2. Corrección de Errores
+
+```bash
+# 1. Rama
+git checkout -b fix/mon-bug
+
+# 2. Reproducir con test
+# 3. Corregir
+# 4. Verificar
+make test
+
+# 5. Commit
+git commit -m "fix(module): resolve mon bug"
+```
+
+## Comandos Diarios
+
+```bash
+# Rutina matutina
+make setup          # Actualizar dependencias
+make generate       # Generar código
+make run            # Ejecutar app
+
+# Desarrollo
+make test-unit      # Pruebas durante desarrollo
+make analyze        # Verificar código
+
+# Antes del commit
+make ci             # Pipeline completo
+
+# Build release
+make build-apk
+```
+
+## Recursos
+
+### Documentación
+- Reglas detalladas: `.claude/rules/`
+- Plantillas de código: `.claude/templates/`
+- Listas de verificación: `.claude/checklists/`
+
+### Enlaces Útiles
+- [Flutter Documentation](https://docs.flutter.dev/)
+- [Effective Dart](https://dart.dev/guides/language/effective-dart)
+- [BLoC Library](https://bloclibrary.dev/)
+- [Riverpod](https://riverpod.dev/)
+
+## Soporte
+
+Para preguntas o sugerencias:
+- Abrir un issue en el repositorio
+- Contactar al líder de desarrollo
+
+---
+
+**Versión**: 1.0
+**Última actualización**: 2024-12-03