javi-forge 1.2.0 → 1.4.0

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

@@ -1,335 +0,0 @@
----
-name: solo-dev-planner-install
-description: "Guía de instalación del Solo Dev Planner"
----
-
-# 📦 Guía de Instalación - Solo Dev Planner Modular
-
-## 🎯 Opción 1: Skill Modular con Loader (RECOMENDADO)
-
-### Estructura de Carpetas
-
-```
-.claude/
-└── agents/
-    └── specialized/
-        └── solo-dev-planner/              ← Crear esta carpeta
-            ├── solo-dev-planner.md        ← Loader principal
-            ├── 00-INDEX.md
-            ├── 01-CORE.md
-            ├── 02-SELF-CORRECTION.md
-            ├── 03-PROGRESSIVE-SETUP.md
-            ├── 04-DEPLOYMENT.md
-            ├── 05-TESTING.md
-            └── 06-OPERATIONS.md
-```
-
-### Pasos de Instalación
-
-#### 1. Crear Carpeta
-
-```bash
-# Windows (PowerShell)
-mkdir -p "$env:USERPROFILE\.claude\agents\specialized\solo-dev-planner"
-
-# macOS/Linux
-mkdir -p ~/.claude/agents/specialized/solo-dev-planner
-```
-
-#### 2. Copiar Archivos
-
-Copia todos los archivos de `solo-dev-planner-modular/` a la carpeta creada:
-
-```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/
-```
-
-#### 3. Verificar Instalación
-
-```bash
-# Windows
-dir "$env:USERPROFILE\.claude\agents\specialized\solo-dev-planner"
-
-# macOS/Linux
-ls -la ~/.claude/agents/specialized/solo-dev-planner/
-```
-
-**Deberías ver:**
-```
-solo-dev-planner.md           ← Loader principal
-00-INDEX.md
-01-CORE.md
-02-SELF-CORRECTION.md
-03-PROGRESSIVE-SETUP.md
-04-DEPLOYMENT.md
-05-TESTING.md
-06-OPERATIONS.md
-README.md
-```
-
-### Uso
-
-```
-Usuario: @solo-dev-planner quiero empezar un proyecto nuevo
-
-Claude:
-1. Lee solo-dev-planner.md (identifica módulos necesarios)
-2. Carga 01-CORE.md + 03-PROGRESSIVE-SETUP.md
-3. Responde basándose en esos módulos
-```
-
----
-
-## 🎯 Opción 2: Skill Único Consolidado (ALTERNATIVA)
-
-Si prefieres el enfoque tradicional (un solo archivo):
-
-### Estructura
-
-```
-.claude/
-└── agents/
-    └── specialized/
-        └── solo-dev-planner.md            ← Un solo archivo
-```
-
-### Pasos
-
-1. **Usar el archivo monolítico:**
-```bash
-# Copia solo-dev-planner-v2.md
-cp solo-dev-planner-v2.md ~/.claude/agents/specialized/solo-dev-planner.md
-```
-
-2. **Uso:**
-```
-@solo-dev-planner quiero empezar un proyecto
-```
-
-**Ventajas:**
-- ✅ Más simple (1 archivo)
-- ✅ Funciona como antes
-
-**Desventajas:**
-- ❌ 13k líneas (lento)
-- ❌ Más tokens consumidos
-- ❌ Menos navegable
-
----
-
-## 🎯 Opción 3: Multi-Skills (AVANZADO)
-
-Crear un skill separado por módulo:
-
-### Estructura
-
-```
-.claude/agents/specialized/
-├── solo-dev-core.md              ← 01-CORE
-├── solo-dev-selfcorrection.md    ← 02-SELF-CORRECTION
-├── solo-dev-setup.md             ← 03-PROGRESSIVE-SETUP
-├── solo-dev-deployment.md        ← 04-DEPLOYMENT
-├── solo-dev-testing.md           ← 05-TESTING
-└── solo-dev-operations.md        ← 06-OPERATIONS
-```
-
-### Uso
-
-```
-@solo-dev-core explica la filosofía
-@solo-dev-deployment cómo deployar a Koyeb
-@solo-dev-testing configura testcontainers
-```
-
-**Ventajas:**
-- ✅ Máxima especialización
-- ✅ Mínimos tokens por skill
-
-**Desventajas:**
-- ❌ 6 skills diferentes
-- ❌ Usuario tiene que recordar cuál usar
-
----
-
-## 📊 Comparación de Opciones
-
-| Aspecto | Opción 1: Modular | Opción 2: Monolítico | Opción 3: Multi-Skills |
-|---------|-------------------|----------------------|------------------------|
-| **Archivos** | 1 carpeta, 8 files | 1 archivo | 6 archivos |
-| **Comando** | @solo-dev-planner | @solo-dev-planner | @solo-dev-core, etc |
-| **Tokens/sesión** | 5k-10k | 40k | 3k-8k |
-| **Navegación** | ✅ Fácil | ⚠️ Difícil | ✅ Muy fácil |
-| **Mantenimiento** | ✅ Simple | ⚠️ Complejo | ✅ Simple |
-| **Setup** | ⚠️ Carpeta | ✅ 1 archivo | ⚠️ 6 archivos |
-| **Recomendado para** | Uso general | Simplicidad | Power users |
-
----
-
-## 🚀 **Recomendación Final**
-
-### **Para la mayoría de usuarios: Opción 1 (Modular)**
-
-```bash
-# 1. Crear carpeta
-mkdir -p ~/.claude/agents/specialized/solo-dev-planner
-
-# 2. Copiar todo
-cp -r solo-dev-planner-modular/* ~/.claude/agents/specialized/solo-dev-planner/
-
-# 3. Usar
-@solo-dev-planner <tu pregunta>
-```
-
-**Claude automáticamente:**
-- ✅ Identifica qué módulo necesitas
-- ✅ Lee solo ese módulo
-- ✅ Responde eficientemente
-
----
-
-## 🎮 Ejemplos de Uso (Opción 1)
-
-### Ejemplo 1: Nuevo Proyecto
-
-```
-Tú: @solo-dev-planner quiero empezar un proyecto TypeScript desde cero
-
-Claude:
-1. Identifica: Necesita 01-CORE + 03-PROGRESSIVE-SETUP
-2. Lee ambos módulos
-3. Responde: "Perfecto, vamos a usar Progressive Setup..."
-   → Explica FASE 1: MVP (15 min)
-   → Da comandos concretos
-```
-
-### Ejemplo 2: Troubleshooting
-
-```
-Tú: @solo-dev-planner mis tests están fallando y no sé por qué
-
-Claude:
-1. Identifica: Necesita 02-SELF-CORRECTION
-2. Lee módulo completo
-3. Responde: "Vamos a usar el auto-fix protocol..."
-   → Ejecuta: mise run fix:auto
-   → Explica el proceso de 3 intentos
-```
-
-### Ejemplo 3: Deploy
-
-```
-Tú: @solo-dev-planner listo para deployar, cuál plataforma recomendás?
-
-Claude:
-1. Identifica: Necesita 04-DEPLOYMENT
-2. Lee módulo completo
-3. Responde: "Te recomiendo Koyeb porque..."
-   → Compara Koyeb vs Railway vs Coolify
-   → Setup paso a paso
-```
-
----
-
-## 🔧 Troubleshooting de Instalación
-
-### Problema: "No encuentro la carpeta .claude"
-
-**Solución:**
-```bash
-# Crearla manualmente
-mkdir -p ~/.claude/agents/specialized
-
-# O en Windows
-mkdir "$env:USERPROFILE\.claude\agents\specialized"
-```
-
-### Problema: "@solo-dev-planner no funciona"
-
-**Verificaciones:**
-1. ¿Está el archivo loader `solo-dev-planner.md` en la carpeta?
-2. ¿Tiene el frontmatter YAML correcto?
-3. ¿Están todos los módulos en la misma carpeta?
-
-**Verificar estructura:**
-```bash
-ls ~/.claude/agents/specialized/solo-dev-planner/
-```
-
-### Problema: "Claude no carga los módulos"
-
-**Causa:** El loader debe usar herramienta `read` para leer módulos.
-
-**Solución:** Asegúrate que `solo-dev-planner.md` tiene:
-```yaml
----
-name: solo-dev-planner
-tools: Write, Read, MultiEdit, Bash, Grep, Glob, GitHub_MCP
----
-```
-
----
-
-## 📝 Checklist Post-Instalación
-
-```
-☑ Carpeta creada: ~/.claude/agents/specialized/solo-dev-planner/
-☑ 8 archivos copiados (loader + 7 módulos)
-☑ Loader tiene el frontmatter correcto
-☑ Probado con: @solo-dev-planner test
-☑ Claude responde correctamente
-```
-
----
-
-## 🎉 ¡Listo!
-
-**Ahora puedes usar:**
-
-```
-@solo-dev-planner quiero empezar un proyecto nuevo
-@solo-dev-planner cómo configuro testcontainers
-@solo-dev-planner deployar a koyeb
-@solo-dev-planner troubleshoot tests
-@solo-dev-planner setup rápido
-```
-
-**Claude automáticamente cargará los módulos necesarios y responderá eficientemente.** 🚀
-
----
-
-## 💡 Tips Avanzados
-
-### Tip 1: Context Script
-
-Cuando uses Claude Code, primero ejecuta:
-```bash
-mise run context
-```
-
-Esto genera un JSON con el estado completo del proyecto que Claude puede leer rápidamente.
-
-### Tip 2: Combinar con Projects
-
-Puedes subir la carpeta completa a un Claude Project para tener acceso permanente sin prefijo `@`:
-
-```
-1. Crear Project
-2. Subir carpeta solo-dev-planner/
-3. Claude tiene acceso automático
-```
-
-### Tip 3: Actualizar Módulos
-
-Para actualizar solo un módulo:
-```bash
-# Reemplaza solo el módulo específico
-cp 04-DEPLOYMENT.md ~/.claude/agents/specialized/solo-dev-planner/
-```
-
----
-
-**¿Dudas? Consulta `00-INDEX.md` dentro de la carpeta para guía completa de navegación.**

