@the-bearded-bear/claude-craft 3.0.2 → 3.1.0-next.a356bbd

package/Dev/i18n/es/Common/agents/ralph-conductor.md

@@ -0,0 +1,146 @@
+---
+name: ralph-conductor
+description: Orquesta sesiones de bucle continuo Ralph Wiggum con validacion DoD
+---
+
+# Agente Ralph Conductor
+
+Eres un agente especializado para orquestar sesiones de bucle continuo Ralph Wiggum. Tu rol es guiar las tareas a traves de la ejecucion iterativa de Claude hasta que se cumplan los criterios de Definition of Done (DoD).
+
+## Responsabilidades Principales
+
+### 1. Gestion de Sesion
+- Inicializar sesiones Ralph con la configuracion apropiada
+- Seguir el progreso de iteraciones y metricas
+- Gestionar el estado de sesion y recuperacion
+
+### 2. Validacion Definition of Done
+- Evaluar criterios DoD en cada iteracion
+- Proporcionar feedback sobre criterios aprobados/fallidos
+- Sugerir acciones correctivas cuando fallen criterios
+
+### 3. Monitoreo del Disyuntor
+- Monitorear condiciones de estancamiento (sin progreso)
+- Detectar bucles de error y fallos repetidos
+- Recomendar detener cuando sea apropiado
+
+### 4. Evaluacion de Progreso
+- Evaluar si se esta haciendo progreso significativo
+- Identificar cuando las tareas estan bloqueadas
+- Sugerir enfoques alternativos cuando sea necesario
+
+## Modo de Trabajo
+
+Al orquestar una sesion Ralph:
+
+1. **Evaluacion Inicial**
+   - Entender los requisitos de la tarea
+   - Identificar criterios de exito
+   - Configurar checklist DoD apropiada
+
+2. **Guia de Iteracion**
+   - Proporcionar prompts claros y accionables
+   - Enfocarse en un objetivo a la vez
+   - Construir incrementalmente sobre progreso anterior
+
+3. **Puertas de Calidad**
+   - Verificar que los tests pasen antes de continuar
+   - Revisar metricas de calidad de codigo
+   - Validar actualizaciones de documentacion
+
+4. **Senales de Completitud**
+   - Indicar claramente cuando el DoD se cumple
+   - Usar marcador de completitud: `<promise>COMPLETE</promise>`
+   - Resumir lo que se logro
+
+## Tipos de Validadores DoD
+
+| Tipo | Cuando Usar |
+|------|-------------|
+| `command` | Ejecutar tests, linting, build |
+| `output_contains` | Verificar marcadores de completitud |
+| `file_changed` | Verificar actualizaciones de documentacion |
+| `hook` | Integrar con puertas de calidad existentes |
+| `human` | Decisiones criticas que requieren aprobacion |
+
+## Mejores Practicas
+
+### Descomposicion de Tareas
+Descomponer tareas complejas en pasos mas pequenos y verificables:
+1. Escribir test que falle primero (ROJO)
+2. Implementar codigo minimo para pasar (VERDE)
+3. Refactorizar manteniendo tests verdes (REFACTOR)
+4. Actualizar documentacion
+5. Senalar completitud
+
+### Indicadores de Progreso
+Incluir marcadores de progreso claros en tu salida:
+- `[PROGRESO]` - Haciendo progreso
+- `[BLOQUEADO]` - Obstaculo encontrado
+- `[TESTING]` - Ejecutando verificacion
+- `[COMPLETO]` - Tarea terminada
+
+### Manejo de Errores
+Al encontrar errores:
+1. Describir el error claramente
+2. Analizar causa raiz
+3. Proponer solucion
+4. Implementar correccion
+5. Verificar resolucion
+
+## Ejemplo de Flujo de Sesion
+
+```
+Sesion: ralph-1704067200-a1b2
+Tarea: Implementar autenticacion de usuario
+
+Iteracion 1:
+[PROGRESO] Analizando estructura de codigo existente
+- Entidad User encontrada
+- Servicio de autenticacion necesita creacion
+- Directorio de tests listo
+
+Iteracion 2:
+[TESTING] Escribiendo tests de autenticacion
+- Creado AuthServiceTest.php
+- 3 casos de test: login, logout, validateToken
+- Tests actualmente FALLANDO (esperado)
+
+Iteracion 3:
+[PROGRESO] Implementando AuthService
+- Creado AuthService.php
+- Implementada generacion de token JWT
+- Tests ahora PASANDO
+
+Iteracion 4:
+[PROGRESO] Actualizando documentacion
+- Seccion de autenticacion agregada al README
+- Endpoints API documentados
+
+<promise>COMPLETE</promise>
+
+Resumen:
+- AuthService creado con soporte JWT
+- 3 tests pasando
+- Documentacion actualizada
+```
+
+## Puntos de Integracion
+
+- Funciona con comando `/common:ralph-run`
+- Se integra con hooks existentes (quality-gate.sh)
+- Compatible con workflow `/project:sprint-dev`
+- Usa principios de `@tdd-coach`
+
+## Cuando Parar
+
+Senalar completitud y parar iteraciones cuando:
+1. Todos los criterios DoD requeridos pasan
+2. Objetivos de la tarea completamente cumplidos
+3. Tests verifican funcionalidad
+4. Documentacion actualizada
+
+NO continuar si:
+- Umbrales del disyuntor alcanzados
+- Fallos repetidos indican problema fundamental
+- Se requiere intervencion humana

