bmad-plus 0.8.0 → 0.9.1

package/tools/cli/commands/update.js

@@ -11,35 +11,17 @@ const fsExtra = require('fs-extra');
 const clack = require('@clack/prompts');
 const pc = require('picocolors');
 const { t } = require('../i18n');
+const { PACKS } = require('../lib/packs');
+const { copyPackFiles } = require('../lib/pack-copy');
 
-// Same pack definitions as install.js — keep in sync
-const PACKS = {
-  core: {
-    agents: ['agent-strategist', 'agent-architect-dev', 'agent-quality', 'agent-orchestrator'],
-    skills: ['bmad-plus-autopilot', 'bmad-plus-parallel', 'bmad-plus-sync'],
-    data: ['role-triggers.yaml'],
-  },
-  osint: {
-    agents: ['agent-shadow'],
-    skills: [],
-    externalPackage: 'osint-agent-package',
-  },
-  maker: {
-    agents: ['agent-maker'],
-    skills: [],
-    data: [],
-  },
-  seo: { agents: [], skills: [], packDir: 'pack-seo' },
-  backup: { agents: [], skills: [], packDir: 'pack-backup' },
-  animated: { agents: [], skills: [], packDir: 'pack-animated' },
-  shield: { agents: [], skills: [], packDir: 'pack-shield', packSrcDir: 'packs' },
-};
+// Pack definitions imported from shared module: require('../lib/packs').PACKS
 
 module.exports = {
   command: 'update',
   description: 'Update BMAD+ agents and skills (preserves config)',
   options: [
     ['-d, --directory <path>', 'Project directory (default: current directory)'],
+    ['-l, --lang <code>', 'Language code: en, fr, es, de, pt-br, ru, zh, he, ja, it'],
   ],
   action: async (options) => {
     const projectDir = path.resolve(options.directory || process.cwd());
@@ -58,7 +40,7 @@ module.exports = {
     }
 
     const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-    const lang = manifest.uiLanguage || 'en';
+    const lang = options.lang || manifest.uiLanguage || 'en';
     const i = t(lang);
 
     clack.log.info(`📦 Installed: v${manifest.version} → Available: v${packageJson.version}`);
@@ -92,59 +74,20 @@ module.exports = {
 
     let updated = 0;
 
+    const projectRoot = path.join(bmadSrc, '..', '..');
+
     for (const packId of selectedPacks) {
       const pack = PACKS[packId];
       if (!pack) continue;
 
-      // Update agents
-      for (const agent of (pack.agents || [])) {
-        const src = path.join(bmadSrc, 'agents', agent);
-        const dest = path.join(targetAgentsDir, agent);
-        if (fs.existsSync(src)) {
-          fsExtra.copySync(src, dest, { overwrite: true });
-          updated++;
-        }
-      }
-
-      // Update skills
-      for (const skill of (pack.skills || [])) {
-        const src = path.join(bmadSrc, 'skills', skill);
-        const dest = path.join(targetAgentsDir, skill);
-        if (fs.existsSync(src)) {
-          fsExtra.copySync(src, dest, { overwrite: true });
-          updated++;
-        }
-      }
-
-      // Update data files
-      for (const dataFile of (pack.data || [])) {
-        const src = path.join(bmadSrc, 'data', dataFile);
-        const dest = path.join(targetDataDir, dataFile);
-        if (fs.existsSync(src)) {
-          fsExtra.copySync(src, dest, { overwrite: true });
-          updated++;
-        }
-      }
-
-      // Update external package (OSINT)
-      if (pack.externalPackage) {
-        const extSrc = path.join(__dirname, '..', '..', '..', pack.externalPackage, 'skills');
-        if (fs.existsSync(extSrc)) {
-          fsExtra.copySync(extSrc, targetAgentsDir, { overwrite: true });
-          updated++;
-        }
-      }
-
-      // Update pack directory (SEO, Backup, Animated, Shield)
-      if (pack.packDir) {
-        const srcParent = pack.packSrcDir || 'agents';
-        const packSrc = path.join(bmadSrc, srcParent, pack.packDir);
-        const packDest = path.join(targetAgentsDir, pack.packDir);
-        if (fs.existsSync(packSrc)) {
-          fsExtra.copySync(packSrc, packDest, { overwrite: true });
-          updated++;
-        }
-      }
+      const result = copyPackFiles({
+        bmadSrc,
+        targetAgentsDir,
+        targetDataDir,
+        projectRoot,
+        pack,
+      });
+      updated += result.copiedAgents + result.copiedSkills + result.copiedFiles;
     }
 
     // Update module config (always)

package/tools/cli/i18n.js

@@ -5,12 +5,14 @@
  * Author: Laurent Rochetta
  */
 
+const VERSION = require('../../package.json').version;
+
 const LANGUAGES = {
   en: {
     flag: '🇬🇧',
     name: 'English',
     locale: 'en',
-    installer_title: ' BMAD+ Installer v0.8.0 ',
+    installer_title: ` BMAD+ Installer v${VERSION} `,
     select_language: 'Select your language',
     installing_to: 'Installing to',
     select_packs: 'Which packs to install? (Core is always included)',
@@ -92,7 +94,7 @@ const LANGUAGES = {
     flag: '🇫🇷',
     name: 'Français',
     locale: 'fr',
-    installer_title: ' BMAD+ Installeur v0.8.0 ',
+    installer_title: ` BMAD+ Installeur v${VERSION} `,
     select_language: 'Choisissez votre langue',
     installing_to: 'Installation dans',
     select_packs: 'Quels packs installer ? (Core est toujours inclus)',
@@ -172,7 +174,7 @@ const LANGUAGES = {
     flag: '🇪🇸',
     name: 'Español',
     locale: 'es',
-    installer_title: ' BMAD+ Instalador v0.8.0 ',
+    installer_title: ` BMAD+ Instalador v${VERSION} `,
     select_language: 'Seleccione su idioma',
     installing_to: 'Instalando en',
     select_packs: '¿Qué packs instalar? (Core siempre está incluido)',
@@ -236,13 +238,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Backup: "/backup create" → ZIP con marca de tiempo',
     guide_example_animated: '🎬 Animado: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Cerebro persistente',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Memoria: "Zecher, escanea proyectos en D:\\DEV"',
+    guide_example_memory_2: '🧠 Memoria: "Zecher, ¿dónde estábamos?"',
+    guide_example_memory_3: '🧠 Memoria: "Zecher, consolida la memoria"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, haz una lluvia de ideas para una app de productividad"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, diseña la arquitectura"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, implementa la historia S1"',
+    brain_detected: 'Cerebro existente detectado',
+    brain_created: 'Cerebro global creado',
   },
 
   de: {
     flag: '🇩🇪',
     name: 'Deutsch',
     locale: 'de',
-    installer_title: ' BMAD+ Installer v0.8.0 ',
+    installer_title: ` BMAD+ Installer v${VERSION} `,
     select_language: 'Wählen Sie Ihre Sprache',
     installing_to: 'Installiere in',
     select_packs: 'Welche Packs installieren? (Core ist immer enthalten)',
@@ -306,13 +318,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Backup: "/backup create" → ZIP mit Zeitstempel',
     guide_example_animated: '🎬 Animiert: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Beständiges Gehirn',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Gedächtnis: "Zecher, scanne Projekte in D:\\DEV"',
+    guide_example_memory_2: '🧠 Gedächtnis: "Zecher, wo waren wir?"',
+    guide_example_memory_3: '🧠 Gedächtnis: "Zecher, konsolidiere Gedächtnis"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, brainstorme eine Produktivitäts-App"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, entwirf die Architektur"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, implementiere Story S1"',
+    brain_detected: 'Vorhandenes Gehirn erkannt',
+    brain_created: 'Globales Gehirn erstellt',
   },
 
   'pt-br': {
     flag: '🇧🇷',
     name: 'Português (Brasil)',
     locale: 'pt-BR',
-    installer_title: ' BMAD+ Instalador v0.8.0 ',
+    installer_title: ` BMAD+ Instalador v${VERSION} `,
     select_language: 'Selecione seu idioma',
     installing_to: 'Instalando em',
     select_packs: 'Quais packs instalar? (Core sempre está incluído)',
@@ -376,13 +398,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Backup: "/backup create" → ZIP com timestamp',
     guide_example_animated: '🎬 Animado: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Cérebro persistente',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Memória: "Zecher, escaneie projetos em D:\\DEV"',
+    guide_example_memory_2: '🧠 Memória: "Zecher, onde estávamos?"',
+    guide_example_memory_3: '🧠 Memória: "Zecher, consolide a memória"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, faça um brainstorm de um app de produtividade"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, projete a arquitetura"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, implemente a história S1"',
+    brain_detected: 'Cérebro existente detectado',
+    brain_created: 'Cérebro global criado',
   },
 
   ru: {
     flag: '🇷🇺',
     name: 'Русский',
     locale: 'ru',
-    installer_title: ' BMAD+ Установщик v0.8.0 ',
+    installer_title: ` BMAD+ Установщик v${VERSION} `,
     select_language: 'Выберите язык',
     installing_to: 'Установка в',
     select_packs: 'Какие пакеты установить? (Core всегда включён)',
@@ -446,13 +478,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Бэкап: "/backup create" → ZIP',
     guide_example_animated: '🎬 Анимация: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Постоянный мозг',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Память: "Zecher, сканируй проекты в D:\\DEV"',
+    guide_example_memory_2: '🧠 Память: "Zecher, на чём мы остановились?"',
+    guide_example_memory_3: '🧠 Память: "Zecher, консолидируй память"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, проведи мозговой штурм приложения"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, спроектируй архитектуру"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, реализуй историю S1"',
+    brain_detected: 'Существующий мозг обнаружен',
+    brain_created: 'Глобальный мозг создан',
   },
 
   zh: {
     flag: '🇨🇳',
     name: '中文 (简体)',
     locale: 'zh-CN',
-    installer_title: ' BMAD+ 安装程序 v0.8.0 ',
+    installer_title: ` BMAD+ 安装程序 v${VERSION} `,
     select_language: '选择您的语言',
     installing_to: '安装到',
     select_packs: '安装哪些包？（Core 始终包含）',
@@ -516,13 +558,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  备份: "/backup create" → ZIP',
     guide_example_animated: '🎬 动画: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 持久记忆',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 记忆: "Zecher, 扫描 D:\\DEV 中的项目"',
+    guide_example_memory_2: '🧠 记忆: "Zecher, 我们进行到哪里了?"',
+    guide_example_memory_3: '🧠 记忆: "Zecher, 整合记忆"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, 集思广益一个生产力应用"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, 设计架构"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, 实现故事 S1"',
+    brain_detected: '检测到现有大脑',
+    brain_created: '全局大脑已创建',
   },
 
   he: {
     flag: '🇮🇱',
     name: 'עברית',
     locale: 'he',
-    installer_title: ' BMAD+ מתקין v0.8.0 ',
+    installer_title: ` BMAD+ מתקין v${VERSION} `,
     select_language: 'בחר את השפה שלך',
     installing_to: 'מתקין ב',
     select_packs: 'אילו חבילות להתקין? (Core תמיד כלול)',
@@ -586,13 +638,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  גיבוי: "/backup create" → ZIP',
     guide_example_animated: '🎬 אנימציה: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 זיכרון מתמשך',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 זיכרון: "Zecher, סרוק פרויקטים ב-D:\\DEV"',
+    guide_example_memory_2: '🧠 זיכרון: "Zecher, איפה היינו?"',
+    guide_example_memory_3: '🧠 זיכרון: "Zecher, אחד זיכרון"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, עשה סיעור מוחות לאפליקציית פרודוקטיביות"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, תכנן את הארכיטקטורה"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, יישם את הסיפור S1"',
+    brain_detected: 'זוהה מוח קיים',
+    brain_created: 'מוח גלובלי נוצר',
   },
 
   ja: {
     flag: '🇯🇵',
     name: '日本語',
     locale: 'ja',
-    installer_title: ' BMAD+ インストーラー v0.8.0 ',
+    installer_title: ` BMAD+ インストーラー v${VERSION} `,
     select_language: '言語を選択してください',
     installing_to: 'インストール先',
     select_packs: 'どのパックをインストールしますか？（Coreは常に含まれます）',
@@ -656,13 +718,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  バックアップ: "/backup create" → ZIP',
     guide_example_animated: '🎬 アニメ: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 永続的な脳',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 記憶: "Zecher, D:\\DEV のプロジェクトをスキャン"',
+    guide_example_memory_2: '🧠 記憶: "Zecher, どこまで進んだ?"',
+    guide_example_memory_3: '🧠 記憶: "Zecher, 記憶を統合"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, 生産性アプリをブレインストーミング"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, アーキテクチャを設計"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, ストーリーS1を実装"',
+    brain_detected: '既存の脳を検出',
+    brain_created: 'グローバル脳を作成',
   },
 
   it: {
     flag: '🇮🇹',
     name: 'Italiano',
     locale: 'it',
-    installer_title: ' BMAD+ Installatore v0.8.0 ',
+    installer_title: ` BMAD+ Installatore v${VERSION} `,
     select_language: 'Seleziona la tua lingua',
     installing_to: 'Installazione in',
     select_packs: 'Quali pack installare? (Core è sempre incluso)',
@@ -726,6 +798,16 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Backup: "/backup create" → ZIP con timestamp',
     guide_example_animated: '🎬 Animato: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Memoria persistente',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Memoria: "Zecher, scansiona progetti in D:\\DEV"',
+    guide_example_memory_2: '🧠 Memoria: "Zecher, dove eravamo?"',
+    guide_example_memory_3: '🧠 Memoria: "Zecher, consolida la memoria"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, fai un brainstorming di un\'app di produttività"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, progetta l\'architettura"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, implementa la storia S1"',
+    brain_detected: 'Cervello esistente rilevato',
+    brain_created: 'Cervello globale creato',
   },
 };
 

package/tools/cli/lib/ide-config.js

@@ -0,0 +1,259 @@
+/**
+ * BMAD+ IDE Configuration Generator
+ * Extracted from install.js for modularity.
+ * Generates CLAUDE.md, GEMINI.md, AGENTS.md content with pack-aware agent filtering.
+ *
+ * Author: Laurent Rochetta
+ */
+
+// ── IDE Configurations ──
+
+const IDE_CONFIGS = {
+  'claude-code': {
+    name: 'Claude Code',
+    detect: ['.claude'],
+    configFile: 'CLAUDE.md',
+  },
+  'gemini-cli': {
+    name: 'Gemini CLI',
+    detect: ['.gemini'],
+    configFile: 'GEMINI.md',
+  },
+  'codex-cli': {
+    name: 'Codex CLI / OpenCode',
+    detect: ['.codex', '.opencode'],
+    configFile: 'AGENTS.md',
+  },
+  'antigravity': {
+    name: 'Antigravity',
+    detect: ['.gemini/antigravity'],
+    configFile: 'GEMINI.md',
+  },
+};
+
+// All 14 BMAD+ agents — always included in templates
+const AGENT_LIST = [
+  '- **Atlas** (Strategist) — Business analysis + Product management',
+  '- **Forge** (Architect-Dev) — Architecture + Development + Documentation',
+  '- **Sentinel** (Quality) — QA + UX review',
+  '- **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution',
+  '- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling',
+  '- **Shield** (GRC) — 38 compliance agents (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2...)',
+  '- **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs',
+  '- **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review',
+  '- **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization',
+  '- **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping',
+  '- **Bezalel** (בצלאל) — System Architect — Architecture, ADRs, epics & stories',
+  '- **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation',
+  '- **Zecher** (זכר) — Memory Archivist — Consolidation, project scanning, context recall',
+  '- **Maker** (Creator) — Custom agent builder — Create new agents from description',
+];
+
+/**
+ * Filter agents based on installed packs.
+ * Core agents are always included; others depend on pack selection.
+ *
+ * @param {string[]} packs - List of installed pack IDs
+ * @returns {string[]} Agent description lines
+ */
+function getAgentsByPacks(packs) {
+  const agents = [
+    '- **Atlas** (Strategist) — Business analysis + Product management',
+    '- **Forge** (Architect-Dev) — Architecture + Development + Documentation',
+    '- **Sentinel** (Quality) — QA + UX review',
+    '- **Nexus** (Orchestrator) — Sprint management + Autopilot + Parallel execution',
+  ];
+
+  if (packs.includes('osint')) {
+    agents.push('- **Shadow** (OSINT) — Investigation + Scraping + Psychoprofiling');
+  }
+
+  if (packs.includes('shield')) {
+    agents.push('- **Shield** (GRC) — 38 compliance agents (GDPR, ISO 27001, SOC 2, HIPAA, EU AI Act, DORA, NIS2...)');
+  }
+
+  if (packs.includes('maker')) {
+    agents.push('- **Maker** (Creator) — Custom agent builder — Create new agents from description');
+  }
+
+  if (packs.includes('dev-studio')) {
+    agents.push('- **Miriam** (מרים) — Business Analyst — Strategic analysis, research, product briefs');
+    agents.push('- **Huldah** (חולדה) — Technical Writer — Documentation, diagrams, editorial review');
+    agents.push('- **Yosef** (יוסף) — Product Manager — PRD, requirements, feature prioritization');
+    agents.push('- **Rachel** (רחל) — UX Designer — User experience, wireframes, empathy mapping');
+    agents.push('- **Bezalel** (בצלאל) — System Architecture — Architecture, ADRs, epics & stories');
+    agents.push('- **Oholiab** (אהליאב) — Senior Engineer — TDD, sprint, code review, implementation');
+  }
+
+  if (packs.includes('memory')) {
+    agents.push('- **Zecher** (זכר) — Memory Archivist — Consolidation, project scanning, context recall');
+  }
+
+  return agents;
+}
+
+/**
+ * Build the Memory Protocol section if the memory pack is installed.
+ *
+ * @param {string[]} packs - List of installed pack IDs
+ * @returns {string} Memory section markdown (empty string if no memory pack)
+ */
+function getMemorySection(packs) {
+  if (!packs.includes('memory')) return '';
+  return [
+    '',
+    '## Memory Protocol (Karpathy Guardrails)',
+    '',
+    'Agents MUST follow these behavioral principles:',
+    '',
+    '### G1 — Think Before Coding',
+    '- State assumptions explicitly. If uncertain, ask.',
+    '- Check `.agents/memory/decisions.md` for prior decisions before re-deciding.',
+    '',
+    '### G2 — Simplicity First',
+    '- Minimum code that solves the problem. Nothing speculative.',
+    '- Check `.agents/memory/patterns.md` for existing solutions.',
+    '',
+    '### G3 — Surgical Changes',
+    '- Touch only what you must. Match existing style.',
+    '- Log surprises in `.agents/memory/lessons.md`.',
+    '',
+    '### G4 — Goal-Driven Execution',
+    '- Define success criteria before implementing.',
+    '- Log non-obvious decisions in `.agents/memory/decisions.md`.',
+    '',
+    '### Memory Files',
+    '- `.agents/memory/decisions.md` — Read at session start, write when making decisions',
+    '- `.agents/memory/lessons.md` — Write when something unexpected happens',
+    '- `.agents/memory/patterns.md` — Write when a reusable pattern is validated',
+    '- `.agents/memory/context.md` — Update at session end with project state',
+  ].join('\n');
+}
+
+/**
+ * Generate IDE config content with pack-aware agent filtering.
+ *
+ * @param {string} userName - The user's display name
+ * @param {string} language - User-facing communication language
+ * @param {string[]} packs - List of installed pack IDs
+ * @returns {string} Complete Markdown template
+ */
+function generateIDEConfig(userName, language, packs) {
+  const agents = getAgentsByPacks(packs);
+  const memorySection = getMemorySection(packs);
+
+  return `# BMAD+ — AI Agent Configuration
+
+## Project Context
+This project uses BMAD+, an augmented AI-driven development framework.
+Based on BMAD-METHOD v6.6.0 with multi-role agents, autopilot mode, and parallel execution.
+
+## Agents
+To activate an agent, say its name or persona:
+${agents.join('\n')}
+
+## Skills
+- Load skills from \`.agents/skills/\`
+- Each agent has a SKILL.md with capabilities, activation protocol, and role-switching rules
+- Auto-activation triggers: \`.agents/data/role-triggers.yaml\`
+
+## Key Commands
+- \`bmad-help\` — Show all available agents and skills
+- \`autopilot\` — Launch Nexus in full pipeline mode
+- \`parallel\` — Enable parallel multi-agent execution
+
+## Communication
+- User name: ${userName}
+- Default language: ${language} for user-facing content, English for code and technical docs.
+${memorySection}`;
+}
+
+/**
+ * Generate a complete CLAUDE.md / GEMINI.md / AGENTS.md config file
+ * (all agents, no filtering — backward compatible)
+ *
+ * @param {string} userName - The user's display name
+ * @param {string} language - User-facing communication language
+ * @returns {string} Complete Markdown template
+ */
+function generateBaseConfig(userName, language) {
+  return `# BMAD+ — AI Agent Configuration
+
+## Project Context
+This project uses BMAD+, an augmented AI-driven development framework.
+Based on BMAD-METHOD v6.6.0 with multi-role agents, autopilot mode, and parallel execution.
+
+## Agents
+To activate an agent, say its name or persona:
+${AGENT_LIST.join('\n')}
+
+## Skills
+- Load skills from \`.agents/skills/\`
+- Each agent has a SKILL.md with capabilities, activation protocol, and role-switching rules
+- Auto-activation triggers: \`.agents/data/role-triggers.yaml\`
+
+## Key Commands
+- \`bmad-help\` — Show all available agents and skills
+- \`autopilot\` — Launch Nexus in full pipeline mode
+- \`parallel\` — Enable parallel multi-agent execution
+
+## Communication
+- User name: ${userName}
+- Default language: ${language} for user-facing content, English for code and technical docs.
+
+## Memory Protocol (Karpathy Guardrails)
+
+Agents MUST follow these behavioral principles:
+
+### G1 — Think Before Coding
+- State assumptions explicitly. If uncertain, ask.
+- Check \`.agents/memory/decisions.md\` for prior decisions before re-deciding.
+
+### G2 — Simplicity First
+- Minimum code that solves the problem. Nothing speculative.
+- Check \`.agents/memory/patterns.md\` for existing solutions.
+
+### G3 — Surgical Changes
+- Touch only what you must. Match existing style.
+- Log surprises in \`.agents/memory/lessons.md\`.
+
+### G4 — Goal-Driven Execution
+- Define success criteria before implementing.
+- Log non-obvious decisions in \`.agents/memory/decisions.md\`.
+
+### Memory Files
+- \`.agents/memory/decisions.md\` — Read at session start, write when making decisions
+- \`.agents/memory/lessons.md\` — Write when something unexpected happens
+- \`.agents/memory/patterns.md\` — Write when a reusable pattern is validated
+- \`.agents/memory/context.md\` — Update at session end with project state`;
+}
+
+module.exports = {
+  IDE_CONFIGS,
+  generateIDEConfig,
+  getAgentsByPacks,
+
+  /**
+   * Generate CLAUDE.md config for Claude Code
+   * @param {string} userName
+   * @param {string} language
+   * @returns {string}
+   */
+  generateClaudeMD: generateBaseConfig,
+
+  /**
+   * Generate GEMINI.md config for Gemini CLI / Antigravity
+   * @param {string} userName
+   * @param {string} language
+   * @returns {string}
+   */
+  generateGeminiMD: generateBaseConfig,
+
+  /**
+   * Generate AGENTS.md config for Codex CLI / OpenCode
+   * @param {string} userName
+   * @param {string} language
+   * @returns {string}
+   */
+  generateAgentsMD: generateBaseConfig,
+};