mdma-cli 4.0.0 → 4.1.1

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

@@ -0,0 +1,60 @@
+# Best Practices
+
+## Règle absolue
+
+> **Toujours coder selon les best practices reconnues** pour chaque langage, framework ou librairie utilisé.
+
+## En cas de doute
+
+Si plusieurs approches sont reconnues comme "best practice" :
+
+1. **STOP** - ne pas choisir arbitrairement
+2. Lister les options avec leurs avantages/inconvénients
+3. Demander à l'utilisateur quelle approche privilégier
+
+## Sources de référence
+
+Par ordre de priorité :
+1. Documentation officielle du langage/framework
+2. Style guides officiels (Google, Airbnb, etc.)
+3. Conventions établies dans le projet existant
+
+## MCP recommandé
+
+Le MCP **context7** permet de récupérer la documentation officielle à jour directement dans le contexte.
+
+### Configuration
+
+Ajouter dans `.mcp.json` (project scope, partagé via git) :
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    }
+  }
+}
+```
+
+### Usage
+
+Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour :
+- "Implémente l'auth avec NextAuth, use context7"
+- "Ajoute la validation Zod, use context7"
+
+### 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"]
+    }
+  }
+}
+```

package/bin/init.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { copyFileSync, mkdirSync, rmSync, readdirSync, existsSync } from 'fs';
+import { copyFileSync, mkdirSync, rmSync, readdirSync, existsSync, readFileSync, appendFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 
@@ -9,7 +9,9 @@ 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 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' },
@@ -59,6 +61,26 @@ function listOptions() {
   console.log('\nUsage: npx mdma-cli add [preset] or npx mdma-cli add --workflow=X --git=Y\n');
 }
 
+function updateGitExclude() {
+  const excludePath = join(process.cwd(), '.git', 'info', 'exclude');
+
+  if (!existsSync(excludePath)) {
+    return false;
+  }
+
+  const content = readFileSync(excludePath, 'utf-8');
+  const linesToAdd = ['# Claude Code', 'CLAUDE.md', '.claude/'];
+  const missingLines = linesToAdd.filter(line => !content.includes(line));
+
+  if (missingLines.length === 0) {
+    return 'already';
+  }
+
+  const addition = '\n' + linesToAdd.join('\n') + '\n';
+  appendFileSync(excludePath, addition);
+  return true;
+}
+
 function parseArgs(args) {
   const result = { preset: null, workflow: null, git: null };
 
@@ -140,7 +162,25 @@ function add(args) {
   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`);
+  // 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) {
+    console.log(`  [ok] .git/info/exclude (updated)`);
+  } else if (excludeResult === 'already') {
+    console.log(`  [skip] .git/info/exclude (already configured)`);
+  } else {
+    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`);
 }
 
 function main() {

package/package.json

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

package/templates/best-practices.md

@@ -0,0 +1,60 @@
+# Best Practices
+
+## Règle absolue
+
+> **Toujours coder selon les best practices reconnues** pour chaque langage, framework ou librairie utilisé.
+
+## En cas de doute
+
+Si plusieurs approches sont reconnues comme "best practice" :
+
+1. **STOP** - ne pas choisir arbitrairement
+2. Lister les options avec leurs avantages/inconvénients
+3. Demander à l'utilisateur quelle approche privilégier
+
+## Sources de référence
+
+Par ordre de priorité :
+1. Documentation officielle du langage/framework
+2. Style guides officiels (Google, Airbnb, etc.)
+3. Conventions établies dans le projet existant
+
+## MCP recommandé
+
+Le MCP **context7** permet de récupérer la documentation officielle à jour directement dans le contexte.
+
+### Configuration
+
+Ajouter dans `.mcp.json` (project scope, partagé via git) :
+
+```json
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    }
+  }
+}
+```
+
+### Usage
+
+Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour :
+- "Implémente l'auth avec NextAuth, use context7"
+- "Ajoute la validation Zod, use context7"
+
+### 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"]
+    }
+  }
+}
+```

package/templates/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/templates/git-jira.md

@@ -9,7 +9,7 @@
 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.
+5. **JAMAIS te citer** : ni dans les descriptions, titres, messages de commit ou co-auteur (pas de "Co-Authored-By"). Tout le travail est attribué à l'utilisateur uniquement
 
 Si tu envisages de transgresser une règle → **STOP** → demande à l'utilisateur.
 
@@ -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` en assignant le milestone correspondant à la version du ticket. Si ce milestone n'existe pas, le créer.
 5. Attendre validation utilisateur

package/templates/mcp.json

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