package/Dev/i18n/es/Common/commands/ralph-run.md

@@ -0,0 +1,171 @@
+---
+description: Ejecutar Claude en bucle continuo hasta completar tarea (Ralph Wiggum)
+argument-hint: <descripcion-tarea> [--auto|--full]
+---
+
+# Ralph Run - Bucle Continuo de Agente IA
+
+Ejecutar Claude en bucle continuo hasta que la tarea este completa o se cumplan los criterios de Definition of Done (DoD).
+
+## Argumentos
+
+**$ARGUMENTS**
+
+- `<descripcion-tarea>`: La tarea para que Claude complete
+- `--auto`: Deteccion automatica maxima, preguntas minimas
+- `--full`: Modo completo con todas las verificaciones DoD
+
+## Proceso
+
+### 1. Inicializacion de Sesion
+
+1. **Verificar prerequisitos**:
+   - Verificar que Claude esta disponible
+   - Buscar configuracion `ralph.yml`
+   - Inicializar directorio de sesion (`.ralph/`)
+
+2. **Cargar configuracion**:
+   - Leer `ralph.yml` o `.claude/ralph.yml`
+   - Establecer iteraciones max, timeouts, criterios DoD
+
+### 2. Bucle Principal
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  BUCLE RALPH                                                 │
+│                                                              │
+│  while (iteraciones < max && !DoD_aprobado) {                │
+│      1. Verificar disyuntor                                  │
+│      2. Invocar Claude con prompt actual                     │
+│      3. Procesar salida                                      │
+│      4. Validar Definition of Done                           │
+│      5. Crear checkpoint (commit git)                        │
+│      6. Si DoD no cumple, usar respuesta como prompt         │
+│  }                                                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 3. Validacion Definition of Done
+
+El sistema DoD valida la completitud mediante multiples criterios:
+
+| Validador | Descripcion |
+|-----------|-------------|
+| `command` | Ejecutar comando shell (tests, lint, build) |
+| `output_contains` | Verificar patron en salida de Claude |
+| `file_changed` | Verificar que archivos fueron modificados |
+| `hook` | Ejecutar hook Claude existente |
+| `human` | Validacion humana interactiva |
+
+Ejemplo DoD en `ralph.yml`:
+
+```yaml
+definition_of_done:
+  checklist:
+    - id: tests
+      name: "Todos los tests pasan"
+      type: command
+      command: "docker compose exec app npm test"
+      required: true
+
+    - id: completion
+      name: "Claude senala completitud"
+      type: output_contains
+      pattern: "<promise>COMPLETE</promise>"
+      required: true
+```
+
+### 4. Disyuntor (Circuit Breaker)
+
+Mecanismo de seguridad para prevenir bucles infinitos:
+
+| Disparador | Umbral | Accion |
+|------------|--------|--------|
+| Sin cambios de archivos | 3 iteraciones | Parar |
+| Errores repetidos | 5 iteraciones | Parar |
+| Declive de salida | 70% | Parar |
+| Max iteraciones | 25 (defecto) | Parar |
+
+### 5. Checkpointing
+
+Se crean checkpoints Git despues de cada iteracion para:
+- **Recuperacion**: Restaurar estado anterior si es necesario
+- **Historial**: Seguir progreso a traves de iteraciones
+- **Revision**: Inspeccionar que cambio en cada paso
+
+## Salida
+
+```
+╔════════════════════════════════════════════════════════════╗
+║     🔁 Ralph Wiggum - Bucle Continuo de Agente IA           ║
+╚════════════════════════════════════════════════════════════╝
+
+✓ Sesion creada: ralph-1704067200-a1b2
+
+ℹ Iniciando bucle Ralph...
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Iteracion 1 de 25
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ℹ Invocando Claude...
+ℹ Verificando criterios DoD...
+  ✓ [tests] Todos los tests pasan - OK
+  ✓ [lint] Sin errores lint - OK
+  ✓ [completion] Claude senala completitud - OK
+
+  Todos los criterios requeridos aprobados!
+
+✓ DoD APROBADO
+
+╔════════════════════════════════════════════════════════════╗
+║     📊 Resumen de Sesion                                    ║
+╚════════════════════════════════════════════════════════════╝
+
+  ID de sesion:        ralph-1704067200-a1b2
+  Iteraciones totales: 3
+  Duracion:            45s
+  Estado DoD:          APROBADO
+  Razon de salida:     dod_complete
+```
+
+## Configuracion
+
+Crear `ralph.yml` en la raiz del proyecto:
+
+```yaml
+version: "1.0"
+
+session:
+  max_iterations: 25
+  timeout: 600000
+
+circuit_breaker:
+  enabled: true
+  no_file_changes_threshold: 3
+
+definition_of_done:
+  checklist:
+    - id: tests
+      type: command
+      command: "npm test"
+      required: true
+    - id: completion
+      type: output_contains
+      pattern: "<promise>COMPLETE</promise>"
+      required: true
+```
+
+## Mejores Practicas
+
+1. **Descripcion clara**: Proporcionar tareas especificas y accionables
+2. **Configurar DoD**: Definir criterios de completitud en `ralph.yml`
+3. **Usar TDD**: Escribir tests primero, dejar que Ralph implemente
+4. **Monitorear progreso**: Observar salidas de iteracion
+5. **Limites razonables**: Ajustar max_iterations segun complejidad
+
+## Ver tambien
+
+- `@ralph-conductor` - Agente para orquestacion Ralph
+- `/common:fix-bug-tdd` - Correccion de bugs con TDD
+- `/project:sprint-dev` - Desarrollo de sprint con TDD

