# Software Development

> Patrones de desarrollo de software: TDD, refactor, code review y debugging sistemático.

- Skill: `ntizar/software-development` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add ntizar/software-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ntizar/software-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ntizar (https://skillmd.com/u/ntizar)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ntizar/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