bmad-plus 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to BMAD+ will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.1] — 2026-05-17
+
+### 🛠️ CLI Commands & Guardrails Injection
+
+### Added
+- **`npx bmad-plus scan [path]`** — Interactive project scanner
+  - Recursive directory scan with stack auto-detection (Node.js, Rust, Python, Go, PHP, Ruby, Java)
+  - Framework detection (Next.js, Nuxt, React, Vue, Svelte, Express, Electron, Tauri)
+  - Status tracking (active/paused/archived based on last modified)
+  - Interactive validation: index all, select, or skip
+  - Auto-generates `projects-index.md` in global brain
+- **`npx bmad-plus memory status`** — Memory health report
+  - Shows project memory + global brain status
+  - Entry counts, last modified dates, health score
+  - Brain link detection
+- **`npx bmad-plus memory export`** — Export brain as portable Markdown archive
+- **Karpathy Guardrails injection** — 4 principles auto-injected into CLAUDE.md/GEMINI.md/AGENTS.md when Memory pack is installed
+- **i18n** — Memory + Dev Studio keys for EN and FR (other languages use fallback)
+
 ## [0.7.0] — 2026-05-17
 
 ### 🧠 Pack Memory — Persistent Brain

package/README.md

@@ -1,6 +1,6 @@
 # ?? BMAD+ � Augmented AI-Driven Development Framework
 
