@the-bearded-bear/claude-craft 3.0.0

package/Dev/i18n/fr/Common/hooks/scripts/session-init.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# Session initialization hook: Load project context at startup
+# This runs on SessionStart event
+set -e
+
+# Read JSON input from stdin
+INPUT=$(cat)
+CWD=$(echo "$INPUT" | jq -r '.cwd // "."')
+
+cd "$CWD" 2>/dev/null || true
+
+# Set environment variables if CLAUDE_ENV_FILE is provided
+if [ -n "$CLAUDE_ENV_FILE" ]; then
+    # Detect and set appropriate environment
+
+    # Node.js
+    if [ -f "package.json" ]; then
+        echo 'export NODE_ENV=development' >> "$CLAUDE_ENV_FILE"
+    fi
+
+    # Load .env.local or .env.development if exists (without secrets)
+    if [ -f ".env.local" ]; then
+        # Only export non-sensitive variables
+        grep -v -E "(PASSWORD|SECRET|KEY|TOKEN)" .env.local >> "$CLAUDE_ENV_FILE" 2>/dev/null || true
+    fi
+fi
+
+# Build context information for Claude
+build_context() {
+    local context=""
+
+    # Detect framework/stack
+    if [ -f "composer.json" ]; then
+        local symfony_version=$(jq -r '.require["symfony/framework-bundle"] // empty' composer.json 2>/dev/null)
+        local php_version=$(jq -r '.require.php // empty' composer.json 2>/dev/null)
+        [ -n "$symfony_version" ] && context+="Symfony $symfony_version, "
+        [ -n "$php_version" ] && context+="PHP $php_version, "
+    fi
+
+    if [ -f "package.json" ]; then
+        local node_version=$(jq -r '.engines.node // empty' package.json 2>/dev/null)
+        local react_version=$(jq -r '.dependencies.react // empty' package.json 2>/dev/null)
+        local next_version=$(jq -r '.dependencies.next // empty' package.json 2>/dev/null)
+        [ -n "$react_version" ] && context+="React $react_version, "
+        [ -n "$next_version" ] && context+="Next.js $next_version, "
+    fi
+
+    if [ -f "pubspec.yaml" ]; then
+        context+="Flutter/Dart, "
+    fi
+
+    if [ -f "pyproject.toml" ]; then
+        context+="Python, "
+    fi
+
+    # Database detection
+    if [ -f "docker-compose.yml" ] || [ -f "docker-compose.yaml" ]; then
+        grep -q "postgres" docker-compose.yml 2>/dev/null && context+="PostgreSQL, "
+        grep -q "mysql" docker-compose.yml 2>/dev/null && context+="MySQL, "
+        grep -q "redis" docker-compose.yml 2>/dev/null && context+="Redis, "
+    fi
+
+    # Remove trailing comma
+    context="${context%, }"
+
+    echo "$context"
+}
+
+CONTEXT=$(build_context)
+
+if [ -n "$CONTEXT" ]; then
+    echo "{\"hookSpecificOutput\": {\"hookEventName\": \"SessionStart\", \"additionalContext\": \"Project stack: $CONTEXT\"}}"
+else
+    echo '{"continue": true}'
+fi
+
+exit 0

