convoke-agents 2.0.1 → 2.1.0

package/README.md

@@ -10,7 +10,7 @@
                 Agent teams for complex systems
 ```
 
-[![Version](https://img.shields.io/badge/version-2.0.0-blue)](https://github.com/amalik/convoke-agents)
+[![Version](https://img.shields.io/badge/version-2.0.1-blue)](https://github.com/amalik/convoke-agents)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 </div>
@@ -155,7 +155,19 @@ Open `_bmad/bme/_vortex/config.yaml` and replace `{user}` with your name. Agents
 
 #### Activate an Agent
 
-**Claude Code / Terminal**
+**Claude Code (slash commands)**
+
+```
+/bmad-agent-bme-contextualization-expert          # Emma  🎯
+/bmad-agent-bme-discovery-empathy-expert          # Isla  🔍
+/bmad-agent-bme-research-convergence-specialist   # Mila  🔬
+/bmad-agent-bme-hypothesis-engineer               # Liam  💡
+/bmad-agent-bme-lean-experiments-specialist        # Wade  🧪
+/bmad-agent-bme-production-intelligence-specialist # Noah  📡
+/bmad-agent-bme-learning-decision-expert           # Max   🧭
+```
+
+**Claude Code (terminal) / Other AI assistants**
 
 ```bash
 cat _bmad/bme/_vortex/agents/contextualization-expert.md          # Emma  🎯

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convoke-agents",
-  "version": "2.0.1",
+  "version": "2.1.0",
   "description": "Agent teams for complex systems, compatible with BMad Method",
   "main": "index.js",
   "files": [

package/scripts/install-vortex-agents.js

@@ -132,6 +132,7 @@ function verifyInstallation(projectRoot) {
 
   const checks = [
     ...AGENTS.map(a => ({ path: `_bmad/bme/_vortex/agents/${a.id}.md`, name: `${a.name} agent file` })),
+    ...AGENTS.map(a => ({ path: `.claude/commands/bmad-agent-bme-${a.id}.md`, name: `${a.name} slash command` })),
     { path: '_bmad/bme/_vortex/config.yaml', name: 'Configuration file' },
   ];
 
@@ -174,11 +175,14 @@ function printSuccess() {
   console.log(`  ${YELLOW}1.${RESET} Personalize your config:`);
   console.log(`     Edit ${CYAN}_bmad/bme/_vortex/config.yaml${RESET} and replace ${YELLOW}{user}${RESET} with your name`);
   console.log('');
-  console.log(`  ${YELLOW}2.${RESET} Activate an agent by reading their file:`);
+  console.log(`  ${YELLOW}2.${RESET} Activate an agent with a slash command (Claude Code):`);
   for (const agent of AGENTS) {
-    console.log(`     ${CYAN}cat _bmad/bme/_vortex/agents/${agent.id}.md${RESET}  (${agent.name})`);
+    console.log(`     ${CYAN}/bmad-agent-bme-${agent.id}${RESET}  (${agent.name})`);
   }
   console.log('');
+  console.log(`  ${YELLOW}3.${RESET} Or read the agent file directly:`);
+  console.log(`     ${CYAN}cat _bmad/bme/_vortex/agents/{agent-id}.md${RESET}`);
+  console.log('');
 }
 
 async function main() {

package/scripts/update/lib/refresh-installation.js

@@ -171,6 +171,44 @@ async function refreshInstallation(projectRoot, options = {}) {
     if (verbose) console.log('    Skipped guide copy (dev environment)');
   }
 
+  // 6. Generate .claude/commands/ slash command files for each agent
+  const commandsTarget = path.join(projectRoot, '.claude', 'commands');
+  await fs.ensureDir(commandsTarget);
+
+  // Remove deprecated command files (agents no longer in registry)
+  const currentCommandFiles = new Set(AGENTS.map(a => `bmad-agent-bme-${a.id}.md`));
+  const existingCommands = (await fs.readdir(commandsTarget)).filter(f => f.startsWith('bmad-agent-bme-'));
+  for (const file of existingCommands) {
+    if (!currentCommandFiles.has(file)) {
+      await fs.remove(path.join(commandsTarget, file));
+      changes.push(`Removed deprecated command: ${file}`);
+      if (verbose) console.log(`    Removed deprecated command: ${file}`);
+    }
+  }
+
+  for (const agent of AGENTS) {
+    const filename = `bmad-agent-bme-${agent.id}.md`;
+    const content = `---
+name: '${agent.id}'
+description: '${agent.id} agent'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/_bmad/bme/_vortex/agents/${agent.id}.md
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+    await fs.writeFile(path.join(commandsTarget, filename), content, 'utf8');
+    changes.push(`Refreshed command: ${filename}`);
+    if (verbose) console.log(`    Refreshed command: ${filename}`);
+  }
+
   return changes;
 }