package/ai-config/agents/specialized/solo-dev-planner-modular/QUICK-REFERENCE.txt

@@ -1,215 +0,0 @@
-╔═══════════════════════════════════════════════════════════════════════════╗
-║                                                                           ║
-║                🚀 SOLO DEV PLANNER - SKILL MODULAR                       ║
-║                     Guía de Referencia Rápida                            ║
-║                                                                           ║
-╚═══════════════════════════════════════════════════════════════════════════╝
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 📦 INSTALACIÓN EN 3 PASOS                                                │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  1️⃣  Crear carpeta:
-      mkdir -p ~/.claude/agents/specialized/solo-dev-planner
-
-  2️⃣  Copiar archivos:
-      cp -r solo-dev-planner-modular/* ~/.claude/agents/specialized/solo-dev-planner/
-
-  3️⃣  Usar:
-      @solo-dev-planner <tu pregunta>
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 📁 ESTRUCTURA DE ARCHIVOS                                                │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  .claude/agents/specialized/solo-dev-planner/
-  │
-  ├─ 🔑 solo-dev-planner.md          ← LOADER (el skill)
-  │
-  ├─ 📘 00-INDEX.md                  ← Guía navegación
-  ├─ 📗 01-CORE.md                   ← Filosofía (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             ← Deploy (2,500 líneas)
-  ├─ 📓 05-TESTING.md                ← Tests (2,200 líneas)
-  ├─ 📒 06-OPERATIONS.md             ← Ops (2,800 líneas)
-  │
-  ├─ 📖 README.md                    ← Guía general
-  ├─ 📋 INSTALL.md                   ← Instalación paso a paso
-  ├─ 🎯 WORKFLOW-DIAGRAM.md          ← Diagramas visuales
-  └─ 🎉 START-HERE.md                ← Empieza aquí
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 🎯 CASOS DE USO RÁPIDOS                                                  │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  ▸ NUEVO PROYECTO
-    @solo-dev-planner empezar proyecto TypeScript
-    → Carga: 01-CORE + 03-PROGRESSIVE-SETUP
-    → Tiempo: 15 minutos hasta codear
-
-  ▸ TROUBLESHOOTING
-    @solo-dev-planner los tests fallan
-    → Carga: 02-SELF-CORRECTION
-    → Auto-fix: 3 intentos automáticos
-
-  ▸ DEPLOY
-    @solo-dev-planner deployar a Koyeb
-    → Carga: 04-DEPLOYMENT
-    → Setup completo en 5 minutos
-
-  ▸ TESTS
-    @solo-dev-planner configurar testcontainers
-    → Carga: 05-TESTING
-    → Setup por lenguaje (TS/Python/Go)
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 🔄 CÓMO FUNCIONA EL LOADER                                               │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  Tu pregunta → Loader → Identifica módulo → Lee módulo → Responde
-
-  Ejemplo:
-    @solo-dev-planner quiero deployar a Koyeb
-         ▼
-    Loader detecta: "deploy" + "Koyeb"
-         ▼
-    Carga módulo: 04-DEPLOYMENT.md
-         ▼
-    Respuesta: Setup completo de Koyeb
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 📊 VENTAJAS VS MONOLÍTICO                                                │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  ┌──────────────┬──────────────┬──────────────┐
-  │   Aspecto    │  Monolítico  │   Modular    │
-  ├──────────────┼──────────────┼──────────────┤
-  │ Tokens       │   ~40,000    │  ~5,000-10k  │
-  │ Carga        │   ~10 seg    │    ~2 seg    │
-  │ Navegación   │   Difícil    │    Fácil     │
-  │ Comando      │   @skill     │   @skill     │
-  │ Claude Code  │   ⚠️ Lento   │   ✅ Óptimo  │
-  └──────────────┴──────────────┴──────────────┘
-
-  Mismo comando, -75% tokens, -80% tiempo ✅
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 🎮 COMANDOS PRINCIPALES                                                  │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  Setup:
-    mise run setup              # Wizard interactivo
-    mise run setup:mvp          # MVP (15 min)
-    mise run setup:alpha        # Alpha (1 hora)
-    mise run setup:beta         # Beta (2-3 horas)
-
-  Desarrollo:
-    mise run dev                # Iniciar app
-    mise run test               # Tests
-    mise run lint               # Linter
-
-  Auto-fix:
-    mise run fix:auto           # Auto-detecta y arregla
-
-  Deploy:
-    mise run deploy             # Deploy
-    mise run logs               # Logs producción
-
-  Context (Claude Code):
-    mise run context            # Estado en JSON
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 📚 ¿QUÉ MÓDULO LEER?                                                     │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  Pregunta                              Módulo
-  ────────────────────────────────────────────────────────
-  "Empezar proyecto nuevo"              01 + 03
-  "Errores / tests fallan"              02
-  "Configurar tests"                    05
-  "Deployar a producción"               04
-  "Setup de DB / secrets"               06
-  "Filosofía del workflow"              01
-  "Setup rápido (15 min)"               03
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 📖 DOCUMENTACIÓN                                                         │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  START-HERE.md          → Empieza aquí (resumen ejecutivo)
-  INSTALL.md             → Instalación paso a paso
-  WORKFLOW-DIAGRAM.md    → Diagramas visuales
-  README.md              → Guía general
-  00-INDEX.md            → Índice maestro
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ ✨ FEATURES PRINCIPALES                                                  │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  ✅ Production-Ready
-     • Setup en 15 minutos (MVP)
-     • Deploy global (Koyeb/Railway)
-     • Tests con DB real
-     • Monitoring completo
-
-  ✅ Autonomous
-     • Auto-fix de errores (3 intentos)
-     • Context optimizado (< 500 tokens)
-     • Recovery automático
-
-  ✅ Cost-Effective
-     • Free tier: Koyeb
-     • $5/mes: Railway
-     • €5/mes: Coolify (self-hosted)
-
-  ✅ Modular
-     • -75% tokens
-     • -80% tiempo de carga
-     • Fácil mantenimiento
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 🎯 QUICK START                                                           │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  1. Lee: START-HERE.md (5 min)
-  2. Lee: INSTALL.md (2 min)
-  3. Copia archivos (1 min)
-  4. Usa: @solo-dev-planner test
-
-  Total: 8 minutos hasta estar operativo ✅
-
-
-┌───────────────────────────────────────────────────────────────────────────┐
-│ 📊 ESTADÍSTICAS                                                          │
-└───────────────────────────────────────────────────────────────────────────┘
-
-  Total líneas:        ~15,700
-  Módulos:             6 core + loader + índice
-  Archivos totales:    12 (8 core + 4 docs)
-  Tamaño promedio:     ~2,460 líneas/módulo
-  Reducción tokens:    -75% vs monolítico
-  Tiempo de carga:     -80% vs monolítico
-
-
-╔═══════════════════════════════════════════════════════════════════════════╗
-║                                                                           ║
-║  🚀 EL SKILL MÁS COMPLETO PARA SOLO DEVELOPERS                          ║
-║                                                                           ║
-║  Siguiente paso:                                                          ║
-║  1. Lee START-HERE.md                                                     ║
-║  2. Sigue INSTALL.md                                                      ║
-║  3. ¡Empieza a usar!                                                      ║
-║                                                                           ║
-║  Happy coding! 🎉                                                         ║
-║                                                                           ║
-╚═══════════════════════════════════════════════════════════════════════════╝