ma-agents 3.4.7 → 3.4.9

package/.roo/skills/.ma-agents.json

@@ -6,235 +6,235 @@
   ],
   "scope": "project",
   "skills": {
-    "ai-audit-trail": {
-      "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:57.964Z",
-      "updatedAt": "2026-04-01T10:30:57.964Z",
-      "installerVersion": "3.4.3",
+    "git-workflow-skill": {
+      "version": "2.1.0",
+      "installedAt": "2026-04-05T18:07:11.796Z",
+      "updatedAt": "2026-04-05T18:09:28.594Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "auto-bug-detection": {
+    "js-ts-dependency-mgmt": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:58.325Z",
-      "updatedAt": "2026-04-01T10:30:58.325Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:29.914Z",
+      "updatedAt": "2026-04-05T18:09:35.500Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cmake-best-practices": {
+    "js-ts-security-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:58.793Z",
-      "updatedAt": "2026-04-01T10:30:58.793Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:31.385Z",
+      "updatedAt": "2026-04-05T18:09:36.516Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "code-documentation": {
+    "logging-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:30:59.731Z",
-      "updatedAt": "2026-04-01T10:30:59.731Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:34.134Z",
+      "updatedAt": "2026-04-05T18:09:43.689Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "code-review": {
+    "open-presentation": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:00.537Z",
-      "updatedAt": "2026-04-01T10:31:00.537Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:36.069Z",
+      "updatedAt": "2026-04-05T18:09:52.386Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "commit-message": {
+    "opentelemetry-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:01.059Z",
-      "updatedAt": "2026-04-01T10:31:01.059Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:38.939Z",
+      "updatedAt": "2026-04-05T18:10:00.924Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-best-practices": {
+    "python-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:01.674Z",
-      "updatedAt": "2026-04-01T10:31:01.674Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:40.136Z",
+      "updatedAt": "2026-04-05T18:07:40.136Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-concurrency-safety": {
+    "python-dependency-mgmt": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:02.633Z",
-      "updatedAt": "2026-04-01T10:31:02.633Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:41.056Z",
+      "updatedAt": "2026-04-05T18:07:41.056Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-const-correctness": {
+    "python-security-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:03.280Z",
-      "updatedAt": "2026-04-01T10:31:03.280Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:43.093Z",
+      "updatedAt": "2026-04-05T18:07:43.093Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-memory-handling": {
+    "self-signed-cert": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:03.815Z",
-      "updatedAt": "2026-04-01T10:31:03.815Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:46.241Z",
+      "updatedAt": "2026-04-05T18:07:46.241Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-modern-composition": {
+    "skill-creator": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:04.665Z",
-      "updatedAt": "2026-04-01T10:31:04.665Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:47.998Z",
+      "updatedAt": "2026-04-05T18:07:47.998Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "cpp-robust-interfaces": {
+    "story-status-lookup": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:05.277Z",
-      "updatedAt": "2026-04-01T10:31:05.277Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:50.543Z",
+      "updatedAt": "2026-04-05T18:07:50.543Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "create-hardened-docker-skill": {
+    "test-accompanied-development": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:05.763Z",
-      "updatedAt": "2026-04-01T10:31:05.763Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:52.573Z",
+      "updatedAt": "2026-04-05T18:07:52.573Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "csharp-best-practices": {
+    "test-generator": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:06.439Z",
-      "updatedAt": "2026-04-01T10:31:06.439Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:54.185Z",
+      "updatedAt": "2026-04-05T18:07:54.185Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "docker-hardening-verification": {
+    "vercel-react-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:06.898Z",
-      "updatedAt": "2026-04-01T10:31:06.898Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:07:57.384Z",
+      "updatedAt": "2026-04-05T18:07:57.384Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "docker-image-signing": {
+    "verify-hardened-docker-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:07.472Z",
-      "updatedAt": "2026-04-01T10:31:07.472Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:03.799Z",
+      "updatedAt": "2026-04-05T18:08:03.799Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "document-revision-history": {
+    "ai-audit-trail": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:07.952Z",
-      "updatedAt": "2026-04-01T10:31:07.952Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:37.965Z",
+      "updatedAt": "2026-04-05T18:08:37.965Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "git-workflow-skill": {
-      "version": "2.1.0",
-      "installedAt": "2026-04-01T10:31:08.676Z",
-      "updatedAt": "2026-04-01T10:31:08.676Z",
-      "installerVersion": "3.4.3",
+    "auto-bug-detection": {
+      "version": "1.0.0",
+      "installedAt": "2026-04-05T18:08:40.373Z",
+      "updatedAt": "2026-04-05T18:08:40.373Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "js-ts-dependency-mgmt": {
+    "cmake-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:09.369Z",
-      "updatedAt": "2026-04-01T10:31:09.369Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:42.856Z",
+      "updatedAt": "2026-04-05T18:08:42.856Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "js-ts-security-skill": {
+    "code-documentation": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:09.751Z",
-      "updatedAt": "2026-04-01T10:31:09.751Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:44.950Z",
+      "updatedAt": "2026-04-05T18:08:44.950Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "logging-best-practices": {
+    "code-review": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:10.601Z",
-      "updatedAt": "2026-04-01T10:31:10.601Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:47.579Z",
+      "updatedAt": "2026-04-05T18:08:47.579Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "open-presentation": {
+    "commit-message": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:11.233Z",
-      "updatedAt": "2026-04-01T10:31:11.233Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:50.135Z",
+      "updatedAt": "2026-04-05T18:08:50.135Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "opentelemetry-best-practices": {
+    "cpp-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:12.098Z",
-      "updatedAt": "2026-04-01T10:31:12.098Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:51.353Z",
+      "updatedAt": "2026-04-05T18:08:51.353Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "python-best-practices": {
+    "cpp-concurrency-safety": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:13.056Z",
-      "updatedAt": "2026-04-01T10:31:13.056Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:56.356Z",
+      "updatedAt": "2026-04-05T18:08:56.356Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "python-dependency-mgmt": {
+    "cpp-const-correctness": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:13.837Z",
-      "updatedAt": "2026-04-01T10:31:13.837Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:57.310Z",
+      "updatedAt": "2026-04-05T18:08:57.310Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "python-security-skill": {
+    "cpp-memory-handling": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:14.421Z",
-      "updatedAt": "2026-04-01T10:31:14.421Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:08:59.504Z",
+      "updatedAt": "2026-04-05T18:08:59.504Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "self-signed-cert": {
+    "cpp-modern-composition": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:14.804Z",
-      "updatedAt": "2026-04-01T10:31:14.804Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:02.773Z",
+      "updatedAt": "2026-04-05T18:09:02.773Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "skill-creator": {
+    "cpp-robust-interfaces": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:15.803Z",
-      "updatedAt": "2026-04-01T10:31:15.803Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:05.339Z",
+      "updatedAt": "2026-04-05T18:09:05.339Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "story-status-lookup": {
+    "create-hardened-docker-skill": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:16.445Z",
-      "updatedAt": "2026-04-01T10:31:16.445Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:06.578Z",
+      "updatedAt": "2026-04-05T18:09:06.578Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "test-accompanied-development": {
+    "csharp-best-practices": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:16.737Z",
-      "updatedAt": "2026-04-01T10:31:16.737Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:09.825Z",
+      "updatedAt": "2026-04-05T18:09:09.825Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "test-generator": {
+    "docker-hardening-verification": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:17.541Z",
-      "updatedAt": "2026-04-01T10:31:17.541Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:12.458Z",
+      "updatedAt": "2026-04-05T18:09:12.458Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "vercel-react-best-practices": {
+    "docker-image-signing": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:18.027Z",
-      "updatedAt": "2026-04-01T10:31:18.027Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:21.187Z",
+      "updatedAt": "2026-04-05T18:09:21.187Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     },
-    "verify-hardened-docker-skill": {
+    "document-revision-history": {
       "version": "1.0.0",
-      "installedAt": "2026-04-01T10:31:18.973Z",
-      "updatedAt": "2026-04-01T10:31:18.973Z",
-      "installerVersion": "3.4.3",
+      "installedAt": "2026-04-05T18:09:25.264Z",
+      "updatedAt": "2026-04-05T18:09:25.264Z",
+      "installerVersion": "3.4.9",
       "agentVersion": "1.0.0"
     }
   }

package/bin/cli.js

@@ -7,6 +7,7 @@ const fs = require('fs');
 const { execFileSync } = require('child_process');
 const { installSkill, uninstallSkill, getStatus, listSkills, listAgents, updateProjectContextRepoLayout } = require('../lib/installer');
 const bmad = require('../lib/bmad');
+const { getBmadPlatformCode } = require('../lib/agents');
 const { handleCreateSkill, handleValidateSkill, handleSetMandatory, handleCustomizeAgent, handleCreateAgent } = require('../lib/skill-authoring');
 
 const PKG = require('../package.json');
@@ -651,13 +652,13 @@ async function collectRepoLayout(flags, existingLayout = null) {
 
 // --- Install wizard ---
 
-async function installWizard(preselectedSkill, preselectedAgents, customPath, forceFlag, yesFlag = false) {
+async function installWizard(preselectedSkill, preselectedAgents, customPath, forceFlag, yesFlag = false, cliScope) {
   const skills = listSkills();
   const agents = listAgents();
 
   let selectedSkillIds = preselectedSkill ? [preselectedSkill] : [];
   let selectedAgentIds = preselectedAgents || [];
-  let installScope = 'project';
+  let installScope = cliScope || 'project';
   let installPath = customPath || '';
 
   const existingStatus = getStatus([], '', 'project');
@@ -827,8 +828,8 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
   const existingLayout = isUpdate ? readExistingLayout() : null;
   const repoLayout = await collectRepoLayout({ yes: yesFlag }, existingLayout);
 
-  // Step 3: Scope (Skip if update, yesFlag, or path already set)
-  if (!isUpdate && !installPath && !yesFlag) {
+  // Step 3: Scope (Skip if update, yesFlag, CLI --global flag, or path already set)
+  if (!isUpdate && !installPath && !yesFlag && !cliScope) {
     const { pathChoice } = await prompts({
       type: 'select',
       name: 'pathChoice',
@@ -853,6 +854,20 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
     }
   }
 
+  // Step 3.4: Filter out BMAD agents for global scope (they require project-level install)
+  if (installScope === 'global') {
+    const bmadAgentIds = selectedAgentIds.filter(id => {
+      const agent = agents.find(a => a.id === id);
+      return agent && agent.category === 'bmad';
+    });
+    if (bmadAgentIds.length > 0) {
+      console.log(chalk.yellow(`\n  Warning: BMAD agents require project-level installation and will be skipped for global scope:`));
+      console.log(chalk.yellow(`    ${bmadAgentIds.join(', ')}`));
+      console.log(chalk.gray(`  Run again without --global to install BMAD agents into the current project.`));
+      selectedAgentIds = selectedAgentIds.filter(id => !bmadAgentIds.includes(id));
+    }
+  }
+
   // Step 3.5: BMAD-METHOD Integration
   if (installScope === 'project') {
     const bmadToolsFilter = agents.filter(a => a.category === 'ide').map(a => a.id);
@@ -870,7 +885,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
     if (!bmadInstalled) {
       if (yesFlag) {
         console.log(chalk.cyan('\n Installing BMAD-METHOD...'));
-        const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
+        const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id)).map(id => getBmadPlatformCode(id));
         const success = await bmad.installBmad(['bmm'], bmadTools);
         if (success) {
           console.log(chalk.green(' BMAD-METHOD installed successfully!'));
@@ -887,7 +902,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
 
         if (installBmad) {
           console.log(chalk.cyan('\n Installing BMAD-METHOD...'));
-          const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
+          const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id)).map(id => getBmadPlatformCode(id));
           const success = await bmad.installBmad(['bmm'], bmadTools);
           if (success) {
             console.log(chalk.green(' BMAD-METHOD installed successfully!'));
@@ -899,7 +914,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
     } else {
       if (yesFlag) {
         console.log(chalk.cyan('\n Updating BMAD-METHOD...'));
-        const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
+        const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id)).map(id => getBmadPlatformCode(id));
         const success = await bmad.updateBmad(['bmm'], bmadTools);
         if (success) {
           console.log(chalk.green(' BMAD-METHOD updated successfully!'));
@@ -916,7 +931,7 @@ async function installWizard(preselectedSkill, preselectedAgents, customPath, fo
 
         if (updateBmad) {
           console.log(chalk.cyan('\n Updating BMAD-METHOD...'));
-          const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id));
+          const bmadTools = selectedAgentIds.filter(id => bmadToolsFilter.includes(id)).map(id => getBmadPlatformCode(id));
           const success = await bmad.updateBmad(['bmm'], bmadTools);
           if (success) {
             console.log(chalk.green(' BMAD-METHOD updated successfully!'));
@@ -1052,13 +1067,13 @@ async function handleInstall(args) {
 
   // No skill → launch wizard (Task 3.3, 3.4)
   if (!skillId) {
-    await installWizard(null, preselectedAgents, customPath, forceFlag, yesFlag);
+    await installWizard(null, preselectedAgents, customPath, forceFlag, yesFlag, scope);
     return;
   }
 
   // Skill but no agents (and no agentFlag) → wizard with skill preselected
   if (!agentFlag && agentIds.length === 0) {
-    await installWizard(skillId, null, customPath, forceFlag, yesFlag);
+    await installWizard(skillId, null, customPath, forceFlag, yesFlag, scope);
     return;
   }
 

package/lib/agents.js

@@ -81,6 +81,7 @@ const agents = [
     },
     fileExtension: '.md',
     template: 'generic',
+    bmadPlatformCode: 'github-copilot',
     instructionFiles: ['.github/copilot/copilot.md'],
     injectionStrategy: { position: 'top', skipPatterns: ['---'] }
   },
@@ -104,6 +105,7 @@ const agents = [
     },
     fileExtension: '.md',
     template: 'generic',
+    bmadPlatformCode: 'kilo',
     instructionFiles: ['.kilocode/kilocode.md'],
     injectionStrategy: { position: 'top', skipPatterns: ['---'] }
   },
@@ -155,6 +157,7 @@ const agents = [
     },
     fileExtension: '.md',
     template: 'generic',
+    bmadPlatformCode: 'roo',
     instructionFiles: ['.roo/rules/00-ma-agents.md'],
     injectionStrategy: { position: 'top', skipPatterns: ['---'] }
   },
@@ -189,16 +192,7 @@ const agents = [
     description: 'Specialized SRE Agent for BMAD-METHOD',
     skillsDir: '_bmad/skills/sre',
     getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'sre'),
-    getGlobalPath: () => {
-      const platform = os.platform();
-      if (platform === 'win32') {
-        return path.join(os.homedir(), 'AppData', 'Roaming', 'SRE', 'skills');
-      } else if (platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', 'SRE', 'skills');
-      } else {
-        return path.join(os.homedir(), '.config', 'sre', 'skills');
-      }
-    },
+    getGlobalPath: () => null,
     fileExtension: '.md',
     template: 'generic',
     instructionFiles: ['_bmad/bmm/agents/sre.md'],
@@ -258,16 +252,7 @@ const agents = [
     description: 'Specialized DevOps Agent for BMAD-METHOD',
     skillsDir: '_bmad/skills/devops',
     getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'devops'),
-    getGlobalPath: () => {
-      const platform = os.platform();
-      if (platform === 'win32') {
-        return path.join(os.homedir(), 'AppData', 'Roaming', 'DevOps', 'skills');
-      } else if (platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', 'DevOps', 'skills');
-      } else {
-        return path.join(os.homedir(), '.config', 'devops', 'skills');
-      }
-    },
+    getGlobalPath: () => null,
     fileExtension: '.md',
     template: 'generic',
     instructionFiles: ['_bmad/bmm/agents/devops.md'],
@@ -281,16 +266,7 @@ const agents = [
     description: 'Specialized Cyber Security Analyst (Yael) for BMAD-METHOD',
     skillsDir: '_bmad/skills/cyber',
     getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'cyber'),
-    getGlobalPath: () => {
-      const platform = os.platform();
-      if (platform === 'win32') {
-        return path.join(os.homedir(), 'AppData', 'Roaming', 'Cyber', 'skills');
-      } else if (platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', 'Cyber', 'skills');
-      } else {
-        return path.join(os.homedir(), '.config', 'cyber', 'skills');
-      }
-    },
+    getGlobalPath: () => null,
     fileExtension: '.md',
     template: 'generic',
     instructionFiles: ['_bmad/bmm/agents/cyber.md'],
@@ -304,16 +280,7 @@ const agents = [
     description: 'MIL-STD-498 Documentation Expert',
     skillsDir: '_bmad/skills/mil498',
     getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'mil498'),
-    getGlobalPath: () => {
-      const platform = os.platform();
-      if (platform === 'win32') {
-        return path.join(os.homedir(), 'AppData', 'Roaming', 'Mil498', 'skills');
-      } else if (platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', 'Mil498', 'skills');
-      } else {
-        return path.join(os.homedir(), '.config', 'mil498', 'skills');
-      }
-    },
+    getGlobalPath: () => null,
     fileExtension: '.md',
     template: 'generic',
     instructionFiles: ['_bmad/bmm/agents/mil498.md'],
@@ -327,16 +294,7 @@ const agents = [
     description: 'Machine Learning Lifecycle Agent (Demerzel)',
     skillsDir: '_bmad/skills/demerzel',
     getProjectPath: () => path.join(process.cwd(), '_bmad', 'skills', 'demerzel'),
-    getGlobalPath: () => {
-      const platform = os.platform();
-      if (platform === 'win32') {
-        return path.join(os.homedir(), 'AppData', 'Roaming', 'Demerzel', 'skills');
-      } else if (platform === 'darwin') {
-        return path.join(os.homedir(), 'Library', 'Application Support', 'Demerzel', 'skills');
-      } else {
-        return path.join(os.homedir(), '.config', 'demerzel', 'skills');
-      }
-    },
+    getGlobalPath: () => null,
     fileExtension: '.md',
     template: 'generic',
     instructionFiles: ['_bmad/bmm/agents/demerzel.md'],
@@ -356,8 +314,20 @@ function getAgentsByCategory(category) {
   return agents.filter(a => a.category === category);
 }
 
+/**
+ * Returns the bmad-method platform code for a given ma-agents agent ID.
+ * Some agents use a different code in bmad-method's platform-codes.yaml
+ * (e.g. ma-agents 'roo-code' → bmad-method 'roo').
+ * Falls back to the agent ID itself if no override is defined.
+ */
+function getBmadPlatformCode(agentId) {
+  const agent = getAgent(agentId);
+  return (agent && agent.bmadPlatformCode) ? agent.bmadPlatformCode : agentId;
+}
+
 module.exports = {
   getAgent,
   getAllAgents,
-  getAgentsByCategory
+  getAgentsByCategory,
+  getBmadPlatformCode
 };