mdma-cli 2.1.0 → 4.0.0

package/.claude/rules/mdma/{git.md → git-default.md}

@@ -7,21 +7,19 @@
 
 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
+3. **JAMAIS merge sans PR**
+4. **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`
+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. Si le projet utilise GitHub Issues, créer une issue (titre + description)
+4. Créer une branche depuis la base choisie : `feature/xxx` ou `fix/xxx`
+5. Checkout la nouvelle branche
 
 ### Commits
 - Convention : **conventional commits**
@@ -36,12 +34,12 @@ Si tu envisages de transgresser une règle → **STOP** → demande à l'utilisa
 
 ### Après validation
 1. `git add <fichiers>` (pas -A)
-2. `git commit -m "feat: description"`
+2. `git commit -m "type: 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`
+7. `git checkout <branche-base> && git pull`
 
 ### Tests
 Les tests **DOIVENT** passer avant merge.

package/README.md

@@ -9,14 +9,47 @@ npx mdma-cli add
 ```
 
 Installs rules to `.claude/rules/mdma/`:
-- `workflow.md` - agent workflow
-- `git.md` - git conventions
-- `style.md` - response style
 - `models.md` - model selection by task complexity
+- `style.md` - response style
+- `workflow-default.md` - agent workflow (7 steps)
+- `git-default.md` - git conventions
+
+## Presets
+
+```bash
+npx mdma-cli add          # default: GitHub workflow, merge auto
+npx mdma-cli add jira     # JIRA integration, milestone, anonymity
+```
+
+## Custom mix
+
+```bash
+npx mdma-cli add --workflow=default --git=jira
+npx mdma-cli add --workflow=jira --git=default
+```
+
+## Commands
+
+```bash
+npx mdma-cli add [preset]              # Install rules
+npx mdma-cli add --workflow=X --git=Y  # Custom mix
+npx mdma-cli list                      # List available options
+npx mdma-cli help                      # Show help
+```
+
+## Available components
+
+**Workflows:**
+- `default` - 7 steps (plan, code, test, review, compound, document, git)
+- `jira` - 5 steps + JIRA REST API integration
+
+**Git:**
+- `default` - ask base branch, conditional GitHub issue, merge auto
+- `jira` - ask base branch, milestone, Claude anonymity
 
 ## Update
 
-Run `npx mdma-cli add` again. The `mdma/` folder is replaced with the latest rules. Your custom rules outside this folder are preserved.
+Run `npx mdma-cli add` again. The `mdma/` folder is replaced with the latest rules.
 
 ## License
 

package/bin/init.js

@@ -1,49 +1,163 @@
 #!/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 TEMPLATES_SRC = join(PKG_ROOT, 'templates');
 const RULES_DEST = join(process.cwd(), '.claude', 'rules', 'mdma');
 
+const CORE_FILES = ['models.md', 'style.md'];
+
+const PRESETS = {
+  default: { workflow: 'default', git: 'default' },
+  jira: { workflow: 'jira', git: 'jira' }
+};
+
 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 [preset]              Install rules with preset');
+  console.log('  npx mdma-cli add --workflow=X --git=Y  Install rules with custom mix');
+  console.log('  npx mdma-cli list                      List available options');
+  console.log('  npx mdma-cli help                      Show this help\n');
+  console.log('Presets:');
+  console.log('  default  workflow-default + git-default (GitHub, merge auto)');
+  console.log('  jira     workflow-jira + git-jira (JIRA integration, milestone)\n');
+  console.log('Examples:');
+  console.log('  npx mdma-cli add                       Install default preset');
+  console.log('  npx mdma-cli add jira                  Install jira preset');
+  console.log('  npx mdma-cli add --workflow=default --git=jira\n');
+}
+
+function listOptions() {
+  console.log('mdma-cli - Available options\n');
+
+  console.log('Presets:');
+  for (const [name, config] of Object.entries(PRESETS)) {
+    console.log(`  ${name.padEnd(10)} → workflow-${config.workflow} + git-${config.git}`);
+  }
+
+  console.log('\nWorkflows:');
+  const workflows = readdirSync(TEMPLATES_SRC)
+    .filter(f => f.startsWith('workflow-') && f.endsWith('.md'))
+    .map(f => f.replace('workflow-', '').replace('.md', ''));
+  for (const w of workflows) {
+    console.log(`  ${w}`);
+  }
+
+  console.log('\nGit:');
+  const gits = readdirSync(TEMPLATES_SRC)
+    .filter(f => f.startsWith('git-') && f.endsWith('.md'))
+    .map(f => f.replace('git-', '').replace('.md', ''));
+  for (const g of gits) {
+    console.log(`  ${g}`);
+  }
+
+  console.log('\nUsage: npx mdma-cli add [preset] or npx mdma-cli add --workflow=X --git=Y\n');
+}
+
+function parseArgs(args) {
+  const result = { preset: null, workflow: null, git: null };
+
+  for (const arg of args) {
+    if (arg.startsWith('--workflow=')) {
+      result.workflow = arg.split('=')[1];
+    } else if (arg.startsWith('--git=')) {
+      result.git = arg.split('=')[1];
+    } else if (!arg.startsWith('-')) {
+      result.preset = arg;
+    }
+  }
+
+  return result;
 }
 
-function add() {
-  console.log('mdma-cli - Installing rules\n');
+function add(args) {
+  const parsed = parseArgs(args);
 
-  // Remove existing mdma rules folder
+  let workflow, git;
+
+  if (parsed.workflow || parsed.git) {
+    // Custom mix
+    workflow = parsed.workflow || 'default';
+    git = parsed.git || 'default';
+  } else {
+    // Preset
+    const presetName = parsed.preset || 'default';
+    const preset = PRESETS[presetName];
+
+    if (!preset) {
+      console.error(`Error: Unknown preset "${presetName}"\n`);
+      listOptions();
+      process.exit(1);
+    }
+
+    workflow = preset.workflow;
+    git = preset.git;
+  }
+
+  // Validate files exist
+  const workflowFile = join(TEMPLATES_SRC, `workflow-${workflow}.md`);
+  const gitFile = join(TEMPLATES_SRC, `git-${git}.md`);
+
+  if (!existsSync(workflowFile)) {
+    console.error(`Error: workflow-${workflow}.md not found\n`);
+    listOptions();
+    process.exit(1);
+  }
+
+  if (!existsSync(gitFile)) {
+    console.error(`Error: git-${git}.md not found\n`);
+    listOptions();
+    process.exit(1);
+  }
+
+  console.log(`mdma-cli - Installing rules\n`);
+  console.log(`  workflow: ${workflow}`);
+  console.log(`  git:      ${git}\n`);
+
+  // Remove existing and create fresh
   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'));
-
-  for (const file of files) {
-    copyFileSync(join(RULES_SRC, file), join(RULES_DEST, file));
-    console.log(`  [ok] ${file}`);
+  // Copy core files
+  for (const file of CORE_FILES) {
+    const src = join(TEMPLATES_SRC, file);
+    if (existsSync(src)) {
+      copyFileSync(src, join(RULES_DEST, file));
+      console.log(`  [ok] ${file}`);
+    }
   }
 
-  console.log(`\n${files.length} file(s) installed to .claude/rules/mdma/`);
-  console.log('Edit them as needed.\n');
+  // Copy workflow
+  copyFileSync(workflowFile, join(RULES_DEST, `workflow-${workflow}.md`));
+  console.log(`  [ok] workflow-${workflow}.md`);
+
+  // Copy git
+  copyFileSync(gitFile, join(RULES_DEST, `git-${git}.md`));
+  console.log(`  [ok] git-${git}.md`);
+
+  console.log(`\n4 file(s) installed to .claude/rules/mdma/\n`);
 }
 
 function main() {
-  const command = process.argv[2];
+  const args = process.argv.slice(2);
+  const command = args[0];
 
   switch (command) {
     case 'add':
-      add();
+      add(args.slice(1));
+      break;
+    case 'list':
+      listOptions();
       break;
     case 'help':
     case '--help':
     case '-h':
+    case undefined:
       showHelp();
       break;
     default:

package/package.json

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

package/templates/git-default.md

@@ -0,0 +1,45 @@
+# 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
+
+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. Si le projet utilise GitHub Issues, créer une issue (titre + description)
+4. Créer une branche depuis la base choisie : `feature/xxx` ou `fix/xxx`
+5. 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 "type: 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 <branche-base> && git pull`
+
+### Tests
+Les tests **DOIVENT** passer avant merge.

