specweave 0.3.13 → 0.4.1

package/src/adapters/claude/adapter.ts

@@ -12,6 +12,7 @@ import * as path from 'path';
 import fs from 'fs-extra';
 import { AdapterBase } from '../adapter-base.js';
 import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+import type { Plugin } from '../../core/types/plugin.js';
 
 export class ClaudeAdapter extends AdapterBase {
   name = 'claude';
@@ -154,4 +155,167 @@ You're ready to build with SpecWeave on Claude Code!
 For complete documentation, see: .claude/README.md
     `;
   }
+
+  /**
+   * Check if Claude adapter supports plugins
+   *
+   * Claude Code has FULL plugin support via native .claude/ directory
+   *
+   * @returns boolean Always true
+   */
+  supportsPlugins(): boolean {
+    return true;
+  }
+
+  /**
+   * Compile and install a plugin for Claude Code
+   *
+   * Claude uses native plugin installation:
+   * - Copy skills to .claude/skills/{plugin-name}/{skill-name}/
+   * - Copy agents to .claude/agents/{plugin-name}/{agent-name}/
+   * - Copy commands to .claude/commands/
+   *
+   * @param plugin Plugin to install
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    const projectPath = process.cwd();
+    const claudeDir = path.join(projectPath, '.claude');
+
+    console.log(`\n📦 Installing plugin: ${plugin.manifest.name}`);
+
+    // Ensure base directories exist
+    await fs.ensureDir(path.join(claudeDir, 'skills'));
+    await fs.ensureDir(path.join(claudeDir, 'agents'));
+    await fs.ensureDir(path.join(claudeDir, 'commands'));
+
+    // Install skills
+    for (const skill of plugin.skills) {
+      const targetPath = path.join(claudeDir, 'skills', skill.name);
+      await fs.ensureDir(targetPath);
+
+      // Copy SKILL.md
+      const skillMdPath = path.join(skill.path, 'SKILL.md');
+      if (await fs.pathExists(skillMdPath)) {
+        await fs.copy(skillMdPath, path.join(targetPath, 'SKILL.md'));
+      }
+
+      // Copy test cases if they exist
+      const testCasesDir = path.join(skill.path, 'test-cases');
+      if (await fs.pathExists(testCasesDir)) {
+        await fs.copy(testCasesDir, path.join(targetPath, 'test-cases'));
+      }
+
+      console.log(`   ✓ Skill: ${skill.name}`);
+    }
+
+    // Install agents
+    for (const agent of plugin.agents) {
+      const targetPath = path.join(claudeDir, 'agents', agent.name);
+      await fs.ensureDir(targetPath);
+
+      // Copy AGENT.md
+      const agentMdPath = path.join(agent.path, 'AGENT.md');
+      if (await fs.pathExists(agentMdPath)) {
+        await fs.copy(agentMdPath, path.join(targetPath, 'AGENT.md'));
+      }
+
+      console.log(`   ✓ Agent: ${agent.name}`);
+    }
+
+    // Install commands
+    for (const command of plugin.commands) {
+      // Commands use their full name as filename
+      const fileName = command.name.replace(/\./g, '-') + '.md';
+      const targetPath = path.join(claudeDir, 'commands', fileName);
+
+      if (await fs.pathExists(command.path)) {
+        await fs.copy(command.path, targetPath);
+      }
+
+      console.log(`   ✓ Command: /${command.name}`);
+    }
+
+    console.log(`\n✅ Plugin ${plugin.manifest.name} installed!`);
+  }
+
+  /**
+   * Unload a plugin from Claude Code
+   *
+   * Removes plugin files from .claude/ directory
+   *
+   * @param pluginName Name of plugin to unload
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    const projectPath = process.cwd();
+    const claudeDir = path.join(projectPath, '.claude');
+
+    console.log(`\n🗑️  Unloading plugin: ${pluginName}`);
+
+    // Read plugin manifest to know what to remove
+    const pluginsDir = path.join(projectPath, 'src', 'plugins');
+    const pluginPath = path.join(pluginsDir, pluginName);
+
+    if (!(await fs.pathExists(pluginPath))) {
+      console.warn(`⚠️  Plugin ${pluginName} not found`);
+      return;
+    }
+
+    // Load plugin to get its components
+    const { PluginLoader } = await import('../../core/plugin-loader.js');
+    const loader = new PluginLoader();
+    const plugin = await loader.loadFromDirectory(pluginPath);
+
+    // Remove skills
+    for (const skill of plugin.skills) {
+      const skillPath = path.join(claudeDir, 'skills', skill.name);
+      if (await fs.pathExists(skillPath)) {
+        await fs.remove(skillPath);
+        console.log(`   ✓ Removed skill: ${skill.name}`);
+      }
+    }
+
+    // Remove agents
+    for (const agent of plugin.agents) {
+      const agentPath = path.join(claudeDir, 'agents', agent.name);
+      if (await fs.pathExists(agentPath)) {
+        await fs.remove(agentPath);
+        console.log(`   ✓ Removed agent: ${agent.name}`);
+      }
+    }
+
+    // Remove commands
+    for (const command of plugin.commands) {
+      const fileName = command.name.replace(/\./g, '-') + '.md';
+      const commandPath = path.join(claudeDir, 'commands', fileName);
+      if (await fs.pathExists(commandPath)) {
+        await fs.remove(commandPath);
+        console.log(`   ✓ Removed command: /${command.name}`);
+      }
+    }
+
+    console.log(`\n✅ Plugin ${pluginName} unloaded!`);
+  }
+
+  /**
+   * Get list of installed plugins
+   *
+   * Returns plugin names that are currently installed in .claude/
+   *
+   * @returns Array of installed plugin names
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    const projectPath = process.cwd();
+    const configPath = path.join(projectPath, '.specweave', 'config.yaml');
+
+    if (!(await fs.pathExists(configPath))) {
+      return [];
+    }
+
+    // Read config to get enabled plugins
+    const yaml = await import('js-yaml');
+    const content = await fs.readFile(configPath, 'utf-8');
+    const config = yaml.load(content) as any;
+
+    return config.plugins?.enabled || [];
+  }
 }

package/src/adapters/copilot/adapter.ts

@@ -11,6 +11,7 @@ import * as path from 'path';
 import fs from 'fs-extra';
 import { AdapterBase } from '../adapter-base.js';
 import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+import type { Plugin } from '../../core/types/plugin.js';
 
 export class CopilotAdapter extends AdapterBase {
   name = 'copilot';
@@ -178,4 +179,141 @@ Note: For better automation, consider Claude Code (full) or Cursor (semi).
 Copilot is best for simple projects or when already using VS Code + Copilot.
     `;
   }
