specweave 0.4.1 → 0.6.0

package/src/adapters/copilot/adapter.ts

@@ -2,9 +2,9 @@
  * GitHub Copilot Adapter
  *
  * Basic automation adapter for GitHub Copilot.
- * Copilot automatically reads AGENTS.md (universal standard) for context and suggestions.
+ * Compiles SpecWeave plugins to AGENTS.md (universal standard) for context and suggestions.
  *
- * This adapter requires no additional files - Copilot reads AGENTS.md automatically.
+ * This adapter compiles skills, agents, and commands into AGENTS.md format.
  */
 
 import * as path from 'path';
@@ -12,6 +12,9 @@ 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';
+import { compileToAgentsMd, getSpecweaveInstallPath } from '../../utils/agents-md-compiler.js';
+import { LanguageManager, getSystemPromptForLanguage } from '../../core/i18n/language-manager.js';
+import type { SupportedLanguage } from '../../core/i18n/types.js';
 
 export class CopilotAdapter extends AdapterBase {
   name = 'copilot';
@@ -47,8 +50,73 @@ export class CopilotAdapter extends AdapterBase {
   async install(options: AdapterOptions): Promise<void> {
     console.log('\n📦 Configuring GitHub Copilot (Basic Automation)\n');
 
-    // No files to install - Copilot reads AGENTS.md automatically
-    console.log('✅ Copilot will automatically read AGENTS.md');
+    // 1. Create .specweave/ structure
+    const specweaveDir = path.join(options.projectPath, '.specweave');
+    await fs.ensureDir(specweaveDir);
+    await fs.ensureDir(path.join(specweaveDir, 'increments'));
+    await fs.ensureDir(path.join(specweaveDir, 'increments', '_backlog'));
+    await fs.ensureDir(path.join(specweaveDir, 'docs', 'internal', 'strategy'));
+    await fs.ensureDir(path.join(specweaveDir, 'docs', 'internal', 'architecture', 'adr'));
+    await fs.ensureDir(path.join(specweaveDir, 'docs', 'internal', 'architecture', 'rfc'));
+    await fs.ensureDir(path.join(specweaveDir, 'docs', 'internal', 'architecture', 'diagrams'));
+    await fs.ensureDir(path.join(specweaveDir, 'docs', 'internal', 'delivery'));
+    await fs.ensureDir(path.join(specweaveDir, 'docs', 'public', 'guides'));
+    await fs.ensureDir(path.join(specweaveDir, 'logs'));
+
+    console.log('✅ Created .specweave/ structure');
+
+    // 2. Find SpecWeave installation
+    let specweavePath: string;
+    try {
+      specweavePath = getSpecweaveInstallPath();
+      console.log(`✅ Found SpecWeave installation at: ${specweavePath}`);
+    } catch (error) {
+      console.error('❌ Could not find SpecWeave installation');
+      console.error('   Make sure SpecWeave is installed: npm install -g specweave');
+      return;
+    }
+
+    // 3. Compile plugins to AGENTS.md
+    console.log('📝 Compiling plugins to AGENTS.md...');
+    const result = await compileToAgentsMd(specweavePath);
+
+    // 4. Write AGENTS.md
+    const agentsMdPath = path.join(options.projectPath, 'AGENTS.md');
+    await fs.writeFile(agentsMdPath, result.agentsMd, 'utf-8');
+
+    console.log('✅ Created AGENTS.md with:');
+    console.log(`   - ${result.skills.length} skills`);
+    console.log(`   - ${result.agents.length} agents`);
+    console.log(`   - ${result.commands.length} commands`);
+
+    // 5. Create .github/copilot/instructions.md (optional)
+    const copilotDir = path.join(options.projectPath, '.github', 'copilot');
+    await fs.ensureDir(copilotDir);
+
+    const instructionsContent = `# GitHub Copilot Instructions
+
+This project uses SpecWeave for spec-driven development.
+
+## Important Context
+
+- **AGENTS.md**: Complete workflow guide (read this first!)
+- **Structure**: All work happens in \`.specweave/increments/\`
+- **Workflow**: spec.md → plan.md → tasks.md → tests.md
+
+## When Suggesting Code
+
+- Follow patterns in AGENTS.md
+- Create files in increment folders, not project root
+- Reference existing specs and plans
+- Follow naming conventions (kebab-case for increments)
+
+See AGENTS.md for complete details.
+`;
+
+    await fs.writeFile(path.join(copilotDir, 'instructions.md'), instructionsContent, 'utf-8');
+    console.log('✅ Created .github/copilot/instructions.md');
+
+    console.log('\n✅ Copilot will automatically read AGENTS.md');
   }
 
   /**
@@ -191,11 +259,56 @@ Copilot is best for simple projects or when already using VS Code + Copilot.
     return true;
   }
 
+  /**
+   * Read language configuration from project config
+   *
+   * @returns Language setting from config, defaults to 'en'
+   */
+  private async getLanguageConfig(): Promise<SupportedLanguage> {
+    const projectPath = process.cwd();
+    const configPath = path.join(projectPath, '.specweave', 'config.json');
+
+    if (!(await fs.pathExists(configPath))) {
+      return 'en'; // Default to English if no config
+    }
+
+    try {
+      const config = await fs.readJson(configPath);
+      return (config.language as SupportedLanguage) || 'en';
+    } catch (error) {
+      console.warn('⚠️  Could not read language from config, defaulting to English');
+      return 'en';
+    }
+  }
+
+  /**
+   * 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(content: string, language: SupportedLanguage): string {
+    if (language === 'en') {
+      return content; // No changes for English - preserve default behavior
+    }
+
+    // Get system prompt for target language
+    const systemPrompt = getSystemPromptForLanguage(language);
+
+    // For AGENTS.md compilation, inject at the beginning of the content
+    return `${systemPrompt}\n\n${content}`;
+  }
+
   /**
    * 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
    */
   async compilePlugin(plugin: Plugin): Promise<void> {
@@ -204,6 +317,12 @@ Copilot is best for simple projects or when already using VS Code + Copilot.
 
     console.log(`\n📦 Compiling plugin for Copilot: ${plugin.manifest.name}`);
 
+    // Get language configuration for system prompt injection
+    const language = await this.getLanguageConfig();
+    if (language !== 'en') {
+      console.log(`   🌐 Language: ${language} (system prompts will be injected)`);
+    }
+
     if (!(await fs.pathExists(agentsMdPath))) {
       throw new Error('AGENTS.md not found. Run specweave init first.');
     }
@@ -225,7 +344,9 @@ Copilot is best for simple projects or when already using VS Code + Copilot.
       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`;
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
+        pluginSection += `### ${skill.name}\n\n${modifiedContent}\n\n`;
       }
     }
 
@@ -233,7 +354,9 @@ Copilot is best for simple projects or when already using VS Code + Copilot.
       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`;
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(agentContent, language);
+        pluginSection += `### ${agent.name}\n\n${modifiedContent}\n\n`;
       }
     }
 
