specweave 0.4.0 → 0.4.1

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/commands/specweave.increment.md

@@ -117,7 +117,51 @@ You are helping the user create a new SpecWeave increment with automatic closure
 - "What's the short name?" (e.g., "user-authentication" for increment 003-user-authentication)
 - "Priority? (P1/P2/P3)" (default: P1)
 
-### Step 4: Activate Increment Planning Workflow
+### Step 4: Detect Suggested Plugins (T-019 - Plugin Auto-Detection)
+
+**🔌 NEW IN v0.4.0**: Auto-detect plugins based on increment description
+
+Before planning, analyze the feature description for plugin keywords and suggest relevant plugins:
+
+```bash
+# Example feature descriptions and their plugin suggestions:
+"Deploy to Kubernetes" → kubernetes plugin
+"Add Stripe payments" → payment-processing plugin
+"Create React dashboard" → frontend-stack plugin
+"Build FastAPI backend" → backend-stack plugin
+"Sync with GitHub issues" → github plugin
+"Integrate with Jira" → jira plugin
+```
+
+**Detection Logic**:
+1. Extract keywords from feature description
+2. Match against plugin triggers (from manifest.json)
+3. Check if plugin already enabled
+4. Suggest new plugins only
+
+**Output Format**:
+```
+💡 Plugin Detection
+
+Analyzing feature: "Add authentication with NextJS and Stripe"
+
+Suggested plugins:
+✅ frontend-stack (NextJS detected)
+✅ payment-processing (Stripe detected)
+
+Would you like to enable these plugins? (Y/n)
+```
+
+**If user confirms**:
+- Enable plugins via PluginManager
+- Plugins become available for increment planning
+- Skills/agents from plugins can be used immediately
+
+**If user declines**:
+- Continue without plugins
+- User can enable later: `specweave plugin enable <name>`
+
+### Step 5: Activate Increment Planning Workflow
 
 **🚨 CRITICAL - YOU MUST USE THE SKILL TOOL:**
 
@@ -149,7 +193,7 @@ The increment-planner skill will:
 - ✅ Quality gates enforced
 - ❌ Direct file writing bypasses entire workflow
 
-### Step 5: Skill Tool Invocation (MANDATORY)
+### Step 6: Skill Tool Invocation (MANDATORY)
 
 **BEFORE PROCEEDING, USE THE SKILL TOOL:**
 
