bmad-method 4.16.1 → 4.18.0

package/tools/installer/lib/file-manager.js

@@ -90,6 +90,7 @@ class FileManager {
       agent: config.agent || null,
       ide_setup: config.ide || null,
       ides_setup: config.ides || [],
+      expansion_packs: config.expansionPacks || [],
       files: [],
     };
 

package/tools/installer/lib/ide-setup.js

@@ -65,8 +65,9 @@ class IdeSetup {
         mdcContent += "alwaysApply: false\n";
         mdcContent += "---\n\n";
         mdcContent += `# ${agentId.toUpperCase()} Agent Rule\n\n`;
-        mdcContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${this.getAgentTitle(
-          agentId
+        mdcContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} agent persona.\n\n`;
         mdcContent += "## Agent Activation\n\n";
         mdcContent +=
@@ -84,8 +85,9 @@ class IdeSetup {
         mdcContent += "## File Reference\n\n";
         mdcContent += `The complete agent definition is available in [.bmad-core/agents/${agentId}.md](mdc:.bmad-core/agents/${agentId}.md).\n\n`;
         mdcContent += "## Usage\n\n";
-        mdcContent += `When the user types \`@${agentId}\`, activate this ${this.getAgentTitle(
-          agentId
+        mdcContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} persona and follow all instructions defined in the YML configuration above.\n`;
 
         await fileManager.writeFile(mdcPath, mdcContent);
@@ -150,8 +152,9 @@ class IdeSetup {
 
         // Create MD content (similar to Cursor but without frontmatter)
         let mdContent = `# ${agentId.toUpperCase()} Agent Rule\n\n`;
-        mdContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${this.getAgentTitle(
-          agentId
+        mdContent += `This rule is triggered when the user types \`@${agentId}\` and activates the ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} agent persona.\n\n`;
         mdContent += "## Agent Activation\n\n";
         mdContent +=
@@ -169,8 +172,9 @@ class IdeSetup {
         mdContent += "## File Reference\n\n";
         mdContent += `The complete agent definition is available in [.bmad-core/agents/${agentId}.md](.bmad-core/agents/${agentId}.md).\n\n`;
         mdContent += "## Usage\n\n";
-        mdContent += `When the user types \`@${agentId}\`, activate this ${this.getAgentTitle(
-          agentId
+        mdContent += `When the user types \`@${agentId}\`, activate this ${await this.getAgentTitle(
+          agentId,
+          installDir
         )} persona and follow all instructions defined in the YML configuration above.\n`;
 
         await fileManager.writeFile(mdPath, mdContent);
@@ -195,20 +199,34 @@ class IdeSetup {
     return agentFiles.map((file) => path.basename(file, ".md"));
   }
 
-  getAgentTitle(agentId) {
-    const agentTitles = {
-      analyst: "Business Analyst",
-      architect: "Solution Architect",
-      "bmad-master": "BMAD Master",
-      "bmad-orchestrator": "BMAD Orchestrator",
-      dev: "Developer",
-      pm: "Product Manager",
-      po: "Product Owner",
-      qa: "QA Specialist",
-      sm: "Scrum Master",
-      "ux-expert": "UX Expert",
-    };
-    return agentTitles[agentId] || agentId;
+  async getAgentTitle(agentId, installDir) {
+    // Try to read the actual agent file to get the title
+    let agentPath = path.join(installDir, ".bmad-core", "agents", `${agentId}.md`);
+    if (!(await fileManager.pathExists(agentPath))) {
+      agentPath = path.join(installDir, "agents", `${agentId}.md`);
+    }
+    
+    if (await fileManager.pathExists(agentPath)) {
+      try {
+        const agentContent = await fileManager.readFile(agentPath);
+        const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
+        
+        if (yamlMatch) {
+          const yaml = yamlMatch[1];
+          const titleMatch = yaml.match(/title:\s*(.+)/);
+          if (titleMatch) {
+            return titleMatch[1].trim();
+          }
+        }
+      } catch (error) {
+        console.warn(`Failed to read agent title for ${agentId}: ${error.message}`);
+      }
+    }
+    
+    // Fallback to formatted agent ID
+    return agentId.split('-').map(word => 
+      word.charAt(0).toUpperCase() + word.slice(1)
+    ).join(' ');
   }
 
   async setupRoo(installDir, selectedAgent) {
@@ -294,7 +312,7 @@ class IdeSetup {
           const whenToUseMatch = yaml.match(/whenToUse:\s*"(.+)"/);
           const roleDefinitionMatch = yaml.match(/roleDefinition:\s*"(.+)"/);
 
-          const title = titleMatch ? titleMatch[1].trim() : this.getAgentTitle(agentId);
+          const title = titleMatch ? titleMatch[1].trim() : await this.getAgentTitle(agentId, installDir);
           const icon = iconMatch ? iconMatch[1].trim() : "🤖";
           const whenToUse = whenToUseMatch ? whenToUseMatch[1].trim() : `Use for ${title} tasks`;
           const roleDefinition = roleDefinitionMatch
@@ -381,8 +399,8 @@ class IdeSetup {
         const mdPath = path.join(clineRulesDir, `${prefix}-${agentId}.md`);
 
         // Create MD content for Cline (focused on project standards and role)
-        let mdContent = `# ${this.getAgentTitle(agentId)} Agent\n\n`;
-        mdContent += `This rule defines the ${this.getAgentTitle(agentId)} persona and project standards.\n\n`;
+        let mdContent = `# ${await this.getAgentTitle(agentId, installDir)} Agent\n\n`;
+        mdContent += `This rule defines the ${await this.getAgentTitle(agentId, installDir)} persona and project standards.\n\n`;
         mdContent += "## Role Definition\n\n";
         mdContent +=
           "When the user types `@" + agentId + "`, adopt this persona and follow these guidelines:\n\n";
@@ -402,7 +420,7 @@ class IdeSetup {
         mdContent += `- Update relevant project files when making changes\n`;
         mdContent += `- Reference the complete agent definition in [.bmad-core/agents/${agentId}.md](.bmad-core/agents/${agentId}.md)\n\n`;
         mdContent += "## Usage\n\n";
-        mdContent += `Type \`@${agentId}\` to activate this ${this.getAgentTitle(agentId)} persona.\n`;
+        mdContent += `Type \`@${agentId}\` to activate this ${await this.getAgentTitle(agentId, installDir)} persona.\n`;
 
         await fileManager.writeFile(mdPath, mdContent);
         console.log(chalk.green(`✓ Created rule: ${prefix}-${agentId}.md`));
@@ -447,6 +465,9 @@ class IdeSetup {
 
     console.log(chalk.green(`\n✓ Created individual agent context files in ${agentsContextDir}`));
 
+    // Add GEMINI.md to the context files array
+    agentContextFiles.push("GEMINI.md");
+
     // Create or update settings.json
     const settingsPath = path.join(geminiDir, "settings.json");
     let settings = {};

package/tools/installer/lib/installer.js

@@ -225,6 +225,10 @@ class Installer {
       const sourceDir = configLoader.getBmadCorePath();
       const bmadCoreDestDir = path.join(installDir, ".bmad-core");
       await fileManager.copyDirectory(sourceDir, bmadCoreDestDir);
+      
+      // Copy common/ items to .bmad-core
+      spinner.text = "Copying common utilities...";
+      await this.copyCommonItems(installDir, ".bmad-core", spinner);
 
       // Get list of all files for manifest
       const glob = require("glob");
@@ -283,6 +287,11 @@ class Installer {
           }
         }
       }
+      
+      // Copy common/ items to .bmad-core
+      spinner.text = "Copying common utilities...";
+      const commonFiles = await this.copyCommonItems(installDir, ".bmad-core", spinner);
+      files.push(...commonFiles);
     } else if (config.installType === "team") {
       // Team installation
       spinner.text = `Installing ${config.team} team...`;
@@ -313,6 +322,11 @@ class Installer {
           }
         }
       }
+      
+      // Copy common/ items to .bmad-core
+      spinner.text = "Copying common utilities...";
+      const commonFiles = await this.copyCommonItems(installDir, ".bmad-core", spinner);
+      files.push(...commonFiles);
     } else if (config.installType === "expansion-only") {
       // Expansion-only installation - create minimal .bmad-core structure
       spinner.text = "Creating minimal .bmad-core structure for expansion packs...";
@@ -341,6 +355,10 @@ class Installer {
         );
         files.push(...copiedFiles.map(f => `.bmad-core/${f}`));
       }
+      
+      // Copy common/ items to .bmad-core
+      spinner.text = "Copying common utilities...";
+      await this.copyCommonItems(installDir, ".bmad-core", spinner);
     }
 
     // Install expansion packs if requested
@@ -607,8 +625,10 @@ class Installer {
     console.log(chalk.green("✓ .bmad-core framework installed with all agents and workflows"));
     
     if (config.expansionPacks && config.expansionPacks.length > 0) {
-      const packNames = config.expansionPacks.join(", ");
-      console.log(chalk.green(`✓ Expansion packs installed: ${packNames}`));
+      console.log(chalk.green(`✓ Expansion packs installed:`));
+      for (const packId of config.expansionPacks) {
+        console.log(chalk.green(`  - ${packId} → .${packId}/`));
+      }
     }
     
     if (config.includeWebBundles && config.webBundlesDirectory) {
@@ -799,7 +819,11 @@ class Installer {
 
         const expansionPackDir = path.dirname(pack.manifestPath);
         
-        // Define the folders to copy from expansion packs to .bmad-core
+        // Create dedicated dot folder for this expansion pack
+        const expansionDotFolder = path.join(installDir, `.${packId}`);
+        await fileManager.ensureDirectory(expansionDotFolder);
+        
+        // Define the folders to copy from expansion packs
         const foldersToSync = [
           'agents',
           'agent-teams',
@@ -824,21 +848,35 @@ class Installer {
               nodir: true
             });
 
-            // Copy each file to the destination
+            // Copy each file to the expansion pack's dot folder
             for (const file of files) {
               const sourcePath = path.join(sourceFolder, file);
-              const destPath = path.join(installDir, '.bmad-core', folder, file);
+              const destPath = path.join(expansionDotFolder, folder, file);
               
               if (await fileManager.copyFile(sourcePath, destPath)) {
-                installedFiles.push(path.join('.bmad-core', folder, file));
+                installedFiles.push(path.join(`.${packId}`, folder, file));
               }
             }
           }
         }
 
-        // Web bundles are now available in the dist/ directory and don't need to be copied
+        // Copy manifest to the expansion pack's dot folder
+        const manifestDestPath = path.join(expansionDotFolder, 'manifest.yml');
+        if (await fileManager.copyFile(pack.manifestPath, manifestDestPath)) {
+          installedFiles.push(path.join(`.${packId}`, 'manifest.yml'));
+        }
 
-        console.log(chalk.green(`✓ Installed expansion pack: ${pack.name}`));
+        // Copy common/ items to expansion pack folder
+        spinner.text = `Copying common utilities to ${packId}...`;
+        await this.copyCommonItems(installDir, `.${packId}`, spinner);
+        
+        // Check and resolve core dependencies
+        await this.resolveExpansionPackCoreDependencies(installDir, expansionDotFolder, packId, spinner);
+        
+        // Check and resolve core agents referenced by teams
+        await this.resolveExpansionPackCoreAgents(installDir, expansionDotFolder, packId, spinner);
+
+        console.log(chalk.green(`✓ Installed expansion pack: ${pack.name} to ${`.${packId}`}`));
       } catch (error) {
         console.error(chalk.red(`Failed to install expansion pack ${packId}: ${error.message}`));
       }
@@ -847,6 +885,168 @@ class Installer {
     return installedFiles;
   }
 
+  async resolveExpansionPackCoreDependencies(installDir, expansionDotFolder, packId, spinner) {
+    const glob = require('glob');
+    const yaml = require('yaml');
+    const fs = require('fs').promises;
+    
+    // Find all agent files in the expansion pack
+    const agentFiles = glob.sync('agents/*.md', {
+      cwd: expansionDotFolder
+    });
+
+    for (const agentFile of agentFiles) {
+      const agentPath = path.join(expansionDotFolder, agentFile);
+      const agentContent = await fs.readFile(agentPath, 'utf8');
+      
+      // Extract YAML frontmatter to check dependencies
+      const yamlMatch = agentContent.match(/```yaml\n([\s\S]*?)```/);
+      if (yamlMatch) {
+        try {
+          const agentConfig = yaml.parse(yamlMatch[1]);
+          const dependencies = agentConfig.dependencies || {};
+          
+          // Check for core dependencies (those that don't exist in the expansion pack)
+          for (const depType of ['tasks', 'templates', 'checklists', 'workflows', 'utils', 'data']) {
+            const deps = dependencies[depType] || [];
+            
+            for (const dep of deps) {
+              const depFileName = dep.endsWith('.md') ? dep : `${dep}.md`;
+              const expansionDepPath = path.join(expansionDotFolder, depType, depFileName);
+              
+              // Check if dependency exists in expansion pack
+              if (!(await fileManager.pathExists(expansionDepPath))) {
+                // Try to find it in core
+                const coreDepPath = path.join(configLoader.getBmadCorePath(), depType, depFileName);
+                
+                if (await fileManager.pathExists(coreDepPath)) {
+                  spinner.text = `Copying core dependency ${dep} for ${packId}...`;
+                  
+                  // Copy from core to expansion pack dot folder
+                  const destPath = path.join(expansionDotFolder, depType, depFileName);
+                  await fileManager.copyFile(coreDepPath, destPath);
+                  
+                  console.log(chalk.dim(`  Added core dependency: ${depType}/${depFileName}`));
+                } else {
+                  console.warn(chalk.yellow(`  Warning: Dependency ${depType}/${dep} not found in core or expansion pack`));
+                }
+              }
+            }
+          }
+        } catch (error) {
+          console.warn(chalk.yellow(`  Warning: Could not parse agent dependencies: ${error.message}`));
+        }
+      }
+    }
+  }
+
+  async resolveExpansionPackCoreAgents(installDir, expansionDotFolder, packId, spinner) {
+    const glob = require('glob');
+    const yaml = require('yaml');
+    const fs = require('fs').promises;
+    
+    // Find all team files in the expansion pack
+    const teamFiles = glob.sync('agent-teams/*.yml', {
+      cwd: expansionDotFolder
+    });
+
+    // Also get existing agents in the expansion pack
+    const existingAgents = new Set();
+    const agentFiles = glob.sync('agents/*.md', {
+      cwd: expansionDotFolder
+    });
+    for (const agentFile of agentFiles) {
+      const agentName = path.basename(agentFile, '.md');
+      existingAgents.add(agentName);
+    }
+
+    // Process each team file
+    for (const teamFile of teamFiles) {
+      const teamPath = path.join(expansionDotFolder, teamFile);
+      const teamContent = await fs.readFile(teamPath, 'utf8');
+      
+      try {
+        const teamConfig = yaml.parse(teamContent);
+        const agents = teamConfig.agents || [];
+        
+        // Add bmad-orchestrator if not present (required for all teams)
+        if (!agents.includes('bmad-orchestrator')) {
+          agents.unshift('bmad-orchestrator');
+        }
+        
+        // Check each agent in the team
+        for (const agentId of agents) {
+          if (!existingAgents.has(agentId)) {
+            // Agent not in expansion pack, try to get from core
+            const coreAgentPath = path.join(configLoader.getBmadCorePath(), 'agents', `${agentId}.md`);
+            
+            if (await fileManager.pathExists(coreAgentPath)) {
+              spinner.text = `Copying core agent ${agentId} for ${packId}...`;
+              
+              // Copy agent file
+              const destPath = path.join(expansionDotFolder, 'agents', `${agentId}.md`);
+              await fileManager.copyFile(coreAgentPath, destPath);
+              existingAgents.add(agentId);
+              
+              console.log(chalk.dim(`  Added core agent: ${agentId}`));
+              
+              // Now resolve this agent's dependencies too
+              const agentContent = await fs.readFile(coreAgentPath, 'utf8');
+              const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)```/);
+              
+              if (yamlMatch) {
+                try {
+                  // Clean up the YAML to handle command descriptions
+                  let yamlContent = yamlMatch[1];
+                  yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
+                  
+                  const agentConfig = yaml.parse(yamlContent);
+                  const dependencies = agentConfig.dependencies || {};
+                  
+                  // Copy all dependencies for this agent
+                  for (const depType of ['tasks', 'templates', 'checklists', 'workflows', 'utils', 'data']) {
+                    const deps = dependencies[depType] || [];
+                    
+                    for (const dep of deps) {
+                      const depFileName = dep.endsWith('.md') || dep.endsWith('.yml') ? dep : `${dep}.md`;
+                      const expansionDepPath = path.join(expansionDotFolder, depType, depFileName);
+                      
+                      // Check if dependency exists in expansion pack
+                      if (!(await fileManager.pathExists(expansionDepPath))) {
+                        // Try to find it in core
+                        const coreDepPath = path.join(configLoader.getBmadCorePath(), depType, depFileName);
+                        
+                        if (await fileManager.pathExists(coreDepPath)) {
+                          const destDepPath = path.join(expansionDotFolder, depType, depFileName);
+                          await fileManager.copyFile(coreDepPath, destDepPath);
+                          console.log(chalk.dim(`    Added agent dependency: ${depType}/${depFileName}`));
+                        } else {
+                          // Try common folder
+                          const commonDepPath = path.join(this.rootDir, 'common', depType, depFileName);
+                          if (await fileManager.pathExists(commonDepPath)) {
+                            const destDepPath = path.join(expansionDotFolder, depType, depFileName);
+                            await fileManager.copyFile(commonDepPath, destDepPath);
+                            console.log(chalk.dim(`    Added agent dependency from common: ${depType}/${depFileName}`));
+                          }
+                        }
+                      }
+                    }
+                  }
+                } catch (error) {
+                  console.warn(chalk.yellow(`  Warning: Could not parse agent ${agentId} dependencies: ${error.message}`));
+                }
+              }
+            } else {
+              console.warn(chalk.yellow(`  Warning: Core agent ${agentId} not found for team ${path.basename(teamFile, '.yml')}`));
+            }
+          }
+        }
+      } catch (error) {
+        console.warn(chalk.yellow(`  Warning: Could not parse team file ${teamFile}: ${error.message}`));
+      }
+    }
+  }
+
   getWebBundleInfo(config) {
     const webBundleType = config.webBundleType || 'all';
     
@@ -944,6 +1144,48 @@ class Installer {
     }
   }
 
+  async copyCommonItems(installDir, targetSubdir, spinner) {
+    const glob = require('glob');
+    const fs = require('fs').promises;
+    const sourceBase = path.dirname(path.dirname(path.dirname(path.dirname(__filename)))); // Go up to project root
+    const commonPath = path.join(sourceBase, 'common');
+    const targetPath = path.join(installDir, targetSubdir);
+    const copiedFiles = [];
+    
+    // Check if common/ exists
+    if (!(await fileManager.pathExists(commonPath))) {
+      console.warn(chalk.yellow('Warning: common/ folder not found'));
+      return copiedFiles;
+    }
+    
+    // Copy all items from common/ to target
+    const commonItems = glob.sync('**/*', {
+      cwd: commonPath,
+      nodir: true
+    });
+    
+    for (const item of commonItems) {
+      const sourcePath = path.join(commonPath, item);
+      const destPath = path.join(targetPath, item);
+      
+      // Read the file content
+      const content = await fs.readFile(sourcePath, 'utf8');
+      
+      // Replace {root} with the target subdirectory
+      const updatedContent = content.replace(/\{root\}/g, targetSubdir);
+      
+      // Ensure directory exists
+      await fileManager.ensureDirectory(path.dirname(destPath));
+      
+      // Write the updated content
+      await fs.writeFile(destPath, updatedContent, 'utf8');
+      copiedFiles.push(path.join(targetSubdir, item));
+    }
+    
+    console.log(chalk.dim(`  Added ${commonItems.length} common utilities`));
+    return copiedFiles;
+  }
+
   async findInstallation() {
     // Look for .bmad-core in current directory or parent directories
     let currentDir = process.cwd();

package/tools/installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bmad-method",
-  "version": "4.16.1",
+  "version": "4.18.0",
   "description": "BMAD Method installer - AI-powered Agile development framework",
   "main": "lib/installer.js",
   "bin": {

package/tools/lib/dependency-resolver.js

@@ -6,6 +6,7 @@ class DependencyResolver {
   constructor(rootDir) {
     this.rootDir = rootDir;
     this.bmadCore = path.join(rootDir, 'bmad-core');
+    this.common = path.join(rootDir, 'common');
     this.cache = new Map();
   }
 
@@ -123,6 +124,7 @@ class DependencyResolver {
       let content = null;
       let filePath = null;
 
+      // First try bmad-core
       for (const ext of extensions) {
         try {
           filePath = path.join(this.bmadCore, type, `${id}${ext}`);
@@ -132,6 +134,19 @@ class DependencyResolver {
           // Try next extension
         }
       }
+      
+      // If not found in bmad-core, try common folder
+      if (!content) {
+        for (const ext of extensions) {
+          try {
+            filePath = path.join(this.common, type, `${id}${ext}`);
+            content = await fs.readFile(filePath, 'utf8');
+            break;
+          } catch (e) {
+            // Try next extension
+          }
+        }
+      }
 
       if (!content) {
         console.warn(`Resource not found: ${type}/${id}`);

package/bmad-core/tasks/core-dump.md

@@ -1,74 +0,0 @@
-# Core Dump Task
-
-## Purpose
-
-To create a concise memory recording file (`.ai/core-dump-n.md`) that captures the essential context of the current agent session, enabling seamless continuation of work in future agent sessions. This task ensures persistent context across agent conversations while maintaining minimal token usage for efficient context loading.
-
-## Inputs for this Task
-
-- Current session conversation history and accomplishments
-- Files created, modified, or deleted during the session
-- Key decisions made and procedures followed
-- Current project state and next logical steps
-- User requests and agent responses that shaped the session
-
-## Task Execution Instructions
-
-### 0. Check Existing Core Dump
-
-Before proceeding, check if `.ai/core-dump.md` already exists:
-
-- If file exists, ask user: "Core dump file exists. Should I: 1. Overwrite, 2. Update, 3. Append or 4. Create new?"
-- **Overwrite**: Replace entire file with new content
-- **Update**: Merge new session info with existing content, updating relevant sections
-- **Append**: Add new session as a separate entry while preserving existing content
-- **Create New**: Create a new file, appending the next possible -# to the file, such as core-dump-3.md if 1 and 2 already exist.
-- If file doesn't exist, proceed with creation of `core-dump-1.md`
-
-### 1. Analyze Session Context
-
-- Review the entire conversation to identify key accomplishments
-- Note any specific tasks, procedures, or workflows that were executed
-- Identify important decisions made or problems solved
-- Capture the user's working style and preferences observed during the session
-
-### 2. Document What Was Accomplished
-
-- **Primary Actions**: List the main tasks completed concisely
-- **Story Progress**: For story work, use format "Tasks Complete: 1-6, 8. Next Task Pending: 7, 9"
-- **Problem Solving**: Document any challenges encountered and how they were resolved
-- **User Communications**: Summarize key user requests, preferences, and discussion points
-
-### 3. Record File System Changes (Concise Format)
-
-- **Files Created**: `filename.ext` (brief purpose/size)
-- **Files Modified**: `filename.ext` (what changed)
-- **Files Deleted**: `filename.ext` (why removed)
-- Focus on essential details, avoid verbose descriptions
-
-### 4. Capture Current Project State
-
-- **Project Progress**: Where the project stands after this session
-- **Current Issues**: Any blockers or problems that need resolution
-- **Next Logical Steps**: What would be the natural next actions to take
-
-### 5. Create/Update Core Dump File
-
-Based on user's choice from step 0, handle the file accordingly:
-
-### 6. Optimize for Minimal Context
-
-- Keep descriptions concise but informative
-- Use abbreviated formats where possible (file sizes, task numbers)
-- Focus on actionable information rather than detailed explanations
-- Avoid redundant information that can be found in project documentation
-- Prioritize information that would be lost without this recording
-- Ensure the file can be quickly scanned and understood
-
-### 7. Validate Completeness
-
-- Verify all significant session activities are captured
-- Ensure a future agent could understand the current state
-- Check that file changes are accurately recorded
-- Confirm next steps are clear and actionable
-- Verify user communication style and preferences are noted