specweave 0.6.7 → 0.6.8

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":

package/src/templates/AGENTS.md.template

@@ -205,6 +205,357 @@ cat plugins/specweave-github/commands/github-sync.md
 
 ---
 
+## 🚀 SpecWeave Commands (Executable Workflows)
+
+**⚡ CRITICAL FOR NON-CLAUDE TOOLS**: Commands are NOT automatic in GitHub Copilot, Cursor, or other tools. You MUST manually discover and execute them.
+
+### What Are Commands?
+
+Commands are **executable workflows** defined as `.md` files in `plugins/specweave/commands/`. Each file contains:
+- Command name (from filename, e.g., `inc.md` → `/inc`)
+- Complete workflow instructions
+- Parameters and usage examples
+- Step-by-step execution guide
+
+**Think of them as runnable scripts** - when user requests a command, you read the file and execute the workflow.
+
+### Command Discovery (MANDATORY!)
+
+**At the start of EVERY session**, discover available commands:
+
+```bash
+# List all core commands
+ls plugins/specweave/commands/
+
+# Common output:
+# inc.md          - Plan new increment (/inc "feature")
+# do.md           - Execute implementation (/do)
+# done.md         - Close increment (/done 0001)
+# validate.md     - Validate increment (/validate 0001)
+# progress.md     - Check status (/progress)
+# sync-docs.md    - Sync living docs (/sync-docs)
+# next.md         - Smart increment transition
+# costs.md        - Display AI cost dashboard
+# translate.md    - Translate content
+# tdd-*.md        - TDD workflow commands
+# ... (17 commands total)
+```
+
+**For plugin commands** (if plugins/ folder exists):
+
+```bash
+# List plugin commands
+ls plugins/specweave-github/commands/
+
+# Example output:
+# github-create-issue.md
+# github-sync.md
+# github-close-issue.md
+# github-status.md
+```
+
+### How to Execute Commands (Step-by-Step)
+
+**When user says**: "create new increment for user auth" or "run /inc user auth"
+
+**You should**:
+
+1. **Identify the command**:
+   - Keywords match: "create increment" → `inc.md`
+   - Explicit slash: "/inc" → `inc.md`
+   - Map request to command file
+
+2. **Read the command file**:
+   ```bash
+   cat plugins/specweave/commands/inc.md
+   ```
+
+3. **Parse the workflow**:
+   - Read YAML frontmatter for metadata
+   - Read markdown body for steps
+   - Note required parameters
+   - Understand expected output
+
+4. **Execute the workflow**:
+   - Follow instructions EXACTLY as written
+   - Use parameters from user request
+   - Reference related files (spec templates, etc.)
+   - Show progress as you work
+
+5. **Provide output**:
+   - Confirm completion
+   - Show created files
+   - Suggest next steps
+
+### Example: Executing /inc Command
+
+**User says**: "create new increment for user authentication"
+
+**Your workflow**:
+
+```bash
+# Step 1: Identify command
+# "create increment" → inc.md
+
+# Step 2: Read command file
+cat plugins/specweave/commands/inc.md
+```
+
+**After reading inc.md, you learn**:
+- This is PM-led increment planning
+- Requires: feature description
+- Creates: spec.md, plan.md, tasks.md, tests.md
+- Location: `.specweave/increments/####-feature-name/`
+
+**Step 3: Execute workflow from inc.md**:
+
+```markdown
+# You see these instructions in inc.md:
+
+1. **Detect tech stack** (TypeScript, Python, Go, etc.)
+2. **PM-led planning**:
+   - Market research
+   - Create spec.md (WHAT & WHY)
+   - Create plan.md (HOW)
+   - Auto-generate tasks.md from plan
+   - Create tests.md (test strategy)
+3. **Strategic agent review**:
+   - Architect designs system
+   - Security reviews threats
+   - QA defines test strategy
+4. **User review checkpoint**
+5. **Ready to build**
+```
+
+**Step 4: Execute those steps**:
+
+```
+📂 Creating increment 0001-user-authentication...
+
+🔍 Tech stack detected: TypeScript + Node.js + PostgreSQL
+
+👔 Adopting PM role to create spec.md...
+   ✓ Market research: Auth requirements
+   ✓ User stories: Login, Register, Password Reset
+   ✓ Acceptance criteria: TC-0001 to TC-0015
+   ✓ Created spec.md (WHAT & WHY, technology-agnostic)
+
+🏗️ Adopting Architect role to create plan.md...
+   ✓ Architecture: JWT + bcrypt + Prisma
+   ✓ API contracts: POST /auth/login, /auth/register
+   ✓ Data model: User table schema
+   ✓ Created plan.md (HOW, technology-specific)
+
+📋 Auto-generating tasks.md from plan.md...
+   ✓ Generated 42 tasks with model hints
+   ✓ Estimated: 3-4 weeks
+
+🧪 Creating tests.md (QA strategy)...
+   ✓ 12 test cases, 85% coverage target
+
+✅ Increment 0001-user-authentication ready!
+
+Next: /do 0001 (execute implementation)
+```
+
+**Step 5: Confirm completion**:
+
+```
+✅ Created increment 0001-user-authentication
+
+Files:
+  • .specweave/increments/0001-user-authentication/spec.md
+  • .specweave/increments/0001-user-authentication/plan.md
+  • .specweave/increments/0001-user-authentication/tasks.md
+  • .specweave/increments/0001-user-authentication/tests.md
+
+Next steps:
+  1. Review generated files
+  2. Run: /do 0001 (execute implementation)
+```
+
+### Core Command Reference
+
+**Most Common** (use these daily):
+
+| Command | File | Purpose | Example |
+|---------|------|---------|---------|
+| `/inc` | `inc.md` | Plan new increment | `/inc "user auth"` |
+| `/do` | `do.md` | Execute implementation | `/do 0001` |
+| `/done` | `done.md` | Close increment | `/done 0001` |
+| `/validate` | `validate.md` | Validate quality | `/validate 0001` |
+| `/progress` | `progress.md` | Check status | `/progress` |
+
+**Specialized** (use when needed):
+
+| Command | File | Purpose | Example |
+|---------|------|---------|---------|
+| `/sync-docs` | `sync-docs.md` | Sync living docs | `/sync-docs update` |
+| `/next` | `next.md` | Smart increment transition | `/next` |
+| `/costs` | `costs.md` | AI cost dashboard | `/costs 0001` |
+| `/translate` | `translate.md` | Translate content | `/translate ru` |
+| `/tdd-cycle` | `tdd-cycle.md` | TDD workflow | `/tdd-cycle` |
+
+**Plugin Commands** (when plugins installed):
+
+| Command | File | Purpose | Plugin |
+|---------|------|---------|--------|
+| `/github:sync` | `plugins/specweave-github/commands/github-sync.md` | Sync to GitHub | specweave-github |
+| `/github:create-issue` | `plugins/specweave-github/commands/github-create-issue.md` | Create GitHub issue | specweave-github |
+
+### Command Execution Pattern (Template)
+
+Use this pattern for ANY command execution:
+
+```bash
+# 1. User request
+# User: "sync to GitHub"
+
+# 2. Identify command
+# Keywords: "sync", "GitHub" → github-sync.md
+
+# 3. Read command file
+cat plugins/specweave-github/commands/github-sync.md
+
+# 4. Parse workflow
+# - Requires: increment ID, GitHub token
+# - Creates: GitHub issue
+# - Syncs: tasks, progress, labels
+
+# 5. Execute workflow
+# Follow steps in github-sync.md:
+#   - Load increment
+#   - Create/update GitHub issue
+#   - Sync task checklist
+#   - Add labels and milestone
+#   - Post comment with summary
+
+# 6. Confirm completion
+# "✅ Synced increment 0001 to GitHub issue #42"
+```
+
+### Why This Matters (Claude Code vs Other Tools)
+
+**Claude Code** (automatic):
+- Commands work via native slash syntax: `/inc "feature"`
+- No manual reading needed
+- Commands execute automatically
+
+**Other Tools** (manual):
+- ❌ No native command support
+- ✅ **Solution**: Read command .md file and execute workflow
+- Commands become "pseudo-executable" via this pattern
+- Same workflows, just manual discovery
+
+**GitHub Copilot Example**:
+
+```
+User: "create increment for payments"
+
+Copilot (you):
+1. Recognize command request: "create increment" → /inc
+2. Read: cat plugins/specweave/commands/inc.md
+3. Execute: Follow PM-led workflow from inc.md
+4. Create: spec.md, plan.md, tasks.md in .specweave/increments/0002-payments/
+5. Confirm: "✅ Increment 0002-payments created"
+
+User gets SAME result as Claude Code, just via manual execution!
+```
+
+### Command Discovery Checklist (Session Start)
+
+**MANDATORY for non-Claude tools**:
+
+```bash
+# 1. Discover core commands
+ls plugins/specweave/commands/
+# Note: 17 commands available (inc, do, done, validate, etc.)
+
+# 2. Check for plugin commands
+if [ -d "plugins/specweave-github" ]; then
+  ls plugins/specweave-github/commands/
+  # Note: 4 GitHub commands available
+fi
+
+# 3. Document available commands
+echo "Session Context:
+- Core commands: 17 available (inc, do, done, validate, ...)
+- Plugin commands: 4 GitHub commands (if plugin installed)
+- Command execution: Read .md file → Execute workflow
+"
+
+# 4. Ready to execute commands when requested
+```
+
+### Advanced: Batch Command Execution
+
+Some workflows require multiple commands:
+
+**Example**: Complete increment lifecycle
+
+```bash
+# User: "Plan, build, and close user auth feature"
+
+# Step 1: Execute /inc
+cat plugins/specweave/commands/inc.md
+# → Create spec.md, plan.md, tasks.md
+
+# Step 2: Execute /do
+cat plugins/specweave/commands/do.md
+# → Execute all 42 tasks
+
+# Step 3: Execute /validate
+cat plugins/specweave/commands/validate.md
+# → Quality checks
+
+# Step 4: Execute /done
+cat plugins/specweave/commands/done.md
+# → PM validation and closure
+```
+
+### Troubleshooting
+
+**Command file not found?**
+
+```bash
+# Check if command exists
+ls plugins/specweave/commands/ | grep inc
+# If not found, command doesn't exist
+
+# Check plugin commands
+ls plugins/specweave-*/commands/
+```
+
+**Command syntax unclear?**
+
+```bash
+# Read command README
+cat plugins/specweave/commands/README.md
+# Contains overview of all commands
+```
+
+**Command fails during execution?**
+
+- Re-read command file for missed steps
+- Check required files exist (spec.md, plan.md, etc.)
+- Verify parameters are correct
+- Check error messages for hints
+
+### Summary: Making Commands Work Without Claude Code
+
+**The Key Insight**: Commands are just markdown files with workflows!
+
+1. **Discover**: `ls plugins/specweave/commands/`
+2. **Read**: `cat plugins/specweave/commands/{command}.md`
+3. **Execute**: Follow the workflow in the file
+4. **Confirm**: Show completion and next steps
+
+**Result**: GitHub Copilot, Cursor, and other tools get the SAME SpecWeave command capabilities as Claude Code, just via manual execution instead of slash syntax.
+
+**This is CRITICAL** - without command execution, you're missing 90% of SpecWeave's automation!
+
+---
+
 ## Available Agents (Specialized Roles)
 
 SpecWeave uses role-based development. When working on tasks, adopt the appropriate role:

