specweave 0.6.6 → 0.6.8

package/plugins/specweave/hooks/docs-changed.sh

@@ -7,7 +7,26 @@
 
 set -e
 
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+# Find project root by searching upward for .specweave/ directory
+# Works regardless of where hook is installed (source or .claude/hooks/)
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
 cd "$PROJECT_ROOT"
 
 # Colors
@@ -54,6 +73,7 @@ if [ -n "$DOC_CHANGES" ]; then
   esac
 
   # Log to hooks log
-  mkdir -p .specweave/logs
-  echo "[$(date)] Documentation changed: $DOC_CHANGES" >> .specweave/logs/hooks.log
+  LOGS_DIR=".specweave/logs"
+  mkdir -p "$LOGS_DIR"
+  echo "[$(date)] Documentation changed: $DOC_CHANGES" >> "$LOGS_DIR/hooks.log"
 fi

package/plugins/specweave/hooks/human-input-required.sh

@@ -10,7 +10,26 @@
 
 set -e
 
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+# Find project root by searching upward for .specweave/ directory
+# Works regardless of where hook is installed (source or .claude/hooks/)
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
 cd "$PROJECT_ROOT"
 
 # Get question/requirement (passed as argument or default)
@@ -37,8 +56,9 @@ play_sound() {
 play_sound &
 
 # 2. Log to main hooks log
-mkdir -p .specweave/logs
-echo "[$(date)] Human input required: $QUESTION" >> .specweave/logs/hooks.log
+LOGS_DIR=".specweave/logs"
+mkdir -p "$LOGS_DIR"
+echo "[$(date)] Human input required: $QUESTION" >> "$LOGS_DIR/hooks.log"
 
 # 3. Log to current work context (if exists)
 CURRENT_WORK=$(find .specweave/work -maxdepth 1 -type d -name "current-*" | head -1 || true)

package/plugins/specweave/hooks/post-task-completion.sh

@@ -28,7 +28,26 @@
 
 set -e
 
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+# Find project root by searching upward for .specweave/ directory
+# Works regardless of where hook is installed (source or .claude/hooks/)
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
 cd "$PROJECT_ROOT" 2>/dev/null || true
 
 # ============================================================================

package/plugins/specweave/hooks/pre-implementation.sh

@@ -6,7 +6,26 @@
 
 set -e
 
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+# Find project root by searching upward for .specweave/ directory
+# Works regardless of where hook is installed (source or .claude/hooks/)
+find_project_root() {
+  local dir="$1"
+  while [ "$dir" != "/" ]; do
+    if [ -d "$dir/.specweave" ]; then
+      echo "$dir"
+      return 0
+    fi
+    dir="$(dirname "$dir")"
+  done
+  # Fallback: try current directory
+  if [ -d "$(pwd)/.specweave" ]; then
+    pwd
+  else
+    echo "$(pwd)"
+  fi
+}
+
+PROJECT_ROOT="$(find_project_root "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)")"
 cd "$PROJECT_ROOT"
 
 # Colors
@@ -40,8 +59,9 @@ else
 fi
 
 # Log to hooks log
-mkdir -p .specweave/logs
-echo "[$(date)] Pre-implementation check complete" >> .specweave/logs/hooks.log
+LOGS_DIR=".specweave/logs"
+mkdir -p "$LOGS_DIR"
+echo "[$(date)] Pre-implementation check complete" >> "$LOGS_DIR/hooks.log"
 
 echo ""
 echo -e "${GREEN}✅ Pre-implementation check complete${NC}"

package/src/adapters/README.md

@@ -16,32 +16,31 @@ SpecWeave
 │       └── docs/
 │
 └── Adapters (Optional)
-    ├── Claude                    # Full automation
+    ├── Claude                    # Full automation (native)
     │   ├── .claude/skills/
     │   ├── .claude/agents/
     │   └── .claude/hooks/
     │
