specweave 0.28.17 → 0.28.20

package/plugins/specweave-ml/agents/data-scientist/AGENT.md

@@ -1,42 +1,38 @@
 ---
 name: data-scientist
-description: Expert data scientist for advanced analytics, machine learning, and statistical modeling. Handles complex data analysis, predictive modeling, and business intelligence. Use PROACTIVELY for data analysis tasks, ML modeling, statistical analysis, and data-driven insights.
-model: claude-sonnet-4-5-20250929
+description: Statistical modeling and business analytics expert. A/B testing, causal inference, customer analytics (CLV, churn, segmentation), time series forecasting. Activates for EDA, statistical analysis, hypothesis testing, regression, cohort analysis, demand forecasting, experiment design.
 model_preference: sonnet
 cost_profile: planning
 fallback_behavior: strict
+max_response_tokens: 2000
 ---
 
-You are a data scientist specializing in advanced analytics, machine learning, statistical modeling, and data-driven business insights.
+## ⚠️ Chunking Rule
 
-## 🚀 How to Invoke This Agent
+Large analyses (EDA + modeling + visualization) = 800+ lines. Generate ONE phase per response: EDA → Feature Engineering → Modeling → Evaluation → Recommendations.
 
-**Subagent Type**: `specweave-ml:data-scientist:data-scientist`
+## How to Invoke This Agent
 
-**Usage Example**:
+**Agent**: `specweave-ml:data-scientist:data-scientist`
 
 ```typescript
 Task({
   subagent_type: "specweave-ml:data-scientist:data-scientist",
-  prompt: "Analyze customer churn patterns and build predictive model to identify at-risk customers",
-  model: "haiku" // optional: haiku, sonnet, opus
+  prompt: "Analyze churn patterns and build predictive model"
 });
 ```
 
-**Naming Convention**: `{plugin}:{directory}:{yaml-name-or-directory-name}`
-- **Plugin**: specweave-ml
-- **Directory**: data-scientist
-- **Agent Name**: data-scientist
+**Use When**: EDA, A/B testing, statistical modeling, business analytics, causal inference.
 
-**When to Use**:
-- You need to perform exploratory data analysis and statistical analysis
-- You want to build machine learning models for prediction or classification
-- You need to design A/B tests or experiments
-- You want to create data visualizations and dashboards
-- You need actionable insights from complex data
+## Philosophy: Rigorous Yet Practical
 
-## Purpose
-Expert data scientist combining strong statistical foundations with modern machine learning techniques and business acumen. Masters the complete data science workflow from exploratory data analysis to production model deployment, with deep expertise in statistical methods, ML algorithms, and data visualization for actionable business insights.
+**I balance statistical rigor with business impact:**
+
+1. **Statistical Significance ≠ Business Significance** - A 0.1% lift may be statistically significant but not worth optimizing.
+2. **Start Simple** - Linear regression often beats complex models. XGBoost if you need more.
+3. **Causation > Correlation** - Design experiments or use causal inference when "why" matters.
+4. **Domain Knowledge First** - Understand the business before the data.
+5. **Communicate Impact** - "Model predicts 20% churn reduction" not "AUC = 0.87".
 
 ## Capabilities
 

package/plugins/specweave-ml/agents/ml-engineer/AGENT.md

@@ -1,42 +1,41 @@
 ---
 name: ml-engineer
+description: End-to-end ML system builder with SpecWeave integration. Enforces best practices - baseline comparison, cross-validation, experiment tracking, explainability (SHAP/LIME). Activates for ML features, model training, hyperparameter tuning, production ML. Works within increment-based workflow.
 model_preference: sonnet
+cost_profile: execution
 max_response_tokens: 2000
 ---
 
 # ML Engineer Agent
 
-## ⚠️ Chunking for Large ML Pipelines
+## ⚠️ Chunking Rule
 
-When generating comprehensive ML pipelines that exceed 1000 lines (e.g., complete end-to-end ML system with data preprocessing, feature engineering, model training, hyperparameter tuning, evaluation, and deployment), generate output **incrementally** to prevent crashes. Break large ML implementations into logical stages (e.g., Data Loading & EDA → Feature Engineering → Model Training → Evaluation → Deployment) and ask the user which stage to implement next. This ensures reliable delivery of ML infrastructure without overwhelming the system.
+Large ML pipelines = 1000+ lines. Generate ONE stage per response: Data/EDA → Features → Training → Evaluation → Deployment.
 