package/templates/git-jira.md

@@ -0,0 +1,44 @@
+# 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 cité** : ni dans les descriptions, titres, ou en tant qu'auteur. Tout est de l'utilisateur.
+
+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 : `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 "type: description"`
+3. `git push -u origin <branche>`
+4. `gh pr create --fill` en assignant le milestone correspondant à la version du ticket. Si ce milestone n'existe pas, le créer.
+5. Attendre validation utilisateur
+6. `git checkout <branche-base> && git pull`
+
+### Tests
+Les tests **DOIVENT** passer avant merge.

package/templates/models.md

@@ -0,0 +1,19 @@
+# Sélection des modèles
+
+Utiliser le modèle approprié selon la complexité de la tâche pour optimiser coûts et rapidité.
+
+## Correspondance tâche/modèle
+
+| Tâche | Modèle | Justification |
+|-------|--------|---------------|
+| Tests, build, lint | `haiku` | Exécution simple, pas de raisonnement |
+| Exploration de code, recherche | `sonnet` | Bon équilibre |
+| Implémentation, review, architecture | `opus` | Raisonnement complexe |
+
+## Syntaxe
+
+Spécifier le modèle dans la demande si besoin :
+- "Lance les tests avec haiku"
+- "Explore le code avec sonnet"
+
+Par défaut, l'agent choisit le modèle selon le tableau ci-dessus.

