mdma-cli 2.1.0 → 3.0.0

package/README.md

@@ -8,12 +8,27 @@ Opinionated rules for Claude Code agents.
 npx mdma-cli add
 ```
 
-Installs rules to `.claude/rules/mdma/`:
+Installs default rules to `.claude/rules/mdma/`:
 - `workflow.md` - agent workflow
 - `git.md` - git conventions
 - `style.md` - response style
 - `models.md` - model selection by task complexity
 
+## Commands
+
+```bash
+npx mdma-cli add              # Install default rules
+npx mdma-cli add <template>   # Install a specific template
+npx mdma-cli list             # List available templates
+npx mdma-cli help             # Show help
+```
+
+## Templates
+
+Templates are project-specific rule sets. Use `npx mdma-cli list` to see available templates.
+
+Common rules (`models.md`, `style.md`) are always included. Template-specific rules (`workflow.md`, `git.md`) can override defaults.
+
 ## Update
 
 Run `npx mdma-cli add` again. The `mdma/` folder is replaced with the latest rules. Your custom rules outside this folder are preserved.

package/bin/init.js

@@ -1,45 +1,112 @@
 #!/usr/bin/env node
 
-import { copyFileSync, mkdirSync, rmSync, readdirSync } from 'fs';
+import { copyFileSync, mkdirSync, rmSync, readdirSync, existsSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const RULES_SRC = join(__dirname, '..', '.claude', 'rules', 'mdma');
+const PKG_ROOT = join(__dirname, '..');
+const RULES_COMMON = join(PKG_ROOT, '.claude', 'rules', 'mdma');
+const RULES_DEFAULT = join(RULES_COMMON, 'default');
+const TEMPLATES_DIR = join(PKG_ROOT, 'project-templates');
 const RULES_DEST = join(process.cwd(), '.claude', 'rules', 'mdma');
 
 function showHelp() {
   console.log('mdma-cli - Opinionated rules for code agents\n');
   console.log('Usage:');
-  console.log('  npx mdma-cli add     Install rules to .claude/rules/mdma/');
-  console.log('  npx mdma-cli help    Show this help\n');
+  console.log('  npx mdma-cli add [template]  Install rules to .claude/rules/mdma/');
+  console.log('  npx mdma-cli list            List available templates');
+  console.log('  npx mdma-cli help            Show this help\n');
+  console.log('Examples:');
+  console.log('  npx mdma-cli add             Install default rules');
+  console.log('  npx mdma-cli add arte-player Install arte-player template\n');
 }
 
-function add() {
-  console.log('mdma-cli - Installing rules\n');
+function listTemplates() {
+  console.log('mdma-cli - Available templates\n');
+
+  if (!existsSync(TEMPLATES_DIR)) {
+    console.log('  (no templates found)\n');
+    return;
+  }
+
+  const templates = readdirSync(TEMPLATES_DIR, { withFileTypes: true })
+    .filter(d => d.isDirectory())
+    .map(d => d.name);
+
+  if (templates.length === 0) {
+    console.log('  (no templates found)\n');
+    return;
+  }
+
+  console.log('  default (built-in)');
+  for (const template of templates) {
+    console.log(`  ${template}`);
+  }
+  console.log(`\nUsage: npx mdma-cli add <template>\n`);
+}
+
+function copyMdFiles(srcDir, destDir, label) {
+  if (!existsSync(srcDir)) {
+    console.log(`  [skip] ${label} (not found)`);
+    return 0;
+  }
+
+  const files = readdirSync(srcDir).filter(f => f.endsWith('.md'));
+
+  for (const file of files) {
+    copyFileSync(join(srcDir, file), join(destDir, file));
+    console.log(`  [ok] ${file}`);
+  }
+
+  return files.length;
+}
+
+function add(templateName) {
+  const isDefault = !templateName || templateName === 'default';
+  const templateDir = isDefault ? RULES_DEFAULT : join(TEMPLATES_DIR, templateName);
+
+  // Validate template exists
+  if (!isDefault && !existsSync(templateDir)) {
+    console.error(`Error: Template "${templateName}" not found.\n`);
+    console.log('Available templates:');
+    listTemplates();
+    process.exit(1);
+  }
+
+  console.log(`mdma-cli - Installing ${isDefault ? 'default' : templateName} rules\n`);
 
   // Remove existing mdma rules folder
   rmSync(RULES_DEST, { recursive: true, force: true });
   mkdirSync(RULES_DEST, { recursive: true });
 
-  // Copy all .md files from source
-  const files = readdirSync(RULES_SRC).filter(f => f.endsWith('.md'));
+  let total = 0;
 
-  for (const file of files) {
-    copyFileSync(join(RULES_SRC, file), join(RULES_DEST, file));
+  // Copy common rules (models.md, style.md)
+  const commonFiles = readdirSync(RULES_COMMON).filter(f => f.endsWith('.md'));
+  for (const file of commonFiles) {
+    copyFileSync(join(RULES_COMMON, file), join(RULES_DEST, file));
     console.log(`  [ok] ${file}`);
+    total++;
   }
 
-  console.log(`\n${files.length} file(s) installed to .claude/rules/mdma/`);
+  // Copy template-specific rules (may override common)
+  total += copyMdFiles(templateDir, RULES_DEST, templateName || 'default');
+
+  console.log(`\n${total} file(s) installed to .claude/rules/mdma/`);
   console.log('Edit them as needed.\n');
 }
 
 function main() {
   const command = process.argv[2];
+  const arg = process.argv[3];
 
   switch (command) {
     case 'add':
-      add();
+      add(arg);
+      break;
+    case 'list':
+      listTemplates();
       break;
     case 'help':
     case '--help':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdma-cli",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Rules opinionated pour agents de code",
   "type": "module",
   "license": "MIT",
@@ -17,7 +17,8 @@
   },
   "files": [
     "bin",
-    ".claude/rules"
+    ".claude/rules",
+    "project-templates"
   ],
   "keywords": [
     "claude",

package/project-templates/ARTE-Video-Player/git.md

@@ -0,0 +1,42 @@
+# Workflow Git
+
+## Règles absolues
+
+> **Anti-rationalisation** : Ces règles n'ont AUCUNE exception. "JAMAIS" signifie jamais.
+> "C'est juste du gitignore" ou "c'est un petit fix" ne justifie PAS de contourner les règles.
+
+1. **JAMAIS push sur main**
+2. **JAMAIS commit sans branche** `feature/` ou `fix/`
+3. **JAMAIS merge sans PR**
+4. **JAMAIS `git add -A`** : commiter uniquement les fichiers modifiés intentionnellement
+5. **JAMAIS tu ne seras cité, ni dans les descriptions, les titres, les descriptions ou en tant qu'auteur. Jamais nul part, tout est de privaloops.
+
+Si tu envisages de transgresser une règle → **STOP** → demande à l'utilisateur.
+
+## Process
+
+### Avant de coder
+1. Synchroniser avec le remote :
+   - Si sur `main` : `git pull origin main`
+   - Si sur une feature branch : `git fetch && git rebase origin/main`
+2. Créer une branche depuis main : `feature/xxx` ou `fix/xxx`
+3. `git checkout -b feature/ma-feature`
+
+### Commits
+- Convention : **conventional commits**
+  - `feat:` nouvelle fonctionnalité
+  - `fix:` correction de bug
+  - `docs:` documentation
+  - `refactor:` refactoring
+  - `chore:` maintenance
+  - `test:` ajout/modification de tests
+- Messages clairs et concis
+- Un commit = un changement logique
+
+### Après validation
+1. `git add <fichiers>` (pas -A)
+2. `git commit -m "feat: description"`
+3. `git push -u origin <branche>`
+4. `gh pr create --fill` en assignant le milestone correspondant à la version corrigé du ticket initial. Si ce milestone n'existe pas, crée le.
+5. Attendre validation utilisateur
+6. `git checkout main && git pull`

package/project-templates/ARTE-Video-Player/workflow.md

@@ -0,0 +1,47 @@
+# Workflow Agent
+
+> **Note** : Ce workflow est agnostique. Pour les commandes spécifiques (test, build, lint), consulte `CLAUDE.md` qui fait référence pour ce projet.
+
+> **Règle de conformité** : Les règles définies ici et dans `git.md` sont ABSOLUES.
+> - Ne jamais rationaliser ("c'est juste un petit fix", "c'est mineur")
+> - Ne jamais faire d'exception, quelle que soit la taille ou nature du changement
+> - En cas de doute → STOP → demander à l'utilisateur
+
+## Étapes obligatoires
+
+### 0. Setup Git
+- Vérifie que tu n'es PAS sur `main` : `git branch --show-current`
+- Si sur `main` → créer une branche AVANT toute modification
+- Ne jamais rationaliser ("c'est juste un petit fix")
+
+### 1. Plan
+- Cherche dans .zshrc pour le token JIRA afin de l'utiliser en REST API avec CURL. Attention le token peut contenir des caractères spéciaux tiens en compte dans le CURL.
+- Cherche le contenu du ticket JIRA à traiter avec l'id donné dans le prompt https://artetv.atlassian.net/browse/XXXXXX
+- Passe le statut du ticket JIRA à "In progress"
+- Attribut le à moi-même
+- Explore le codebase (structure documentée dans `CLAUDE.md`)
+- Propose un plan d'implémentation
+- **STOP** → attend validation avant de coder
+
+### 2. Code
+- Implémente selon le plan validé
+- Petits commits logiques (conventions dans `git.md`)
+- **STOP** → montre les modifications, attend validation
+
+### 3. Test
+- Lance les tests(commande dans `CLAUDE.md`)
+- Si fail → arrête et fixe CE test uniquement
+- Si le test passe → relance la suite complète
+- Max 5 itérations
+- Si toujours fail → **STOP** → demande quoi faire
+
+### 4. Review
+- Review ton propre code
+- Vérifie : sécurité, performance, lisibilité
+- Propose des améliorations si pertinent
+- **STOP** → attend validation
+
+### 5. Git
+- Exécute le workflow défini dans `git.md`
+- **STOP** → attend validation avant de commiter
+- Passe le statut du ticket JIRA à "Testing"

package/project-templates/arte-player/git.md

@@ -0,0 +1,42 @@
+# Workflow Git
+
+## Règles absolues
+
+> **Anti-rationalisation** : Ces règles n'ont AUCUNE exception. "JAMAIS" signifie jamais.
+> "C'est juste du gitignore" ou "c'est un petit fix" ne justifie PAS de contourner les règles.
+
+1. **JAMAIS push sur main**
+2. **JAMAIS commit sans branche** `feature/` ou `fix/`
+4. **JAMAIS merge sans PR**
+5. **JAMAIS `git add -A`** : commiter uniquement les fichiers modifiés intentionnellement
+
+Si tu envisages de transgresser une règle → **STOP** → demande à l'utilisateur.
+
+## Process
+
+### Avant de coder
+1. Demander à l'utilisateur s'il souhaite se baser sur `main/master` ou `develop/dev`
+2. Synchroniser la branche de base choisie avec le remote :
+3. Créer une branche depuis la base choisie et la nommer : `feature/xxx` ou `fix/xxx`
+4. Checkout la nouvelle branche
+
+### Commits
+- Convention : **conventional commits**
+  - `feat:` nouvelle fonctionnalité
+  - `fix:` correction de bug
+  - `docs:` documentation
+  - `refactor:` refactoring
+  - `chore:` maintenance
+  - `test:` ajout/modification de tests
+- Messages clairs et concis
+- Un commit = un changement logique
+
+### Après validation
+1. `git add <fichiers>` (pas -A)
+2. `git commit -m "XXX: description"`. Remplacer XXX par le prefix de conventionnal commits qui correspond le mieux (voir ### Commits)
+3. `git push -u origin <branche>`
+4. `gh pr create --fill`
+7. `git checkout main && git pull`
+
+### Tests
+Les tests **DOIVENT** passer avant merge.

package/project-templates/arte-player/workflow.md

@@ -0,0 +1,65 @@
+# Workflow Agent
+
+> **Note** : Ce workflow est agnostique. Pour les commandes spécifiques (test, build, lint), consulte `CLAUDE.md` qui fait référence pour ce projet.
+
+> **Règle de conformité** : Les règles définies ici et dans `git.md` sont ABSOLUES.
+> - Ne jamais rationaliser ("c'est juste un petit fix", "c'est mineur")
+> - Ne jamais faire d'exception, quelle que soit la taille ou nature du changement
+> - En cas de doute → STOP → demander à l'utilisateur
+
+## Étapes obligatoires
+
+### 0. Setup Git
+- Vérifie que tu n'es PAS sur `main` : `git branch --show-current`
+- Si sur `main` → créer une branche AVANT toute modification
+- Ne jamais rationaliser ("c'est juste un petit fix")
+
+### 1. Plan
+- Explore le codebase (structure documentée dans `CLAUDE.md`)
+- Propose un plan d'implémentation
+- **STOP** → attend validation avant de coder
+
+### 2. Code
+- Implémente selon le plan validé
+- Petits commits logiques (conventions dans `git.md`)
+- **STOP** → montre les modifications, attend validation
+
+### 3. Test
+- Lance les tests (commande dans `CLAUDE.md`)
+- Si fail → arrête et fixe CE test uniquement
+- Si le test passe → relance la suite complète
+- Max 5 itérations
+- Si toujours fail → **STOP** → demande quoi faire
+
+#### 3.1 Tests visuels (obligatoire si applicable)
+- **Vérifie** si `.claude/rules/visual-test.md` existe
+- Si oui → exécute `/screenshot` et compare `current/` vs `baseline/`
+- Différence intentionnelle → mettre à jour `baseline/`
+- Régression détectée → **STOP** → corriger avant de continuer
+
+- Si tous les tests passent → **STOP** → attend validation
+
+### 4. Review
+- Review ton propre code
+- Vérifie : sécurité, performance, lisibilité
+- Propose des améliorations si pertinent
+- **STOP** → attend validation
+
+### 5. Compound
+- Consulte `CHANGELOG.md`, `DECISIONS.md`, `LEARNINGS.md` pour contexte
+- Apprends des feedbacks de cette session
+- Note les préférences exprimées pour les appliquer ensuite
+
+### 6. Document
+- Met à jour `CHANGELOG.md` pour chaque feature/fix (obligatoire)
+- Met à jour `LEARNINGS.md` si apprentissage important
+- Met à jour `DECISIONS.md` si décision structurante
+- Si ces fichiers n'existent pas → les créer avec les formats standards :
+  - CHANGELOG.md : [Keep a Changelog](https://keepachangelog.com/)
+  - DECISIONS.md : format ADR (Architecture Decision Records)
+  - LEARNINGS.md : format session avec contexte, décisions, leçons
+- **STOP** → attend validation
+
+### 7. Git
+- Exécute le workflow défini dans `git.md`
+- **STOP** → attend validation avant de commiter

package/project-templates/developpement.ai/git.md

@@ -0,0 +1,47 @@
+# Workflow Git
+
+## Règles absolues
+
+> **Anti-rationalisation** : Ces règles n'ont AUCUNE exception. "JAMAIS" signifie jamais.
+> "C'est juste du gitignore" ou "c'est un petit fix" ne justifie PAS de contourner les règles.
+
+1. **JAMAIS push sur main**
+2. **JAMAIS commit sans branche** `feature/` ou `fix/`
+3. **JAMAIS branche sans issue GitHub**
+4. **JAMAIS merge sans PR**
+5. **JAMAIS `git add -A`** : commiter uniquement les fichiers modifiés intentionnellement
+
+Si tu envisages de transgresser une règle → **STOP** → demande à l'utilisateur.
+
+## Process
+
+### Avant de coder
+1. Synchroniser avec le remote :
+   - Si sur `main` : `git pull origin main`
+   - Si sur une feature branch : `git fetch && git rebase origin/main`
+2. Créer une issue GitHub (titre + description)
+3. Créer une branche depuis main : `feature/xxx` ou `fix/xxx`
+4. `git checkout -b feature/ma-feature`
+
+### Commits
+- Convention : **conventional commits**
+  - `feat:` nouvelle fonctionnalité
+  - `fix:` correction de bug
+  - `docs:` documentation
+  - `refactor:` refactoring
+  - `chore:` maintenance
+  - `test:` ajout/modification de tests
+- Messages clairs et concis
+- Un commit = un changement logique
+
+### Après validation
+1. `git add <fichiers>` (pas -A)
+2. `git commit -m "feat: description"`
+3. `git push -u origin <branche>`
+4. `gh pr create --fill`
+5. Attendre validation utilisateur
+6. `gh pr merge --merge --delete-branch`
+7. `git checkout main && git pull`
+
+### Tests
+Les tests **DOIVENT** passer avant merge.

package/project-templates/developpement.ai/workflow.md

@@ -0,0 +1,65 @@
+# Workflow Agent
+
+> **Note** : Ce workflow est agnostique. Pour les commandes spécifiques (test, build, lint), consulte `CLAUDE.md` qui fait référence pour ce projet.
+
+> **Règle de conformité** : Les règles définies ici et dans `git.md` sont ABSOLUES.
+> - Ne jamais rationaliser ("c'est juste un petit fix", "c'est mineur")
+> - Ne jamais faire d'exception, quelle que soit la taille ou nature du changement
+> - En cas de doute → STOP → demander à l'utilisateur
+
+## Étapes obligatoires
+
+### 0. Setup Git
+- Vérifie que tu n'es PAS sur `main` : `git branch --show-current`
+- Si sur `main` → créer une branche AVANT toute modification
+- Ne jamais rationaliser ("c'est juste un petit fix")
+
+### 1. Plan
+- Explore le codebase (structure documentée dans `CLAUDE.md`)
+- Propose un plan d'implémentation
+- **STOP** → attend validation avant de coder
+
+### 2. Code
+- Implémente selon le plan validé
+- Petits commits logiques (conventions dans `git.md`)
+- **STOP** → montre les modifications, attend validation
+
+### 3. Test
+- Lance les tests (commande dans `CLAUDE.md`)
+- Si fail → arrête et fixe CE test uniquement
+- Si le test passe → relance la suite complète
+- Max 5 itérations
+- Si toujours fail → **STOP** → demande quoi faire
+
+#### 3.1 Tests visuels (obligatoire si applicable)
+- **Vérifie** si `.claude/rules/visual-test.md` existe
+- Si oui → exécute `/screenshot` et compare `current/` vs `baseline/`
+- Différence intentionnelle → mettre à jour `baseline/`
+- Régression détectée → **STOP** → corriger avant de continuer
+
+- Si tous les tests passent → **STOP** → attend validation
+
+### 4. Review
+- Review ton propre code
+- Vérifie : sécurité, performance, lisibilité
+- Propose des améliorations si pertinent
+- **STOP** → attend validation
+
+### 5. Compound
+- Consulte `CHANGELOG.md`, `DECISIONS.md`, `LEARNINGS.md` pour contexte
+- Apprends des feedbacks de cette session
+- Note les préférences exprimées pour les appliquer ensuite
+
+### 6. Document
+- Met à jour `CHANGELOG.md` pour chaque feature/fix (obligatoire)
+- Met à jour `LEARNINGS.md` si apprentissage important
+- Met à jour `DECISIONS.md` si décision structurante
+- Si ces fichiers n'existent pas → les créer avec les formats standards :
+  - CHANGELOG.md : [Keep a Changelog](https://keepachangelog.com/)
+  - DECISIONS.md : format ADR (Architecture Decision Records)
+  - LEARNINGS.md : format session avec contexte, décisions, leçons
+- **STOP** → attend validation
+
+### 7. Git
+- Exécute le workflow défini dans `git.md`
+- **STOP** → attend validation avant de commiter

package/project-templates/patria/git.md

@@ -0,0 +1,47 @@
+# Workflow Git
+
+## Règles absolues
+
+> **Anti-rationalisation** : Ces règles n'ont AUCUNE exception. "JAMAIS" signifie jamais.
+> "C'est juste du gitignore" ou "c'est un petit fix" ne justifie PAS de contourner les règles.
+
+1. **JAMAIS push sur main**
+2. **JAMAIS commit sans branche** `feature/` ou `fix/`
+3. **JAMAIS branche sans issue GitHub**
+4. **JAMAIS merge sans PR**
+5. **JAMAIS `git add -A`** : commiter uniquement les fichiers modifiés intentionnellement
+
+Si tu envisages de transgresser une règle → **STOP** → demande à l'utilisateur.
+
+## Process
+
+### Avant de coder
+1. Synchroniser avec le remote :
+   - Si sur `main` : `git pull origin main`
+   - Si sur une feature branch : `git fetch && git rebase origin/main`
+2. Créer une issue GitHub (titre + description)
+3. Créer une branche depuis main : `feature/xxx` ou `fix/xxx`
+4. `git checkout -b feature/ma-feature`
+
+### Commits
+- Convention : **conventional commits**
+  - `feat:` nouvelle fonctionnalité
+  - `fix:` correction de bug
+  - `docs:` documentation
+  - `refactor:` refactoring
+  - `chore:` maintenance
+  - `test:` ajout/modification de tests
+- Messages clairs et concis
+- Un commit = un changement logique
+
+### Après validation
+1. `git add <fichiers>` (pas -A)
+2. `git commit -m "feat: description"`
+3. `git push -u origin <branche>`
+4. `gh pr create --fill`
+5. Attendre validation utilisateur
+6. `gh pr merge --merge --delete-branch`
+7. `git checkout main && git pull`
+
+### Tests
+Les tests **DOIVENT** passer avant merge.

package/project-templates/patria/workflow.md

@@ -0,0 +1,65 @@
+# Workflow Agent
+
+> **Note** : Ce workflow est agnostique. Pour les commandes spécifiques (test, build, lint), consulte `CLAUDE.md` qui fait référence pour ce projet.
+
+> **Règle de conformité** : Les règles définies ici et dans `git.md` sont ABSOLUES.
+> - Ne jamais rationaliser ("c'est juste un petit fix", "c'est mineur")
+> - Ne jamais faire d'exception, quelle que soit la taille ou nature du changement
+> - En cas de doute → STOP → demander à l'utilisateur
+
+## Étapes obligatoires
+
+### 0. Setup Git
+- Vérifie que tu n'es PAS sur `main` : `git branch --show-current`
+- Si sur `main` → créer une branche AVANT toute modification
+- Ne jamais rationaliser ("c'est juste un petit fix")
+
+### 1. Plan
+- Explore le codebase (structure documentée dans `CLAUDE.md`)
+- Propose un plan d'implémentation
+- **STOP** → attend validation avant de coder
+
+### 2. Code
+- Implémente selon le plan validé
+- Petits commits logiques (conventions dans `git.md`)
+- **STOP** → montre les modifications, attend validation
+
+### 3. Test
+- Lance les tests (commande dans `CLAUDE.md`)
+- Si fail → arrête et fixe CE test uniquement
+- Si le test passe → relance la suite complète
+- Max 5 itérations
+- Si toujours fail → **STOP** → demande quoi faire
+
+#### 3.1 Tests visuels (obligatoire si applicable)
+- **Vérifie** si `.claude/rules/visual-test.md` existe
+- Si oui → exécute `/screenshot` et compare `current/` vs `baseline/`
+- Différence intentionnelle → mettre à jour `baseline/`
+- Régression détectée → **STOP** → corriger avant de continuer
+
+- Si tous les tests passent → **STOP** → attend validation
+
+### 4. Review
+- Review ton propre code
+- Vérifie : sécurité, performance, lisibilité
+- Propose des améliorations si pertinent
+- **STOP** → attend validation
+
+### 5. Compound
+- Consulte `CHANGELOG.md`, `DECISIONS.md`, `LEARNINGS.md` pour contexte
+- Apprends des feedbacks de cette session
+- Note les préférences exprimées pour les appliquer ensuite
+
+### 6. Document
+- Met à jour `CHANGELOG.md` pour chaque feature/fix (obligatoire)
+- Met à jour `LEARNINGS.md` si apprentissage important
+- Met à jour `DECISIONS.md` si décision structurante
+- Si ces fichiers n'existent pas → les créer avec les formats standards :
+  - CHANGELOG.md : [Keep a Changelog](https://keepachangelog.com/)
+  - DECISIONS.md : format ADR (Architecture Decision Records)
+  - LEARNINGS.md : format session avec contexte, décisions, leçons
+- **STOP** → attend validation
+
+### 7. Git
+- Exécute le workflow défini dans `git.md`
+- **STOP** → attend validation avant de commiter