javi-forge 1.2.0 → 1.4.0

package/ai-config/agents/specialized/solo-dev-planner-modular/README.md

@@ -1,260 +0,0 @@
----
-name: solo-dev-planner-readme
-description: "README del Solo Dev Planner - Guía de estructura modular"
----
-
-# 🚀 Solo Dev Planner - Skill Modular
-
-**Production-ready skill para solo developers, optimizado para Claude Code y Projects**
-
-## 📦 Estructura Modular
-
-```
-solo-dev-planner-modular/
-├── README.md                      ← Estás aquí
-├── 00-INDEX.md                    ← Guía maestra
-│
-├── 01-CORE.md                     ← Filosofía + Atomic Sequential
-├── 02-SELF-CORRECTION.md          ← Auto-fix protocol + Context
-├── 03-PROGRESSIVE-SETUP.md        ← Setup MVP/Alpha/Beta
-├── 04-DEPLOYMENT.md               ← Koyeb, Railway, Coolify
-├── 05-TESTING.md                  ← Strategy + Testcontainers
-└── 06-OPERATIONS.md               ← DB, Secrets, Monitoring, Mise
-```
-
-## 🎯 Quick Start
-
-### Para Claude Projects
-
-```markdown
-1. Carga: 00-INDEX.md (lee la guía)
-2. Carga: 01-CORE.md (filosofía base)
-3. Carga: Módulo específico según necesites
-```
-
-### Para Claude Code
-
-```markdown
-Sesión típica:
-1. Carga: 01-CORE.md + módulo específico
-2. Usa: 02-SELF-CORRECTION.md para troubleshooting
-3. Máximo: 2-3 módulos simultáneos
-```
-
-## 📊 Comparación con Versión Monolítica
-
-| Aspecto | Monolítico | Modular |
-|---------|------------|---------|
-| **Archivo único** | 13,241 líneas | 6 archivos |
-| **Tamaño promedio** | N/A | 1,800-3,500 líneas |
-| **Tokens por carga** | ~40,000 | ~5,000-10,000 |
-| **Navegación** | Scroll infinito | Por módulo |
-| **Para Claude Code** | ⚠️ Lento | ✅ Óptimo |
-| **Mantenimiento** | ⚠️ Complejo | ✅ Simple |
-
-## 🎮 Workflows Comunes
-
-### 1. Nuevo Proyecto (Día 1)
-
-```bash
-Claude: Lee 01-CORE.md + 03-PROGRESSIVE-SETUP.md
-Humano: mise run setup:mvp
-Tiempo: 30 minutos
-```
-
-### 2. Configurar Tests
-
-```bash
-Claude: Lee 05-TESTING.md
-Humano: Implementa según el módulo
-```
-
-### 3. Deploy a Producción
-
-```bash
-Claude: Lee 04-DEPLOYMENT.md
-Humano: mise run deploy:setup:koyeb
-```
-
-### 4. Troubleshooting
-
-```bash
-Claude: Lee 02-SELF-CORRECTION.md
-Humano: mise run fix:auto
-```
-
-## 📋 Contenido por Módulo
-
-| Módulo | Tamaño | Contenido | Cuándo Leer |
-|--------|--------|-----------|-------------|
-| **00-INDEX** | 300 líneas | Guía maestra | Primero siempre |
-| **01-CORE** | ~3,500 | Filosofía + Workflow | Nuevo proyecto |
-| **02-SELF-CORRECTION** | ~1,800 | Auto-fix + Context | Troubleshooting |
-| **03-PROGRESSIVE-SETUP** | ~2,000 | MVP/Alpha/Beta | Setup inicial |
-| **04-DEPLOYMENT** | ~2,500 | Deploy platforms | Pre-launch |
-| **05-TESTING** | ~2,200 | Strategy + Testcontainers | Mejorar calidad |
-| **06-OPERATIONS** | ~2,800 | DB/Secrets/Monitoring | Operaciones |
-
-## 🚀 Ventajas del Skill Modular
-
-### Para el Desarrollador
-
-```
-✅ Setup más rápido (15 min vs 6 horas)
-✅ Solo cargas lo que necesitas
-✅ Más fácil de navegar
-✅ Actualizar módulos independientemente
-```
-
-### Para Claude
-
-```
-✅ Menos tokens por sesión (-75%)
-✅ Carga más rápida (2s vs 10s)
-✅ Context window optimizado
-✅ Especialización por tarea
-```
-
-## 🔄 Dependencias entre Módulos
-
-```
-Todos dependen de:
-└── 01-CORE.md (base)
-
-03-PROGRESSIVE-SETUP.md usa:
-├── 02-SELF-CORRECTION.md (git hooks)
-├── 04-DEPLOYMENT.md (fase beta)
-└── 06-OPERATIONS.md (mise, DB)
-
-04-DEPLOYMENT.md usa:
-└── 06-OPERATIONS.md (secrets)
-
-05-TESTING.md usa:
-└── 06-OPERATIONS.md (mise tasks)
-```
-
-## 📚 Documentación Adicional
-
-- **00-INDEX.md:** Guía completa de navegación
-- **Cada módulo:** Tiene su propia tabla de contenidos
-- **Original:** `solo-dev-planner-v2.md` (monolítico, 13k líneas)
-
-## 💡 Recomendaciones
-
-### Para Proyectos Nuevos
-
-```
-1. Lee 00-INDEX.md (10 min)
-2. Lee 01-CORE.md completo (30 min)
-3. Lee 03-PROGRESSIVE-SETUP.md (15 min)
-4. Ejecuta: mise run setup
-5. ¡Empieza a codear!
-```
-
-### Para Optimizar Claude Code
-
-```
-# En cada sesión:
-1. Carga SOLO lo necesario
-2. Usa context script (02-SELF-CORRECTION.md)
-3. Máximo 2-3 módulos
-4. Revisa 00-INDEX.md si dudas
-```
-
-### Para Troubleshooting
-
-```
-# Orden de lectura:
-1. 02-SELF-CORRECTION.md (auto-fix)
-2. Módulo específico al problema
-3. 01-CORE.md si dudas de filosofía
-```
-
-## 🎯 Casos de Uso Específicos
-
-### "Quiero empezar YA"
-→ **Lee:** 01-CORE + 03-PROGRESSIVE-SETUP (sección MVP)  
-→ **Ejecuta:** `mise run setup:mvp`  
-→ **Tiempo:** 15 minutos
-
-### "Tests están fallando"
-→ **Lee:** 02-SELF-CORRECTION (sección auto-fix tests)  
-→ **Ejecuta:** `mise run fix:auto`  
-→ **Tiempo:** 5 minutos
-
-### "Listo para producción"
-→ **Lee:** 04-DEPLOYMENT (comparativa) + 06-OPERATIONS (secrets)  
-→ **Ejecuta:** `mise run deploy:setup:koyeb`  
-→ **Tiempo:** 1 hora
-
-### "Quiero tests enterprise-grade"
-→ **Lee:** 05-TESTING (completo)  
-→ **Implementa:** Testcontainers  
-→ **Tiempo:** 2-3 horas
-
-## 📊 Estadísticas
-
-```
-Total líneas:        ~14,800
-Módulos:             6
-Tamaño promedio:     ~2,460 líneas/módulo
-Reducción tokens:    -75% vs monolítico
-Tiempo de carga:     -80% vs monolítico
-```
-
-## 🔗 Enlaces
-
-- **Versión monolítica:** `../solo-dev-planner-v2.md` (13,241 líneas)
-- **Addon con mejoras:** `../solo-dev-planner-MEJORAS-ADDON.md`
-- **Documentación completa:** `../solo-dev-improvements.md`
-
----
-
-## 🎉 El Skill Más Completo para Solo Devs
-
-```
-✅ Production-ready desde día 1
-✅ Setup en 15 minutos (MVP)
-✅ Auto-fix de errores (3 intentos)
-✅ Deploy global ($0-15/mes)
-✅ Tests con DB real (Testcontainers)
-✅ Monitoring completo
-✅ Secrets management
-✅ 100% modular y optimizado
-```
-
-**Empieza leyendo `00-INDEX.md` → `01-CORE.md` → Módulo que necesites** 🚀
-
----
-
-## 📝 Changelog del Skill Modular
-
-### v2.1.0 - Modularización (27 Dic 2025)
-
-```
-✅ Dividido en 6 módulos especializados
-✅ Optimizado para Claude Code (-75% tokens)
-✅ Navegación mejorada con TOC
-✅ Headers con relaciones entre módulos
-✅ Quick start por caso de uso
-✅ INDEX maestro con guías
-```
-
-### v2.0.0 - Mejoras Críticas (27 Dic 2025)
-
-```
-✅ Self-Correction Protocol
-✅ Progressive Disclosure (MVP/Alpha/Beta)
-✅ Context Script optimizado
-✅ Deployment Simple (Koyeb/Railway/Coolify)
-✅ Testcontainers para 3 lenguajes
-```
-
-### v1.0.0 - Versión Original
-
-```
-✅ Atomic Sequential Merges
-✅ Mise como herramienta principal
-✅ CI/CD adaptativo
-✅ Stacks modernos (TypeScript, Python, Go, Java)
-```