@@ -242,7 +365,9 @@ Copilot is best for simple projects or when already using VS Code + Copilot.
       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`;
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
+        pluginSection += `### /${command.name}\n\n${modifiedContent}\n\n`;
       }
     }
 

package/src/adapters/cursor/adapter.ts

@@ -13,6 +13,8 @@ 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';
+import { LanguageManager, getSystemPromptForLanguage } from '../../core/i18n/language-manager.js';
+import type { SupportedLanguage } from '../../core/i18n/types.js';
 
 export class CursorAdapter extends AdapterBase {
   name = 'cursor';
@@ -232,6 +234,49 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
     return true;
   }
 
+  /**
+   * Read language configuration from project config
+   *
+   * @returns Language setting from config, defaults to 'en'
+   */
+  private async getLanguageConfig(): Promise<SupportedLanguage> {
+    const projectPath = process.cwd();
+    const configPath = path.join(projectPath, '.specweave', 'config.json');
+
+    if (!(await fs.pathExists(configPath))) {
+      return 'en'; // Default to English if no config
+    }
+
+    try {
+      const config = await fs.readJson(configPath);
+      return (config.language as SupportedLanguage) || 'en';
+    } catch (error) {
+      console.warn('⚠️  Could not read language from config, defaulting to English');
+      return 'en';
+    }
+  }
+
+  /**
+   * 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(content: string, language: SupportedLanguage): string {
+    if (language === 'en') {
+      return content; // No changes for English - preserve default behavior
+    }
+
+    // Get system prompt for target language
+    const systemPrompt = getSystemPromptForLanguage(language);
+
+    // For AGENTS.md compilation, inject at the beginning of the content
+    return `${systemPrompt}\n\n${content}`;
+  }
+
   /**
    * Compile and install a plugin for Cursor
    *
@@ -240,6 +285,8 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
    * - Append agents to AGENTS.md
    * - Append commands to team commands JSON
    *
+   * NEW: Injects system prompts for non-English languages
+   *
    * @param plugin Plugin to install
    */
   async compilePlugin(plugin: Plugin): Promise<void> {
@@ -248,6 +295,12 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
 
     console.log(`\n📦 Compiling plugin for Cursor: ${plugin.manifest.name}`);
 
+    // Get language configuration for system prompt injection
+    const language = await this.getLanguageConfig();
+    if (language !== 'en') {
+      console.log(`   🌐 Language: ${language} (system prompts will be injected)`);
+    }
+
     // Ensure AGENTS.md exists
     if (!(await fs.pathExists(agentsMdPath))) {
       throw new Error('AGENTS.md not found. Run specweave init first.');
@@ -275,8 +328,10 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
         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/, '');
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
         pluginSection += `### ${skill.name}\n\n`;
-        pluginSection += `${contentWithoutFrontmatter}\n\n`;
+        pluginSection += `${modifiedContent}\n\n`;
       }
     }
 