-    ├── Cursor                    # Semi-automation
-    │   └── .cursorrules
+    ├── Cursor                    # Partial automation
+    │   ├── .cursorrules (legacy)
+    │   └── AGENTS.md
     │
-    ├── Copilot                   # Basic automation
-    │   └── .github/copilot/instructions.md
-    │
-    └── Generic                   # Manual workflow
-        └── SPECWEAVE.md
+    └── Generic                   # Limited features
+        └── AGENTS.md             # Works with Copilot, ChatGPT, Gemini
 ```
 
 ## Available Adapters
 
-| Adapter | Automation | Market Share | Status |
-|---------|------------|--------------|--------|
-| **Claude** | Full (skills, agents, hooks) | 10% | ✅ Active |
-| **Cursor** | Semi (.cursorrules, @ shortcuts) | 30% | ✅ Active |
-| **Copilot** | Basic (workspace instructions) | 40% | ✅ Active |
-| **Generic** | Manual (step-by-step guide) | 20% (other tools) | ✅ Active |
+| Adapter | Automation | Tools | Status |
+|---------|------------|-------|--------|
+| **Claude** | Full (skills, agents, hooks) | Claude Code | ✅ Active |
+| **Cursor** | Partial (AGENTS.md, team commands, less reliable) | Cursor | ✅ Active |
+| **Generic** | Limited (AGENTS.md, no hooks, manual workflow) | Copilot, ChatGPT, Gemini, etc. | ✅ Active |
 
 **Total Market Coverage**: 100% (works with ANY AI tool)
 
+**Note**: Claude Code is the only fully reliable option. Others have reduced features and reliability.
+
 ## Adapter Interface
 
 All adapters implement the `IAdapter` interface defined in `adapter-interface.ts`:
@@ -110,47 +109,17 @@ Only load files listed in manifest.
 
 ---
 
-### 3. Copilot Adapter (Basic Automation)
-
-**Files Installed**:
-- `.github/copilot/instructions.md` - Workspace instructions for Copilot
-
-**Features**:
-- Workspace-level guidance read by Copilot
-- Context manifests referenced in instructions
-- Suggestions based on SpecWeave structure
-
-**Instruction File** (.github/copilot/instructions.md):
-```markdown
-# SpecWeave Workspace Instructions
-
-## Project Overview
-This project uses SpecWeave for spec-driven development.
-
-## Workflow: Creating Features
-1. Create increment folder: `.specweave/increments/####-short-name/`
-2. Create spec.md (WHAT and WHY)
-3. Create plan.md (HOW)
-4. Create tasks.md (Implementation)
-
-## Context Loading (CRITICAL)
-Always read context-manifest.yaml first!
-```
-
-**Detection**: Checks for GitHub Copilot extension in VS Code
-
----
-
-### 4. Generic Adapter (Manual Workflow)
+### 3. Generic Adapter (Limited Features)
 
 **Files Installed**:
-- `SPECWEAVE.md` - Complete step-by-step manual guide
+- `AGENTS.md` - Universal instruction file for all AI tools
 
 **Features**:
-- Works with ANY AI tool (ChatGPT web, Claude web, Gemini, etc.)
-- Clear manual workflow
-- Copy-paste instructions
-- 100% compatibility (no tool dependencies)
+- Works with Copilot, ChatGPT, Gemini, and ANY AI tool
+- AGENTS.md format (https://agents.md/)
+- No automation (manual workflow)
+- No hooks (manual living docs sync)
+- High context usage
 
 **Manual Guide** (SPECWEAVE.md):
 ```markdown
@@ -186,17 +155,13 @@ Copy files listed in `context-manifest.yaml` to your AI chat.
 - Cursor reads `.cursorrules` which contains workflow instructions
 - AI follows instructions step-by-step
 