-[![Version](https://img.shields.io/badge/version-0.7.0-blue.svg)](CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.7.1-blue.svg)](CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-plus",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "BMAD+ — Augmented AI-Driven Development Framework with multi-role agents, autopilot, and parallel execution",
   "keywords": [
     "bmad",

package/readme-international/README.de.md

@@ -1,6 +1,6 @@
 # ?? BMAD+ � Erweitertes KI-gest�tztes Entwicklungs-Framework
 
-[![Version](https://img.shields.io/badge/version-0.7.0-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.7.1-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/readme-international/README.es.md

@@ -1,6 +1,6 @@
 # ?? BMAD+ � Framework de Desarrollo Impulsado por IA Aumentada
 
-[![Version](https://img.shields.io/badge/version-0.7.0-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.7.1-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/readme-international/README.fr.md

@@ -1,6 +1,6 @@
 # ?? BMAD+ � Augmented AI-Driven Development Framework
 
-[![Version](https://img.shields.io/badge/version-0.7.0-blue.svg)](../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-0.7.1-blue.svg)](../CHANGELOG.md)
 [![Based on](https://img.shields.io/badge/based%20on-BMAD--METHOD%20v6.2.0-green.svg)](https://github.com/bmad-code-org/BMAD-METHOD)
 [![License](https://img.shields.io/badge/license-MIT-yellow.svg)](../LICENSE)
 

package/tools/cli/bmad-plus-cli.js

@@ -25,6 +25,8 @@ const install = require('./commands/install');
 const uninstall = require('./commands/uninstall');
 const update = require('./commands/update');
 const doctor = require('./commands/doctor');
+const scan = require('./commands/scan');
+const memory = require('./commands/memory');
 
 program
   .version(packageJson.version)
@@ -66,6 +68,26 @@ for (const option of doctor.options || []) {
 }
 doctorCmd.action(doctor.action);
 
+// Scan command
+const scanCmd = program
+  .command('scan')
+  .description('Scan directories to discover and index projects in the global brain');
+
+for (const option of scan.options || []) {
+  scanCmd.option(...option);
+}
+scanCmd.action(scan.action);
+
+// Memory command
+const memoryCmd = program
+  .command('memory [subcommand]')
+  .description('Manage persistent brain (status, export)');
+
+for (const option of memory.options || []) {
+  memoryCmd.option(...option);
+}
+memoryCmd.action(memory.action);
+
 program.parse(process.argv);
 
 if (process.argv.slice(2).length === 0) {

package/tools/cli/commands/install.js

@@ -56,7 +56,7 @@ const PACKS = {
   'dev-studio': {
     name: 'Dev Studio — Full SDLC',
     icon: '🏗️',
-    description: '6 Torah-named agents + 30 workflows — Analysis → Architecture → Implementation',
+    description: 'Full SDLC pipeline: brainstorm → PRD → architecture → TDD → code review → deploy',
     required: false,
     agents: [],
     skills: [],
@@ -655,6 +655,39 @@ function generateIDEConfig(userName, language, packs) {
     agents.push('- **Zecher** (זכר) — Memory Archivist — Consolidation, project scanning, context recall');
   }
 
+  // Build memory section if memory pack is installed
+  let memorySection = '';
+  if (packs.includes('memory')) {
+    memorySection = [
+      '',
+      '## 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');
+  }
+
   return `# BMAD+ — AI Agent Configuration
 
 ## Project Context
@@ -678,7 +711,7 @@ ${agents.join('\n')}
 ## Communication
 - User name: ${userName}
 - Default language: ${language} for user-facing content, English for code and technical docs.
-`;
+${memorySection}`;
 }
 
 function generateConfigYaml(userName, language, projectDir) {

package/tools/cli/commands/memory.js

@@ -0,0 +1,194 @@
+/**
+ * BMAD+ Memory Command
+ * Manage persistent brain: status, export, consolidate
+ *
+ * Author: Laurent Rochetta
+ */
+
+const path = require('node:path');
+const fs = require('node:fs');
+const os = require('node:os');
+const clack = require('@clack/prompts');
+const pc = require('picocolors');
+
+function countEntries(filePath) {
+  if (!fs.existsSync(filePath)) return { exists: false, count: 0, lastModified: null };
+  try {
+    const content = fs.readFileSync(filePath, 'utf8');
+    const entries = content.match(/^### /gm);
+    const stat = fs.statSync(filePath);
+    return {
+      exists: true,
+      count: entries ? entries.length : 0,
+      lastModified: stat.mtime.toISOString().slice(0, 10),
+      sizeKB: (stat.size / 1024).toFixed(1),
+    };
+  } catch {
+    return { exists: true, count: 0, lastModified: null };
+  }
+}
+
+function countSessions(dir) {
+  if (!fs.existsSync(dir)) return 0;
+  try {
+    return fs.readdirSync(dir).filter(f => f.endsWith('.md')).length;
+  } catch { return 0; }
+}
+
+module.exports = {
+  command: 'memory',
+  description: 'Manage BMAD+ persistent brain (status, export)',
+  options: [
+    ['-d, --directory <path>', 'Project directory (default: current directory)'],
+  ],
+  subcommands: {
+    status: 'Show memory health report',
+    export: 'Export brain as portable archive',
+  },
+  action: async (subcommand, options) => {
+    const projectDir = path.resolve(options?.directory || process.cwd());
+    const cmd = subcommand || 'status';
+
+    clack.intro(pc.bgMagenta(pc.white(' 🧠 BMAD+ Memory Manager ')));
+
+    if (cmd === 'status') {
+      // ── Project Memory ──
+      const memoryDir = path.join(projectDir, '.agents', 'memory');
+      const hasProjectMemory = fs.existsSync(memoryDir);
+
+      clack.log.info(pc.bold('\n📁 Project Memory') + pc.dim(` (${projectDir})`));
+
+      if (hasProjectMemory) {
+        const decisions = countEntries(path.join(memoryDir, 'decisions.md'));
+        const lessons = countEntries(path.join(memoryDir, 'lessons.md'));
+        const patterns = countEntries(path.join(memoryDir, 'patterns.md'));
+        const context = countEntries(path.join(memoryDir, 'context.md'));
+        const sessions = countSessions(path.join(memoryDir, 'sessions'));
+        const brainLink = fs.existsSync(path.join(memoryDir, '.brain-link'));
+
+        clack.log.info(`  decisions.md     ${decisions.exists ? pc.green('✓') : pc.red('✗')}  ${decisions.count} entries  ${pc.dim(decisions.lastModified || '')}`);
+        clack.log.info(`  lessons.md       ${lessons.exists ? pc.green('✓') : pc.red('✗')}  ${lessons.count} entries  ${pc.dim(lessons.lastModified || '')}`);
+        clack.log.info(`  patterns.md      ${patterns.exists ? pc.green('✓') : pc.red('✗')}  ${patterns.count} entries  ${pc.dim(patterns.lastModified || '')}`);
+        clack.log.info(`  context.md       ${context.exists ? pc.green('✓') : pc.red('✗')}  ${pc.dim(context.lastModified || '')}`);
+        clack.log.info(`  sessions/        ${sessions > 0 ? pc.green('✓') : pc.dim('·')}  ${sessions} handoff(s)`);
+
+        if (brainLink) {
+          try {
+            const link = JSON.parse(fs.readFileSync(path.join(memoryDir, '.brain-link'), 'utf8'));
+            clack.log.info(`  ${pc.cyan('🔗 Linked brain')}: ${link.linked_brain}`);
+          } catch {
+            clack.log.info(`  ${pc.cyan('🔗 Brain link exists')}`);
+          }
+        }
+      } else {
+        clack.log.warn('  Not installed. Run: npx bmad-plus install (select Memory pack)');
+      }
+
+      // ── Global Brain ──
+      const globalBrainDir = path.join(os.homedir(), '.bmad-plus', 'brain');
+      const hasGlobalBrain = fs.existsSync(globalBrainDir);
+
+      clack.log.info(pc.bold('\n🌐 Global Brain') + pc.dim(` (${globalBrainDir})`));
+
+      if (hasGlobalBrain) {
+        const identity = fs.existsSync(path.join(globalBrainDir, 'identity.yaml'));
+        const gDecisions = countEntries(path.join(globalBrainDir, 'decisions.md'));
+        const gLessons = countEntries(path.join(globalBrainDir, 'lessons.md'));
+        const gPatterns = countEntries(path.join(globalBrainDir, 'patterns.md'));
+
+        const projectsDir = path.join(globalBrainDir, 'projects');
+        let projectCount = 0;
+        if (fs.existsSync(projectsDir)) {
+          projectCount = fs.readdirSync(projectsDir).filter(f => f.endsWith('.yaml')).length;
+        }
+
+        const indexExists = fs.existsSync(path.join(globalBrainDir, 'projects-index.md'));
+
+        clack.log.info(`  identity.yaml    ${identity ? pc.green('✓') : pc.yellow('✗ missing')}`);
+        clack.log.info(`  decisions.md     ${gDecisions.exists ? pc.green('✓') : pc.dim('·')}  ${gDecisions.count} entries`);
+        clack.log.info(`  lessons.md       ${gLessons.exists ? pc.green('✓') : pc.dim('·')}  ${gLessons.count} entries`);
+        clack.log.info(`  patterns.md      ${gPatterns.exists ? pc.green('✓') : pc.dim('·')}  ${gPatterns.count} entries`);
+        clack.log.info(`  projects/        ${pc.green('✓')}  ${projectCount} project(s) indexed`);
+        clack.log.info(`  projects-index   ${indexExists ? pc.green('✓') : pc.dim('·')}`);
+      } else {
+        clack.log.warn('  Not initialized. Run: npx bmad-plus install (select Memory pack)');
+      }
+
+      // ── Health Score ──
+      let score = 0;
+      let maxScore = 0;
+
+      if (hasProjectMemory) {
+        const checks = [
+          fs.existsSync(path.join(memoryDir, 'decisions.md')),
+          fs.existsSync(path.join(memoryDir, 'lessons.md')),
+          fs.existsSync(path.join(memoryDir, 'patterns.md')),
+          fs.existsSync(path.join(memoryDir, 'context.md')),
+          countSessions(path.join(memoryDir, 'sessions')) > 0,
+        ];
+        maxScore += checks.length;
+        score += checks.filter(Boolean).length;
+      }
+
+      if (hasGlobalBrain) {
+        const gChecks = [
+          fs.existsSync(path.join(globalBrainDir, 'identity.yaml')),
+          fs.existsSync(path.join(globalBrainDir, 'decisions.md')),
+          fs.existsSync(path.join(globalBrainDir, 'lessons.md')),
+          fs.existsSync(path.join(globalBrainDir, 'patterns.md')),
+          fs.existsSync(path.join(globalBrainDir, 'projects')),
+        ];
+        maxScore += gChecks.length;
+        score += gChecks.filter(Boolean).length;
+      }
+
+      if (maxScore > 0) {
+        const pct = Math.round((score / maxScore) * 100);
+        const color = pct >= 80 ? pc.green : pct >= 50 ? pc.yellow : pc.red;
+        clack.log.info('');
+        clack.log.info(pc.bold(`🏥 Health: ${color(`${pct}%`)} (${score}/${maxScore} checks)`));
+      }
+
+      clack.log.info('');
+    } else if (cmd === 'export') {
+      // Export brain as text dump
+      const globalBrainDir = path.join(os.homedir(), '.bmad-plus', 'brain');
+      if (!fs.existsSync(globalBrainDir)) {
+        clack.log.error('Global brain not found. Nothing to export.');
+        clack.outro(pc.red('Export failed.'));
+        return;
+      }
+
+      const exportPath = path.join(projectDir, `bmad-brain-export-${new Date().toISOString().slice(0, 10)}.md`);
+      const sections = [];
+
+      sections.push('# BMAD+ Brain Export', `> Exported: ${new Date().toISOString()}`, '');
+
+      for (const file of ['identity.yaml', 'decisions.md', 'lessons.md', 'patterns.md']) {
+        const fp = path.join(globalBrainDir, file);
+        if (fs.existsSync(fp)) {
+          sections.push(`## ${file}`, '```', fs.readFileSync(fp, 'utf8').trim(), '```', '');
+        }
+      }
+
+      // Project index
+      const projectsDir = path.join(globalBrainDir, 'projects');
+      if (fs.existsSync(projectsDir)) {
+        sections.push('## Projects', '');
+        for (const f of fs.readdirSync(projectsDir)) {
+          if (f.endsWith('.yaml')) {
+            sections.push(`### ${f}`, '```yaml', fs.readFileSync(path.join(projectsDir, f), 'utf8').trim(), '```', '');
+          }
+        }
+      }
+
+      fs.writeFileSync(exportPath, sections.join('\n'), 'utf8');
+      clack.log.success(`📦 Brain exported to: ${exportPath}`);
+    } else {
+      clack.log.error(`Unknown subcommand: ${cmd}`);
+      clack.log.info('Available: status, export');
+    }
+
+    clack.outro(pc.green('Done! 🧠'));
+  },
+};

package/tools/cli/commands/scan.js

@@ -0,0 +1,335 @@
+/**
+ * BMAD+ Scan Command
+ * Scan directories to discover projects, detect stacks, and index them in the global brain.
+ * Interactive validation — user confirms each project before indexing.
+ *
+ * Author: Laurent Rochetta
+ */
+
+const path = require('node:path');
+const fs = require('node:fs');
+const os = require('node:os');
+const crypto = require('node:crypto');
+const clack = require('@clack/prompts');
+const pc = require('picocolors');
+
+// Project detection markers (priority order)
+const PROJECT_MARKERS = [
+  { file: 'package.json', stack: 'Node.js', detect: (dir) => {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+      if (deps['next']) return 'Next.js';
+      if (deps['nuxt']) return 'Nuxt';
+      if (deps['react']) return 'React';
+      if (deps['vue']) return 'Vue.js';
+      if (deps['svelte']) return 'Svelte';
+      if (deps['express']) return 'Express';
+      if (deps['fastify']) return 'Fastify';
+      if (deps['electron']) return 'Electron';
+      if (deps['tauri']) return 'Tauri';
+      return 'Node.js';
+    } catch { return 'Node.js'; }
+  }},
+  { file: 'Cargo.toml', stack: 'Rust' },
+  { file: 'pyproject.toml', stack: 'Python' },
+  { file: 'requirements.txt', stack: 'Python' },
+  { file: 'go.mod', stack: 'Go' },
+  { file: 'composer.json', stack: 'PHP' },
+  { file: 'Gemfile', stack: 'Ruby' },
+  { file: 'pom.xml', stack: 'Java' },
+  { file: 'build.gradle', stack: 'Java/Kotlin' },
+];
+
+// Directories to skip during scanning
+const SKIP_DIRS = new Set([
+  'node_modules', '.git', 'vendor', '__pycache__', 'dist', 'build',
+  '.next', '.nuxt', '.svelte-kit', 'target', '.venv', 'venv',
+  '.cache', '.output', 'coverage', '.turbo', '.angular',
+  '$RECYCLE.BIN', 'System Volume Information', 'Windows',
+  'Program Files', 'Program Files (x86)', 'ProgramData',
+  'AppData', 'Recovery', 'PerfLogs',
+]);
+
+function getProjectStatus(dir) {
+  try {
+    const stat = fs.statSync(dir);
+    const daysSince = (Date.now() - stat.mtimeMs) / (1000 * 60 * 60 * 24);
+    if (daysSince < 30) return 'active';
+    if (daysSince < 180) return 'paused';
+    return 'archived';
+  } catch { return 'unknown'; }
+}
+
+function getStatusIcon(status) {
+  switch (status) {
+    case 'active': return pc.green('●');
+    case 'paused': return pc.yellow('◐');
+    case 'archived': return pc.dim('○');
+    default: return pc.dim('?');
+  }
+}
+
+function getProjectName(dir) {
+  try {
+    const pkgPath = path.join(dir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      if (pkg.name) return pkg.name;
+    }
+  } catch {}
+  return path.basename(dir);
+}
+
+function hasBmadInstalled(dir) {
+  return fs.existsSync(path.join(dir, '.agents')) ||
+         fs.existsSync(path.join(dir, '_bmad'));
+}
+
+function scanDirectory(rootDir, maxDepth = 4, currentDepth = 0) {
+  const projects = [];
+
+  if (currentDepth > maxDepth) return projects;
+
+  let entries;
+  try {
+    entries = fs.readdirSync(rootDir, { withFileTypes: true });
+  } catch {
+    return projects; // Permission denied or inaccessible
+  }
+
+  // Check if current dir is a project
+  for (const marker of PROJECT_MARKERS) {
+    if (fs.existsSync(path.join(rootDir, marker.file))) {
+      const stack = marker.detect ? marker.detect(rootDir) : marker.stack;
+      projects.push({
+        path: rootDir,
+        name: getProjectName(rootDir),
+        stack,
+        status: getProjectStatus(rootDir),
+        bmad: hasBmadInstalled(rootDir),
+        hasAgentsMd: fs.existsSync(path.join(rootDir, 'AGENTS.md')),
+        hasGit: fs.existsSync(path.join(rootDir, '.git')),
+      });
+      return projects; // Don't recurse into project subdirs
+    }
+  }
+
+  // Also detect by .git alone (any project with version control)
+  if (fs.existsSync(path.join(rootDir, '.git')) && currentDepth > 0) {
+    projects.push({
+      path: rootDir,
+      name: getProjectName(rootDir),
+      stack: 'Unknown',
+      status: getProjectStatus(rootDir),
+      bmad: hasBmadInstalled(rootDir),
+      hasAgentsMd: fs.existsSync(path.join(rootDir, 'AGENTS.md')),
+      hasGit: true,
+    });
+    return projects;
+  }
+
+  // Recurse into subdirectories
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (SKIP_DIRS.has(entry.name)) continue;
+    if (entry.name.startsWith('.') && entry.name !== '.git') continue;
+
+    const subPath = path.join(rootDir, entry.name);
+    const subProjects = scanDirectory(subPath, maxDepth, currentDepth + 1);
+    projects.push(...subProjects);
+  }
+
+  return projects;
+}
+
+module.exports = {
+  command: 'scan',
+  description: 'Scan directories to discover and index projects in the global brain',
+  options: [
+    ['-d, --directory <path>', 'Directory to scan (default: current directory)'],
+    ['--depth <n>', 'Max depth to scan (default: 4)', '4'],
+    ['-y, --yes', 'Index all projects without prompting'],
+  ],
+  action: async (options) => {
+    const scanDir = path.resolve(options.directory || process.cwd());
+    const maxDepth = parseInt(options.depth) || 4;
+
+    clack.intro(pc.bgMagenta(pc.white(' 🧠 BMAD+ Project Scanner ')));
+
+    // Verify directory exists
+    if (!fs.existsSync(scanDir)) {
+      clack.log.error(`Directory not found: ${scanDir}`);
+      clack.outro(pc.red('Scan failed.'));
+      return;
+    }
+
+    // Scan
+    const spinner = clack.spinner();
+    spinner.start(`Scanning ${scanDir} (depth: ${maxDepth})...`);
+
+    const projects = scanDirectory(scanDir, maxDepth);
+
+    if (projects.length === 0) {
+      spinner.stop('No projects found.');
+      clack.outro('Try scanning a different directory or increasing --depth');
+      return;
+    }
+
+    spinner.stop(`Found ${pc.bold(projects.length)} project(s)`);
+
+    // Display table
+    clack.log.info('');
+    clack.log.info(pc.bold('  #   Status  BMAD+  Stack             Name                  Path'));
+    clack.log.info(pc.dim('  ' + '─'.repeat(90)));
+
+    projects.forEach((p, i) => {
+      const num = String(i + 1).padStart(3);
+      const status = getStatusIcon(p.status) + ' ' + p.status.padEnd(8);
+      const bmad = p.bmad ? pc.green('✓') : pc.dim('·');
+      const stack = p.stack.padEnd(16);
+      const name = p.name.substring(0, 20).padEnd(20);
+      const projPath = p.path.length > 40 ? '...' + p.path.slice(-37) : p.path;
+      clack.log.info(`  ${num}  ${status}  ${bmad}      ${stack}  ${name}  ${pc.dim(projPath)}`);
+    });
+
+    clack.log.info('');
+
+    // Interactive validation
+    const globalBrainDir = path.join(os.homedir(), '.bmad-plus', 'brain', 'projects');
+
+    if (options.yes) {
+      // Auto-index all
+      const fsExtra = require('fs-extra');
+      fsExtra.ensureDirSync(globalBrainDir);
+
+      let indexed = 0;
+      for (const proj of projects) {
+        const hash = crypto.createHash('sha256').update(proj.path).digest('hex').slice(0, 8);
+        const meta = {
+          path: proj.path,
+          name: proj.name,
+          hash,
+          stack: proj.stack,
+          status: proj.status,
+          bmad_installed: proj.bmad,
+          has_git: proj.hasGit,
+          last_scanned: new Date().toISOString().slice(0, 10),
+        };
+        fs.writeFileSync(
+          path.join(globalBrainDir, `${hash}.yaml`),
+          Object.entries(meta).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join('\n'),
+          'utf8'
+        );
+        indexed++;
+      }
+      clack.log.success(`✅ ${indexed} project(s) indexed in ${globalBrainDir}`);
+    } else {
+      // Interactive mode
+      const action = await clack.select({
+        message: `${projects.length} project(s) found. What to do?`,
+        options: [
+          { value: 'all', label: `✅ Index all ${projects.length} projects` },
+          { value: 'select', label: '✏️  Select which to index' },
+          { value: 'none', label: '⏭️  Skip — don\'t index anything' },
+        ],
+      });
+
+      if (clack.isCancel(action) || action === 'none') {
+        clack.cancel('Scan cancelled.');
+        return;
+      }
+
+      const fsExtra = require('fs-extra');
+      fsExtra.ensureDirSync(globalBrainDir);
+
+      let toIndex = projects;
+
+      if (action === 'select') {
+        const selected = await clack.multiselect({
+          message: 'Select projects to index:',
+          options: projects.map((p, i) => ({
+            value: i,
+            label: `${p.name} (${p.stack})`,
+            hint: `${p.status} — ${p.path}`,
+          })),
+          required: false,
+        });
+
+        if (clack.isCancel(selected)) {
+          clack.cancel('Scan cancelled.');
+          return;
+        }
+
+        toIndex = selected.map(i => projects[i]);
+      }
+
+      let indexed = 0;
+      for (const proj of toIndex) {
+        const hash = crypto.createHash('sha256').update(proj.path).digest('hex').slice(0, 8);
+        const meta = {
+          path: proj.path,
+          name: proj.name,
+          hash,
+          stack: proj.stack,
+          status: proj.status,
+          bmad_installed: proj.bmad,
+          has_git: proj.hasGit,
+          last_scanned: new Date().toISOString().slice(0, 10),
+        };
+        fs.writeFileSync(
+          path.join(globalBrainDir, `${hash}.yaml`),
+          Object.entries(meta).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join('\n'),
+          'utf8'
+        );
+        indexed++;
+      }
+
+      clack.log.success(`✅ ${indexed} project(s) indexed in global brain`);
+    }
+
+    // Generate human-readable index
+    const indexPath = path.join(os.homedir(), '.bmad-plus', 'brain', 'projects-index.md');
+    const existingProjects = [];
+    if (fs.existsSync(globalBrainDir)) {
+      for (const f of fs.readdirSync(globalBrainDir)) {
+        if (!f.endsWith('.yaml')) continue;
+        try {
+          const content = fs.readFileSync(path.join(globalBrainDir, f), 'utf8');
+          const meta = {};
+          for (const line of content.split('\n')) {
+            const m = line.match(/^(\w+):\s*(.+)$/);
+            if (m) {
+              try { meta[m[1]] = JSON.parse(m[2]); } catch { meta[m[1]] = m[2]; }
+            }
+          }
+          existingProjects.push(meta);
+        } catch {}
+      }
+    }
+
+    const indexContent = [
+      '---',
+      'title: Project Index',
+      `last_updated: "${new Date().toISOString().slice(0, 10)}"`,
+      `total_projects: ${existingProjects.length}`,
+      '---',
+      '',
+      '# Project Index',
+      '',
+      `> Auto-generated by \`npx bmad-plus scan\` — ${new Date().toISOString().slice(0, 10)}`,
+      '',
+      '| Status | Name | Stack | BMAD+ | Path |',
+      '|--------|------|-------|-------|------|',
+      ...existingProjects.map(p =>
+        `| ${p.status || '?'} | ${p.name || '?'} | ${p.stack || '?'} | ${p.bmad_installed ? '✓' : '·'} | \`${p.path || '?'}\` |`
+      ),
+      '',
+    ];
+
+    fs.writeFileSync(indexPath, indexContent.join('\n'), 'utf8');
+    clack.log.info(`📋 Project index updated: ${indexPath}`);
+
+    clack.outro(pc.green('Scan complete! 🧠'));
+  },
+};

package/tools/cli/i18n.js

@@ -10,7 +10,7 @@ const LANGUAGES = {
     flag: '🇬🇧',
     name: 'English',
     locale: 'en',
-    installer_title: ' BMAD+ Installer v0.7.0 ',
+    installer_title: ' BMAD+ Installer v0.7.1 ',
     select_language: 'Select your language',
     installing_to: 'Installing to',
     select_packs: 'Which packs to install? (Core is always included)',
@@ -76,13 +76,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Backup: "/backup create" → ZIP timestamped',
     guide_example_animated: '🎬 Animated: "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT: "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Persistent Brain',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Memory: "Zecher, scan projects in D:\\DEV"',
+    guide_example_memory_2: '🧠 Memory: "Zecher, where were we?"',
+    guide_example_memory_3: '🧠 Memory: "Zecher, consolidate memory"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio: "Miriam, brainstorm a productivity app"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio: "Bezalel, design the architecture"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio: "Oholiab, implement story S1"',
+    brain_detected: 'Existing brain detected',
+    brain_created: 'Global brain created',
   },
 
   fr: {
     flag: '🇫🇷',
     name: 'Français',
     locale: 'fr',
-    installer_title: ' BMAD+ Installeur v0.7.0 ',
+    installer_title: ' BMAD+ Installeur v0.7.1 ',
     select_language: 'Choisissez votre langue',
     installing_to: 'Installation dans',
     select_packs: 'Quels packs installer ? (Core est toujours inclus)',
@@ -146,13 +156,23 @@ const LANGUAGES = {
     guide_example_backup: '🗂️  Backup : "/backup create" → ZIP horodaté',
     guide_example_animated: '🎬 Animé : "/animated build hero.mp4"',
     guide_example_osint: '🔍 OSINT : "Shadow, investigate John Doe"',
+    guide_memory: '🧠 Cerveau persistant',
+    guide_dev_studio: '🏗️ Dev Studio',
+    guide_example_memory_1: '🧠 Mémoire : "Zecher, scanne les projets dans D:\\DEV"',
+    guide_example_memory_2: '🧠 Mémoire : "Zecher, où en étions-nous ?"',
+    guide_example_memory_3: '🧠 Mémoire : "Zecher, consolide la mémoire"',
+    guide_example_dev_studio_1: '🏗️ Dev Studio : "Miriam, brainstorme une app de productivité"',
+    guide_example_dev_studio_2: '🏗️ Dev Studio : "Bezalel, conçois l\'architecture"',
+    guide_example_dev_studio_3: '🏗️ Dev Studio : "Oholiab, implémente la story S1"',
+    brain_detected: 'Cerveau existant détecté',
+    brain_created: 'Cerveau global créé',
   },
 
   es: {
     flag: '🇪🇸',
     name: 'Español',
     locale: 'es',
-    installer_title: ' BMAD+ Instalador v0.7.0 ',
+    installer_title: ' BMAD+ Instalador v0.7.1 ',
     select_language: 'Seleccione su idioma',
     installing_to: 'Instalando en',
     select_packs: '¿Qué packs instalar? (Core siempre está incluido)',
@@ -222,7 +242,7 @@ const LANGUAGES = {
     flag: '🇩🇪',
     name: 'Deutsch',
     locale: 'de',
-    installer_title: ' BMAD+ Installer v0.7.0 ',
+    installer_title: ' BMAD+ Installer v0.7.1 ',
     select_language: 'Wählen Sie Ihre Sprache',
     installing_to: 'Installiere in',
     select_packs: 'Welche Packs installieren? (Core ist immer enthalten)',
@@ -292,7 +312,7 @@ const LANGUAGES = {
     flag: '🇧🇷',
     name: 'Português (Brasil)',
     locale: 'pt-BR',
-    installer_title: ' BMAD+ Instalador v0.7.0 ',
+    installer_title: ' BMAD+ Instalador v0.7.1 ',
     select_language: 'Selecione seu idioma',
     installing_to: 'Instalando em',
     select_packs: 'Quais packs instalar? (Core sempre está incluído)',
@@ -362,7 +382,7 @@ const LANGUAGES = {
     flag: '🇷🇺',
     name: 'Русский',
     locale: 'ru',
-    installer_title: ' BMAD+ Установщик v0.7.0 ',
+    installer_title: ' BMAD+ Установщик v0.7.1 ',
     select_language: 'Выберите язык',
     installing_to: 'Установка в',
     select_packs: 'Какие пакеты установить? (Core всегда включён)',
@@ -432,7 +452,7 @@ const LANGUAGES = {
     flag: '🇨🇳',
     name: '中文 (简体)',
     locale: 'zh-CN',
-    installer_title: ' BMAD+ 安装程序 v0.7.0 ',
+    installer_title: ' BMAD+ 安装程序 v0.7.1 ',
     select_language: '选择您的语言',
     installing_to: '安装到',
     select_packs: '安装哪些包？（Core 始终包含）',
@@ -502,7 +522,7 @@ const LANGUAGES = {
     flag: '🇮🇱',
     name: 'עברית',
     locale: 'he',
-    installer_title: ' BMAD+ מתקין v0.7.0 ',
+    installer_title: ' BMAD+ מתקין v0.7.1 ',
     select_language: 'בחר את השפה שלך',
     installing_to: 'מתקין ב',
     select_packs: 'אילו חבילות להתקין? (Core תמיד כלול)',
@@ -572,7 +592,7 @@ const LANGUAGES = {
     flag: '🇯🇵',
     name: '日本語',
     locale: 'ja',
-    installer_title: ' BMAD+ インストーラー v0.7.0 ',
+    installer_title: ' BMAD+ インストーラー v0.7.1 ',
     select_language: '言語を選択してください',
     installing_to: 'インストール先',
     select_packs: 'どのパックをインストールしますか？（Coreは常に含まれます）',
@@ -642,7 +662,7 @@ const LANGUAGES = {
     flag: '🇮🇹',
     name: 'Italiano',
     locale: 'it',
-    installer_title: ' BMAD+ Installatore v0.7.0 ',
+    installer_title: ' BMAD+ Installatore v0.7.1 ',
     select_language: 'Seleziona la tua lingua',
     installing_to: 'Installazione in',
     select_packs: 'Quali pack installare? (Core è sempre incluso)',