@@ -285,8 +340,10 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
       pluginSection += `## Agents\n\n`;
       for (const agent of plugin.agents) {
         const agentContent = await fs.readFile(path.join(agent.path, 'AGENT.md'), 'utf-8');
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(agentContent, language);
         pluginSection += `### ${agent.name}\n\n`;
-        pluginSection += `${agentContent}\n\n`;
+        pluginSection += `${modifiedContent}\n\n`;
       }
     }
 
@@ -297,8 +354,10 @@ Pro tip: Say "act as [role]" to follow AGENTS.md patterns:
         const commandContent = await fs.readFile(command.path, 'utf-8');
         // Remove frontmatter
         const contentWithoutFrontmatter = commandContent.replace(/^---\n[\s\S]+?\n---\n/, '');
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
         pluginSection += `### /${command.name}\n\n`;
-        pluginSection += `${contentWithoutFrontmatter}\n\n`;
+        pluginSection += `${modifiedContent}\n\n`;
       }
     }
 

package/src/adapters/generic/adapter.ts

@@ -13,6 +13,8 @@ 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';
+import { LanguageManager, getSystemPromptForLanguage } from '../../core/i18n/language-manager.js';
+import type { SupportedLanguage } from '../../core/i18n/types.js';
 
 export class GenericAdapter extends AdapterBase {
   name = 'generic';
@@ -173,11 +175,56 @@ Remember: AGENTS.md is the universal standard - it works everywhere!
     return true;
   }
 
+  /**
+   * Read language configuration from project config
+   *
+   * @returns Language setting from config, defaults to 'en'
+   */
+  private async getLanguageConfig(): Promise<SupportedLanguage> {
+    const projectPath = process.cwd();
+    const configPath = path.join(projectPath, '.specweave', 'config.json');
+
+    if (!(await fs.pathExists(configPath))) {
+      return 'en'; // Default to English if no config
+    }
+
+    try {
+      const config = await fs.readJson(configPath);
+      return (config.language as SupportedLanguage) || 'en';
+    } catch (error) {
+      console.warn('⚠️  Could not read language from config, defaulting to English');
+      return 'en';
+    }
+  }
+
+  /**
+   * 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(content: string, language: SupportedLanguage): string {
+    if (language === 'en') {
+      return content; // No changes for English - preserve default behavior
+    }
+
+    // Get system prompt for target language
+    const systemPrompt = getSystemPromptForLanguage(language);
+
+    // For AGENTS.md compilation, inject at the beginning of the content
+    return `${systemPrompt}\n\n${content}`;
+  }
+
   /**
    * Compile and install a plugin for Generic adapter
    *
    * Appends plugin content to AGENTS.md for manual copy-paste workflows
    *
+   * NEW: Injects system prompts for non-English languages
+   *
    * @param plugin Plugin to install
    */
   async compilePlugin(plugin: Plugin): Promise<void> {
@@ -186,6 +233,12 @@ Remember: AGENTS.md is the universal standard - it works everywhere!
 
     console.log(`\n📦 Adding plugin to AGENTS.md: ${plugin.manifest.name}`);
 
+    // Get language configuration for system prompt injection
+    const language = await this.getLanguageConfig();
+    if (language !== 'en') {
+      console.log(`   🌐 Language: ${language} (system prompts will be injected)`);
+    }
+
     if (!(await fs.pathExists(agentsMdPath))) {
       throw new Error('AGENTS.md not found. Run specweave init first.');
     }
@@ -207,7 +260,9 @@ Remember: AGENTS.md is the universal standard - it works everywhere!
       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`;
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
+        pluginSection += `### ${skill.name}\n\n${modifiedContent}\n\n`;
       }
     }
 