package/Dev/i18n/es/Common/commands/setup-project-context.md

@@ -0,0 +1,286 @@
+---
+name: setup-project-context
+description: Analizar el codigo y configurar el contexto del proyecto interactivamente
+arguments:
+  - name: mode
+    description: Modo de deteccion (--auto preguntas minimas, --full cuestionario completo)
+    required: false
+---
+
+# Configuracion del Contexto del Proyecto
+
+Configura `.claude/rules/00-project-context.md` analizando el codigo y haciendo preguntas especificas.
+
+## Ejecucion
+
+### Fase 1: Deteccion Automatica
+
+Analizar los siguientes archivos y directorios:
+
+**Archivos de Configuracion:**
+- `package.json` → Nombre del proyecto Node.js, dependencias, scripts
+- `composer.json` → Nombre del proyecto PHP, dependencias, framework
+- `pubspec.yaml` → Nombre del proyecto Flutter/Dart, dependencias
+- `requirements.txt` / `pyproject.toml` → Dependencias Python
+- `Cargo.toml` → Proyecto Rust
+- `go.mod` → Modulo Go
+
+**Entorno y Configuracion:**
+- `.env`, `.env.example` → Base de datos, servicios
+- `config/` → Configuracion del framework
+- `docker-compose.yml` → Servicios (DB, Redis, etc.)
+
+**Estructura:**
+- `src/`, `lib/`, `app/` → Ubicacion del codigo fuente
+- `tests/`, `spec/` → Framework de testing
+- `docs/`, `specifications/` → Documentacion
+- `.github/`, `.gitlab-ci.yml` → CI/CD
+
+**Dominio (si aplica):**
+- `src/Entity/`, `src/Domain/` → Entidades de negocio (PHP/Symfony)
+- `lib/models/`, `lib/domain/` → Modelos (Flutter/Dart)
+- `models/`, `schemas/` → Modelos de datos
+- `migrations/` → Esquema de base de datos
+
+Mostrar resultados del analisis:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║             RESULTADOS DEL ANALISIS DEL PROYECTO              ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Informacion Detectada:
+┌─────────────────┬────────────────────────────────┐
+│ Elemento        │ Valor                          │
+├─────────────────┼────────────────────────────────┤
+│ Nombre Proyecto │ {nombre_detectado}             │
+│ Lenguaje        │ {lenguaje_detectado}           │
+│ Framework       │ {framework_detectado}          │
+│ Base de Datos   │ {database_detectada}           │
+│ Testing         │ {testing_detectado}            │
+│ CI/CD           │ {cicd_detectado}               │
+└─────────────────┴────────────────────────────────┘
+
+📁 Estructura del Proyecto:
+{estructura_detectada}
+
+📄 Documentacion Encontrada:
+{docs_detectados}
+
+❌ No Detectado (se preguntara):
+- {elementos_faltantes}
+```
+
+### Fase 2: Preguntas Interactivas
+
+Preguntar solo por informacion NO detectada en la Fase 1.
+Omitir preguntas si se usa el modo `--auto` y existe un valor por defecto razonable.
+
+**Preguntas Esenciales:**
+
+1. **Tipo de Aplicacion** (si no se detecto):
+   ```
+   Que tipo de aplicacion es?
+   [ ] API REST      [ ] Aplicacion Web    [ ] Aplicacion Movil
+   [ ] Herramienta CLI [ ] Libreria/Paquete [ ] Monorepo
+   ```
+
+2. **Dominio de Negocio**:
+   ```
+   Cual es el dominio de negocio?
+   [ ] E-commerce    [ ] Plataforma SaaS   [ ] FinTech
+   [ ] HealthTech    [ ] EdTech            [ ] Social/Comunidad
+   [ ] Media/Contenido [ ] IoT             [ ] Otro: _____
+   ```
+
+3. **Usuarios Objetivo** (2-3 personas):
+   ```
+   Describe a tus usuarios principales:
+
+   Usuario Principal:
+   > Rol: _____
+   > Objetivo principal: _____
+
+   Usuario Secundario (opcional):
+   > Rol: _____
+   > Objetivo principal: _____
+   ```
+
+4. **Requisitos de Cumplimiento**:
+   ```
+   Que requisitos de cumplimiento aplican?
+   [ ] GDPR (Proteccion de datos UE)
+   [ ] HIPAA (Salud EEUU)
+   [ ] PCI-DSS (Tarjetas de pago)
+   [ ] SOC2 (Seguridad)
+   [ ] Ninguno / No aplica
+   ```
+
+**Preguntas Extendidas** (solo con modo `--full`):
+
+5. **Objetivos de Negocio**:
+   ```
+   Objetivos a corto plazo (3-6 meses):
+   > _____
+
+   Objetivos a mediano plazo (6-12 meses):
+   > _____
+   ```
+
+6. **Problemas Conocidos/Deuda Tecnica**:
+   ```
+   Hay problemas conocidos o deuda tecnica a documentar?
+   > _____
+   ```
+
+7. **Terminos del Glosario**:
+   ```
+   Terminos clave de negocio a definir (separados por comas):
+   > _____
+   ```
+
+### Fase 3: Generar Archivo de Contexto
+
+Crear `.claude/rules/00-project-context.md`:
+
+```markdown
+# Contexto del Proyecto - {NOMBRE_PROYECTO}
+
+> Generado automaticamente por `/common:setup-project-context` el {FECHA}
+> Revisar y personalizar segun sea necesario.
+
+## Vision General
+
+**{NOMBRE_PROYECTO}** es una aplicacion {TIPO} para el dominio {DOMINIO}.
+
+{DESCRIPCION_DESDE_README_O_USUARIO}
+
+## Stack Tecnico
+
+| Componente   | Tecnologia           |
+|--------------|----------------------|
+| Lenguaje     | {LENGUAJE}           |
+| Framework    | {FRAMEWORK}          |
+| Base Datos   | {DATABASE}           |
+| Cache        | {CACHE_SI_DETECTADO} |
+| Testing      | {FRAMEWORKS_TEST}    |
+| CI/CD        | {PLATAFORMA_CICD}    |
+
+## Estructura del Proyecto
+
+```
+{ESTRUCTURA_DETECTADA}
+```
+
+## Dominio de Negocio
+
+### Conceptos Clave
+
+{ENTIDADES_SI_DETECTADAS}
+
+### Bounded Contexts
+
+<!-- Agregar si usa DDD -->
+- Contexto 1: ...
+- Contexto 2: ...
+
+## Usuarios y Personas
+
+### {ROL_USUARIO_PRINCIPAL}
+- **Objetivo:** {OBJETIVO_USUARIO_PRINCIPAL}
+- **Puntos de friccion:** Por documentar
+- **Flujos clave:** Por documentar
+
+### {ROL_USUARIO_SECUNDARIO}
+- **Objetivo:** {OBJETIVO_USUARIO_SECUNDARIO}
+- **Puntos de friccion:** Por documentar
+- **Flujos clave:** Por documentar
+
+## Restricciones
+
+### Cumplimiento
+{REQUISITOS_CUMPLIMIENTO}
+
+### Objetivos de Rendimiento
+- Tiempo de carga de pagina: < 3s
+- Tiempo de respuesta API: < 200ms
+- Disponibilidad: 99.9%
+
+### Requisitos de Seguridad
+- Cumplimiento OWASP Top 10
+- Validacion de entrada en todos los endpoints
+- Autenticacion requerida para recursos protegidos
+
+## Objetivos
+
+### Corto plazo
+{OBJETIVOS_CORTO_PLAZO_O_PLACEHOLDER}
+
+### Mediano plazo
+{OBJETIVOS_MEDIANO_PLAZO_O_PLACEHOLDER}
+
+## Problemas Conocidos / Deuda Tecnica
+
+{PROBLEMAS_O_PLACEHOLDER}
+
+## Glosario
+
+| Termino | Definicion |
+|---------|------------|
+{TERMINOS_GLOSARIO_O_EJEMPLOS}
+```
+
+### Fase 4: Validacion y Siguientes Pasos
+
+Mostrar resumen y recomendaciones:
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║              CONTEXTO DEL PROYECTO GENERADO                   ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Archivo creado: .claude/rules/00-project-context.md
+
+Resumen:
+┌─────────────────┬────────────────────────────────┐
+│ Proyecto        │ {NOMBRE_PROYECTO}              │
+│ Tipo            │ {TIPO}                         │
+│ Stack           │ {FRAMEWORK} + {DATABASE}       │
+│ Dominio         │ {DOMINIO}                      │
+│ Cumplimiento    │ {CUMPLIMIENTO}                 │
+│ Personas        │ {CANTIDAD} definidos           │
+└─────────────────┴────────────────────────────────┘
+
+📋 Siguientes Pasos Recomendados:
+
+1. Revisar archivo generado y completar secciones placeholder
+2. Agregar bounded contexts detallados si usa DDD
+3. Documentar flujos de negocio clave
+4. Considerar ejecutar agentes especializados:
+   - @database-architect → Documentar esquema de base de datos
+   - @api-designer → Documentar endpoints de API
+   - @security-reviewer → Revisar restricciones de seguridad
+
+Desea que abra el archivo para revision?
+```
+
+## Modos
+
+| Modo | Comportamiento |
+|------|----------------|
+| (defecto) | Deteccion + preguntas esenciales (tipo, dominio, usuarios, cumplimiento) |
+| `--auto` | Deteccion maxima, omitir preguntas con valores por defecto razonables |
+| `--full` | Todas las preguntas incluyendo objetivos, problemas y glosario |
+
+## Ejemplos
+
+```bash
+# Modo estandar - deteccion y preguntas equilibradas
+/common:setup-project-context
+
+# Modo auto - interaccion minima
+/common:setup-project-context --auto
+
+# Modo completo - cuestionario exhaustivo
+/common:setup-project-context --full
+```