@@ -158,9 +202,9 @@ You must literally call the Skill tool like this:
 Skill(command: "increment-planner")
 ```
 
-Wait for the skill to complete. Do NOT continue to Step 6 until the increment-planner skill returns.
+Wait for the skill to complete. Do NOT continue to Step 7 until the increment-planner skill returns.
 
-### Step 6: Alternative Approach (ONLY IF SKILL FAILS)
+### Step 7: Alternative Approach (ONLY IF SKILL FAILS)
 
 **Only use this if Skill tool is unavailable or fails:**
 

package/src/hooks/post-increment-plugin-detect.sh

@@ -0,0 +1,142 @@
+#!/bin/bash
+
+#
+# Post-Increment Plugin Detection Hook (T-021)
+#
+# Runs AFTER increment completion to suggest plugins based on git diff
+# This is Phase 4 of the 4-phase plugin detection system
+#
+# Trigger: After `/specweave.done` completes an increment
+# Output: Plugin suggestions for NEXT increment
+#
+
+# Exit on error
+set -e
+
+# Get project root (assumes hook runs from project directory)
+PROJECT_ROOT=$(pwd)
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+GRAY='\033[0;37m'
+MAGENTA='\033[0;35m'
+NC='\033[0m' # No Color
+
+# Check if SpecWeave is installed
+if ! command -v specweave &> /dev/null; then
+    # Silent exit if SpecWeave not installed (development mode)
+    exit 0
+fi
+
+# Check if git repository exists
+if [ ! -d ".git" ]; then
+    # Not a git repo, skip detection
+    exit 0
+fi
+
+# Get completed increment number (passed as argument)
+INCREMENT_NUM="$1"
+
+if [ -z "$INCREMENT_NUM" ]; then
+    # No increment number provided, skip
+    exit 0
+fi
+
+# Get git diff since last increment tag (or HEAD if no tags)
+LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "HEAD~10")
+GIT_DIFF=$(git diff --name-only "$LAST_TAG"..HEAD 2>/dev/null || echo "")
+
+if [ -z "$GIT_DIFF" ]; then
+    # No changes detected, skip
+    exit 0
+fi
+
+# Also check package.json changes for new dependencies
+PACKAGE_JSON_CHANGED=false
+if echo "$GIT_DIFF" | grep -q "package.json"; then
+    PACKAGE_JSON_CHANGED=true
+fi
+
+# Keyword-based plugin detection from file changes
+declare -A PLUGIN_PATTERNS=(
+    ["specweave-github"]=".github/|github-"
+    ["specweave-kubernetes"]="kubernetes/|k8s/|helm/|\.yaml$"
+    ["specweave-frontend-stack"]="components/|pages/|app/|\.tsx$|\.jsx$"
+    ["specweave-backend-stack"]="api/|server/|routes/|controllers/"
+    ["specweave-ml-ops"]="models/|training/|\.ipynb$|\.h5$|\.pkl$"
+    ["specweave-payment-processing"]="payments/|billing/|stripe"
+    ["specweave-figma"]="\.figma|design/|mockups/"
+    ["specweave-observability"]="prometheus/|grafana/|monitoring/"
+    ["specweave-diagrams"]="diagrams/|\.mmd$|architecture/"
+)
+
+# Dependency-based detection (if package.json changed)
+declare -A DEPENDENCY_PLUGINS=(
+    ["specweave-frontend-stack"]="react|vue|angular|next"
+    ["specweave-backend-stack"]="express|fastapi|django|nestjs"
+    ["specweave-payment-processing"]="stripe|paypal"
+    ["specweave-ml-ops"]="tensorflow|pytorch|scikit-learn"
+    ["specweave-observability"]="prometheus-client|@opentelemetry"
+)
+
+# Detect plugins based on file patterns
+SUGGESTED_PLUGINS=()
+
+# Check file patterns
+for plugin in "${!PLUGIN_PATTERNS[@]}"; do
+    pattern="${PLUGIN_PATTERNS[$plugin]}"
+
+    if echo "$GIT_DIFF" | grep -qi -E "$pattern"; then
+        # Check if plugin is already enabled
+        if ! specweave plugin list --enabled 2>/dev/null | grep -q "$plugin"; then
+            if [[ ! " ${SUGGESTED_PLUGINS[@]} " =~ " ${plugin} " ]]; then
+                SUGGESTED_PLUGINS+=("$plugin")
+            fi
+        fi
+    fi
+done
+
+# Check package.json dependencies if it changed
+if [ "$PACKAGE_JSON_CHANGED" = true ] && [ -f "package.json" ]; then
+    DEPENDENCIES=$(cat package.json | grep -A 100 '"dependencies"' | grep -A 100 '"devDependencies"' || echo "")
+
+    for plugin in "${!DEPENDENCY_PLUGINS[@]}"; do
+        keywords="${DEPENDENCY_PLUGINS[$plugin]}"
+
+        if echo "$DEPENDENCIES" | grep -qi -E "$keywords"; then
+            if ! specweave plugin list --enabled 2>/dev/null | grep -q "$plugin"; then
+                if [[ ! " ${SUGGESTED_PLUGINS[@]} " =~ " ${plugin} " ]]; then
+                    SUGGESTED_PLUGINS+=("$plugin")
+                fi
+            fi
+        fi
+    done
+fi
+
+# Output suggestions if any found
+if [ ${#SUGGESTED_PLUGINS[@]} -gt 0 ]; then
+    echo ""
+    echo -e "${MAGENTA}══════════════════════════════════════════════════════${NC}"
+    echo -e "${CYAN}💡 Plugin Suggestions for Next Increment${NC}"
+    echo -e "${MAGENTA}══════════════════════════════════════════════════════${NC}"
+    echo ""
+    echo -e "${GRAY}Increment ${INCREMENT_NUM} introduced changes that suggest:${NC}"
+    echo ""
+
+    for plugin in "${SUGGESTED_PLUGINS[@]}"; do
+        echo -e "   ✨ ${GREEN}${plugin}${NC}"
+    done
+
+    echo ""
+    echo -e "${YELLOW}Consider enabling these plugins for your next increment:${NC}"
+    echo -e "${CYAN}   specweave plugin enable <name>${NC}"
+    echo ""
+    echo -e "${GRAY}Plugins will auto-activate skills and agents for better support${NC}"
+    echo -e "${MAGENTA}══════════════════════════════════════════════════════${NC}"
+    echo ""
+fi
+
+# Always exit successfully (non-blocking)
+exit 0