mdma-cli 4.0.0 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/.claude/rules/mdma/best-practices.md +60 -0
  2. package/bin/init.js +12 -2
  3. package/package.json +1 -1
  4. package/templates/best-practices.md +60 -0
  5. package/templates/mcp.json +8 -0
package/.claude/rules/mdma/best-practices.md ADDED
@@ -0,0 +1,60 @@
1
+ # Best Practices
2
+
3
+ ## Règle absolue
4
+
5
+ > **Toujours coder selon les best practices reconnues** pour chaque langage, framework ou librairie utilisé.
6
+
7
+ ## En cas de doute
8
+
9
+ Si plusieurs approches sont reconnues comme "best practice" :
10
+
11
+ 1. **STOP** - ne pas choisir arbitrairement
12
+ 2. Lister les options avec leurs avantages/inconvénients
13
+ 3. Demander à l'utilisateur quelle approche privilégier
14
+
15
+ ## Sources de référence
16
+
17
+ Par ordre de priorité :
18
+ 1. Documentation officielle du langage/framework
19
+ 2. Style guides officiels (Google, Airbnb, etc.)
20
+ 3. Conventions établies dans le projet existant
21
+
22
+ ## MCP recommandé
23
+
24
+ Le MCP **context7** permet de récupérer la documentation officielle à jour directement dans le contexte.
25
+
26
+ ### Configuration
27
+
28
+ Ajouter dans `.mcp.json` (project scope, partagé via git) :
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "context7": {
34
+ "command": "npx",
35
+ "args": ["-y", "@upstash/context7-mcp"]
36
+ }
37
+ }
38
+ }
39
+ ```
40
+
41
+ ### Usage
42
+
43
+ Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour :
44
+ - "Implémente l'auth avec NextAuth, use context7"
45
+ - "Ajoute la validation Zod, use context7"
46
+
47
+ ### API Key (optionnel)
48
+
49
+ Pour des rate limits plus élevés, obtenir une clé gratuite sur [context7.com/dashboard](https://context7.com/dashboard) et ajouter :
50
+
51
+ ```json
52
+ {
53
+ "mcpServers": {
54
+ "context7": {
55
+ "command": "npx",
56
+ "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
57
+ }
58
+ }
59
+ }
60
+ ```
package/bin/init.js CHANGED
@@ -9,7 +9,9 @@ const PKG_ROOT = join(__dirname, '..');
9
9
  const TEMPLATES_SRC = join(PKG_ROOT, 'templates');
10
10
  const RULES_DEST = join(process.cwd(), '.claude', 'rules', 'mdma');
11
11
 
12
- const CORE_FILES = ['models.md', 'style.md'];
12
+ const CORE_FILES = ['models.md', 'style.md', 'best-practices.md'];
13
+ const MCP_FILE = 'mcp.json';
14
+ const MCP_DEST = join(process.cwd(), '.mcp.json');
13
15
 
14
16
  const PRESETS = {
15
17
  default: { workflow: 'default', git: 'default' },
@@ -140,7 +142,15 @@ function add(args) {
140
142
  copyFileSync(gitFile, join(RULES_DEST, `git-${git}.md`));
141
143
  console.log(` [ok] git-${git}.md`);
142
144
 
143
- console.log(`\n4 file(s) installed to .claude/rules/mdma/\n`);
145
+ // Copy MCP config to project root
146
+ const mcpSrc = join(TEMPLATES_SRC, MCP_FILE);
147
+ if (existsSync(mcpSrc)) {
148
+ copyFileSync(mcpSrc, MCP_DEST);
149
+ console.log(` [ok] .mcp.json (project root)`);
150
+ }
151
+
152
+ console.log(`\n5 file(s) installed to .claude/rules/mdma/`);
153
+ console.log(`1 file(s) installed to project root (.mcp.json)\n`);
144
154
  }
145
155
 
146
156
  function main() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mdma-cli",
3
- "version": "4.0.0",
3
+ "version": "4.1.0",
4
4
  "description": "Rules opinionated pour agents de code",
5
5
  "type": "module",
6
6
  "license": "MIT",
package/templates/best-practices.md ADDED
@@ -0,0 +1,60 @@
1
+ # Best Practices
2
+
3
+ ## Règle absolue
4
+
5
+ > **Toujours coder selon les best practices reconnues** pour chaque langage, framework ou librairie utilisé.
6
+
7
+ ## En cas de doute
8
+
9
+ Si plusieurs approches sont reconnues comme "best practice" :
10
+
11
+ 1. **STOP** - ne pas choisir arbitrairement
12
+ 2. Lister les options avec leurs avantages/inconvénients
13
+ 3. Demander à l'utilisateur quelle approche privilégier
14
+
15
+ ## Sources de référence
16
+
17
+ Par ordre de priorité :
18
+ 1. Documentation officielle du langage/framework
19
+ 2. Style guides officiels (Google, Airbnb, etc.)
20
+ 3. Conventions établies dans le projet existant
21
+
22
+ ## MCP recommandé
23
+
24
+ Le MCP **context7** permet de récupérer la documentation officielle à jour directement dans le contexte.
25
+
26
+ ### Configuration
27
+
28
+ Ajouter dans `.mcp.json` (project scope, partagé via git) :
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "context7": {
34
+ "command": "npx",
35
+ "args": ["-y", "@upstash/context7-mcp"]
36
+ }
37
+ }
38
+ }
39
+ ```
40
+
41
+ ### Usage
42
+
43
+ Inclure `use context7` dans le prompt pour que l'agent récupère la doc à jour :
44
+ - "Implémente l'auth avec NextAuth, use context7"
45
+ - "Ajoute la validation Zod, use context7"
46
+
47
+ ### API Key (optionnel)
48
+
49
+ Pour des rate limits plus élevés, obtenir une clé gratuite sur [context7.com/dashboard](https://context7.com/dashboard) et ajouter :
50
+
51
+ ```json
52
+ {
53
+ "mcpServers": {
54
+ "context7": {
55
+ "command": "npx",
56
+ "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
57
+ }
58
+ }
59
+ }
60
+ ```
package/templates/mcp.json ADDED
@@ -0,0 +1,8 @@
1
+ {
2
+ "mcpServers": {
3
+ "context7": {
4
+ "command": "npx",
5
+ "args": ["-y", "@upstash/context7-mcp"]
6
+ }
7
+ }
8
+ }