-### GitHub Copilot (Instruction Files)
-- User types: "create increment for user auth"
-- Copilot reads `.github/copilot/instructions.md`
-- AI follows workspace instructions
-
-### Generic (Manual Copy-Paste)
-- User reads `SPECWEAVE.md`
-- User copies relevant sections to AI chat
-- User guides AI through workflow manually
+### Generic / Copilot / ChatGPT (AGENTS.md)
+- All tools read `AGENTS.md` (universal standard)
+- Copilot reads it automatically in VS Code
+- ChatGPT/Gemini: User copies sections to chat
+- Manual workflow with AI assistance
 
-**Pattern**: Each adapter uses **instruction files** appropriate to the tool's capabilities.
+**Pattern**: AGENTS.md is the universal instruction format. Only Claude Code uses native plugins (.claude/).
 
 ## Installation
 
@@ -209,8 +174,7 @@ npx specweave init my-project
 # Or specify adapter explicitly
 npx specweave init my-project --adapter claude
 npx specweave init my-project --adapter cursor
-npx specweave init my-project --adapter copilot
-npx specweave init my-project --adapter generic
+npx specweave init my-project --adapter generic  # For Copilot, ChatGPT, Gemini
 ```
 
 ### For Developers (Install All Adapters)

package/src/adapters/adapter-interface.ts

@@ -2,7 +2,7 @@
  * Adapter Interface for Multi-Tool Support
  *
  * Defines the contract that all SpecWeave adapters must implement.
- * Enables SpecWeave to work with ANY AI coding tool (Claude, Cursor, Copilot, etc.)
+ * Enables SpecWeave to work with ANY AI coding tool (Claude, Cursor, Copilot/ChatGPT/Gemini via generic, etc.)
  */
 
 import type { Plugin } from '../core/types/plugin.js';
@@ -34,11 +34,12 @@ export type AutomationLevel = 'full' | 'semi' | 'basic' | 'manual';
 /**
  * Base Adapter Interface
  *
- * All adapters (Claude, Cursor, Copilot, Generic) must implement this interface.
+ * All adapters (Cursor, Generic) must implement this interface.
+ * Note: Claude Code is NOT an adapter - it's the native baseline experience.
  */
 export interface IAdapter {
   /**
-   * Adapter name (e.g., 'claude', 'cursor', 'copilot', 'generic')
+   * Adapter name (e.g., 'cursor', 'generic')
    */
   name: string;
 
@@ -60,9 +61,8 @@ export interface IAdapter {
    * Detect if this adapter's tool is present in the environment
    *
    * Examples:
-   * - Claude: Check for Claude Code CLI
    * - Cursor: Check for .cursor/ directory or Cursor process
-   * - Copilot: Check for .github/copilot/ or Copilot extension
+   * - Generic: Always true (fallback for any tool)
    *
    * @returns Promise<boolean> True if tool detected
    */
@@ -90,7 +90,7 @@ export interface IAdapter {
   /**
    * Install this adapter to a project
    *
-   * Creates tool-specific files (e.g., .cursorrules, .github/copilot/instructions.md)
+   * Creates tool-specific files (e.g., .cursorrules for Cursor, AGENTS.md for all)
    * Installs relevant skills/agents if applicable
    *
    * @param options Installation options
@@ -124,8 +124,8 @@ export interface IAdapter {
    * Check if this adapter supports plugins
    *
    * Returns true if the adapter can install and compile plugins
-   * (Claude native, Cursor AGENTS.md, Copilot instructions.md)
-   * Returns false for generic/manual adapters
+   * (Cursor AGENTS.md compilation, Generic AGENTS.md)
+   * Returns false for manual-only adapters
    *
    * @returns boolean True if plugins are supported
    */
@@ -135,10 +135,10 @@ export interface IAdapter {
    * Compile and install a plugin for this adapter
    *
    * Transforms plugin content (skills/agents/commands) to tool-specific format:
-   * - Claude: Copy to .claude/skills/, .claude/agents/, .claude/commands/
    * - Cursor: Compile to AGENTS.md + team commands JSON
-   * - Copilot: Compile to .github/copilot/instructions.md
-   * - Generic: Generate manual copy-paste instructions
+   * - Generic: Compile to AGENTS.md for Copilot/ChatGPT/Gemini
+   *
+   * Note: Claude Code uses native plugin system (no compilation needed)
    *
    * @param plugin Plugin to compile and install
    * @returns Promise<void>

package/src/adapters/adapter-loader.ts

@@ -11,7 +11,6 @@ import * as YAML from 'yaml';
 import { execSync } from 'child_process';
 import { IAdapter } from './adapter-interface.js';
 import { CursorAdapter } from './cursor/adapter.js';
-import { CopilotAdapter } from './copilot/adapter.js';
 import { GeminiAdapter } from './gemini/adapter.js';
 import { CodexAdapter } from './codex/adapter.js';
 import { GenericAdapter } from './generic/adapter.js';
@@ -53,7 +52,6 @@ export class AdapterLoader {
   private initializeAdapters(): void {
     // Note: No ClaudeAdapter - Claude is the baseline, not an adaptation!
     this.adapters.set('cursor', new CursorAdapter());
-    this.adapters.set('copilot', new CopilotAdapter());
     this.adapters.set('gemini', new GeminiAdapter());
     this.adapters.set('codex', new CodexAdapter());
     this.adapters.set('generic', new GenericAdapter());
@@ -101,8 +99,7 @@ export class AdapterLoader {
    * 2. Cursor (if cursor CLI or .cursor/ or .cursorrules exists)
    * 3. Gemini CLI (if gemini CLI found)
    * 4. Codex (if codex CLI found)
-   * 5. Copilot (if .github/copilot/ exists)
-   * 6. Generic (only if explicitly requested via --adapter generic)
+   * 5. Generic (only if explicitly requested via --adapter generic)
    *
    * @returns Promise<string> Detected tool name (not adapter - Claude has no adapter!)
    */
@@ -110,7 +107,7 @@ export class AdapterLoader {
     console.log('🔍 Detecting AI coding tool...\n');
 
     // Check other tools first (if they have specific indicators)
-    const detectionOrder = ['cursor', 'gemini', 'codex', 'copilot'];
+    const detectionOrder = ['cursor', 'gemini', 'codex'];
 
     for (const adapterName of detectionOrder) {
       const adapter = this.adapters.get(adapterName);
@@ -241,7 +238,7 @@ export class AdapterLoader {
     if (explicitChoice) {
       const adapter = this.adapters.get(explicitChoice);
       if (!adapter) {
-        throw new Error(`Invalid adapter: ${explicitChoice}. Use 'claude', 'cursor', 'copilot', or 'generic'`);
+        throw new Error(`Invalid adapter: ${explicitChoice}. Use 'claude', 'cursor', or 'generic'`);
       }
       return adapter;
     }

package/src/adapters/agents-md-generator.ts

@@ -6,11 +6,11 @@
  *
  * IMPORTANT:
  * - Claude Code does NOT read this file - it only reads CLAUDE.md
- * - This file is for: Cursor, Gemini CLI, Codex, GitHub Copilot, and ANY other AI tool
+ * - This file is for: Cursor, GitHub Copilot, ChatGPT, Gemini, and ANY other AI tool
  *
  * This ONE file replaces:
- * - .cursorrules (Cursor)
- * - .github/copilot/instructions.md (Copilot)
+ * - .cursorrules (Cursor - legacy)
+ * - .github/copilot/instructions.md (Copilot - no longer needed, Copilot reads AGENTS.md)
  * - Any other tool-specific configuration files
  */
 

package/src/adapters/generic/adapter.ts

@@ -4,8 +4,8 @@
  * Universal adapter that works with ANY AI tool.
  * All AI tools can read AGENTS.md (universal standard) for workflow instructions.
  *
- * This adapter ensures 100% compatibility - works with ChatGPT web, Claude web,
- * Gemini, or literally ANY AI that can read markdown and follow instructions.
+ * This adapter ensures 100% compatibility - works with GitHub Copilot, ChatGPT web,
+ * Claude web, Gemini, or literally ANY AI that can read markdown and follow instructions.
  */
 
 import * as path from 'path';
@@ -18,7 +18,7 @@ import type { SupportedLanguage } from '../../core/i18n/types.js';
 
 export class GenericAdapter extends AdapterBase {
   name = 'generic';
-  description = 'Generic adapter - AGENTS.md works with ANY AI tool (ChatGPT, Gemini, etc.)';
+  description = 'Generic adapter - AGENTS.md works with ANY AI tool (Copilot, ChatGPT, Gemini, etc.)';
   automationLevel = 'manual' as const;
 
   /**
@@ -49,7 +49,7 @@ export class GenericAdapter extends AdapterBase {
     console.log('\n📦 Configuring for Universal AI Tool Compatibility\n');
 
     // No files to install - any AI can read AGENTS.md
-    console.log('✅ AGENTS.md works with any AI tool (ChatGPT, Gemini, Claude web, etc.)');
+    console.log('✅ AGENTS.md works with any AI tool (Copilot, ChatGPT, Gemini, Claude web, etc.)');
   }
 
   /**
@@ -72,19 +72,38 @@ Your project is now configured for ANY AI tool!
 
 WHAT THIS PROVIDES:
 
-- AGENTS.md (Universal Standard)
-  - Any AI tool can read this file
+- AGENTS.MD (Universal Standard)
+  - GitHub Copilot automatically reads this file
+  - ChatGPT, Gemini, Claude web can also use it
   - Contains all workflow instructions
   - Project structure and templates
   - Following agents.md standard (https://agents.md/)
 
 - 100% Compatibility
+  - GitHub Copilot (best experience with AGENTS.md)
   - ChatGPT (web), Claude (web), Gemini
   - Any AI that can read markdown
 
 HOW TO USE AGENTS.MD WITH ANY AI:
 
-Method 1: Copy-Paste Workflow (ChatGPT web, Claude web, etc.)
+Method 1: Command Discovery (GitHub Copilot - Recommended!)
+1. AI reads AGENTS.md automatically (Copilot scans project files)
+2. AGENTS.md contains "SpecWeave Commands" section with all 17 commands
+3. Ask: "create increment for payments" or "run /inc payments"
+4. AI reads plugins/specweave/commands/inc.md
+5. AI executes PM-led workflow (market research, spec.md, plan.md, tasks.md)
+6. Increment created - same result as Claude Code!
+
+Available commands AI can execute:
+- /inc "feature" - Plan new increment
+- /do - Execute implementation tasks
+- /done 0001 - Close increment
+- /validate 0001 - Quality validation
+- /progress - Check status
+- /sync-docs - Sync living documentation
+... and 11 more commands!
+
+Method 2: Copy-Paste Workflow (ChatGPT web, Claude web, etc.)
 1. Open AGENTS.md in your browser/editor
 2. Copy relevant section (e.g., "Creating a Feature Increment")
 3. Paste into AI chat (ChatGPT, Claude web, Gemini, etc.)
@@ -92,10 +111,10 @@ Method 1: Copy-Paste Workflow (ChatGPT web, Claude web, etc.)
 5. AI generates content (spec.md, plan.md, etc.)
 6. Copy AI's response, save to files
 
-Method 2: File System Access (AI with file access)
+Method 3: File System Access (AI with file access)
 1. AI automatically reads AGENTS.md
 2. Ask: "Create increment for user authentication"
-3. AI follows AGENTS.md workflow
+3. AI follows AGENTS.md workflow and command execution instructions
 4. AI creates files directly
 
 UNDERSTANDING "MANUAL":