specweave 0.21.1 → 0.21.3

package/plugins/specweave-ui/README.md

@@ -292,9 +292,9 @@ mcp__plugin_specweave-ui_playwright__browser_fill({
 
 ---
 
-### Browserbase (FALLBACK - Cloud Browser Automation)
+### Browserbase (OPTIONAL - Cloud Browser Automation)
 
-**⚠️ Use only when Playwright MCP unavailable (CI/CD, cloud scenarios)**
+**⚠️ NOT loaded by default. Enable only when needed for CI/CD or cloud scenarios.**
 
 **What it does**:
 - Runs Playwright tests in cloud infrastructure
@@ -302,7 +302,7 @@ mcp__plugin_specweave-ui_playwright__browser_fill({
 - No local browser dependencies in CI
 - Automatic screenshots/videos
 
-**Setup**:
+**Manual Setup** (when needed):
 
 1. Get API key from [Browserbase](https://www.browserbase.com/)
 
@@ -312,26 +312,29 @@ mcp__plugin_specweave-ui_playwright__browser_fill({
    export BROWSERBASE_PROJECT_ID="proj_xxx"
    ```
 
-3. SpecWeave auto-configures MCP server (via `.mcp.json`)
+3. **Add to your project's `.claude/settings.json`**:
+   ```json
+   {
+     "mcpServers": {
+       "browserbase": {
+         "command": "npx",
+         "args": ["-y", "@browserbasehq/mcp-server-browserbase"],
+         "env": {
+           "BROWSERBASE_API_KEY": "${BROWSERBASE_API_KEY}",
+           "BROWSERBASE_PROJECT_ID": "${BROWSERBASE_PROJECT_ID}"
+         }
+       }
+     }
+   }
+   ```
 
-4. Use in CI/CD pipelines
+4. Restart Claude Code
 
-**Configuration** (`.mcp.json`):
-```json
-{
-  "mcpServers": {
-    "browserbase": {
-      "command": "npx",
-      "args": ["-y", "@browserbasehq/mcp-server-browserbase"],
-      "env": {
-        "BROWSERBASE_API_KEY": "${BROWSERBASE_API_KEY}",
-        "BROWSERBASE_PROJECT_ID": "${BROWSERBASE_PROJECT_ID}"
-      },
-      "optional": true
-    }
-  }
-}
-```
+**Why not auto-loaded?**
+- Saves ~5,600 tokens per request
+- Most developers use Playwright locally, not Browserbase
+- Browserbase requires API keys (not needed for most users)
+- Can still enable when needed for CI/CD
 
 **Benefits**:
 - ✅ Parallel execution (10x faster)
@@ -392,11 +395,6 @@ npm run storybook
   "plugins": {
     "specweave-ui": {
       "enabled": true,
-      "mcp": {
-        "browserbase": {
-          "enabled": false
-        }
-      },
       "defaults": {
         "frontend_framework": "react",  // or "vue", "angular"
         "test_framework": "playwright",
@@ -407,6 +405,8 @@ npm run storybook
 }
 ```
 
+**Note**: Browserbase is NOT auto-loaded. See "Browserbase (OPTIONAL)" section above for manual setup.
+
 ---
 
 ## FAQ

package/plugins/specweave-ui/skills/browser-automation/SKILL.md

@@ -1,12 +1,14 @@
 ---
 name: browser-automation
 description: |
-  Browser automation and E2E testing using Playwright MCP (primary) or Browserbase (fallback).
+  Browser automation and E2E testing using Playwright MCP (always available).
   Auto-activates for: browser automation, web testing, E2E tests, Playwright, browser interaction,
   scraping, testing flows, user journeys, accessibility testing, screenshot capture.
 
   CRITICAL: ALWAYS use Playwright MCP (mcp__plugin_specweave-ui_playwright__*) as PRIMARY choice.
-  Only use Browserbase (mcp__plugin_specweave-ui_browserbase__*) as FALLBACK when Playwright unavailable.
+
+  NOTE: Browserbase tools (mcp__plugin_specweave-ui_browserbase__*) are NOT loaded by default.
+  They require manual setup and are only for CI/CD or cloud scenarios.
 allowed-tools:
   - mcp__plugin_specweave-ui_playwright__*
   - mcp__plugin_specweave-ui_browserbase__*
@@ -133,9 +135,11 @@ browser_console_messages()
 browser_close()
 ```
 
-### 2. Browserbase Integration (FALLBACK - Cloud Testing)
+### 2. Browserbase Integration (OPTIONAL - Cloud Testing)
+
+**⚠️ NOT LOADED BY DEFAULT - Manual setup required!**
 
-**⚠️ ONLY USE AS FALLBACK when Playwright MCP unavailable!**
+**Note**: Browserbase is NOT auto-loaded to save ~5,600 tokens per request. Enable only when needed for CI/CD or cloud scenarios.
 
 Browserbase provides cloud-based browser automation:
 
@@ -148,6 +152,8 @@ Browserbase provides cloud-based browser automation:
 
 #### Available Tools (mcp__plugin_specweave-ui_browserbase__*)
 
+**Note**: These tools are ONLY available after manual setup.
+
 - **browserbase_session_create** - Create cloud session
 - **browserbase_session_close** - Close session
 - **browserbase_stagehand_navigate** - Navigate to URL
@@ -158,7 +164,7 @@ Browserbase provides cloud-based browser automation:
 - **browserbase_stagehand_get_url** - Get current URL
 - **browserbase_stagehand_agent** - Run autonomous task
 
-#### Setup Requirements
+#### Manual Setup (when needed)
 
 1. Get API credentials from [Browserbase](https://www.browserbase.com/)
 2. Set environment variables:
@@ -166,7 +172,22 @@ Browserbase provides cloud-based browser automation:
    export BROWSERBASE_API_KEY="bb_xxx"
    export BROWSERBASE_PROJECT_ID="proj_xxx"
    ```
-3. Configuration is in `.mcp.json`
+3. Add to `.claude/settings.json`:
+   ```json
+   {
+     "mcpServers": {
+       "browserbase": {
+         "command": "npx",
+         "args": ["-y", "@browserbasehq/mcp-server-browserbase"],
+         "env": {
+           "BROWSERBASE_API_KEY": "${BROWSERBASE_API_KEY}",
+           "BROWSERBASE_PROJECT_ID": "${BROWSERBASE_PROJECT_ID}"
+         }
+       }
+     }
+   }
+   ```
+4. Restart Claude Code
 
 #### Testing Workflow (Browserbase)
 
@@ -398,30 +419,22 @@ Are you running locally (dev machine or VM)?
 
 ## Configuration Files
 
-### .mcp.json (Plugin-Level)
+### .mcp.json (Plugin-Level - Auto-Loaded)
 ```json
 {
   "mcpServers": {
     "playwright": {
       "command": "npx",
-      "args": ["@playwright/mcp@latest"],
+      "args": ["-y", "@playwright/mcp@latest"],
       "description": "Local Playwright - PRIMARY",
       "optional": false
-    },
-    "browserbase": {
-      "command": "npx",
-      "args": ["-y", "@browserbasehq/mcp-server-browserbase"],
-      "env": {
-        "BROWSERBASE_API_KEY": "${BROWSERBASE_API_KEY}",
-        "BROWSERBASE_PROJECT_ID": "${BROWSERBASE_PROJECT_ID}"
-      },
-      "description": "Cloud Browserbase - FALLBACK",
-      "optional": true
     }
   }
 }
 ```
 
+**Note**: Browserbase is NOT in `.mcp.json` (not auto-loaded). To enable Browserbase, add it to your project's `.claude/settings.json` as shown in the "Manual Setup" section above.
+
 ### playwright.config.ts (Project-Level)
 ```typescript
 import { defineConfig } from '@playwright/test';

package/src/templates/tasks.md.template

@@ -23,16 +23,33 @@ Use this template for each task:
 **Priority**: P0 | P1 | P2 | P3
 **Estimate**: X hours
 **Status**: pending | in_progress | completed | blocked
+**AC-IDs**: AC-US-XXX-YY (links to spec.md acceptance criteria)
 **GitHub Issue**: #NNN (auto-populated after sync)
 **Assignee**: @username (optional)
 
 **Description**:
 Brief description of what this task accomplishes.
 
-**Subtasks** (optional):
-- [ ] S-XXX-01: Subtask description (Xmin)
-- [ ] S-XXX-02: Subtask description (Xmin)
-- [ ] S-XXX-03: Subtask description (Xmin)
+**Implementation**:
+- [ ] Create/update ClassName with method()
+- [ ] Implement core feature logic
+- [ ] Add error handling for edge cases
+- [ ] Add JSDoc comments
+- [ ] Update related type definitions
+
+**Test Plan** (BDD):
+- **Given** [precondition describing initial state]
+- **When** [action or event that triggers behavior]
+- **Then** [expected result or outcome]
+
+**Test Cases**:
+- Unit (`class-name.test.ts`):
+  - method_withValidInput_returnsExpectedResult
+  - method_withInvalidInput_throwsError
+  - Coverage: >95%
+- Integration (`feature.integration.test.ts`):
+  - fullWorkflow_happyPath_succeeds
+  - Coverage: >85%
 
 **Files to Create** (if applicable):
 - `path/to/new/file.ts`
@@ -42,20 +59,15 @@ Brief description of what this task accomplishes.
 - `path/to/existing/file.ts`
 - `path/to/another/existing.md`
 
-**Implementation** (optional - code snippets, examples):
+**Code Examples** (optional - snippets for clarity):
 ```typescript
-// Example implementation
+// Example implementation approach
 export function exampleFunction() {
   // Code here
 }
 ```
 ```
 
-**Acceptance Criteria**:
-- ✅ Criterion 1
-- ✅ Criterion 2
-- ✅ Criterion 3
-
 **Dependencies** (optional - tasks that must complete first):
 - T-001 (must complete first)
 - T-002 (must complete first)
@@ -75,25 +87,40 @@ export function exampleFunction() {
 **Priority**: P0
 **Estimate**: 2 hours
 **Status**: pending
+**AC-IDs**: AC-US1-01, AC-US1-02
 **GitHub Issue**: (will be populated after sync)
 **Assignee**: (assign in GitHub after sync)
 
 **Description**:
-This is an example task showing the enhanced template format with GitHub sync fields.
+This is an example task showing the canonical template format following ADR-0047.
 
-**Subtasks**:
-- [ ] S-001-01: First subtask (30min)
-- [ ] S-001-02: Second subtask (45min)
-- [ ] S-001-03: Third subtask (30min)
-- [ ] S-001-04: Final polish (15min)
+**Implementation**:
+- [ ] Define ExampleInterface with id and name fields
+- [ ] Create ExampleClass implementing ExampleInterface
+- [ ] Add constructor with parameter properties
+- [ ] Add JSDoc comments for interface and class
+- [ ] Export both interface and class
+
+**Test Plan** (BDD):
+- **Given** ExampleClass constructor receives valid id and name
+- **When** new ExampleClass('123', 'Test') is instantiated
+- **Then** instance has correct id and name properties
+
+**Test Cases**:
+- Unit (`example-class.test.ts`):
+  - constructor_withValidParams_createsInstance
+  - constructor_withEmptyId_throwsError
+  - interface_conformsToContract
+  - Coverage: >95%
 
 **Files to Create**:
 - `src/example/new-file.ts`
+- `tests/unit/example/example-class.test.ts`
 
 **Files to Modify**:
 - `src/example/existing-file.ts`
 
-**Implementation**:
+**Code Examples**:
 ```typescript
 export interface ExampleInterface {
   id: string;
@@ -105,12 +132,6 @@ export class ExampleClass implements ExampleInterface {
 }
 ```
 
-**Acceptance Criteria**:
-- ✅ All interfaces defined
-- ✅ TypeScript compiles without errors
-- ✅ Unit tests pass
-- ✅ Documentation comments added
-
 **Dependencies**:
 None (foundation task)
 
@@ -231,22 +252,19 @@ As you work on tasks:
 - **Priority**: P0 (critical), P1 (high), P2 (medium), P3 (low)
 - **Estimate**: Hours or days (e.g., "2 hours", "3 days")
 - **Status**: pending, in_progress, completed, blocked
+- **AC-IDs**: Links to spec.md acceptance criteria (e.g., "AC-US1-01, AC-US1-02")
 - **Description**: What this task accomplishes
-- **Acceptance Criteria**: How we know it's done
+- **Implementation**: Checkable technical steps to complete the task
+- **Test Plan (BDD)**: Given-When-Then test scenarios
+- **Test Cases**: Unit and integration test cases with coverage targets
 
 ### Optional Fields (Enhanced for GitHub Sync)
 - **GitHub Issue**: Auto-populated after `/specweave.github.sync-tasks`
 - **Assignee**: GitHub username (assign in GitHub UI or via `@username`)
-- **Subtasks**: Granular steps (15-60min each, shown as checkboxes in GitHub)
 - **Dependencies**: Tasks that must complete first (linked in GitHub via "depends on")
 - **Blocks**: Tasks waiting on this one (linked in GitHub via "blocks")
-- **Files to Create/Modify**: Context for reviewers
-- **Implementation**: Code snippets, examples, pseudocode
-
-### Subtask Naming Convention
-- Format: `S-{TASK_ID}-{SUBTASK_NUM}: Description (time)`
-- Example: `S-001-01: Define interfaces (30min)`
-- Numbering: Zero-padded 2 digits (01, 02, 03, ...)
+- **Files to Create/Modify**: Context for reviewers and developers
+- **Code Examples**: Snippets showing implementation approach (TypeScript, pseudocode, etc.)
 
 ### Task Status Lifecycle
 1. **pending** - Not started, in backlog

package/dist/locales/de/cli.json

@@ -1,108 +0,0 @@
-{
-  "init": {
-    "welcome": "🚀 SpecWeave Initialization",
-    "projectName": "Project name:",
-    "projectNamePrompt": "Project name (for templates):",
-    "projectNameDefault": "my-saas",
-    "detectingTool": "Detecting AI tool...",
-    "foundClaude": "✅ Found Claude Code",
-    "foundCursor": "✅ Found Cursor",
-    "foundCopilot": "✅ Found GitHub Copilot",
-    "noToolDetected": "No AI tool detected, using Generic adapter",
-    "complete": "✨ Initialization complete!",
-    "claudeNativeComplete": "✨ Claude Code native installation complete!",
-    "claudeNativeBenefits": "✅ Native skills, agents, hooks work out of the box",
-    "projectSuccess": "SpecWeave project created successfully!",
-    "readyToBuild": "🚀 Ready to build with SpecWeave!",
-    "errors": {
-      "invalidName": "Project name must contain only lowercase letters, numbers, and hyphens",
-      "alreadyExists": ".specweave directory already exists",
-      "cancelled": "❌ Initialization cancelled",
-      "invalidLanguage": "❌ Invalid language: {{language}}",
-      "supportedLanguages": "Supported languages: {{languages}}",
-      "nestedNotSupported": "❌ Nested .specweave/ folders are NOT supported!",
-      "parentFound": "Found parent .specweave/ at:",
-      "projectCreationFailed": "Failed to create project",
-      "commandsCopyFailed": "❌ Commands copy failed: {{error}}",
-      "agentsCopyFailed": "❌ Agents copy failed: {{error}}",
-      "skillsCopyFailed": "❌ Skills copy failed: {{error}}",
-      "hooksCopyFailed": "❌ Hooks copy failed: {{error}}"
-    },
-    "warnings": {
-      "invalidDirName": "⚠️  Current directory name '{{dirName}}' contains invalid characters.",
-      "directoryNotEmpty": "⚠️  Current directory contains {{count}} file{{plural}}.",
-      "skillsIndexWarning": "⚠️  Warning: Could not generate skills index: {{error}}",
-      "skillsIndexNote": "Skills will still work, but manual indexing may be needed."
-    },
-    "prompts": {
-      "confirmInitInCurrent": "Initialize SpecWeave in current directory?",
-      "overwriteSpecweave": ".specweave directory already exists. Overwrite?",
-      "overwriteDirectory": "Directory {{projectName}} already exists. Overwrite?",
-      "enablePlugins": "Enable suggested plugins now?"
-    },
-    "info": {
-      "nestedEnforcement": "SpecWeave enforces a single source of truth:",
-      "nestedBullet1": "• Use the parent folder for all increments",
-      "nestedBullet2": "• Increments can span multiple subdirectories",
-      "nestedBullet3": "• See CLAUDE.md section \"Root-Level .specweave/ Folder\"",
-      "nestedToFix": "To fix:",
-      "suggestedPlugins": "💡 Suggested Plugins:",
-      "copiedFiles": "✓ Copied {{count}} command files",
-      "copiedAgents": "✓ Copied {{count}} agent directories",
-      "copiedSkills": "✓ Copied {{count}} skill directories",
-      "copiedHooks": "✓ Copied {{count}} hook files"
-    },
-    "progress": {
-      "creatingProject": "Creating SpecWeave project...",
-      "detected": "Detected {{tool}}...",
-      "usingTool": "Using {{tool}}...",
-      "directoryCreated": "Directory structure created...",
-      "templatesCopied": "Base templates copied...",
-      "installingComponents": "Installing Claude Code components...",
-      "commandsInstalled": "Slash commands installed...",
-      "agentsInstalled": "Agents installed...",
-      "skillsInstalled": "Skills installed...",
-      "hooksInstalled": "Hooks installed...",
-      "generatingIndex": "Generating skills index...",
-      "indexGenerated": "Skills index generated...",
-      "installingAdapter": "Installing {{tool}} adapter...",
-      "projectSuccess": "SpecWeave project created successfully!",
-      "detectingPlugins": "Detecting plugins...",
-      "detectedPlugins": "Detected {{count}} suggested plugins",
-      "enablingPlugins": "Enabling plugins...",
-      "enabledPlugin": "Enabled {{plugin}}",
-      "pluginsEnabled": "Plugins enabled"
-    },
-    "nextSteps": {
-      "header": "🎯 Next steps:",
-      "cd": "cd {{projectName}}",
-      "footer": "🚀 Ready to build with SpecWeave!",
-      "docsLink": "Documentation: https://spec-weave.com",
-      "githubLink": "GitHub: https://github.com/anton-abyzov/specweave"
-    }
-  },
-  "increment": {
-    "creating": "📝 Creating increment: {name}",
-    "created": "✅ Increment {id} created successfully!",
-    "nextStepDo": "Next: Run /specweave.do to start implementation",
-    "errors": {
-      "incompleteFound": "Cannot create new increment! Previous increments incomplete"
-    }
-  },
-  "progress": {
-    "currentIncrement": "Current Increment: {id}",
-    "status": "Status: {status}",
-    "completion": "Completion: {percent}%"
-  },
-  "translate": {
-    "translating": "🌐 Translating content to {language}...",
-    "complete": "✅ Translation complete!"
-  },
-  "version": {
-    "current": "SpecWeave version: {version}"
-  },
-  "errors": {
-    "fileNotFound": "❌ File not found: {path}",
-    "invalidConfig": "❌ Invalid configuration: {error}"
-  }
-}