package/templates/style.md

@@ -0,0 +1,42 @@
+# Style de réponse
+
+## Profil
+- **Niveau** : Senior
+- **Style** : Détaillé
+
+## Comment répondre
+
+- Réponses détaillées avec contexte
+- Explique les choix importants
+- Propose des alternatives quand pertinent
+- Va droit au but, pas de fioritures inutiles
+
+## Autonomie
+
+- **Demande TOUJOURS avant d'agir**
+- Ne fais rien sans validation explicite
+- Expose le plan, attend "ok", puis agis
+
+## À éviter
+
+- **Obséquiosité** : pas de "Excellent choix!", "Très bonne question!", "C'est une super idée!"
+- Pas de compliments excessifs
+- Pas de formules de politesse superflues
+- Pas d'emojis (sauf si demandé)
+
+## Principes de dev
+
+- **DRY** : Don't Repeat Yourself
+- **YAGNI** : You Ain't Gonna Need It
+- **KISS** : Keep It Simple, Stupid
+
+## Contraintes
+
+### Ne jamais faire
+- Commiter sur main directement
+- Over-engineering
+- Ajouter des features non demandées
+
+### Toujours faire
+- Respecter le workflow défini dans `workflow.md` et `git.md`
+- Garder les solutions simples

package/templates/workflow-default.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/templates/workflow-jira.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, en tenir compte dans le CURL.
+- Cherche le contenu du ticket JIRA à traiter avec l'id donné dans le prompt
+- Passe le statut du ticket JIRA à "In progress"
+- Attribue le ticket à l'utilisateur
+- 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`
+- Passe le statut du ticket JIRA à "Testing"
+- **STOP** → attend validation avant de commiter