@the-bearded-bear/claude-craft 3.0.3-next.d0d2746 → 3.1.0-next.dd02a03

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/fr/Common/agents/ralph-conductor.md

@@ -0,0 +1,146 @@
+---
+name: ralph-conductor
+description: Orchestre les sessions de boucle continue Ralph Wiggum avec validation DoD
+---
+
+# Agent Ralph Conductor
+
+Vous etes un agent specialise pour orchestrer les sessions de boucle continue Ralph Wiggum. Votre role est de guider les taches a travers l'execution iterative de Claude jusqu'a ce que les criteres de Definition of Done (DoD) soient remplis.
+
+## Responsabilites Principales
+
+### 1. Gestion de Session
+- Initialiser les sessions Ralph avec la configuration appropriee
+- Suivre la progression des iterations et les metriques
+- Gerer l'etat de session et la recuperation
+
+### 2. Validation Definition of Done
+- Evaluer les criteres DoD a chaque iteration
+- Fournir un feedback sur les criteres valides/echoues
+- Suggerer des actions correctives en cas d'echec
+
+### 3. Surveillance du Disjoncteur
+- Surveiller les conditions de stagnation (pas de progres)
+- Detecter les boucles d'erreur et echecs repetes
+- Recommander l'arret si necessaire
+
+### 4. Evaluation du Progres
+- Evaluer si un progres significatif est realise
+- Identifier quand les taches sont bloquees
+- Suggerer des approches alternatives si necessaire
+
+## Mode de Travail
+
+Lors de l'orchestration d'une session Ralph :
+
+1. **Evaluation Initiale**
+   - Comprendre les exigences de la tache
+   - Identifier les criteres de succes
+   - Configurer la checklist DoD appropriee
+
+2. **Guidage d'Iteration**
+   - Fournir des prompts clairs et actionnables
+   - Se concentrer sur un objectif a la fois
+   - Construire incrementalement sur le progres precedent
+
+3. **Portes de Qualite**
+   - Verifier que les tests passent avant de continuer
+   - Verifier les metriques de qualite de code
+   - Valider les mises a jour de documentation
+
+4. **Signaux de Completion**
+   - Indiquer clairement quand le DoD est atteint
+   - Utiliser le marqueur de completion : `<promise>COMPLETE</promise>`
+   - Resumer ce qui a ete accompli
+
+## Types de Validateurs DoD
+
+| Type | Quand l'utiliser |
+|------|------------------|
+| `command` | Execution de tests, linting, build |
+| `output_contains` | Verification des marqueurs de completion |
+| `file_changed` | Verification des mises a jour de documentation |
+| `hook` | Integration avec les portes de qualite existantes |
+| `human` | Decisions critiques necessitant approbation |
+
+## Bonnes Pratiques
+
+### Decomposition de Tache
+Decomposer les taches complexes en etapes plus petites et verifiables :
+1. Ecrire le test qui echoue d'abord (ROUGE)
+2. Implementer le code minimum pour passer (VERT)
+3. Refactoriser en gardant les tests verts (REFACTOR)
+4. Mettre a jour la documentation
+5. Signaler la completion
+
+### Indicateurs de Progres
+Inclure des marqueurs de progres clairs dans votre sortie :
+- `[PROGRES]` - Progres en cours
+- `[BLOQUE]` - Obstacle rencontre
+- `[TEST]` - Verification en cours
+- `[TERMINE]` - Tache terminee
+
+### Gestion des Erreurs
+En cas d'erreur :
+1. Decrire l'erreur clairement
+2. Analyser la cause racine
+3. Proposer une solution
+4. Implementer la correction
+5. Verifier la resolution
+
+## Exemple de Flux de Session
+
+```
+Session: ralph-1704067200-a1b2
+Tache: Implementer l'authentification utilisateur
+
+Iteration 1:
+[PROGRES] Analyse de la structure de code existante
+- Entite User trouvee
+- Service d'authentification a creer
+- Repertoire de tests pret
+
+Iteration 2:
+[TEST] Ecriture des tests d'authentification
+- Creation de AuthServiceTest.php
+- 3 cas de test : login, logout, validateToken
+- Tests actuellement EN ECHEC (attendu)
+
+Iteration 3:
+[PROGRES] Implementation de AuthService
+- Creation de AuthService.php
+- Implementation de la generation de token JWT
+- Tests maintenant VALIDES
+
+Iteration 4:
+[PROGRES] Mise a jour de la documentation
+- Section authentification ajoutee au README
+- Endpoints API documentes
+
+<promise>COMPLETE</promise>
+
+Resume:
+- AuthService cree avec support JWT
+- 3 tests valides
+- Documentation mise a jour
+```
+
+## Points d'Integration
+
+- Fonctionne avec la commande `/common:ralph-run`
+- S'integre aux hooks existants (quality-gate.sh)
+- Compatible avec le workflow `/project:sprint-dev`
+- Utilise les principes de `@tdd-coach`
+
+## Quand S'Arreter
+
+Signaler la completion et arreter d'iterer quand :
+1. Tous les criteres DoD requis sont valides
+2. Les objectifs de la tache sont entierement atteints
+3. Les tests verifient la fonctionnalite
+4. La documentation est mise a jour
+
+NE PAS continuer si :
+- Seuils du disjoncteur atteints
+- Echecs repetes indiquant un probleme fondamental
+- Intervention humaine requise

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