@@ -215,7 +270,9 @@ Remember: AGENTS.md is the universal standard - it works everywhere!
       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`;
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(agentContent, language);
+        pluginSection += `### ${agent.name}\n\n${modifiedContent}\n\n`;
       }
     }
 
@@ -224,7 +281,9 @@ Remember: AGENTS.md is the universal standard - it works everywhere!
       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`;
+        // Inject system prompt if needed
+        const modifiedContent = this.injectSystemPrompt(contentWithoutFrontmatter, language);
+        pluginSection += `### ${command.name.replace('specweave.', '')}\n\n${modifiedContent}\n\n`;
       }
     }
 

package/src/templates/AGENTS.md.template

@@ -45,12 +45,166 @@ This is a **SpecWeave project** where specifications and documentation are the s
 ├── agents/                  # Specialized roles (PM, Architect, DevOps, etc.)
 ├── skills/                  # Capabilities (increment-planner, context-loader, etc.)
 └── commands/                # Slash commands (/inc, /do, /done)
+
+plugins/                     # Optional plugins (extended capabilities)
+└── specweave-{name}/
+    ├── .claude-plugin/      # Plugin manifest (Claude native format)
+    │   └── plugin.json
+    ├── skills/              # Plugin-specific skills
+    ├── agents/              # Plugin-specific agents
+    └── commands/            # Plugin-specific commands
 ```
 
 **CRITICAL**: Always read `context-manifest.yaml` first! Only load files listed there.
 
 ---
 
+## 🔌 Plugin Architecture (IMPORTANT FOR NON-CLAUDE TOOLS)
+
+### For Claude Code Users
+
+Plugins work automatically via marketplace:
+```bash
+/plugin install github@specweave
+```
+
+Skills, agents, and commands are immediately available. **Skip this section if using Claude Code.**
+
+### For Other Tools (Cursor, Copilot, ChatGPT, etc.)
+
+**⚠️ CRITICAL**: Claude Code has native plugin support. **Other tools DO NOT.**
+
+You MUST manually discover and load plugins at the start of each session:
+
+#### Step 1: Check for Plugins
+
+```bash
+# Check if project uses plugins
+ls plugins/
+
+# Example output:
+# specweave-github/
+# specweave-jira/
+```
+
+If `plugins/` folder exists, proceed to Step 2.
+
+#### Step 2: Load Plugin Components
+
+**For EACH plugin, load its components BEFORE starting work:**
+
+```bash
+# Example: Loading GitHub plugin
+
+# 1. Check plugin structure
+ls plugins/specweave-github/
+
+# 2. Load ALL plugin skills (like core skills)
+cat plugins/specweave-github/skills/github-sync/SKILL.md
+cat plugins/specweave-github/skills/github-issue-tracker/SKILL.md
+
+# 3. Load plugin agents (if any)
+cat plugins/specweave-github/agents/github-manager/AGENT.md
+
+# 4. Note available commands (load on-demand when user requests)
+ls plugins/specweave-github/commands/
+# github-create-issue.md, github-sync.md, github-status.md
+```
+
+#### Step 3: Make Plugin Capabilities Available
+
+Treat plugin components like core components:
+
+**Plugin Skills**:
+- Same activation pattern as core skills
+- Check "Activates for" keywords in SKILL.md
+- Follow workflow when relevant
+
+**Plugin Agents**:
+- Adopt role when needed (like core agents)
+- Example: "Adopting github-manager agent role..."
+
+**Plugin Commands**:
+- Load command file when user requests action
+- Example: User says "sync to GitHub" → Load `plugins/specweave-github/commands/github-sync.md`
+
+#### Step 4: Document Loaded Plugins
+
+At session start, note which plugins are active:
+
+```markdown
+# Session Context
+- Core skills: ✅ Loaded from .claude/skills/
+- Core agents: ✅ Loaded from .claude/agents/
+- Plugins detected:
+  - specweave-github: ✅ Loaded (2 skills, 1 agent, 4 commands)
+  - specweave-jira: ✅ Loaded (1 skill, 1 agent, 2 commands)
+```
+
+### Why Manual Loading Is Required
+
+**Claude Code**: Has native plugin marketplace, auto-loads plugins, manages dependencies.
+
+**Other Tools**: No plugin system, so you must:
+- ✅ Discover plugins in `plugins/` folder
+- ✅ Read plugin skills/agents/commands manually
+- ✅ Make them available in your context
+- ✅ Use them like core components
+
+**This is NOT optional** - plugins extend SpecWeave capabilities. Without loading them, you're missing critical functionality (GitHub sync, Jira integration, tech-specific skills, etc.).
+
+### Example: Session Start Routine (Non-Claude Tools)
+
+```bash
+# 1. Load core components
+cat .claude/skills/SKILLS-INDEX.md  # Core skills index
+cat AGENTS.md                        # This file
+
+# 2. Check for plugins
+if [ -d "plugins" ]; then
+  # 3. For each plugin, load components
+  for plugin in plugins/*/; do
+    echo "Loading plugin: $(basename $plugin)"
+
+    # Load all skills
+    find "$plugin/skills" -name "SKILL.md" -exec cat {} \;
+
+    # Load all agents
+    find "$plugin/agents" -name "AGENT.md" -exec cat {} \;
+
+    # Note available commands
+    ls "$plugin/commands/"
+  done
+fi
+
+# 4. Now ready to work with full SpecWeave capabilities
+```
+
+### Plugin Naming Convention
+
+Plugin commands use namespace pattern:
+
+**Core commands** (no namespace):
+- `/specweave:inc` → Core framework
+- `/specweave:do` → Core framework
+- `/specweave:progress` → Core framework
+
+**Plugin commands** (with namespace):
+- `/specweave:github:sync` → GitHub plugin
+- `/specweave:github:create-issue` → GitHub plugin
+- `/specweave:jira:sync` → Jira plugin
+- `/specweave:jira:create-ticket` → Jira plugin
+
+**In non-Claude tools**: Read the command file when user requests the action:
+```bash
+# User: "Sync this increment to GitHub"
+# You: Load and execute command
+cat plugins/specweave-github/commands/github-sync.md
+# Then follow the instructions in that file
+```
+
+---
+
 ## Available Agents (Specialized Roles)
 
 SpecWeave uses role-based development. When working on tasks, adopt the appropriate role:
@@ -319,6 +473,7 @@ max_context_tokens: 10000
 
 If using Claude Code, these slash commands are available:
 
+**Core Commands** (always available):
 | Command | Purpose | Example |
 |---------|---------|---------|
 | `/inc` | Create new increment | `/inc "user authentication"` |
@@ -326,7 +481,21 @@ If using Claude Code, these slash commands are available:
 | `/progress` | Check status | `/progress` |
 | `/done` | Close increment | `/done 0001` |
 | `/validate` | Validate quality | `/validate 0001 --quality` |
-| `/sync-github` | Sync to GitHub | `/sync-github` |
+
+**Plugin Commands** (when plugin installed):
+| Command | Purpose | Plugin |
+|---------|---------|--------|
+| `/specweave:github:sync` | Sync to GitHub | specweave-github |
+| `/specweave:github:create-issue` | Create GitHub issue | specweave-github |
+| `/specweave:jira:sync` | Sync to Jira | specweave-jira |
+| `/specweave:jira:create-ticket` | Create Jira ticket | specweave-jira |
+
+**For non-Claude tools**: Read the command file when user requests the action:
+```bash
+# User: "Sync to GitHub"
+cat plugins/specweave-github/commands/github-sync.md
+# Then follow instructions in that file
+```
 
 ---