| name | software-development |
| version | 2.0.0 |
| description | Patrones de desarrollo de software: TDD, refactor, code review y debugging sistemático. |
| tags | ["software","development","tdd","refactoring","debugging","code-review","specification","spike","documentation","dataset"] |
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