software-development

# Software Development — Patrones Completos ## Resumen Ecosistema completo de patrones de desarrollo de software organizado en 4 categorías: ### Método de Desarrollo | Patrón | Descripción | |--------|-------------| | **Spec-Driven** | Construir software desde specs (PRD, planes, constituciones) | | **TDD** | RED-GREEN-REFACTOR, tests antes que código | | **Spike** | Experimentos throwaway para validar ideas antes de construir | | **Multi-Iteration** | Mejoras 9009 en múltiples iteraciones, batches de 20 | ### Refactorización y Calidad | Patrón | Descripción | |--------|-------------| | **Safe Refactoring** | Auditoría y refactorización segura sin romper producción | | **Code Review** | Pre-commit: security scan, quality gates, auto-fix | | **Google Eng Practices** | Code review profesional, cultura de code health | | **Systematic Debugging** | 4-phase root cause debugging | ### Documentación y Traspaso | Patrón | Descripción | |--------|-------------| | **Codebase Handoff** | Guías de mantenimiento para que cualquier persona trabaje en código | | **Agent Skills Standard** | Formato y patrón para skills reutilizables de agentes IA | ### Patrones de Código y Datos | Patrón | Descripción | |--------|-------------| | **Hash Index** | Índice hash para acceso O(1) en datasets grandes | | **Lazy Loading** | Carga progresiva: solo lo que el usuario necesita, cuando lo necesita | | **Sparse JSON** | 40-60% menos de tamaño en datasets grandes | | **TopoJSON** | Compresión geográfica: 70% menos que GeoJSON | | **Delegar no Comprimir** | Paralelizar tareas en subagentes en vez de compresiones contextuales | | **Subagent Driven** | Ejecutar planes via delegate_task con review 2-etapas | | **Geospatial Asset** | Plataformas SaaS de gestión de activos georreferenciados | | **Leaflet Choropleth** | Mapa interactivo con miles de polígonos sin lag | | **Map Optimization** | Optimización combinatoria (p-median, TSP) sobre mapas | | **Pin Auth NodeJS** | Autenticación PIN + SQLite para apps Node.js | | **Rebranding** | Rebranding sistemático de proyectos web completos | | **Refactor NodeJS** | Monolítico → arquitectura modular por dominios | | **TypeScript Cross-Module** | Tipos flexibles para engine+tests+frontend multi-módulo | ## Decision Guide ``` ¿Qué necesitas? ├── ¿Nuevo proyecto? → Spec-Driven Development ├── ¿Calidad de código? → TDD + Code Review + Google Eng Practices ├── ¿Cambiar idea? → Spike (experimento throwaway) ├── ¿Mejorar código existente? → Safe Refactoring ├── ¿Debug? → Systematic Debugging (4 phases) ├── ¿Múltiples iteraciones? → 9009 Multi-Iteration ├── ¿Documentar? → Codebase Handoff ├── ¿Optimizar datos? → Hash Index + Lazy Loading + Sparse JSON ├── ¿Mapas? → Leaflet Choropleth + TopoJSON + Map Optimization └── ¿Arquitectura? → Refactor NodeJS + TypeScript Cross-Module + Pin Auth ``` ## Subsecciones Detail ### Spec-Driven Development Basado en spec-kit de GitHub (113K⭐). Construir software desde specs (PRD, plans, constituciones) en vez de "vibe coding". ### TDD Enforce RED-GREEN-REFACTOR. Tests antes que código. Ciclo: Write failing test → Make it pass → Refactor. ### Spike Throwaway experiments para validar una idea antes de construir. No dejar rastro en el codebase principal. ### Safe Refactoring Auditar y refactorizar proyectos existentes sin romperlos. Capturado del incidente MasterFit v3 donde la extracción de JS eliminó CDNs de Chart.js y Three.js. ### Code Review Pre-commit review con security scan, quality gates y auto-fix. Verifica: seguridad, calidad, rendimiento, consistencia. ### Google Engineering Practices Code review profesional, buenas prácticas de ingeniería, cultura de code health. 22.6K⭐ en GitHub. ### Systematic Debugging 4-phase root cause debugging: understand bugs before fixing. Phase 1: Reproduce. Phase 2: Isolate. Phase 3: Root cause. Phase 4: Fix + verify. ### Multi-Iteration (9009) Patrón genérico para ejecutar mejoras en múltiples iteraciones. Análisis rápido, plan, implementación directa, verificación. Batches de 20. ### Codebase Handoff Documentación de traspaso: leer codebase completo, explicar qué hace cada bloque, esquemas de datos, scripts, despliegue, errores conocidos. ### Agent Skills Standard Formato y patrón para skills reutilizables de agentes IA. Inspirado en K-Dense-AI/scientific-agent-skills (26K⭐) con 142 skills científicas. ### Delegar no Comprimir Paralelizar tareas en subagentes en vez de hacer compresiones de contexto con secuencias largas de herramientas. ### Subagent Driven Development Ejecutar planes via delegate_task con 2-stage review. Planificar → Delegar → Review resultado → Iterar. ### Hash Index Índice hash para acceso O(1) a registros en datasets grandes. Patrón IDX: array → objeto hash por key, merge de datasets, precomputación de métricas. ### Lazy Dataset Loading Carga progresiva: solo lo que el usuario necesita, cuando lo necesita. Patrón con ensureDataset, cache de estado, merge en hash index, precarga idle. Reduce carga de 10s a 250ms. ### Sparse JSON Formato JSON sparse para datasets grandes: 40-60% menos de tamaño. Clave-valores en arrays en vez de objetos repetidos. ### TopoJSON Compresión geográfica: 70% menos de tamaño que GeoJSON, conversión en runtime, liberación de memoria. Para países, municipios, barrios. ### Leaflet Canvas Choropleth Mapa choropleth interactivo con Leaflet + Canvas renderer. Miles de polígonos sin lag. 4 escalas de color, pane system, lazy dataset switching. ### Map Optimization Herramientas de optimización combinatoria sobre mapas: p-median, p-center, TSP, problema de transporte. Heurísticas JS, integración ORS/OSRM. ### Geospatial Asset Platform Plataformas SaaS de gestión de activos georreferenciados: municipal, hospitalario, logístico. PostgreSQL+PostGIS, Three.js, optimistic locking, audit trail. ### Pin Auth NodeJS Autenticación con PIN para apps Node.js + SQLite (sql.js). Migración de BD, login con creación de usuario, PIN siempre visible. ### Rebranding Rebranding sistemático de proyectos web: búsqueda y reemplazo en HTML, JS, server, README, Docker, favicon. Checklist + verificación post-cambio. ### Refactor NodeJS Refactorizar proyecto Node.js monolítico a arquitectura modular por dominios. Separar por responsabilidad, crear límites claros. ### TypeScript Cross-Module Tipos flexibles para engine+tests+frontend en proyectos multi-módulo. Declaration files, typecheck antes de push, prevención de errores CI. ## Referencias Cruzadas - `web-research-fallback` → Cuando todas las búsquedas fallan - `github-workflow` → GitHub auth, repos, PR lifecycle, code review