mdma-cli 4.1.1 → 4.3.0

package/.claude/rules/mdma/best-practices.md

@@ -25,19 +25,16 @@ Le MCP **context7** permet de récupérer la documentation officielle à jour di
 
 ### Configuration
 
-Ajouter dans `.mcp.json` (project scope, partagé via git) :
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"]
-    }
-  }
-}
+**mdma-cli** configure automatiquement context7 en scope user lors de `npx mdma-cli add`.
+
+Configuration manuelle si nécessaire :
+
+```bash
+claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp
 ```
 
+> **Scope user** : context7 est disponible pour tous vos projets, sans polluer les `.mcp.json` individuels.
+
 ### Usage
 
 Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour :
@@ -46,15 +43,8 @@ Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour
 
 ### API Key (optionnel)
 
-Pour des rate limits plus élevés, obtenir une clé gratuite sur [context7.com/dashboard](https://context7.com/dashboard) et ajouter :
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
-    }
-  }
-}
+Pour des rate limits plus élevés, obtenir une clé gratuite sur [context7.com/dashboard](https://context7.com/dashboard) :
+
+```bash
+claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
 ```

package/.claude/rules/mdma/git-default.md

@@ -34,7 +34,7 @@ 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 "type: description"`
+2. `git commit -m "XXX: description"`. Remplacer XXX par le prefix de conventionnal commits qui correspond le mieux au sujet traité (voir ### Commits)
 3. `git push -u origin <branche>`
 4. `gh pr create --fill`
 5. Attendre validation utilisateur

package/README.md

@@ -21,6 +21,26 @@ npx mdma-cli add          # default: GitHub workflow, merge auto
 npx mdma-cli add jira     # JIRA integration, milestone, anonymity
 ```
 
+### Configuration JIRA
+
+**Variables globales** (`.zshrc` ou `.bashrc`) :
+
+```bash
+export ARTE_ATLASSIAN_ROOT_URL="https://mycompany.atlassian.net"  # ou URL on-premise
+export ARTE_ATLASSIAN_USER_EMAIL="user@email.com"
+export ARTE_ATLASSIAN_API_TOKEN="your-api-token"
+```
+
+**Variable projet** (dans `CLAUDE.md` ou `.env`) :
+
+```bash
+export ARTE_ATLASSIAN_PROJECT_NAME="PROJ"  # clé du projet JIRA
+```
+
+Créer un token : [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)
+
+**Fallback MCP** : si l'API échoue, le workflow propose d'utiliser `@anthropic/atlassian-mcp-server`.
+
 ## Custom mix
 
 ```bash

package/bin/init.js

@@ -3,6 +3,7 @@
 import { copyFileSync, mkdirSync, rmSync, readdirSync, existsSync, readFileSync, appendFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = join(__dirname, '..');
@@ -10,8 +11,6 @@ const TEMPLATES_SRC = join(PKG_ROOT, 'templates');
 const RULES_DEST = join(process.cwd(), '.claude', 'rules', 'mdma');
 
 const CORE_FILES = ['models.md', 'style.md', 'best-practices.md'];
-const MCP_FILE = 'mcp.json';
-const MCP_DEST = join(process.cwd(), '.mcp.json');
 
 const PRESETS = {
   default: { workflow: 'default', git: 'default' },
@@ -81,6 +80,32 @@ function updateGitExclude() {
   return true;
 }
 
+function setupContext7() {
+  try {
+    // Check if context7 is already configured
+    const result = execSync('claude mcp list', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    if (result.includes('context7')) {
+      return 'already';
+    }
+  } catch {
+    // claude command not found or error - try to add anyway
+  }
+
+  try {
+    execSync('claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp', {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return true;
+  } catch (error) {
+    // Check if error is because it already exists
+    if (error.message && error.message.includes('already exists')) {
+      return 'already';
+    }
+    return false;
+  }
+}
+
 function parseArgs(args) {
   const result = { preset: null, workflow: null, git: null };
 
@@ -162,13 +187,6 @@ function add(args) {
   copyFileSync(gitFile, join(RULES_DEST, `git-${git}.md`));
   console.log(`  [ok] git-${git}.md`);
 
-  // Copy MCP config to project root
-  const mcpSrc = join(TEMPLATES_SRC, MCP_FILE);
-  if (existsSync(mcpSrc)) {
-    copyFileSync(mcpSrc, MCP_DEST);
-    console.log(`  [ok] .mcp.json (project root)`);
-  }
-
   // Update .git/info/exclude
   const excludeResult = updateGitExclude();
   if (excludeResult === true) {
@@ -179,8 +197,18 @@ function add(args) {
     console.log(`  [skip] .git/info/exclude (not a git repo)`);
   }
 
-  console.log(`\n5 file(s) installed to .claude/rules/mdma/`);
-  console.log(`1 file(s) installed to project root (.mcp.json)\n`);
+  // Setup context7 MCP (user scope)
+  const context7Result = setupContext7();
+  if (context7Result === true) {
+    console.log(`  [ok] context7 MCP (user scope)`);
+  } else if (context7Result === 'already') {
+    console.log(`  [skip] context7 MCP (already configured)`);
+  } else {
+    console.log(`  [warn] context7 MCP (claude CLI not found)`);
+    console.log(`         Run manually: claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp`);
+  }
+
+  console.log(`\n5 file(s) installed to .claude/rules/mdma/\n`);
 }
 
 function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdma-cli",
-  "version": "4.1.1",
+  "version": "4.3.0",
   "description": "Rules opinionated pour agents de code",
   "type": "module",
   "license": "MIT",

package/templates/best-practices.md

@@ -25,19 +25,16 @@ Le MCP **context7** permet de récupérer la documentation officielle à jour di
 
 ### Configuration
 
-Ajouter dans `.mcp.json` (project scope, partagé via git) :
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"]
-    }
-  }
-}
+**mdma-cli** configure automatiquement context7 en scope user lors de `npx mdma-cli add`.
+
+Configuration manuelle si nécessaire :
+
+```bash
+claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp
 ```
 
+> **Scope user** : context7 est disponible pour tous vos projets, sans polluer les `.mcp.json` individuels.
+
 ### Usage
 
 Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour :
@@ -46,15 +43,8 @@ Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour
 
 ### API Key (optionnel)
 
-Pour des rate limits plus élevés, obtenir une clé gratuite sur [context7.com/dashboard](https://context7.com/dashboard) et ajouter :
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
-    }
-  }
-}
+Pour des rate limits plus élevés, obtenir une clé gratuite sur [context7.com/dashboard](https://context7.com/dashboard) :
+
+```bash
+claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY
 ```

package/templates/workflow-jira.md

@@ -7,6 +7,44 @@
 > - Ne jamais faire d'exception, quelle que soit la taille ou nature du changement
 > - En cas de doute → STOP → demander à l'utilisateur
 
+## Configuration JIRA
+
+### Variables globales (`.zshrc` ou `.bashrc`)
+
+```bash
+export ARTE_ATLASSIAN_ROOT_URL="https://mycompany.atlassian.net"  # ou URL on-premise
+export ARTE_ATLASSIAN_USER_EMAIL="user@email.com"
+export ARTE_ATLASSIAN_API_TOKEN="your-api-token"
+```
+
+### Variable projet (`CLAUDE.md` du projet)
+
+```markdown
+## JIRA
+- **Projet** : `PROJ` (clé JIRA)
+```
+
+Ou via variable d'environnement projet :
+```bash
+export ARTE_ATLASSIAN_PROJECT_NAME="PROJ"
+```
+
+### Utilisation API
+
+```bash
+# Exemple de requête JIRA
+curl -s -u "$ARTE_ATLASSIAN_USER_EMAIL:$ARTE_ATLASSIAN_API_TOKEN" \
+  "$ARTE_ATLASSIAN_ROOT_URL/rest/api/3/issue/PROJ-123"
+```
+
+### Fallback
+
+Si l'API REST échoue (erreurs réseau, permissions), utiliser le MCP Atlassian :
+
+```bash
+claude mcp add atlassian -- npx -y @anthropic/atlassian-mcp-server
+```
+
 ## Étapes obligatoires
 
 ### 0. Setup Git
@@ -15,7 +53,7 @@
 - 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.
+- Utilise les variables `$ARTE_ATLASSIAN_*` pour les appels API JIRA (voir Configuration ci-dessus)
 - 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

package/templates/mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@upstash/context7-mcp"]
-    }
-  }
-}