package/Dev/i18n/fr/Common/hooks/templates/settings-hooks.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://claude.ai/settings-schema.json",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash(git commit:*)",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/pre-commit-check.sh",
+            "timeout": 30
+          }
+        ]
+      },
+      {
+        "matcher": "Bash(rm -rf:*)",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/block-dangerous-commands.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/post-edit-lint.sh",
+            "timeout": 60
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/quality-gate.sh",
+            "timeout": 120
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/session-init.sh",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "permission_prompt",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/notify-slack.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/Dev/i18n/fr/Common/mcp/MCP-QUICKSTART.md

@@ -0,0 +1,79 @@
+# MCP Quick Start Guide
+
+Model Context Protocol (MCP) extends Claude Code with external tools and data sources.
+
+## Quick Setup
+
+### 1. Context7 (Recommended - Up-to-date Documentation)
+
+Create `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    }
+  }
+}
+```
+
+Usage: Add "use context7" to any prompt for up-to-date library documentation.
+
+### 2. GitHub Integration
+
+```json
+{
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}
+```
+
+Set your token: `export GITHUB_TOKEN=ghp_xxx`
+
+### 3. Database (PostgreSQL)
+
+```json
+{
+  "mcpServers": {
+    "postgres": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres"],
+      "env": {
+        "POSTGRES_CONNECTION_STRING": "${DATABASE_URL}"
+      }
+    }
+  }
+}
+```
+
+## Available Templates
+
+| Template | Servers Included |
+|----------|------------------|
+| `context7.mcp.json` | Context7 documentation |
+| `github.mcp.json` | GitHub integration |
+| `postgres.mcp.json` | PostgreSQL database |
+| `slack.mcp.json` | Slack messaging |
+| `full-stack.mcp.json` | All of the above |
+
+## Example Usage
+
+```
+You: use context7 to help me implement Symfony forms
+
+Claude: [Fetches current Symfony 7.2 form documentation]
+        Here's how to create forms in Symfony 7.2...
+```
+
+## More Information
+
+See the full documentation: [docs/MCP.md](/docs/MCP.md)

package/Dev/i18n/fr/Common/mcp/templates/context7.mcp.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://claude.ai/mcp-schema.json",
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    }
+  }
+}

package/Dev/i18n/fr/Common/mcp/templates/full-stack.mcp.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://claude.ai/mcp-schema.json",
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      }
+    },
+    "postgres": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres"],
+      "env": {
+        "POSTGRES_CONNECTION_STRING": "${DATABASE_URL}"
+      }
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
+    }
+  }
+}

package/Dev/i18n/fr/Common/mcp/templates/github.mcp.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://claude.ai/mcp-schema.json",
+  "mcpServers": {
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": {
+        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
+      }
+    }
+  }
+}

package/Dev/i18n/fr/Common/mcp/templates/postgres.mcp.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://claude.ai/mcp-schema.json",
+  "mcpServers": {
+    "postgres": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-postgres"],
+      "env": {
+        "POSTGRES_CONNECTION_STRING": "${DATABASE_URL}"
+      }
+    }
+  }
+}

package/Dev/i18n/fr/Common/mcp/templates/slack.mcp.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://claude.ai/mcp-schema.json",
+  "mcpServers": {
+    "slack": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-slack"],
+      "env": {
+        "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}",
+        "SLACK_TEAM_ID": "${SLACK_TEAM_ID}"
+      }
+    }
+  }
+}

package/Dev/i18n/fr/Common/rules/00-project-context.md.template

@@ -0,0 +1,118 @@
+# Contexte Projet - {{PROJECT_NAME}}
+
+## Vue d'ensemble
+
+**{{PROJECT_NAME}}** est une application ...
+
+<!-- Décrivez brièvement le projet, son objectif et ses utilisateurs cibles -->
+
+## Domaine Métier
+
+### Concepts Clés
+
+#### Entité Principale 1
+- **Définition** : ...
+- **Propriétés** : ...
+- **Statuts** : ...
+- **Règles métier** :
+  - ...
+
+#### Entité Principale 2
+- **Définition** : ...
+- **Propriétés** : ...
+- **Statuts** : ...
+- **Règles métier** :
+  - ...
+
+### Bounded Contexts Identifiés (DDD)
+
+#### 1. Context 1
+**Responsabilité** : ...
+- Entités : ...
+- Use Cases :
+  - ...
+
+#### 2. Context 2
+**Responsabilité** : ...
+- Entités : ...
+- Use Cases :
+  - ...
+
+## Utilisateurs
+
+### Utilisateur Type 1
+- **Actions** : ...
+- **Besoins** : ...
+- **Contraintes** : ...
+
+### Utilisateur Type 2
+- **Actions** : ...
+- **Besoins** : ...
+- **Contraintes** : ...
+
+## Contraintes Techniques et Réglementaires
+
+### Conformité (RGPD, HIPAA, etc.)
+- **Données sensibles** : ...
+- **Obligations** :
+  - ...
+
+### Performance
+- **Objectifs** :
+  - Temps chargement page < 2s
+  - Time to Interactive < 3s
+  - Score Lighthouse > 90
+- **Stratégies** :
+  - Cache
+  - Lazy loading
+  - Pagination
+  - Optimisation requêtes
+
+### Sécurité (OWASP Top 10)
+- **Protections** :
+  - Validation inputs (XSS, injection)
+  - CSRF tokens sur formulaires
+  - Headers sécurité (CSP, HSTS, X-Frame-Options)
+  - Rate limiting
+  - Logs accès
+
+## Objectifs Business
+
+### Court terme (3 mois)
+1. ...
+2. ...
+
+### Moyen terme (6 mois)
+1. ...
+2. ...
+
+### Long terme (12 mois)
+1. ...
+2. ...
+
+## Stack Technique
+
+{{TECH_STACK}}
+
+## Problèmes Actuels Identifiés
+
+### Problème 1
+- **Problème** : ...
+- **Impact** : ...
+- **Solution** : ...
+
+### Problème 2
+- **Problème** : ...
+- **Impact** : ...
+- **Solution** : ...
+
+## Glossaire Métier (Ubiquitous Language)
+
+| Terme Français | Terme Code (English) | Définition |
+|----------------|----------------------|------------|
+| ... | ... | ... |
+
+## Références
+
+- **Documentation** : ...
+- **Spécifications** : ...

