@the-bearded-bear/claude-craft 3.0.2 → 3.1.0

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

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

@@ -0,0 +1,286 @@
+---
+name: setup-project-context
+description: Analyser la codebase et configurer le contexte projet interactivement
+arguments:
+  - name: mode
+    description: Mode de detection (--auto questions minimales, --full questionnaire complet)
+    required: false
+---
+
+# Configuration du Contexte Projet
+
+Configure `.claude/rules/00-project-context.md` en analysant la codebase et en posant des questions ciblees.
+
+## Execution
+
+### Phase 1 : Detection Automatique
+
+Analyser les fichiers et repertoires suivants :
+
+**Fichiers de Configuration :**
+- `package.json` → Nom projet Node.js, dependances, scripts
+- `composer.json` → Nom projet PHP, dependances, framework
+- `pubspec.yaml` → Nom projet Flutter/Dart, dependances
+- `requirements.txt` / `pyproject.toml` → Dependances Python
+- `Cargo.toml` → Projet Rust
+- `go.mod` → Module Go
+
+**Environnement & Config :**
+- `.env`, `.env.example` → Base de donnees, services
+- `config/` → Configuration framework
+- `docker-compose.yml` → Services (DB, Redis, etc.)
+
+**Structure :**
+- `src/`, `lib/`, `app/` → Emplacement code source
+- `tests/`, `spec/` → Framework de test
+- `docs/`, `specifications/` → Documentation
+- `.github/`, `.gitlab-ci.yml` → CI/CD
+
+**Domaine (si applicable) :**
+- `src/Entity/`, `src/Domain/` → Entites metier (PHP/Symfony)
+- `lib/models/`, `lib/domain/` → Modeles (Flutter/Dart)
+- `models/`, `schemas/` → Modeles de donnees
+- `migrations/` → Schema base de donnees
+
+Afficher les resultats d'analyse :
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║             RESULTATS D'ANALYSE DU PROJET                     ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Informations Detectees :
+┌─────────────────┬────────────────────────────────┐
+│ Element         │ Valeur                         │
+├─────────────────┼────────────────────────────────┤
+│ Nom du Projet   │ {nom_detecte}                  │
+│ Langage         │ {langage_detecte}              │
+│ Framework       │ {framework_detecte}            │
+│ Base de Donnees │ {database_detectee}            │
+│ Tests           │ {tests_detectes}               │
+│ CI/CD           │ {cicd_detecte}                 │
+└─────────────────┴────────────────────────────────┘
+
+📁 Structure du Projet :
+{structure_detectee}
+
+📄 Documentation Trouvee :
+{docs_detectees}
+
+❌ Non Detecte (sera demande) :
+- {elements_manquants}
+```
+
+### Phase 2 : Questions Interactives
+
+Poser uniquement les questions pour les informations NON detectees en Phase 1.
+Ignorer les questions si le mode `--auto` est utilise et qu'une valeur par defaut raisonnable existe.
+
+**Questions Essentielles :**
+
+1. **Type d'Application** (si non detecte) :
+   ```
+   Quel type d'application est-ce ?
+   [ ] API REST      [ ] Application Web    [ ] Application Mobile
+   [ ] Outil CLI     [ ] Librairie/Package  [ ] Monorepo
+   ```
+
+2. **Domaine Metier** :
+   ```
+   Quel est le domaine metier ?
+   [ ] E-commerce    [ ] Plateforme SaaS    [ ] FinTech
+   [ ] HealthTech    [ ] EdTech             [ ] Social/Communaute
+   [ ] Media/Contenu [ ] IoT                [ ] Autre : _____
+   ```
+
+3. **Utilisateurs Cibles** (2-3 personas) :
+   ```
+   Decrivez vos utilisateurs principaux :
+
+   Utilisateur Principal :
+   > Role : _____
+   > Objectif principal : _____
+
+   Utilisateur Secondaire (optionnel) :
+   > Role : _____
+   > Objectif principal : _____
+   ```
+
+4. **Exigences de Conformite** :
+   ```
+   Quelles exigences de conformite s'appliquent ?
+   [ ] RGPD (Protection des donnees EU)
+   [ ] HIPAA (Sante US)
+   [ ] PCI-DSS (Cartes de paiement)
+   [ ] SOC2 (Securite)
+   [ ] Aucune / Non applicable
+   ```
+
+**Questions Etendues** (uniquement avec le mode `--full`) :
+
+5. **Objectifs Business** :
+   ```
+   Objectifs court-terme (3-6 mois) :
+   > _____
+
+   Objectifs moyen-terme (6-12 mois) :
+   > _____
+   ```
+
+6. **Problemes Connus/Dette Technique** :
+   ```
+   Y a-t-il des problemes connus ou de la dette technique a documenter ?
+   > _____
+   ```
+
+7. **Termes du Glossaire** :
+   ```
+   Termes metier cles a definir (separes par des virgules) :
+   > _____
+   ```
+
+### Phase 3 : Generer le Fichier de Contexte
+
+Creer `.claude/rules/00-project-context.md` :
+
+```markdown
+# Contexte Projet - {NOM_PROJET}
+
+> Genere automatiquement par `/common:setup-project-context` le {DATE}
+> A revoir et personnaliser selon vos besoins.
+
+## Vue d'Ensemble
+
+**{NOM_PROJET}** est une application {TYPE} pour le domaine {DOMAINE}.
+
+{DESCRIPTION_DEPUIS_README_OU_UTILISATEUR}
+
+## Stack Technique
+
+| Composant    | Technologie          |
+|--------------|----------------------|
+| Langage      | {LANGAGE}            |
+| Framework    | {FRAMEWORK}          |
+| Base Donnees | {DATABASE}           |
+| Cache        | {CACHE_SI_DETECTE}   |
+| Tests        | {FRAMEWORKS_TEST}    |
+| CI/CD        | {PLATEFORME_CICD}    |
+
+## Structure du Projet
+
+```
+{STRUCTURE_DETECTEE}
+```
+
+## Domaine Metier
+
+### Concepts Cles
+
+{ENTITES_SI_DETECTEES}
+
+### Bounded Contexts
+
+<!-- Ajouter si utilisation de DDD -->
+- Contexte 1 : ...
+- Contexte 2 : ...
+
+## Utilisateurs & Personas
+
+### {ROLE_UTILISATEUR_PRINCIPAL}
+- **Objectif :** {OBJECTIF_UTILISATEUR_PRINCIPAL}
+- **Points de friction :** A documenter
+- **Workflows cles :** A documenter
+
+### {ROLE_UTILISATEUR_SECONDAIRE}
+- **Objectif :** {OBJECTIF_UTILISATEUR_SECONDAIRE}
+- **Points de friction :** A documenter
+- **Workflows cles :** A documenter
+
+## Contraintes
+
+### Conformite
+{EXIGENCES_CONFORMITE}
+
+### Objectifs de Performance
+- Temps de chargement page : < 3s
+- Temps de reponse API : < 200ms
+- Disponibilite : 99.9%
+
+### Exigences de Securite
+- Conformite OWASP Top 10
+- Validation des entrees sur tous les endpoints
+- Authentification requise pour les ressources protegees
+
+## Objectifs
+
+### Court-terme
+{OBJECTIFS_COURT_TERME_OU_PLACEHOLDER}
+
+### Moyen-terme
+{OBJECTIFS_MOYEN_TERME_OU_PLACEHOLDER}
+
+## Problemes Connus / Dette Technique
+
+{PROBLEMES_OU_PLACEHOLDER}
+
+## Glossaire
+
+| Terme | Definition |
+|-------|------------|
+{TERMES_GLOSSAIRE_OU_EXEMPLES}
+```
+
+### Phase 4 : Validation & Prochaines Etapes
+
+Afficher le resume et les recommandations :
+
+```
+╔══════════════════════════════════════════════════════════════╗
+║              CONTEXTE PROJET GENERE                           ║
+╚══════════════════════════════════════════════════════════════╝
+
+✅ Fichier cree : .claude/rules/00-project-context.md
+
+Resume :
+┌─────────────────┬────────────────────────────────┐
+│ Projet          │ {NOM_PROJET}                   │
+│ Type            │ {TYPE}                         │
+│ Stack           │ {FRAMEWORK} + {DATABASE}       │
+│ Domaine         │ {DOMAINE}                      │
+│ Conformite      │ {CONFORMITE}                   │
+│ Personas        │ {NOMBRE} definis               │
+└─────────────────┴────────────────────────────────┘
+
+📋 Prochaines Etapes Recommandees :
+
+1. Revoir le fichier genere et completer les sections placeholder
+2. Ajouter des bounded contexts detailles si utilisation de DDD
+3. Documenter les workflows metier cles
+4. Envisager d'executer des agents specialises :
+   - @database-architect → Documenter le schema de base de donnees
+   - @api-designer → Documenter les endpoints API
+   - @security-reviewer → Revoir les contraintes de securite
+
+Voulez-vous que j'ouvre le fichier pour revision ?
+```
+
+## Modes
+
+| Mode | Comportement |
+|------|--------------|
+| (defaut) | Detection + questions essentielles (type, domaine, utilisateurs, conformite) |
+| `--auto` | Detection maximale, ignorer les questions avec valeurs par defaut raisonnables |
+| `--full` | Toutes les questions incluant objectifs, problemes et glossaire |
+
+## Exemples
+
+```bash
+# Mode standard - detection et questions equilibrees
+/common:setup-project-context
+
+# Mode auto - interaction minimale
+/common:setup-project-context --auto
+
+# Mode complet - questionnaire exhaustif
+/common:setup-project-context --full
+```