package/ai-config/agents/specialized/solo-dev-planner-modular/START-HERE.md

@@ -1,379 +0,0 @@
----
-name: solo-dev-planner-start
-description: "Punto de inicio del Solo Dev Planner"
----
-
-# 🎉 Solo Dev Planner - Skill Modular COMPLETO
-
-## 📦 ¿Qué Tienes Ahora?
-
-Has recibido el **skill más completo para solo developers**, optimizado y modularizado.
-
----
-
-## 📁 Archivos en tu Carpeta de Outputs
-
-```
-solo-dev-planner-modular/
-├── 📖 README.md                      ← Lee primero (guía general)
-├── 📋 INSTALL.md                     ← Guía de instalación paso a paso
-├── 🎯 WORKFLOW-DIAGRAM.md            ← Cómo funciona visualmente
-│
-├── 🔑 solo-dev-planner.md            ← LOADER (el "skill" principal)
-├── 📘 00-INDEX.md                    ← Índice maestro
-├── 📗 01-CORE.md                     ← Filosofía + Workflow (3,500 líneas)
-├── 📙 02-SELF-CORRECTION.md          ← Auto-fix (1,800 líneas)
-├── 📕 03-PROGRESSIVE-SETUP.md        ← MVP/Alpha/Beta (2,000 líneas)
-├── 📔 04-DEPLOYMENT.md               ← Koyeb/Railway/Coolify (2,500 líneas)
-├── 📓 05-TESTING.md                  ← Strategy + Testcontainers (2,200 líneas)
-└── 📒 06-OPERATIONS.md               ← DB/Secrets/Monitoring (2,800 líneas)
-
-Total: 11 archivos
-```
-
----
-
-## 🚀 Quick Start en 3 Pasos
-
-### Paso 1: Copiar Archivos
-
-```bash
-# Windows (PowerShell)
-Copy-Item -Path ".\solo-dev-planner-modular\*" -Destination "$env:USERPROFILE\.claude\agents\specialized\solo-dev-planner\" -Recurse
-
-# macOS/Linux
-cp -r solo-dev-planner-modular/* ~/.claude/agents/specialized/solo-dev-planner/
-```
-
-### Paso 2: Verificar
-
-```bash
-# Deberías ver:
-.claude/agents/specialized/solo-dev-planner/
-├── solo-dev-planner.md       ← Loader
-├── 00-INDEX.md
-├── 01-CORE.md
-├── 02-SELF-CORRECTION.md
-├── 03-PROGRESSIVE-SETUP.md
-├── 04-DEPLOYMENT.md
-├── 05-TESTING.md
-└── 06-OPERATIONS.md
-```
-
-### Paso 3: Usar
-
-```
-En Claude Desktop/Projects:
-
-@solo-dev-planner quiero empezar un proyecto nuevo
-@solo-dev-planner cómo deployar a Koyeb
-@solo-dev-planner configurar testcontainers
-@solo-dev-planner troubleshoot tests
-```
-
-**¡Listo! Claude cargará automáticamente los módulos necesarios.**
-
----
-
-## 🎯 Cómo Funciona
-
-### Sistema de Loader Inteligente
-
-```
-Tú: @solo-dev-planner <pregunta>
-     ▼
-Loader (solo-dev-planner.md):
-  1. Identifica qué necesitas
-  2. Lee módulo(s) relevante(s)
-  3. Responde basándose en el módulo
-     ▼
-Resultado: Respuesta precisa y rápida
-```
-
-### Ejemplo Real
-
-```
-Tú: @solo-dev-planner necesito deployar a Koyeb
-
-Claude (internamente):
-  1. Lee loader → Detecta "deploy" + "Koyeb"
-  2. Carga 04-DEPLOYMENT.md
-  3. Encuentra sección de Koyeb
-  4. Responde con setup completo
-
-Respuesta:
-  "Perfecto, Koyeb es ideal porque..."
-  → Setup paso a paso
-  → Comandos concretos
-  → koyeb.yaml completo
-```
-
----
-
-## 📊 Ventajas vs Skill Monolítico
-
-| Aspecto | Monolítico | Modular |
-|---------|------------|---------|
-| **Archivos** | 1 (13k líneas) | 8 archivos |
-| **Tokens/sesión** | ~40,000 | ~5,000-10,000 |
-| **Tiempo de carga** | ~10 seg | ~2 seg |
-| **Navegación** | Scroll infinito | Por módulo |
-| **Comando** | @solo-dev-planner | @solo-dev-planner |
-| **Para Claude Code** | ⚠️ Lento | ✅ Óptimo |
-
-**Mismo comando, mejores resultados ✅**
-
----
-
-## 🎮 Casos de Uso Principales
-
-### 1. Nuevo Proyecto (15 min)
-
-```
-@solo-dev-planner empezar proyecto TypeScript
-
-Claude carga: 01-CORE + 03-PROGRESSIVE-SETUP
-Responde: Setup MVP en 15 minutos
-```
-
-### 2. Troubleshooting
-
-```
-@solo-dev-planner los tests fallan
-
-Claude carga: 02-SELF-CORRECTION
-Responde: Auto-fix protocol (3 intentos)
-```
-
-### 3. Deploy a Producción
-
-```
-@solo-dev-planner deployar a Koyeb
-
-Claude carga: 04-DEPLOYMENT
-Responde: Setup completo de Koyeb
-```
-
-### 4. Configurar Tests
-
-```
-@solo-dev-planner configurar testcontainers
-
-Claude carga: 05-TESTING
-Responde: Setup completo por lenguaje
-```
-
----
-
-## 📚 Documentación por Archivo
-
-### README.md
-- Guía general del skill
-- Estructura modular
-- Workflows comunes
-- Ventajas del sistema
-
-### INSTALL.md
-- 3 opciones de instalación
-- Paso a paso detallado
-- Troubleshooting
-- Checklist post-instalación
-
-### WORKFLOW-DIAGRAM.md
-- Diagrama visual del flujo
-- Ejemplos prácticos
-- Lógica del loader
-- Comparación antes/ahora
-
-### solo-dev-planner.md (LOADER)
-- Skill principal
-- Router inteligente
-- Mapa de decisión
-- Carga módulos según necesidad
-
-### 00-INDEX.md
-- Índice maestro
-- Guía de navegación
-- Qué módulo usar cuándo
-- Quick start por escenario
-
-### Módulos (01-06)
-- Contenido especializado
-- Auto-contenidos
-- Con tabla de contenidos
-- Headers con relaciones
-
----
-
-## 🎯 Features del Skill
-
-### ✅ Production-Ready
-```
-✓ Setup en 15 minutos (MVP)
-✓ Deploy automático a global edge
-✓ Tests con DB real (Testcontainers)
-✓ Monitoring completo
-✓ Secrets management
-```
-
-### ✅ Autonomous
-```
-✓ Auto-fix de errores (3 intentos)
-✓ Context eficiente (< 500 tokens)
-✓ Recovery automático
-✓ Self-healing hooks
-```
-
-### ✅ Cost-Effective
-```
-✓ Free tier en Koyeb
-✓ $5/mes en Railway
-✓ €5/mes self-hosted
-✓ No AWS overkill
-```
-
-### ✅ Global-Ready
-```
-✓ Edge deployment en 6 regiones
-✓ Baja latencia mundial
-✓ Auto-scaling
-✓ Zero-downtime deploys
-```
-
----
-
-## 📊 Estadísticas
-
-```
-Total líneas:        ~15,700
-Módulos:             6 + loader + índice
-Tamaño promedio:     ~2,460 líneas/módulo
-Reducción tokens:    -75% vs monolítico
-Tiempo de carga:     -80% vs monolítico
-Archivos totales:    11 (8 core + 3 docs)
-```
-
----
-
-## 🔄 Changelog
-
-### v2.1.0 - Modularización (27 Dic 2025)
-```
-✅ Dividido en 6 módulos especializados
-✅ Loader inteligente creado
-✅ Optimizado para Claude Code (-75% tokens)
-✅ Navegación mejorada con TOC
-✅ 3 guías de documentación
-✅ Workflow diagrams
-```
-
-### v2.0.0 - Mejoras Críticas (27 Dic 2025)
-```
-✅ Self-Correction Protocol
-✅ Progressive Disclosure (MVP/Alpha/Beta)
-✅ Context Script optimizado
-✅ Deployment Simple (Koyeb/Railway/Coolify)
-✅ Testcontainers para 3 lenguajes
-```
-
-### v1.0.0 - Versión Original
-```
-✅ Atomic Sequential Merges
-✅ Mise como herramienta principal
-✅ CI/CD adaptativo
-✅ Stacks modernos
-```
-
----
-
-## 💡 Tips Finales
-
-### Tip 1: Empieza Simple
-```
-1. Instala archivos
-2. Prueba: @solo-dev-planner test
-3. Si funciona, úsalo normalmente
-```
-
-### Tip 2: Consulta Documentación
-```
-- Dudas de instalación → INSTALL.md
-- Cómo funciona → WORKFLOW-DIAGRAM.md
-- Qué módulo usar → 00-INDEX.md
-- Guía general → README.md
-```
-
-### Tip 3: Actualización Modular
-```
-Para actualizar solo deployment:
-1. Reemplaza 04-DEPLOYMENT.md
-2. Los demás módulos siguen igual
-3. No necesitas tocar el loader
-```
-
-### Tip 4: Context Script
-```
-En Claude Code, ejecuta:
-mise run context
-
-Genera JSON con estado completo
-Claude lo lee en < 500 tokens
-```
-
----
-
-## 🎉 Resumen Final
-
-### Lo Que Tienes
-
-```
-✅ Skill modular completo
-✅ 6 módulos especializados
-✅ Loader inteligente
-✅ 3 guías de documentación
-✅ Optimizado para Claude Code
-✅ Production-ready desde día 1
-```
-
-### Cómo Usarlo
-
-```
-1. Copia archivos a ~/.claude/agents/specialized/solo-dev-planner/
-2. Usa: @solo-dev-planner <tu pregunta>
-3. Claude carga módulos automáticamente
-4. Respuesta precisa y rápida
-```
-
-### Ventajas Principales
-
-```
-✅ -75% tokens por sesión
-✅ -80% tiempo de carga
-✅ Mismo comando que antes
-✅ Mejores respuestas
-✅ Más fácil de mantener
-```
-
----
-
-## 🚀 ¡Listo para Usar!
-
-**El skill más completo para solo developers está listo.**
-
-**Siguiente paso:**
-1. Lee `INSTALL.md` para instalación paso a paso
-2. Copia archivos a la carpeta correcta
-3. Empieza a usar: `@solo-dev-planner`
-
-**¡Happy coding!** 🎉
-
----
-
-## 📞 Archivos de Referencia
-
-- **Instalación:** `INSTALL.md`
-- **Workflow:** `WORKFLOW-DIAGRAM.md`
-- **Navegación:** `00-INDEX.md`
-- **General:** `README.md`
-
-**¿Dudas? Todos los archivos tienen documentación completa.**