package/Dev/i18n/fr/Common/rules/01-workflow-analysis.md

@@ -0,0 +1,226 @@
+# Workflow d'Analyse Obligatoire
+
+## Principe Fondamental
+
+**AVANT toute modification de code (feature, bugfix, refactoring), une phase d'analyse approfondie est OBLIGATOIRE.**
+
+Cette règle est CRITIQUE et NON NÉGOCIABLE. Elle évite :
+- Les régressions
+- Les effets de bord inattendus
+- La dette technique
+- Les bugs en production
+
+---
+
+## Processus en 4 Étapes
+
+### Étape 1 : Comprendre la Demande
+
+**Questions à se poser :**
+1. Quel est l'objectif précis ?
+2. Quels sont les critères d'acceptation ?
+3. Y a-t-il des contraintes (performance, sécurité, conformité) ?
+4. Quel est l'impact utilisateur ?
+
+**Actions :**
+- Reformuler la demande pour validation
+- Identifier les use cases concernés
+- Vérifier l'alignement avec les objectifs business
+
+### Étape 2 : Analyser le Code Existant
+
+**Fichiers à lire OBLIGATOIREMENT :**
+1. Les fichiers directement concernés par la modification
+2. Les fichiers dépendants (qui utilisent le code modifié)
+3. Les tests existants (pour comprendre le comportement attendu)
+4. Les migrations de schéma (si impact sur la base de données)
+
+**Points de vigilance :**
+- Y a-t-il des tests qui vont casser ?
+- Y a-t-il d'autres modules qui dépendent de ce code ?
+- Le code respecte-t-il l'architecture du projet ?
+- Y a-t-il des données sensibles ?
+
+### Étape 3 : Documenter l'Analyse
+
+**Contenu obligatoire :**
+
+1. **Objectif** : Description claire de la modification
+2. **Fichiers impactés** : Liste exhaustive avec justification
+3. **Impacts** :
+   - Breaking changes : oui/non
+   - Migration DB nécessaire : oui/non
+   - Impact performance : oui/non
+   - Données sensibles : oui/non
+4. **Risques** : Liste + mitigations
+5. **Approche** : Stratégie d'implémentation (TDD, refactoring progressif, etc.)
+6. **Tests TDD** : Liste des tests à écrire AVANT implémentation
+
+**Exemple :**
+
+```markdown
+## Analyse : Ajout d'une fonctionnalité de notification
+
+### Objectif
+Envoyer une notification email lors de la création d'une commande.
+
+### Fichiers impactés
+- OrderService (ajout dispatch event)
+- NotificationListener (nouveau)
+- EmailService (utilisation existante)
+- Tests unitaires pour le listener
+
+### Impacts
+- Breaking change : NON
+- Migration DB : NON
+- Performance : Faible (async recommandé)
+- Données sensibles : Email utilisateur (déjà géré)
+
+### Risques
+1. Surcharge email → Mitigation : queue async
+2. Email en spam → Mitigation : configuration DKIM/SPF
+
+### Approche
+1. TDD : écrire tests du listener
+2. Implémenter le listener
+3. Dispatcher l'event depuis OrderService
+4. Tester intégration
+
+### Tests TDD
+1. test_should_send_email_on_order_created()
+2. test_should_not_send_if_user_opted_out()
+3. test_should_handle_email_failure_gracefully()
+```
+
+### Étape 4 : Validation
+
+**Critères de décision :**
+
+| Impact | Action |
+|--------|--------|
+| **Faible** (1 fichier, pas de breaking change, < 1h) | Procéder directement |
+| **Moyen** (2-5 fichiers, migration DB, < 4h) | Valider avec l'utilisateur |
+| **Fort** (> 5 fichiers, breaking changes, refactoring archi) | Planification détaillée + validation obligatoire |
+
+**Questions de validation :**
+- L'approche respecte-t-elle l'architecture du projet ?
+- Les tests TDD sont-ils suffisants ?
+- Y a-t-il une alternative plus simple (KISS) ?
+- Les risques sont-ils acceptables ?
+
+---
+
+## Anti-Patterns à Éviter
+
+### ❌ Coder sans lire le code existant
+
+```
+// MAUVAIS : modification sans comprendre l'impact
+function updateOrder(order) {
+  order.status = "confirmed"  // ⚠️ Impact sur d'autres modules ?
+}
+```
+
+### ❌ Ignorer les dépendances
+
+```
+// MAUVAIS : modification sans vérifier qui utilise cette méthode
+function getPrice() {
+  return this.price * 0.8  // ⚠️ Qui appelle getPrice() ?
+}
+```
+
+### ❌ Oublier les tests
+
+```
+// MAUVAIS : pas de vérification des tests existants
+// Si je modifie User, quels tests vont casser ?
+```
+
+### ❌ Ignorer la sécurité
+
+```
+// MAUVAIS : ajouter un champ sensible sans protection
+class User {
+  socialSecurityNumber: string  // ⚠️ Données sensibles !
+}
+```
+
+---
+
+## Checklist Rapide
+
+Avant toute modification :
+
+- [ ] J'ai lu et compris la demande
+- [ ] J'ai lu les fichiers concernés
+- [ ] J'ai identifié les dépendances
+- [ ] J'ai documenté l'analyse
+- [ ] J'ai évalué les risques
+- [ ] J'ai défini les tests TDD
+- [ ] J'ai validé l'approche (si impact moyen/fort)
+- [ ] J'ai vérifié la conformité architecture + SOLID
+- [ ] J'ai vérifié sécurité si données sensibles
+
+---
+
+## Workflow Visuel
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    DEMANDE REÇUE                            │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│             ÉTAPE 1 : COMPRENDRE                            │
+│  - Objectif précis ?                                        │
+│  - Critères d'acceptation ?                                 │
+│  - Contraintes ?                                            │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│             ÉTAPE 2 : ANALYSER                              │
+│  - Lire les fichiers concernés                              │
+│  - Identifier les dépendances                               │
+│  - Vérifier les tests existants                             │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│             ÉTAPE 3 : DOCUMENTER                            │
+│  - Fichiers impactés                                        │
+│  - Risques + mitigations                                    │
+│  - Tests TDD à écrire                                       │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│             ÉTAPE 4 : VALIDER                               │
+│  - Impact faible → Procéder                                 │
+│  - Impact moyen/fort → Demander validation                  │
+└─────────────────────────┬───────────────────────────────────┘
+                          │
+                          ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    IMPLÉMENTER                              │
+│  1. Écrire les tests (RED)                                  │
+│  2. Implémenter le code (GREEN)                             │
+│  3. Refactorer (REFACTOR)                                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Templates Associés
+
+- `templates/analysis.md` - Template analyse détaillée
+- `checklists/new-feature.md` - Checklist nouvelle feature
+- `checklists/refactoring.md` - Checklist refactoring
+
+---
+
+**Date de dernière mise à jour:** 2025-01
+**Version:** 1.0.0
+**Auteur:** The Bearded CTO