-## 🚀 How to Invoke This Agent
+## How to Invoke This Agent
 
-**Subagent Type**: `specweave-ml:ml-engineer:ml-engineer`
-
-**Usage Example**:
+**Agent**: `specweave-ml:ml-engineer:ml-engineer`
 
 ```typescript
 Task({
   subagent_type: "specweave-ml:ml-engineer:ml-engineer",
-  prompt: "Build fraud detection model for transactions with baseline comparison, hyperparameter tuning, and explainability",
-  model: "haiku" // optional: haiku, sonnet, opus
+  prompt: "Build fraud detection model with baseline comparison and explainability"
 });
 ```
 
-**Naming Convention**: `{plugin}:{directory}:{yaml-name-or-directory-name}`
-- **Plugin**: specweave-ml
-- **Directory**: ml-engineer
-- **Agent Name**: ml-engineer
+**Use When**: ML feature implementation, model training, hyperparameter tuning, production ML with SpecWeave.
+
+## Philosophy: Disciplined ML Engineering
+
+**Every model I build follows these non-negotiable rules:**
 
-**When to Use**:
-- You need to plan and implement ML features with SpecWeave increments
-- You want to enforce ML best practices (baseline comparison, cross-validation, explainability)
-- You're selecting appropriate algorithms and handling hyperparameter tuning
-- You need production-ready ML systems with proper evaluation
-- You want to integrate ML with SpecWeave's living documentation
+1. **Baseline First** - No model ships without beating a simple baseline by 20%+.
+2. **Cross-Validation Always** - Single train/test splits lie. Use k-fold.
+3. **Log Everything** - Every experiment tracked to increment folder.
+4. **Explain Your Model** - SHAP/LIME for production models. Non-negotiable.
+5. **Load Test Before Deploy** - p95 latency < target or optimize first.
 
-You are a Machine Learning Engineer specializing in end-to-end ML system design, implementation, and deployment. You work within SpecWeave's increment-based workflow to build production-ready ML systems.
+I work within SpecWeave's increment-based workflow to build **production-ready, reproducible ML systems**.
 
 ## Your Expertise
 

package/plugins/specweave-ml/skills/{ml-pipeline-workflow → mlops-dag-builder}/SKILL.md

@@ -1,24 +1,27 @@
 ---
-name: ml-pipeline-workflow
-description: Build end-to-end MLOps pipelines from data preparation through model training, validation, and production deployment. Use when creating ML pipelines, implementing MLOps practices, or automating model training and deployment workflows.
+name: mlops-dag-builder
+description: Design DAG-based MLOps pipeline architectures with Airflow, Dagster, Kubeflow, or Prefect. Activates for DAG orchestration, workflow automation, pipeline design patterns, CI/CD for ML. Use for platform-agnostic MLOps infrastructure - NOT for SpecWeave increment-based ML (use ml-pipeline-orchestrator instead).
 ---
 
-# ML Pipeline Workflow
+# MLOps DAG Builder
 
-Complete end-to-end MLOps pipeline orchestration from data preparation through model deployment.
+Design and implement DAG-based ML pipeline architectures using production orchestration tools.
 
 ## Overview
 
-This skill provides comprehensive guidance for building production ML pipelines that handle the full lifecycle: data ingestion → preparation → training → validation → deployment → monitoring.
+This skill provides guidance for building **platform-agnostic MLOps pipelines** using DAG orchestrators (Airflow, Dagster, Kubeflow, Prefect). It focuses on workflow architecture, not SpecWeave integration.
+
+**When to use this skill vs ml-pipeline-orchestrator:**
+- **Use this skill**: General MLOps architecture, Airflow/Dagster DAGs, cloud ML platforms
+- **Use ml-pipeline-orchestrator**: SpecWeave increment-based ML development with experiment tracking
 
 ## When to Use This Skill
 
-- Building new ML pipelines from scratch
-- Designing workflow orchestration for ML systems
-- Implementing data → model → deployment automation
-- Setting up reproducible training workflows
-- Creating DAG-based ML orchestration
-- Integrating ML components into production systems
+- Designing DAG-based workflow orchestration (Airflow, Dagster, Kubeflow)
+- Implementing platform-agnostic ML pipeline patterns
+- Setting up CI/CD automation for ML training jobs
+- Creating reusable pipeline templates for teams
+- Integrating with cloud ML services (SageMaker, Vertex AI, Azure ML)
 
 ## What This Skill Provides
 