+
+  /**
+   * Check if Copilot adapter supports plugins
+   *
+   * Copilot has plugin support via AGENTS.md compilation (same as Cursor)
+   *
+   * @returns boolean True for Copilot
+   */
+  supportsPlugins(): boolean {
+    return true;
+  }
+
+  /**
+   * Compile and install a plugin for Copilot
+   *
+   * Copilot uses AGENTS.md compilation (same as Cursor)
+   *
+   * @param plugin Plugin to install
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    console.log(`\n📦 Compiling plugin for Copilot: ${plugin.manifest.name}`);
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      throw new Error('AGENTS.md not found. Run specweave init first.');
+    }
+
+    let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+
+    const pluginMarker = `<!-- Plugin: ${plugin.manifest.name} -->`;
+    if (agentsMd.includes(pluginMarker)) {
+      console.log(`   ℹ️  Plugin ${plugin.manifest.name} already compiled to AGENTS.md`);
+      return;
+    }
+
+    let pluginSection = `\n\n${pluginMarker}\n\n`;
+    pluginSection += `# Plugin: ${plugin.manifest.name}\n\n`;
+    pluginSection += `${plugin.manifest.description}\n\n`;
+
+    if (plugin.skills.length > 0) {
+      pluginSection += `## Skills\n\n`;
+      for (const skill of plugin.skills) {
+        const skillContent = await fs.readFile(path.join(skill.path, 'SKILL.md'), 'utf-8');
+        const contentWithoutFrontmatter = skillContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        pluginSection += `### ${skill.name}\n\n${contentWithoutFrontmatter}\n\n`;
+      }
+    }
+
+    if (plugin.agents.length > 0) {
+      pluginSection += `## Agents\n\n`;
+      for (const agent of plugin.agents) {
+        const agentContent = await fs.readFile(path.join(agent.path, 'AGENT.md'), 'utf-8');
+        pluginSection += `### ${agent.name}\n\n${agentContent}\n\n`;
+      }
+    }
+
+    if (plugin.commands.length > 0) {
+      pluginSection += `## Commands\n\n`;
+      for (const command of plugin.commands) {
+        const commandContent = await fs.readFile(command.path, 'utf-8');
+        const contentWithoutFrontmatter = commandContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        pluginSection += `### /${command.name}\n\n${contentWithoutFrontmatter}\n\n`;
+      }
+    }
+
+    pluginSection += `<!-- End Plugin: ${plugin.manifest.name} -->\n`;
+
+    agentsMd += pluginSection;
+    await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+
+    console.log(`   ✓ Compiled to AGENTS.md`);
+    console.log(`   ✓ ${plugin.skills.length} skills, ${plugin.agents.length} agents, ${plugin.commands.length} commands`);
+    console.log(`\n✅ Plugin ${plugin.manifest.name} compiled for Copilot!`);
+  }
+
+  /**
+   * Unload a plugin from Copilot
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    console.log(`\n🗑️  Unloading plugin from Copilot: ${pluginName}`);
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      console.warn(`⚠️  AGENTS.md not found`);
+      return;
+    }
+
+    let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+
+    const startMarker = `<!-- Plugin: ${pluginName} -->`;
+    const endMarker = `<!-- End Plugin: ${pluginName} -->`;
+
+    const startIndex = agentsMd.indexOf(startMarker);
+    if (startIndex === -1) {
+      console.warn(`⚠️  Plugin ${pluginName} not found in AGENTS.md`);
+      return;
+    }
+
+    const endIndex = agentsMd.indexOf(endMarker, startIndex);
+    if (endIndex === -1) {
+      console.warn(`⚠️  Plugin ${pluginName} section malformed`);
+      return;
+    }
+
+    agentsMd = agentsMd.slice(0, startIndex) + agentsMd.slice(endIndex + endMarker.length);
+    await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+
+    console.log(`   ✓ Removed from AGENTS.md`);
+    console.log(`\n✅ Plugin ${pluginName} unloaded!`);
+  }
+
+  /**
+   * Get list of installed plugins for Copilot
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      return [];
+    }
+
+    const agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+    const pluginMarkerRegex = /<!-- Plugin: (specweave-[a-z0-9-]+) -->/g;
+    const matches = agentsMd.matchAll(pluginMarkerRegex);
+
+    const plugins: string[] = [];
+    for (const match of matches) {
+      plugins.push(match[1]);
+    }
+
+    return plugins;
+  }
 }

package/src/adapters/cursor/adapter.ts

@@ -12,6 +12,7 @@ import * as path from 'path';
 import fs from 'fs-extra';
 import { AdapterBase } from '../adapter-base.js';
 import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+import type { Plugin } from '../../core/types/plugin.js';
 
 export class CursorAdapter extends AdapterBase {
   name = 'cursor';
@@ -219,4 +220,173 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
 - "act as DevOps and create infrastructure" (AGENTS.md defines DevOps role)
     `;
   }
+
+  /**
+   * Check if Cursor adapter supports plugins
+   *
+   * Cursor has plugin support via AGENTS.md compilation
+   *
+   * @returns boolean True for Cursor
+   */
+  supportsPlugins(): boolean {
+    return true;
+  }
+
+  /**
+   * Compile and install a plugin for Cursor
+   *
+   * Cursor uses AGENTS.md compilation:
+   * - Append skills to AGENTS.md
+   * - Append agents to AGENTS.md
+   * - Append commands to team commands JSON
+   *
+   * @param plugin Plugin to install
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    console.log(`\n📦 Compiling plugin for Cursor: ${plugin.manifest.name}`);
+
+    // Ensure AGENTS.md exists
+    if (!(await fs.pathExists(agentsMdPath))) {
+      throw new Error('AGENTS.md not found. Run specweave init first.');
+    }
+
+    // Read current AGENTS.md
+    let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+
+    // Check if plugin already compiled
+    const pluginMarker = `<!-- Plugin: ${plugin.manifest.name} -->`;
+    if (agentsMd.includes(pluginMarker)) {
+      console.log(`   ℹ️  Plugin ${plugin.manifest.name} already compiled to AGENTS.md`);
+      return;
+    }
+
+    // Generate plugin section for AGENTS.md
+    let pluginSection = `\n\n${pluginMarker}\n\n`;
+    pluginSection += `# Plugin: ${plugin.manifest.name}\n\n`;
+    pluginSection += `${plugin.manifest.description}\n\n`;
+
+    // Add skills
+    if (plugin.skills.length > 0) {
+      pluginSection += `## Skills\n\n`;
+      for (const skill of plugin.skills) {
+        const skillContent = await fs.readFile(path.join(skill.path, 'SKILL.md'), 'utf-8');
+        // Remove frontmatter for AGENTS.md
+        const contentWithoutFrontmatter = skillContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        pluginSection += `### ${skill.name}\n\n`;
+        pluginSection += `${contentWithoutFrontmatter}\n\n`;
+      }
+    }
+
+    // Add agents
+    if (plugin.agents.length > 0) {
+      pluginSection += `## Agents\n\n`;
+      for (const agent of plugin.agents) {
+        const agentContent = await fs.readFile(path.join(agent.path, 'AGENT.md'), 'utf-8');
+        pluginSection += `### ${agent.name}\n\n`;
+        pluginSection += `${agentContent}\n\n`;
+      }
+    }
+
+    // Add commands
+    if (plugin.commands.length > 0) {
+      pluginSection += `## Commands\n\n`;
+      for (const command of plugin.commands) {
+        const commandContent = await fs.readFile(command.path, 'utf-8');
+        // Remove frontmatter
+        const contentWithoutFrontmatter = commandContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        pluginSection += `### /${command.name}\n\n`;
+        pluginSection += `${contentWithoutFrontmatter}\n\n`;
+      }
+    }
+
+    pluginSection += `<!-- End Plugin: ${plugin.manifest.name} -->\n`;
+
+    // Append to AGENTS.md
+    agentsMd += pluginSection;
+    await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+
+    console.log(`   ✓ Compiled to AGENTS.md`);
+    console.log(`   ✓ ${plugin.skills.length} skills added`);
+    console.log(`   ✓ ${plugin.agents.length} agents added`);
+    console.log(`   ✓ ${plugin.commands.length} commands added`);
+
+    console.log(`\n✅ Plugin ${plugin.manifest.name} compiled for Cursor!`);
+  }
+
+  /**
+   * Unload a plugin from Cursor
+   *
+   * Removes plugin section from AGENTS.md
+   *
+   * @param pluginName Name of plugin to unload
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    console.log(`\n🗑️  Unloading plugin from Cursor: ${pluginName}`);
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      console.warn(`⚠️  AGENTS.md not found`);
+      return;
+    }
+
+    // Read AGENTS.md
+    let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+
+    // Find plugin section
+    const startMarker = `<!-- Plugin: ${pluginName} -->`;
+    const endMarker = `<!-- End Plugin: ${pluginName} -->`;
+
+    const startIndex = agentsMd.indexOf(startMarker);
+    if (startIndex === -1) {
+      console.warn(`⚠️  Plugin ${pluginName} not found in AGENTS.md`);
+      return;
+    }
+
+    const endIndex = agentsMd.indexOf(endMarker, startIndex);
+    if (endIndex === -1) {
+      console.warn(`⚠️  Plugin ${pluginName} section malformed in AGENTS.md`);
+      return;
+    }
+
+    // Remove plugin section
+    agentsMd = agentsMd.slice(0, startIndex) + agentsMd.slice(endIndex + endMarker.length);
+
+    // Write back
+    await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+
+    console.log(`   ✓ Removed from AGENTS.md`);
+    console.log(`\n✅ Plugin ${pluginName} unloaded!`);
+  }
+
+  /**
+   * Get list of installed plugins for Cursor
+   *
+   * Parses AGENTS.md for plugin markers
+   *
+   * @returns Array of installed plugin names
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      return [];
+    }
+
+    const agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+    const pluginMarkerRegex = /<!-- Plugin: (specweave-[a-z0-9-]+) -->/g;
+    const matches = agentsMd.matchAll(pluginMarkerRegex);
+
+    const plugins: string[] = [];
+    for (const match of matches) {
+      plugins.push(match[1]);
+    }
+
+    return plugins;
+  }
 }

package/src/adapters/generic/adapter.ts

@@ -12,6 +12,7 @@ import * as path from 'path';
 import fs from 'fs-extra';
 import { AdapterBase } from '../adapter-base.js';
 import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
+import type { Plugin } from '../../core/types/plugin.js';
 
 export class GenericAdapter extends AdapterBase {
   name = 'generic';
@@ -160,4 +161,140 @@ You're ready to build with SpecWeave using ANY AI tool!
 Remember: AGENTS.md is the universal standard - it works everywhere!
     `;
   }
+
+  /**
+   * Check if Generic adapter supports plugins
+   *
+   * Generic has manual plugin support via AGENTS.md
+   *
+   * @returns boolean True
+   */
+  supportsPlugins(): boolean {
+    return true;
+  }
+
+  /**
+   * Compile and install a plugin for Generic adapter
+   *
+   * Appends plugin content to AGENTS.md for manual copy-paste workflows
+   *
+   * @param plugin Plugin to install
+   */
+  async compilePlugin(plugin: Plugin): Promise<void> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    console.log(`\n📦 Adding plugin to AGENTS.md: ${plugin.manifest.name}`);
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      throw new Error('AGENTS.md not found. Run specweave init first.');
+    }
+
+    let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+
+    const pluginMarker = `<!-- Plugin: ${plugin.manifest.name} -->`;
+    if (agentsMd.includes(pluginMarker)) {
+      console.log(`   ℹ️  Plugin ${plugin.manifest.name} already in AGENTS.md`);
+      return;
+    }
+
+    let pluginSection = `\n\n${pluginMarker}\n\n`;
+    pluginSection += `# Plugin: ${plugin.manifest.name}\n\n`;
+    pluginSection += `${plugin.manifest.description}\n\n`;
+
+    if (plugin.skills.length > 0) {
+      pluginSection += `## Skills\n\n`;
+      for (const skill of plugin.skills) {
+        const skillContent = await fs.readFile(path.join(skill.path, 'SKILL.md'), 'utf-8');
+        const contentWithoutFrontmatter = skillContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        pluginSection += `### ${skill.name}\n\n${contentWithoutFrontmatter}\n\n`;
+      }
+    }
+
+    if (plugin.agents.length > 0) {
+      pluginSection += `## Agents\n\n`;
+      for (const agent of plugin.agents) {
+        const agentContent = await fs.readFile(path.join(agent.path, 'AGENT.md'), 'utf-8');
+        pluginSection += `### ${agent.name}\n\n${agentContent}\n\n`;
+      }
+    }
+
+    if (plugin.commands.length > 0) {
+      pluginSection += `## Workflows (Manual)\n\n`;
+      for (const command of plugin.commands) {
+        const commandContent = await fs.readFile(command.path, 'utf-8');
+        const contentWithoutFrontmatter = commandContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        pluginSection += `### ${command.name.replace('specweave.', '')}\n\n${contentWithoutFrontmatter}\n\n`;
+      }
+    }
+
+    pluginSection += `<!-- End Plugin: ${plugin.manifest.name} -->\n`;
+
+    agentsMd += pluginSection;
+    await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+
+    console.log(`   ✓ Added to AGENTS.md (copy-paste workflows)`);
+    console.log(`\n✅ Plugin ${plugin.manifest.name} available for manual use!`);
+  }
+
+  /**
+   * Unload a plugin from Generic adapter
+   */
+  async unloadPlugin(pluginName: string): Promise<void> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    console.log(`\n🗑️  Removing plugin from AGENTS.md: ${pluginName}`);
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      console.warn(`⚠️  AGENTS.md not found`);
+      return;
+    }
+
+    let agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+
+    const startMarker = `<!-- Plugin: ${pluginName} -->`;
+    const endMarker = `<!-- End Plugin: ${pluginName} -->`;
+
+    const startIndex = agentsMd.indexOf(startMarker);
+    if (startIndex === -1) {
+      console.warn(`⚠️  Plugin ${pluginName} not found in AGENTS.md`);
+      return;
+    }
+
+    const endIndex = agentsMd.indexOf(endMarker, startIndex);
+    if (endIndex === -1) {
+      console.warn(`⚠️  Plugin ${pluginName} section malformed`);
+      return;
+    }
+
+    agentsMd = agentsMd.slice(0, startIndex) + agentsMd.slice(endIndex + endMarker.length);
+    await fs.writeFile(agentsMdPath, agentsMd, 'utf-8');
+
+    console.log(`   ✓ Removed from AGENTS.md`);
+    console.log(`\n✅ Plugin ${pluginName} removed!`);
+  }
+
+  /**
+   * Get list of installed plugins for Generic adapter
+   */
+  async getInstalledPlugins(): Promise<string[]> {
+    const projectPath = process.cwd();
+    const agentsMdPath = path.join(projectPath, 'AGENTS.md');
+
+    if (!(await fs.pathExists(agentsMdPath))) {
+      return [];
+    }
+
+    const agentsMd = await fs.readFile(agentsMdPath, 'utf-8');
+    const pluginMarkerRegex = /<!-- Plugin: (specweave-[a-z0-9-]+) -->/g;
+    const matches = agentsMd.matchAll(pluginMarkerRegex);
+
+    const plugins: string[] = [];
+    for (const match of matches) {
+      plugins.push(match[1]);
+    }
+
+    return plugins;
+  }
 }

package/src/agents/architect/AGENT.md

@@ -3,6 +3,9 @@ name: architect
 description: System Architect and technical design expert. Creates system architecture, technical specifications, Architecture Decision Records (ADRs), component designs, API contracts, data models, and deployment architectures. Handles design patterns, scalability planning, technology stack decisions, microservices architecture, event-driven systems, CQRS, domain-driven design. Activates for: architecture, system design, technical design, ADR, architecture decision record, design patterns, microservices, API design, data model, database schema, scalability, performance architecture, technology stack, tech stack selection, distributed systems, event-driven, CQRS, DDD, domain model, component architecture, integration patterns, CAP theorem, consistency, availability, partition tolerance.
 tools: Read, Write, Edit
 model: claude-sonnet-4-5-20250929
+model_preference: sonnet
+cost_profile: planning
+fallback_behavior: strict
 ---
 
 # Architect Agent - System Architecture & Technical Design Expert