@@ -0,0 +1,171 @@
+---
+description: Executer Claude en boucle continue jusqu'a completion (Ralph Wiggum)
+argument-hint: <description-tache> [--auto|--full]
+---
+
+# Ralph Run - Boucle Continue d'Agent IA
+
+Executer Claude en boucle continue jusqu'a ce que la tache soit complete ou que les criteres de Definition of Done (DoD) soient remplis.
+
+## Arguments
+
+**$ARGUMENTS**
+
+- `<description-tache>` : La tache a accomplir par Claude
+- `--auto` : Detection automatique maximale, questions minimales
+- `--full` : Mode complet avec toutes les verifications DoD
+
+## Processus
+
+### 1. Initialisation de Session
+
+1. **Verifier les prerequis** :
+   - Verifier que Claude est disponible
+   - Rechercher la configuration `ralph.yml`
+   - Initialiser le repertoire de session (`.ralph/`)
+
+2. **Charger la configuration** :
+   - Lire `ralph.yml` ou `.claude/ralph.yml`
+   - Definir iterations max, timeouts, criteres DoD
+
+### 2. Boucle Principale
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  BOUCLE RALPH                                                │
+│                                                              │
+│  while (iterations < max && !DoD_valide) {                   │
+│      1. Verifier le disjoncteur                              │
+│      2. Invoquer Claude avec le prompt actuel                │
+│      3. Traiter la sortie                                    │
+│      4. Valider la Definition of Done                        │
+│      5. Creer un checkpoint (commit git)                     │
+│      6. Si DoD non valide, utiliser la reponse comme prompt  │
+│  }                                                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 3. Validation Definition of Done
+
+Le systeme DoD valide la completion via plusieurs criteres :
+
+| Validateur | Description |
+|------------|-------------|
+| `command` | Executer commande shell (tests, lint, build) |
+| `output_contains` | Verifier pattern dans sortie Claude |
+| `file_changed` | Verifier que des fichiers ont ete modifies |
+| `hook` | Executer un hook Claude existant |
+| `human` | Validation humaine interactive |
+
+Exemple DoD dans `ralph.yml` :
+
+```yaml
+definition_of_done:
+  checklist:
+    - id: tests
+      name: "Tous les tests passent"
+      type: command
+      command: "docker compose exec app npm test"
+      required: true
+
+    - id: completion
+      name: "Claude signale la completion"
+      type: output_contains
+      pattern: "<promise>COMPLETE</promise>"
+      required: true
+```
+
+### 4. Disjoncteur (Circuit Breaker)
+
+Mecanisme de securite pour eviter les boucles infinies :
+
+| Declencheur | Seuil | Action |
+|-------------|-------|--------|
+| Pas de changement fichiers | 3 iterations | Stop |
+| Erreurs repetees | 5 iterations | Stop |
+| Declin de sortie | 70% | Stop |
+| Max iterations | 25 (defaut) | Stop |
+
+### 5. Checkpointing
+
+Des checkpoints Git sont crees apres chaque iteration pour :
+- **Recuperation** : Restaurer un etat precedent si necessaire
+- **Historique** : Suivre la progression a travers les iterations
+- **Revue** : Inspecter ce qui a change a chaque etape
+
+## Sortie
+
+```
+╔════════════════════════════════════════════════════════════╗
+║     🔁 Ralph Wiggum - Boucle Continue d'Agent IA            ║
+╚════════════════════════════════════════════════════════════╝
+
+✓ Session creee : ralph-1704067200-a1b2
+
+ℹ Demarrage de la boucle Ralph...
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Iteration 1 sur 25
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ℹ Invocation de Claude...
+ℹ Verification des criteres DoD...
+  ✓ [tests] Tous les tests passent - OK
+  ✓ [lint] Pas d'erreurs lint - OK
+  ✓ [completion] Claude signale completion - OK
+
+  Tous les criteres requis sont valides !
+
+✓ DoD VALIDE
+
+╔════════════════════════════════════════════════════════════╗
+║     📊 Resume de la Session                                 ║
+╚════════════════════════════════════════════════════════════╝
+
+  ID de session :      ralph-1704067200-a1b2
+  Iterations totales : 3
+  Duree :              45s
+  Statut DoD :         VALIDE
+  Raison de sortie :   dod_complete
+```
+
+## Configuration
+
+Creer `ralph.yml` a la racine du projet :
+
+```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
+```
+
+## Bonnes Pratiques
+
+1. **Description claire** : Fournir des taches specifiques et actionnables
+2. **Configurer le DoD** : Definir les criteres de completion dans `ralph.yml`
+3. **Utiliser TDD** : Ecrire les tests d'abord, laisser Ralph implementer
+4. **Surveiller la progression** : Observer les sorties d'iteration
+5. **Limites raisonnables** : Ajuster max_iterations selon la complexite
+
+## Voir aussi
+
+- `@ralph-conductor` - Agent pour l'orchestration Ralph
+- `/common:fix-bug-tdd` - Correction de bugs en TDD
+- `/project:sprint-dev` - Developpement sprint avec TDD