@@ -240,6 +243,7 @@ After setting up your pipeline:
 
 ## Related Skills
 
-- **experiment-tracking-setup**: MLflow and Weights & Biases integration
-- **hyperparameter-tuning**: Automated hyperparameter optimization
-- **model-deployment-patterns**: Advanced deployment strategies
+- **ml-pipeline-orchestrator**: SpecWeave-integrated ML development (use for increment-based ML)
+- **experiment-tracker**: MLflow and Weights & Biases experiment tracking
+- **automl-optimizer**: Automated hyperparameter optimization with Optuna/Hyperopt
+- **ml-deployment-helper**: Model serving and deployment patterns

package/plugins/specweave-release/hooks/.specweave/logs/dora-tracking.log

@@ -1105,3 +1105,114 @@
 [2025-11-26 01:29:07] 🎯 Post-Increment-Completion Hook Triggered
 [2025-11-26 01:29:07] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
 [2025-11-26 01:29:07]    Run: npm run build
+[2025-11-26 02:36:06] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 02:36:06] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 02:36:06]    Run: npm run build
+[2025-11-26 02:36:06] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 02:36:06] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 02:36:06]    Run: npm run build
+[2025-11-26 02:36:06] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 02:36:06] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 02:36:06]    Run: npm run build
+[2025-11-26 02:36:06] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 02:36:06] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 02:36:06]    Run: npm run build
+[2025-11-26 02:36:06] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 02:36:06] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 02:36:06]    Run: npm run build
+[2025-11-26 03:25:15] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:25:15] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:25:15]    Run: npm run build
+[2025-11-26 03:25:15] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:25:15] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:25:15]    Run: npm run build
+[2025-11-26 03:25:16] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:25:16] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:25:16]    Run: npm run build
+[2025-11-26 03:27:50] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:27:50] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:27:50]    Run: npm run build
+[2025-11-26 03:27:50] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:27:50] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:27:50]    Run: npm run build
+[2025-11-26 03:27:50] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:27:50] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:27:50]    Run: npm run build
+[2025-11-26 03:47:12] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:12] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:12]    Run: npm run build
+[2025-11-26 03:47:12] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:12] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:12]    Run: npm run build
+[2025-11-26 03:47:13] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:13] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:13]    Run: npm run build
+[2025-11-26 03:47:13] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:13] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:13]    Run: npm run build
+[2025-11-26 03:47:13] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:13] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:13]    Run: npm run build
+[2025-11-26 03:47:13] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:13] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:13]    Run: npm run build
+[2025-11-26 03:47:13] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:13] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:13]    Run: npm run build
+[2025-11-26 03:47:13] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:13] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:13]    Run: npm run build
+[2025-11-26 03:47:22] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:22] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:22]    Run: npm run build
+[2025-11-26 03:47:22] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:22] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:22]    Run: npm run build
+[2025-11-26 03:47:22] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:47:22] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:47:22]    Run: npm run build
+[2025-11-26 03:52:20] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:52:20] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:52:20]    Run: npm run build
+[2025-11-26 03:52:20] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:52:20] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:52:20]    Run: npm run build
+[2025-11-26 03:52:20] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 03:52:20] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 03:52:20]    Run: npm run build
+[2025-11-26 08:47:37] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:47:37] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:47:37]    Run: npm run build
+[2025-11-26 08:47:37] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:47:37] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:47:37]    Run: npm run build
+[2025-11-26 08:47:37] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:47:37] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:47:37]    Run: npm run build
+[2025-11-26 08:50:09] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:50:09] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:50:09]    Run: npm run build
+[2025-11-26 08:50:09] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:50:09] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:50:09]    Run: npm run build
+[2025-11-26 08:50:09] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:50:09] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:50:09]    Run: npm run build
+[2025-11-26 08:52:35] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:52:35] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:52:35]    Run: npm run build
+[2025-11-26 08:52:36] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:52:36] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:52:36]    Run: npm run build
+[2025-11-26 08:52:36] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 08:52:36] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 08:52:36]    Run: npm run build
+[2025-11-26 12:29:21] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 12:29:21] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 12:29:21]    Run: npm run build
+[2025-11-26 12:29:21] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 12:29:21] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 12:29:21]    Run: npm run build
+[2025-11-26 12:29:21] 🎯 Post-Increment-Completion Hook Triggered
+[2025-11-26 12:29:21] ⚠️  DORA calculator not found at /Users/antonabyzov/Projects/github/specweave/plugins/specweave-release/hooks/dist/src/metrics/dora-calculator.js
+[2025-11-26 12:29:21]    Run: npm run build

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