package/dist/adapters/copilot/adapter.d.ts

@@ -1,86 +0,0 @@
-/**
- * GitHub Copilot Adapter
- *
- * Basic automation adapter for GitHub Copilot.
- * Compiles SpecWeave plugins to AGENTS.md (universal standard) for context and suggestions.
- *
- * This adapter compiles skills, agents, and commands into AGENTS.md format.
- */
-import { AdapterBase } from '../adapter-base.js';
-import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
-import type { Plugin } from '../../core/types/plugin.js';
-export declare class CopilotAdapter extends AdapterBase {
-    name: string;
-    description: string;
-    automationLevel: "basic";
-    /**
-     * Detect if GitHub Copilot is available
-     *
-     * Note: Detection is best-effort since Copilot might be installed
-     * but we can't detect it reliably. This adapter is safe to use
-     * as a fallback since Copilot reads AGENTS.md (universal standard).
-     */
-    detect(): Promise<boolean>;
-    /**
-     * Get files to install for Copilot adapter
-     *
-     * Note: Copilot automatically reads AGENTS.md (universal standard).
-     * No additional files needed.
-     */
-    getFiles(): AdapterFile[];
-    /**
-     * Install Copilot adapter
-     */
-    install(options: AdapterOptions): Promise<void>;
-    /**
-     * Post-installation instructions
-     */
-    postInstall(options: AdapterOptions): Promise<void>;
-    /**
-     * Get usage instructions for Copilot adapter
-     */
-    getInstructions(): string;
-    /**
-     * Check if Copilot adapter supports plugins
-     *
-     * Copilot has plugin support via AGENTS.md compilation (same as Cursor)
-     *
-     * @returns boolean True for Copilot
-     */
-    supportsPlugins(): boolean;
-    /**
-     * Read language configuration from project config
-     *
-     * @returns Language setting from config, defaults to 'en'
-     */
-    private getLanguageConfig;
-    /**
-     * Inject system prompt for non-English languages
-     *
-     * Prepends language instruction to markdown content if language !== 'en'
-     *
-     * @param content Original markdown content
-     * @param language Target language
-     * @returns Modified content with system prompt (or unchanged if English)
-     */
-    private injectSystemPrompt;
-    /**
-     * Compile and install a plugin for Copilot
-     *
-     * Copilot uses AGENTS.md compilation (same as Cursor)
-     *
-     * NEW: Injects system prompts for non-English languages
-     *
-     * @param plugin Plugin to install
-     */
-    compilePlugin(plugin: Plugin): Promise<void>;
-    /**
-     * Unload a plugin from Copilot
-     */
-    unloadPlugin(pluginName: string): Promise<void>;
-    /**
-     * Get list of installed plugins for Copilot
-     */
-    getInstalledPlugins(): Promise<string[]>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/copilot/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/copilot/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAKzD,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAA8D;IACzE,eAAe,EAAG,OAAO,CAAU;IAEnC;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAMhC;;;;;OAKG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwErD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;IAuHzB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;OAIG;YACW,iBAAiB;IAiB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;;;;;;;OAQG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsElD;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCrD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAmB/C"}