supermind-claude 2.1.0 → 2.1.1

package/cli/commands/install.js

@@ -72,7 +72,7 @@ module.exports = async function install(flags) {
 
   // Step 7: Templates
   logger.step(7, TOTAL, 'Installing templates...');
-  installTemplates();
+  installTemplates(mcpConfig.mode);
 
   // Write version marker
   fs.writeFileSync(PATHS.versionFile, version);

package/cli/commands/update.js

@@ -7,6 +7,7 @@ const { readSettings, writeSettings, mergeSettings, backupSettings } = require('
 const { installHooks, getHookSettings } = require('../lib/hooks');
 const { installSkills, removeLegacySkills } = require('../lib/skills');
 const { installTemplates } = require('../lib/templates');
+const { detectMcpMode } = require('../lib/mcp');
 const { version } = require('../../package.json');
 
 module.exports = function update(flags) {
@@ -44,7 +45,7 @@ module.exports = function update(flags) {
 
   // Step 4: Templates
   logger.step(4, TOTAL, 'Updating templates...');
-  installTemplates();
+  installTemplates(detectMcpMode());
 
   // Write version marker
   fs.writeFileSync(PATHS.versionFile, version);

package/cli/lib/mcp.js

@@ -91,22 +91,42 @@ async function setupMcp(flags) {
   }
   if (!mode || mode === 'skip') {
     logger.info('Skipping MCP setup');
-    return {};
+    return { mode: 'skip' };
   }
 
   if (mode === 'docker') {
     await setupDocker();
-    return {}; // Docker mode uses AIRIS, not settings.json mcpServers
+    return { mode: 'docker' }; // Docker uses AIRIS gateway; mode drives template MCP section
   }
 
   if (mode === 'direct') {
     const apiKeys = await promptApiKeys(flags);
     const servers = setupDirect(apiKeys);
     logger.success(`Configured ${Object.keys(servers).length} MCP servers`);
-    return { mcpServers: servers };
+    return { mode: 'direct', mcpServers: servers };
   }
 
-  return {};
+  return { mode: 'skip' };
 }
 
-module.exports = { setupMcp };
+// Infer MCP mode from installed artifacts. Used by update to re-render the template MCP section.
+function detectMcpMode() {
+  if (fs.existsSync(path.join(PATHS.airisDir, 'docker-compose.yml'))) {
+    return 'docker';
+  }
+  // Any known direct-mode server in settings.json means direct install was used
+  try {
+    const settings = JSON.parse(fs.readFileSync(PATHS.settings, 'utf-8'));
+    const servers = settings.mcpServers || {};
+    if (servers.context7 || servers.playwright || servers.serena || servers.tavily) {
+      return 'direct';
+    }
+  } catch (err) {
+    if (err.code !== 'ENOENT') {
+      logger.warn(`Could not read settings.json to detect MCP mode: ${err.message}`);
+    }
+  }
+  return 'skip';
+}
+
+module.exports = { setupMcp, detectMcpMode };

package/cli/lib/templates.js

@@ -5,11 +5,58 @@ const path = require('path');
 const { PATHS, ensureDir, getPackageRoot } = require('./platform');
 const logger = require('./logger');
 
-function installTemplates() {
+const MCP_SECTIONS = {
+  docker: `## MCP Servers
+Use these naturally when relevant — don't wait to be asked.
+
+- **Magic MCP** — \`component_builder\`, \`component_inspiration\`, \`component_refiner\`, \`logo_search\` — use when building/refining UI components
+- **Airis Gateway** (Docker, localhost:9400) — cold-start sub-servers:
+  - **context7** — Library docs lookup
+  - **playwright** — Browser automation/testing
+  - **serena** — Symbolic code navigation (run \`activate_project\` on first use)
+  - **tavily** — Web search/research
+  - **chrome-devtools** — Chrome debugging
+  - **shadcn** — shadcn/ui component search
+`,
+
+  direct: `## MCP Servers
+Use these naturally when relevant — don't wait to be asked.
+
+- **Magic MCP** — \`component_builder\`, \`component_inspiration\`, \`component_refiner\`, \`logo_search\` — use when building/refining UI components
+- **context7** — Library docs lookup (npx)
+- **playwright** — Browser automation/testing (npx)
+- **serena** — Symbolic code navigation; run \`activate_project\` on first use (uvx)
+- **tavily** — Web search/research (npx, requires TAVILY_API_KEY)
+- **chrome-devtools** — Chrome debugging (npx)
+- **shadcn** — shadcn/ui component search (npx)
+`,
+
+  skip: `## MCP Servers
+Use these naturally when relevant — don't wait to be asked.
+
+- **Magic MCP** — \`component_builder\`, \`component_inspiration\`, \`component_refiner\`, \`logo_search\` — use when building/refining UI components
+<!-- Add your MCP servers here. Run \`npx supermind-claude\` to set up context7, playwright, serena, tavily, and more. -->
+`,
+};
+
+// Matches MCP section up to next heading or end of file (with or without trailing newline)
+const MCP_SECTION_PATTERN = /## MCP Servers\nUse these naturally when relevant.*?(?=\n## |\n?$)/s;
+
+function installTemplates(mcpMode) {
   ensureDir(PATHS.templatesDir);
   const src = path.join(getPackageRoot(), 'templates', 'CLAUDE.md');
   const dest = path.join(PATHS.templatesDir, 'CLAUDE.md');
   fs.copyFileSync(src, dest);
+
+  if (mcpMode && MCP_SECTIONS[mcpMode]) {
+    const content = fs.readFileSync(dest, 'utf-8');
+    const updated = content.replace(MCP_SECTION_PATTERN, MCP_SECTIONS[mcpMode]);
+    if (updated === content && mcpMode !== 'docker') { // docker is the template default, so no-op is expected
+      logger.warn('MCP section pattern did not match template — using default MCP content');
+    }
+    fs.writeFileSync(dest, updated);
+  }
+
   logger.success('CLAUDE.md template');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supermind-claude",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Complete, opinionated Claude Code setup — hooks, skills, status line, MCP servers, and living documentation",
   "bin": {
     "supermind-claude": "cli/index.js",

package/templates/CLAUDE.md

@@ -78,6 +78,7 @@ Use the superpowers `/using-git-worktrees` skill for worktree creation. It handl
 - The code reviewer must find zero remaining issues before merging. If it finds problems, fix them and run the reviewer again. Repeat until clean.
 - Never skip the review step. Never skip "minor" fixes. Every finding gets fixed.
 - This entire process — create, implement, review, fix, merge, clean up — executes without stopping to ask for permission.
+- **Branch safety:** If the current branch is `main` or `master` when a code change is requested, create a feature branch first (`feature/…`, `fix/…`, or `chore/…`) before making any changes. Never commit directly to `main` or `master`.
 
 ## MCP Servers
 Use these naturally when relevant — don't wait to be asked.