specweave 0.1.9 → 0.3.1

package/dist/adapters/gemini/adapter.js

@@ -0,0 +1,281 @@
+/**
+ * Gemini CLI Adapter
+ *
+ * Semi-automation adapter for Google Gemini CLI.
+ * Uses universal AGENTS.md file for instructions.
+ *
+ * Gemini CLI features:
+ * - Open-source AI agent (Apache 2.0)
+ * - 1M token context window
+ * - ReAct loop with built-in tools
+ * - MCP (Model Context Protocol) support
+ * - Agent mode for multi-file tasks
+ */
+import * as path from 'path';
+import fs from 'fs-extra';
+import { AdapterBase } from '../adapter-base.js';
+import { AgentsMdGenerator } from '../agents-md-generator.js';
+import { getDirname } from '../../utils/esm-helpers.js';
+const __dirname = getDirname(import.meta.url);
+export class GeminiAdapter extends AdapterBase {
+    constructor() {
+        super(...arguments);
+        this.name = 'gemini';
+        this.description = 'Gemini CLI adapter - Semi-automation with AGENTS.md and agent mode';
+        this.automationLevel = 'semi';
+    }
+    /**
+     * Detect if Gemini CLI is available
+     *
+     * Checks for:
+     * - gemini command in PATH
+     * - .gemini/ directory exists
+     * - AGENTS.md file exists (previously configured)
+     */
+    async detect() {
+        const hasGeminiCLI = await this.commandExists('gemini');
+        const hasGeminiDir = await this.fileExists('.gemini');
+        const hasAgentsMd = await this.fileExists('AGENTS.md');
+        return hasGeminiCLI || hasGeminiDir || hasAgentsMd;
+    }
+    /**
+     * Get files to install for Gemini adapter
+     */
+    getFiles() {
+        return [
+            {
+                sourcePath: 'AGENTS.md',
+                targetPath: 'AGENTS.md',
+                description: 'Universal SpecWeave instructions (works with all AI tools)'
+            },
+            {
+                sourcePath: 'README.md',
+                targetPath: '.gemini/README.md',
+                description: 'Gemini adapter documentation'
+            }
+        ];
+    }
+    /**
+     * Install Gemini adapter
+     */
+    async install(options) {
+        console.log('\n📦 Installing Gemini CLI Adapter (Semi-Automation)\n');
+        // Ensure .gemini directory exists
+        const geminiDir = path.join(options.projectPath, '.gemini');
+        await fs.ensureDir(geminiDir);
+        // Generate AGENTS.md
+        const agentsMdPath = path.join(options.projectPath, 'AGENTS.md');
+        await this.generateAgentsMd(agentsMdPath, options);
+        // Copy README
+        const readmePath = path.join(__dirname, 'README.md');
+        if (await fs.pathExists(readmePath)) {
+            await fs.copy(readmePath, path.join(geminiDir, 'README.md'));
+        }
+        console.log('\n✨ Gemini adapter installed!');
+        console.log('\n📋 Files created:');
+        console.log('   - AGENTS.md (universal instructions)');
+        console.log('   - .gemini/README.md (adapter documentation)');
+    }
+    /**
+     * Generate AGENTS.md file
+     */
+    async generateAgentsMd(targetPath, options) {
+        const generator = new AgentsMdGenerator(path.join(__dirname, '../../skills'), path.join(__dirname, '../../agents'), path.join(__dirname, '../../commands'));
+        const content = await generator.generate({
+            projectName: options.projectName,
+            projectPath: options.projectPath
+        });
+        await fs.writeFile(targetPath, content);
+        console.log('  ✅ AGENTS.md - Universal SpecWeave instructions');
+    }
+    /**
+     * Post-installation instructions
+     */
+    async postInstall(options) {
+        console.log(this.getInstructions());
+    }
+    /**
+     * Get usage instructions for Gemini adapter
+     */
+    getInstructions() {
+        return `
+================================================================
+      Gemini CLI Adapter - Semi-Automation
+================================================================
+
+Your project is now configured for Gemini CLI with SEMI-automation!
+
+WHAT THIS PROVIDES:
+
+- AGENTS.md (Universal Instructions)
+  - Works with Gemini CLI AND other tools
+  - Auto-generated from actual skills/agents
+  - SpecWeave structure and workflows
+  - 1M token context window support
+
+- Agent Mode Integration
+  - Multi-file task handling
+  - ReAct loop with built-in tools
+  - MCP support for extensibility
+
+QUICK START:
+
+1. Install Gemini CLI (if not already installed):
+
+   npm install -g @google-cloud/gemini-cli
+
+2. Authenticate:
+
+   gemini auth
+
+3. Create your first feature:
+
+   gemini "Read AGENTS.md and create increment for user authentication"
+
+   Gemini will:
+   - Read AGENTS.md for SpecWeave context
+   - Adopt PM role: Create spec.md (WHAT/WHY)
+   - Adopt Architect role: Create plan.md (HOW)
+   - Create tasks.md
+   - Use agent mode for multi-file operations
+
+4. Continue development:
+
+   gemini "Implement task T001 from increment 0001"
+   gemini "Run tests for increment 0001"
+   gemini "Review and fix any issues"
+
+HOW TO USE:
+
+Gemini CLI reads AGENTS.md automatically when you reference it:
+
+\`\`\`bash
+# Explicit reference (recommended):
+gemini "Read AGENTS.md and [your request]"
+
+# Natural language:
+gemini "Create a new feature following SpecWeave structure"
+
+# With context:
+gemini "Following the PM role in AGENTS.md, create requirements for payments"
+\`\`\`
+
+CONTEXT LOADING (70%+ Token Savings):
+
+CRITICAL: Tell Gemini to read context-manifest.yaml first!
+
+\`\`\`bash
+gemini "Read context-manifest.yaml from increment 0001, load only those files, then implement task T001"
+\`\`\`
+
+**Why this matters**:
+- Gemini has 1M token context window
+- But loading everything wastes tokens
+- Context manifests = precise, efficient loading
+
+FEATURES:
+
+✅ 1M Token Context Window
+   - Can handle large specifications
+   - Read entire codebase if needed
+
+✅ Agent Mode
+   - Multi-file task completion
+   - Automatic planning and execution
+   - Interactive approval before changes
+
+✅ Built-in Tools
+   - File operations
+   - Shell commands
+   - Google Search grounding
+   - Web fetching
+
+✅ MCP Support
+   - Extend with custom integrations
+   - Local or remote MCP servers
+
+✅ Free Tier
+   - Gemini 2.5 Pro included
+   - 60 requests/minute
+   - 1,000 requests/day
+
+EXAMPLE WORKFLOWS:
+
+1. **Create Feature**:
+   \`\`\`bash
+   gemini "Read AGENTS.md. Create increment 0002 for payment processing with Stripe. Follow SpecWeave structure: spec.md (PM role), plan.md (Architect role), tasks.md"
+   \`\`\`
+
+2. **Implement Task**:
+   \`\`\`bash
+   gemini "Read increment 0002, implement task T001 (Setup Stripe SDK)"
+   \`\`\`
+
+3. **Fix Bug**:
+   \`\`\`bash
+   gemini "Read AGENTS.md and increment 0001. Fix authentication bug in login endpoint. Update tests."
+   \`\`\`
+
+4. **Review Code**:
+   \`\`\`bash
+   gemini "Adopt Tech Lead role from AGENTS.md. Review code in src/auth/ and provide feedback"
+   \`\`\`
+
+TIPS & TRICKS:
+
+1. **Always Reference AGENTS.md**
+   - Ensures Gemini understands SpecWeave structure
+   - Provides role definitions (PM, Architect, etc.)
+
+2. **Use Agent Mode**
+   - For complex, multi-file tasks
+   - Gemini proposes plan before execution
+   - You approve changes
+
+3. **Leverage 1M Context Window**
+   - Can load large specs
+   - But still use context manifests for efficiency
+
+4. **MCP Integration**
+   - Connect to your tools (JIRA, GitHub, etc.)
+   - See: https://modelcontextprotocol.io/
+
+5. **Check Gemini Documentation**
+   - \`gemini --help\`
+   - https://developers.google.com/gemini-code-assist/docs/gemini-cli
+
+COMPARISON:
+
+| Feature | Claude Code | Gemini CLI |
+|---------|-------------|------------|
+| **Automation** | Full | Semi |
+| **Skills** | Native | Via AGENTS.md |
+| **Agents** | Native | Via AGENTS.md |
+| **Context Window** | 200k | 1M (5x larger!) |
+| **Cost** | Paid | Free tier available |
+| **Open Source** | No | Yes (Apache 2.0) |
+
+LIMITATIONS:
+
+- No native skills/agents (manual role adoption via AGENTS.md)
+- No hooks (can't auto-update docs on events)
+- Requires explicit instruction referencing
+- CLI-only (no IDE integration yet)
+
+But still VERY powerful with 1M context and agent mode!
+
+DOCUMENTATION:
+
+- AGENTS.md: Universal SpecWeave instructions (READ THIS!)
+- SPECWEAVE.md: Complete framework documentation
+- .gemini/README.md: Gemini adapter guide
+- https://developers.google.com/gemini-code-assist/docs/gemini-cli
+
+You're ready to build with SpecWeave on Gemini CLI!
+
+Pro tip: Leverage the 1M token context window for large specifications,
+but always use context manifests for efficiency!
+    `;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/gemini/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/gemini/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE9C,MAAM,OAAO,aAAc,SAAQ,WAAW;IAA9C;;QACE,SAAI,GAAG,QAAQ,CAAC;QAChB,gBAAW,GAAG,oEAAoE,CAAC;QACnF,oBAAe,GAAG,MAAe,CAAC;IA+QpC,CAAC;IA7QC;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAEvD,OAAO,YAAY,IAAI,YAAY,IAAI,WAAW,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,WAAW;gBACvB,WAAW,EAAE,4DAA4D;aAC1E;YACD;gBACE,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,mBAAmB;gBAC/B,WAAW,EAAE,8BAA8B;aAC5C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QAEtE,kCAAkC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAE9B,qBAAqB;QACrB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACjE,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEnD,cAAc;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACrD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACpC,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,UAAkB,EAAE,OAAuB;QACxE,MAAM,SAAS,GAAG,IAAI,iBAAiB,CACrC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,CACvC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;YACvC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QAEH,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAuB;QACvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiLN,CAAC;IACJ,CAAC;CACF"}

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

@@ -1,14 +1,14 @@
 /**
  * Generic Adapter
  *
- * Manual workflow adapter that works with ANY AI tool.
- * Provides step-by-step instructions for using SpecWeave without tool-specific features.
+ * 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.
  */
-import { AdapterBase } from '../adapter-base';
-import { AdapterOptions, AdapterFile } from '../adapter-interface';
+import { AdapterBase } from '../adapter-base.js';
+import { AdapterOptions, AdapterFile } from '../adapter-interface.js';
 export declare class GenericAdapter extends AdapterBase {
     name: string;
     description: string;
@@ -22,6 +22,9 @@ export declare class GenericAdapter extends AdapterBase {
     detect(): Promise<boolean>;
     /**
      * Get files to install for Generic adapter
+     *
+     * Note: Any AI tool can read AGENTS.md (universal standard).
+     * No additional files needed.
      */
     getFiles(): AdapterFile[];
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/generic/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnE,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAA+E;IAC1F,eAAe,EAAG,QAAQ,CAAU;IAEpC;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKhC;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAezB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAqF1B"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/generic/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtE,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,SAAa;IACjB,WAAW,SAAgF;IAC3F,eAAe,EAAG,QAAQ,CAAU;IAEpC;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKhC;;;;;OAKG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;OAEG;IACH,eAAe,IAAI,MAAM;CAqG1B"}

package/dist/adapters/generic/adapter.js

@@ -1,21 +1,18 @@
-"use strict";
 /**
  * Generic Adapter
  *
- * Manual workflow adapter that works with ANY AI tool.
- * Provides step-by-step instructions for using SpecWeave without tool-specific features.
+ * 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.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenericAdapter = void 0;
-const adapter_base_1 = require("../adapter-base");
-class GenericAdapter extends adapter_base_1.AdapterBase {
+import { AdapterBase } from '../adapter-base.js';
+export class GenericAdapter extends AdapterBase {
     constructor() {
         super(...arguments);
         this.name = 'generic';
-        this.description = 'Generic adapter - Manual workflow for ANY AI tool (ChatGPT, Gemini, etc.)';
+        this.description = 'Generic adapter - AGENTS.md works with ANY AI tool (ChatGPT, Gemini, etc.)';
         this.automationLevel = 'manual';
     }
     /**
@@ -30,31 +27,20 @@ class GenericAdapter extends adapter_base_1.AdapterBase {
     }
     /**
      * Get files to install for Generic adapter
+     *
+     * Note: Any AI tool can read AGENTS.md (universal standard).
+     * No additional files needed.
      */
     getFiles() {
-        return [
-            {
-                sourcePath: 'SPECWEAVE-MANUAL.md',
-                targetPath: 'SPECWEAVE-MANUAL.md',
-                description: 'Complete manual workflow guide for ANY AI tool'
-            },
-            {
-                sourcePath: 'README.md',
-                targetPath: '.specweave/adapters/generic/README.md',
-                description: 'Generic adapter documentation'
-            }
-        ];
+        return [];
     }
     /**
      * Install Generic adapter
      */
     async install(options) {
-        console.log('\n📦 Installing Generic Adapter (Manual Workflow)\n');
-        // Generic adapter is simple - just copy manual guide
-        await super.install(options);
-        console.log('\n✨ Generic adapter installed!');
-        console.log('\n📋 Files created:');
-        console.log('   - SPECWEAVE-MANUAL.md (complete manual workflow guide)');
+        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.)');
     }
     /**
      * Post-installation instructions
@@ -68,35 +54,49 @@ class GenericAdapter extends adapter_base_1.AdapterBase {
     getInstructions() {
         return `
 ================================================================
-        Generic Adapter - Manual Workflow
+        Generic Adapter - Universal Compatibility
 ================================================================
 
 Your project is now configured for ANY AI tool!
 
 WHAT THIS PROVIDES:
 
-- SPECWEAVE-MANUAL.md (Complete Manual Guide)
-  - Step-by-step instructions for creating increments
-  - Templates you can copy-paste to any AI
-  - Workflow guidance (no tool dependencies)
-  - Works with LITERALLY any AI
+- AGENTS.md (Universal Standard)
+  - Any AI tool can read this file
+  - Contains all workflow instructions
+  - Project structure and templates
+  - Following agents.md standard (https://agents.md/)
 
 - 100% Compatibility
   - ChatGPT (web), Claude (web), Gemini
-  - Any AI that can read text
+  - Any AI that can read markdown
+
+HOW TO USE AGENTS.MD WITH ANY AI:
+
+Method 1: 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.)
+4. Ask AI to follow the instructions
+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)
+1. AI automatically reads AGENTS.md
+2. Ask: "Create increment for user authentication"
+3. AI follows AGENTS.md workflow
+4. AI creates files directly
 
 UNDERSTANDING "MANUAL":
 
 Manual = You Orchestrate, AI Executes
 
 Example workflow:
-1. You read SPECWEAVE-MANUAL.md (Step 1: Create Folder)
-2. You run: mkdir -p .specweave/increments/0001-auth
-3. You read Step 2: Create spec.md
-4. You copy template from manual, paste to AI (ChatGPT)
-5. AI generates spec.md content
-6. You copy AI's response, save to spec.md file
-7. Repeat for plan.md, tasks.md, etc.
+1. Read AGENTS.md section "Creating a Feature Increment"
+2. Copy instructions to ChatGPT
+3. ChatGPT generates spec.md content
+4. Save content to .specweave/increments/0001-auth/spec.md
+5. Repeat for plan.md, tasks.md
 
 Manual does not mean harder - just means YOU control each step (no automation).
 Benefit: Works with ANY AI tool!
@@ -104,13 +104,13 @@ Benefit: Works with ANY AI tool!
 COMPARISON:
 
 Claude Code (Full): "create increment" -> Done in 30 seconds (auto)
-Cursor (Semi): "create increment" -> Done in 5 minutes (.cursorrules)
-Copilot (Basic): Create files manually, Copilot suggests content
-Generic (Manual): Follow SPECWEAVE-MANUAL.md step-by-step (30-60 min)
+Cursor (Semi): "create increment" -> Done in 5 minutes (reads AGENTS.md)
+Copilot (Basic): Reads AGENTS.md, suggests content as you type
+Generic (Manual): Copy AGENTS.md instructions to any AI (10-30 min)
 
 Trade-off: Speed vs Compatibility
-- Claude Code: Fast, but only works with Claude Code
-- Generic: Slower, but works with EVERY AI tool!
+- Claude Code: Fast, but requires Claude Code CLI
+- Generic: Slower, but works with EVERY AI tool (even web-based)!
 
 WHEN TO USE:
 
@@ -121,35 +121,36 @@ Use Generic adapter if:
 - Simple projects where automation isn't critical
 
 Consider alternatives if:
-- You want automation -> Use Claude Code (full) or Cursor (semi)
-- You have file system access -> Use Copilot at minimum
+- You want automation -> Use Claude Code (full)
+- You have CLI access -> Use Cursor (semi) or Copilot (basic)
 - Large projects -> Manual workflow becomes tedious
 
 QUICK START:
 
-1. Open SPECWEAVE-MANUAL.md
-   Read the complete manual workflow guide
+1. Open AGENTS.md
+   Read the "Common Workflows" section
+
+2. Copy workflow to your AI tool:
+   - "Creating a Feature Increment" section
+   - Paste into ChatGPT/Claude/Gemini
 
-2. Follow step-by-step for your first feature
-   - Step 1: Create increment folder
-   - Step 2: Create spec.md (copy template, paste to AI, save)
-   - Step 3: Create plan.md (copy template, paste to AI, save)
-   - Step 4: Create tasks.md (copy template, paste to AI, save)
+3. Follow AI's guidance:
+   - AI generates spec.md content (copy & save)
+   - AI generates plan.md content (copy & save)
+   - AI generates tasks.md content (copy & save)
 
-3. Use any AI tool you prefer
+4. Use any AI tool you prefer:
    ChatGPT, Claude web, Gemini, Perplexity, etc.
 
 DOCUMENTATION:
 
-- SPECWEAVE-MANUAL.md: Complete step-by-step guide (READ THIS FIRST!)
-- SPECWEAVE.md: Complete technical documentation
+- AGENTS.md: Universal workflow instructions (works with any AI!)
 - .specweave/docs/: Project documentation
 
 You're ready to build with SpecWeave using ANY AI tool!
 
-Remember: Generic = Manual = Copy-paste workflow, but 100% compatible!
+Remember: AGENTS.md is the universal standard - it works everywhere!
     `;
     }
 }
-exports.GenericAdapter = GenericAdapter;
 //# sourceMappingURL=adapter.js.map

package/dist/adapters/generic/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/generic/adapter.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAIH,kDAA8C;AAG9C,MAAa,cAAe,SAAQ,0BAAW;IAA/C;;QACE,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,2EAA2E,CAAC;QAC1F,oBAAe,GAAG,QAAiB,CAAC;IA4ItC,CAAC;IA1IC;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,yDAAyD;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL;gBACE,UAAU,EAAE,qBAAqB;gBACjC,UAAU,EAAE,qBAAqB;gBACjC,WAAW,EAAE,gDAAgD;aAC9D;YACD;gBACE,UAAU,EAAE,WAAW;gBACvB,UAAU,EAAE,uCAAuC;gBACnD,WAAW,EAAE,+BAA+B;aAC7C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QAEnE,qDAAqD;QACrD,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7B,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAuB;QACvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkFN,CAAC;IACJ,CAAC;CACF;AA/ID,wCA+IC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/generic/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,MAAM,OAAO,cAAe,SAAQ,WAAW;IAA/C;;QACE,SAAI,GAAG,SAAS,CAAC;QACjB,gBAAW,GAAG,4EAA4E,CAAC;QAC3F,oBAAe,GAAG,QAAiB,CAAC;IAgJtC,CAAC;IA9IC;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,yDAAyD;QACzD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QAEtE,kDAAkD;QAClD,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAuB;QACvC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAkGN,CAAC;IACJ,CAAC;CACF"}

package/dist/cli/commands/init.d.ts

@@ -1,5 +1,7 @@
 interface InitOptions {
-    template: string;
+    template?: string;
+    adapter?: string;
+    techStack?: string;
 }
 export declare function initCommand(projectName?: string, options?: InitOptions): Promise<void>;
 export {};

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAOA,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAkC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAgGf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAcA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAkOf"}