@@ -1,6 +1,6 @@
 ---
 name: browser-automation
-description: Browser automation expert using Playwright for UI testing, web scraping, form automation, screenshot capture, and automated workflows. Activates for Playwright, Puppeteer, Selenium, web automation, browser testing, UI automation, web scraping, screenshot, headless browser, element inspection, selector strategies.
+description: Non-testing browser automation - web scraping, form filling, screenshot capture, PDF generation, workflow automation. For TESTING with Playwright, use e2e-playwright skill instead. Activates for web scraping, form automation, screenshot, PDF, headless browser, Puppeteer, Selenium, automation scripts, data extraction.
 ---
 
 # Browser Automation Skill

package/plugins/specweave-ui/skills/ui-testing/SKILL.md

@@ -1,135 +1,23 @@
 ---
 name: ui-testing
-description: UI and end-to-end testing expert using Playwright Test, Cypress, Testing Library, and component testing frameworks. Covers test strategies, page object models, accessibility testing, CI integration, and test flakiness mitigation. Activates for UI testing, E2E testing, Playwright Test, Cypress, Testing Library, component tests, integration tests, accessibility testing, test flakiness, page object model, CI testing.
+description: Multi-framework UI testing expert - Cypress, Testing Library, component tests. Use for framework comparison, Cypress-specific testing, or React Testing Library. For DEEP Playwright expertise, use e2e-playwright skill instead. Activates for Cypress, Testing Library, component tests, React testing, Vue testing, framework comparison, which testing tool, Cypress vs Playwright.
 ---
 
 # UI Testing Skill
 
-Expert in UI and end-to-end (E2E) testing using modern frameworks like Playwright Test, Cypress, and Testing Library. Specializes in writing reliable, maintainable tests that catch bugs before production.
+Expert in UI testing with **Cypress** and **Testing Library**. For deep Playwright expertise, see the `e2e-playwright` skill.
 
-## Core Testing Frameworks
+## Framework Selection Guide
 
-### 1. Playwright Test (Recommended for E2E)
+| Framework | Best For | Key Strength |
+|-----------|----------|--------------|
+| **Playwright** | E2E, cross-browser | Auto-wait, multi-browser → Use `e2e-playwright` skill |
+| **Cypress** | E2E, developer experience | Time-travel debugging, real-time reload |
+| **Testing Library** | Component tests | User-centric queries, accessibility-first |
 
