Initial commit

skills/running-quality-gate/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: running-quality-gate
+description: Executes all quality checks (format, lint, tests, i18n, coverage). Use before commits, PRs, or releases to ensure quality standards
+allowed-tools: Read, Grep, Glob, Bash
+---
+
+# Porte de Qualité
+
+Exécute vérifications de qualité pour garantir standards avant commit/merge/release.
+
+## Table des matières
+
+- [Quand utiliser](#quand-utiliser)
+- [Standards obligatoires](#standards-obligatoires)
+- [Scripts npm](#scripts-npm)
+- [Workflow séquentiel](#workflow-séquentiel)
+- [Gestion des échecs](#gestion-des-échecs)
+- [Checklist avant commit](#checklist-avant-commit)
+- [En cas de doute](#en-cas-de-doute)
+
+## Quand utiliser
+
+- Avant créer commit
+- Avant créer PR
+- Avant merger vers main
+- Avant release
+- En CI/CD pipeline
+
+## Standards obligatoires
+
+**MUST PASS :**
+
+1. Formatage code (Prettier)
+2. Linting (ESLint)
+3. Tests unitaires (Jest)
+4. Couverture ≥ 80% (Branches, Functions, Lines, Statements)
+5. i18n synchronisé (fr.json, en.json, es.json)
+
+**Recommandés :**
+
+- Pas d'erreurs console
+- Dead code vérifié
+- Audit sécurité (`npm audit`)
+
+## Scripts npm
+
+Trouve et utilise :
+
+- `npm run format:check` - Vérifier formatage
+- `npm run format` - Formater automatiquement
+- `npm run lint` - Linter
+- `npm run lint:fix` - Auto-fix linting
+- `npm test` ou `npm run verify` - Tests + coverage
+- `npm run i18n:compare` - Synchronisation traductions
+- `npm run dead-code` - Détection code mort
+
+## Workflow séquentiel
+
+1. **Format :** `npm run format:check`
+   - Si ✗ : `npm run format` → commit changements
+2. **Lint :** `npm run lint`
+   - Si ✗ : `npm run lint:fix` ou corrige manuellement
+3. **Tests :** `npm test`
+   - Si ✗ : Identifier/corriger test échoué
+4. **Coverage :** Vérifier rapport (≥ 80%)
+   - Si < 80% : Ajouter tests manquants
+5. **i18n :** `npm run i18n:compare`
+   - Si désynchronisé : Ajouter clés manquantes
+6. **Optionnels :** dead-code, audit
+
+**Total : < 2 min**
+
+## Gestion des échecs
+
+| Problème          | Solution                  |
+| ----------------- | ------------------------- |
+| Format échoue     | `npm run format` → commit |
+| Lint auto-fixable | `npm run lint:fix`        |
+| Tests échouent    | Debug test, corriger code |
+| Coverage < 80%    | Ajouter tests critiques   |
+| i18n désyncé      | Ajouter clés manquantes   |
+
+## Checklist avant commit
+
+- [ ] format:check ✅
+- [ ] lint ✅
+- [ ] tests ✅ (pas de .skip)
+- [ ] coverage ≥ 80%
+- [ ] i18n synchronisé
+- [ ] console clean (pas de console.log)
+- [ ] Code logiquement correct
+- [ ] Commit message descriptif
+
+## En cas de doute
+
+**Règles absolues :**
+
+1. Lancer TOUS les scripts avant commit
+2. Ne JAMAIS bypass vérifications
+3. Corriger erreurs une par une
+4. Re-lancer quality gate jusqu'à 100% pass
+5. CI/CD doit être vert avant merge
+
+**Exécution rapide :**
+
+```bash
+npm run format:check && npm run lint && npm test
+```
+
+**Références :**
+
+- Scripts npm (package.json)
+- ESLint config (eslint.config.js)
+- Prettier config (.prettierrc)
+- Jest config (jest.config.cjs)
+- CI/CD (.gitlab-ci.yml or .github/workflows)