-**Why Playwright?**
-- Multi-browser support (Chromium, Firefox, WebKit)
-- Auto-wait (no manual `waitFor` needed)
-- Fast parallel execution
-- Built-in assertions and fixtures
-- Network interception and mocking
-
-#### Basic Test Structure
-
-```typescript
-import { test, expect } from '@playwright/test';
-
-test.describe('User Authentication', () => {
-  test('should login with valid credentials', async ({ page }) => {
-    // Navigate
-    await page.goto('https://example.com/login');
-
-    // Interact
-    await page.fill('input[name="email"]', 'user@example.com');
-    await page.fill('input[name="password"]', 'SecurePass123!');
-    await page.click('button[type="submit"]');
-
-    // Assert
-    await expect(page).toHaveURL('https://example.com/dashboard');
-    await expect(page.locator('h1')).toHaveText('Welcome, User');
-  });
-
-  test('should show error with invalid credentials', async ({ page }) => {
-    await page.goto('https://example.com/login');
-
-    await page.fill('input[name="email"]', 'wrong@example.com');
-    await page.fill('input[name="password"]', 'WrongPass');
-    await page.click('button[type="submit"]');
-
-    // Wait for error message
-    const errorMessage = page.locator('.error-message');
-    await expect(errorMessage).toBeVisible();
-    await expect(errorMessage).toHaveText('Invalid credentials');
-  });
-});
-```
-
-#### Fixtures (Reusable Setup)
-
-```typescript
-// fixtures.ts
-import { test as base } from '@playwright/test';
-
-type Fixtures = {
-  authenticatedPage: Page;
-};
-
-export const test = base.extend<Fixtures>({
-  authenticatedPage: async ({ page }, use) => {
-    // Login before each test
-    await page.goto('https://example.com/login');
-    await page.fill('input[name="email"]', 'user@example.com');
-    await page.fill('input[name="password"]', 'SecurePass123!');
-    await page.click('button[type="submit"]');
-    await page.waitForURL('**/dashboard');
-
-    // Use the authenticated page
-    await use(page);
-
-    // Cleanup (logout)
-    await page.click('[data-testid="logout"]');
-  },
-});
-
-// tests/dashboard.spec.ts
-import { test, expect } from './fixtures';
-
-test('should display user dashboard', async ({ authenticatedPage }) => {
-  // Already logged in via fixture
-  await expect(authenticatedPage.locator('h1')).toHaveText('Dashboard');
-});
-```
-
-#### Page Object Model (POM)
-
-```typescript
-// pages/LoginPage.ts
-export class LoginPage {
-  constructor(private page: Page) {}
-
-  async goto() {
-    await this.page.goto('https://example.com/login');
-  }
-
-  async login(email: string, password: string) {
-    await this.page.fill('input[name="email"]', email);
-    await this.page.fill('input[name="password"]', password);
-    await this.page.click('button[type="submit"]');
-  }
-
-  async getErrorMessage() {
-    const errorElement = this.page.locator('.error-message');
-    return errorElement.textContent();
-  }
-
-  async isLoginButtonDisabled() {
-    return this.page.locator('button[type="submit"]').isDisabled();
-  }
-}
-
-// tests/login.spec.ts
-import { LoginPage } from '../pages/LoginPage';
-
-test('login with POM', async ({ page }) => {
-  const loginPage = new LoginPage(page);
-
-  await loginPage.goto();
-  await loginPage.login('user@example.com', 'SecurePass123!');
-
-  await expect(page).toHaveURL('**/dashboard');
-});
-```
+---
 
-### 2. Cypress (Alternative for E2E)
+## 1. Cypress (E2E Testing)
 
 **Why Cypress?**
 - Developer-friendly API

package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts

@@ -1,70 +0,0 @@
-/**
- * Epic Content Builder - Hierarchical GitHub issue content for Feature Specs
- *
- * Architecture:
- * - Reads FS-* folder (FEATURE.md + us-*.md files)
- * - Reads increment tasks.md files to map tasks to user stories
- * - Generates hierarchical issue body:
- *   1. User Stories section (with status + increment)
- *   2. Tasks section (grouped by User Story)
- *
- * Key Features:
- * - NO single "Increment" field (epics span multiple increments)
- * - User Stories are checkable with status and increment link
- * - Tasks grouped under their User Story
- * - Shows which increment each US/task belongs to
- */
-export declare class EpicContentBuilder {
-    private epicFolder;
-    private projectRoot;
-    constructor(epicFolder: string, projectRoot: string);
-    /**
-     * Build hierarchical GitHub issue body
-     *
-     * Format:
-     * - Epic overview
-     * - User Stories section (checkable, with status + increment)
-     * - Tasks section (grouped by User Story)
-     */
-    buildIssueBody(): Promise<string>;
-    /**
-     * Read Epic FEATURE.md frontmatter
-     */
-    private readEpicMetadata;
-    /**
-     * Read all user stories from us-*.md files
-     */
-    private readUserStories;
-    /**
-     * Extract tasks for a user story from its Implementation section
-     */
-    private extractTasksForUserStory;
-    /**
-     * Extract acceptance criteria from user story content
-     *
-     * Parses the "## Acceptance Criteria" section and extracts all checkable items.
-     * Format: - [x] **AC-US2-01**: Description...
-     */
-    private extractAcceptanceCriteria;
-    /**
-     * Build overview section
-     */
-    private buildOverviewSection;
-    /**
-     * Build User Stories section
-     */
-    private buildUserStoriesSection;
-    /**
-     * Build Tasks section (grouped by User Story)
-     */
-    private buildTasksSection;
-    /**
-     * Normalize status values
-     */
-    private normalizeStatus;
-    /**
-     * Get status emoji
-     */
-    private getStatusEmoji;
-}
-//# sourceMappingURL=epic-content-builder.d.ts.map

package/dist/plugins/specweave-github/lib/epic-content-builder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"epic-content-builder.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-github/lib/epic-content-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA8CH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAKnD;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAgBvC;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,eAAe;IA8C7B;;OAEG;YACW,wBAAwB;IAoEtC;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAgCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA8B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,cAAc;CAgBvB"}