specweave 0.23.16 → 0.24.0

package/plugins/specweave-kubernetes/commands/helm-scaffold.md

@@ -0,0 +1,333 @@
+# Helm Chart Scaffolding
+
+Generate production-ready Helm charts with best practices.
+
+## Task
+
+You are a Helm expert. Generate complete Helm chart structure for applications.
+
+### Steps:
+
+1. **Ask for Information**:
+   - Chart name
+   - Application type (web app, API, worker, etc.)
+   - Dependencies (databases, caches, etc.)
+
+2. **Generate Chart Structure**:
+
+```
+my-app/
+├── Chart.yaml
+├── values.yaml
+├── values-dev.yaml
+├── values-staging.yaml
+├── values-prod.yaml
+├── templates/
+│   ├── NOTES.txt
+│   ├── _helpers.tpl
+│   ├── deployment.yaml
+│   ├── service.yaml
+│   ├── ingress.yaml
+│   ├── configmap.yaml
+│   ├── secret.yaml
+│   ├── hpa.yaml
+│   ├── serviceaccount.yaml
+│   ├── networkpolicy.yaml
+│   └── tests/
+│       └── test-connection.yaml
+├── charts/  # Subcharts
+└── .helmignore
+```
+
+3. **Generate Chart.yaml**:
+
+```yaml
+apiVersion: v2
+name: my-app
+description: A Helm chart for my-app
+type: application
+version: 1.0.0  # Chart version
+appVersion: "1.0.0"  # Application version
+
+keywords:
+  - application
+  - api
+
+home: https://github.com/myorg/my-app
+sources:
+  - https://github.com/myorg/my-app
+
+maintainers:
+  - name: Your Name
+    email: you@example.com
+    url: https://example.com
+
+dependencies:
+  - name: postgresql
+    version: "12.x.x"
+    repository: https://charts.bitnami.com/bitnami
+    condition: postgresql.enabled
+  - name: redis
+    version: "17.x.x"
+    repository: https://charts.bitnami.com/bitnami
+    condition: redis.enabled
+```
+
+4. **Generate values.yaml**:
+
+```yaml
+# Default values for my-app
+# This is a YAML-formatted file
+
+replicaCount: 3
+
+image:
+  repository: myapp
+  pullPolicy: IfNotPresent
+  tag: ""  # Overrides appVersion
+
+imagePullSecrets: []
+
+nameOverride: ""
+fullnameOverride: ""
+
+serviceAccount:
+  create: true
+  annotations: {}
+  name: ""
+
+podAnnotations:
+  prometheus.io/scrape: "true"
+  prometheus.io/port: "8080"
+
+podSecurityContext:
+  runAsNonRoot: true
+  runAsUser: 1000
+  fsGroup: 2000
+
+securityContext:
+  capabilities:
+    drop:
+    - ALL
+  readOnlyRootFilesystem: true
+  allowPrivilegeEscalation: false
+
+service:
+  type: ClusterIP
+  port: 80
+  targetPort: 8080
+
+ingress:
+  enabled: true
+  className: "nginx"
+  annotations:
+    cert-manager.io/cluster-issuer: "letsencrypt-prod"
+  hosts:
+    - host: myapp.example.com
+      paths:
+        - path: /
+          pathType: Prefix
+  tls:
+    - secretName: myapp-tls
+      hosts:
+        - myapp.example.com
+
+resources:
+  limits:
+    cpu: 500m
+    memory: 512Mi
+  requests:
+    cpu: 250m
+    memory: 256Mi
+
+autoscaling:
+  enabled: true
+  minReplicas: 3
+  maxReplicas: 10
+  targetCPUUtilizationPercentage: 70
+  targetMemoryUtilizationPercentage: 80
+
+nodeSelector: {}
+
+tolerations: []
+
+affinity:
+  podAntiAffinity:
+    preferredDuringSchedulingIgnoredDuringExecution:
+      - weight: 100
+        podAffinityTerm:
+          labelSelector:
+            matchExpressions:
+              - key: app.kubernetes.io/name
+                operator: In
+                values:
+                  - my-app
+          topologyKey: kubernetes.io/hostname
+
+# Application-specific configs
+config:
+  logLevel: info
+  nodeEnv: production
+
+# Dependencies
+postgresql:
+  enabled: true
+  auth:
+    database: myapp
+    username: myapp
+  primary:
+    persistence:
+      enabled: true
+      size: 10Gi
+
+redis:
+  enabled: true
+  architecture: standalone
+  auth:
+    enabled: true
+```
+
+5. **Generate deployment.yaml (templated)**:
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "my-app.fullname" . }}
+  labels:
+    {{- include "my-app.labels" . | nindent 4 }}
+spec:
+  {{- if not .Values.autoscaling.enabled }}
+  replicas: {{ .Values.replicaCount }}
+  {{- end }}
+  selector:
+    matchLabels:
+      {{- include "my-app.selectorLabels" . | nindent 6 }}
+  template:
+    metadata:
+      annotations:
+        checksum/config: {{ include (print $.Template.BasePath "/configmap.yaml") . | sha256sum }}
+        {{- with .Values.podAnnotations }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+      labels:
+        {{- include "my-app.selectorLabels" . | nindent 8 }}
+    spec:
+      {{- with .Values.imagePullSecrets }}
+      imagePullSecrets:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      serviceAccountName: {{ include "my-app.serviceAccountName" . }}
+      securityContext:
+        {{- toYaml .Values.podSecurityContext | nindent 8 }}
+      containers:
+      - name: {{ .Chart.Name }}
+        securityContext:
+          {{- toYaml .Values.securityContext | nindent 12 }}
+        image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
+        imagePullPolicy: {{ .Values.image.pullPolicy }}
+        ports:
+        - name: http
+          containerPort: {{ .Values.service.targetPort }}
+          protocol: TCP
+        livenessProbe:
+          httpGet:
+            path: /health
+            port: http
+        readinessProbe:
+          httpGet:
+            path: /ready
+            port: http
+        resources:
+          {{- toYaml .Values.resources | nindent 12 }}
+        env:
+        - name: NODE_ENV
+          value: {{ .Values.config.nodeEnv }}
+        - name: LOG_LEVEL
+          value: {{ .Values.config.logLevel }}
+        {{- if .Values.postgresql.enabled }}
+        - name: DB_HOST
+          value: {{ include "my-app.fullname" . }}-postgresql
+        - name: DB_PASSWORD
+          valueFrom:
+            secretKeyRef:
+              name: {{ include "my-app.fullname" . }}-postgresql
+              key: password
+        {{- end }}
+```
+
+6. **Generate _helpers.tpl**:
+
+```yaml
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "my-app.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+*/}}
+{{- define "my-app.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{/*
+Common labels
+*/}}
+{{- define "my-app.labels" -}}
+helm.sh/chart: {{ include "my-app.chart" . }}
+{{ include "my-app.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{/*
+Selector labels
+*/}}
+{{- define "my-app.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "my-app.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+```
+
+### Deployment Commands:
+
+```bash
+# Install chart
+helm install my-app ./my-app -f values-dev.yaml
+
+# Upgrade
+helm upgrade my-app ./my-app -f values-prod.yaml
+
+# Template (dry-run)
+helm template my-app ./my-app -f values-prod.yaml
+
+# Lint
+helm lint ./my-app
+
+# Package
+helm package ./my-app
+
+# Test
+helm test my-app
+```
+
+### Example Usage:
+
+```
+User: "Create Helm chart for Node.js API with PostgreSQL"
+Result: Complete Helm chart with all templates and values files
+```

package/plugins/specweave-ml/.claude-plugin/plugin.json

@@ -1,10 +1,10 @@
 {
   "name": "specweave-ml",
-  "version": "0.22.14",
+  "version": "0.24.0",
   "description": "Complete ML/AI workflow integration for SpecWeave - from experiment tracking to production deployment. Includes 13 comprehensive skills covering the full ML lifecycle: pipeline orchestration, experiment tracking, model evaluation, explainability, deployment, feature engineering, AutoML, computer vision, NLP, time series forecasting, anomaly detection, data visualization, and model registry.",
   "author": {
-    "name": "SpecWeave Team",
-    "email": "[email protected]",
+    "name": "Anton Abyzov",
+    "email": "anton.abyzov@gmail.com",
     "url": "https://spec-weave.com"
   },
   "homepage": "https://spec-weave.com",

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

@@ -9,6 +9,32 @@ fallback_behavior: strict
 
 You are a data scientist specializing in advanced analytics, machine learning, statistical modeling, and data-driven business insights.
 
+## 🚀 How to Invoke This Agent
+
+**Subagent Type**: `specweave-ml:data-scientist:data-scientist`
+
+**Usage Example**:
+
+```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
+});
+```
+
+**Naming Convention**: `{plugin}:{directory}:{yaml-name-or-directory-name}`
+- **Plugin**: specweave-ml
+- **Directory**: data-scientist
+- **Agent Name**: data-scientist
+
+**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
+
 ## 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.
 

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

@@ -5,6 +5,32 @@ model_preference: sonnet
 
 # ML Engineer Agent
 
+## 🚀 How to Invoke This Agent
+
+**Subagent Type**: `specweave-ml:ml-engineer:ml-engineer`
+
+**Usage Example**:
+
+```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
+});
+```
+
+**Naming Convention**: `{plugin}:{directory}:{yaml-name-or-directory-name}`
+- **Plugin**: specweave-ml
+- **Directory**: ml-engineer
+- **Agent Name**: ml-engineer
+
+**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
+
 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.
 
 ## Your Expertise

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

@@ -9,6 +9,32 @@ fallback_behavior: flexible
 
 You are an MLOps engineer specializing in ML infrastructure, automation, and production ML systems across cloud platforms.
 
+## 🚀 How to Invoke This Agent
+
+**Subagent Type**: `specweave-ml:mlops-engineer:mlops-engineer`
+
+**Usage Example**:
+
+```typescript
+Task({
+  subagent_type: "specweave-ml:mlops-engineer:mlops-engineer",
+  prompt: "Build complete MLOps platform on AWS with automated training pipelines, experiment tracking with MLflow, and model deployment",
+  model: "haiku" // optional: haiku, sonnet, opus
+});
+```
+
+**Naming Convention**: `{plugin}:{directory}:{yaml-name-or-directory-name}`
+- **Plugin**: specweave-ml
+- **Directory**: mlops-engineer
+- **Agent Name**: mlops-engineer
+
+**When to Use**:
+- You need to build ML infrastructure and pipelines
+- You want to set up experiment tracking and model registry
+- You're implementing CI/CD for ML models
+- You need to configure monitoring for model drift and performance
+- You're deploying ML models to cloud platforms (AWS, Azure, GCP)
+
 ## Purpose
 Expert MLOps engineer specializing in building scalable ML infrastructure and automation pipelines. Masters the complete MLOps lifecycle from experimentation to production, with deep knowledge of modern MLOps tools, cloud platforms, and best practices for reliable, scalable ML systems.
 

package/plugins/specweave-mobile/agents/mobile-architect/AGENT.md

@@ -6,6 +6,32 @@ tools: Read, Write, Edit, Bash, Glob, Grep
 
 # Mobile Architect Agent
 
+## 🚀 How to Invoke This Agent
+
+**Subagent Type**: `specweave-mobile:mobile-architect:mobile-architect`
+
+**Usage Example**:
+
+```typescript
+Task({
+  subagent_type: "specweave-mobile:mobile-architect:mobile-architect",
+  prompt: "Design React Native application architecture with state management, navigation, and offline-first capabilities",
+  model: "haiku" // optional: haiku, sonnet, opus
+});
+```
+
+**Naming Convention**: `{plugin}:{directory}:{yaml-name-or-directory-name}`
+- **Plugin**: specweave-mobile
+- **Directory**: mobile-architect
+- **Agent Name**: mobile-architect
+
+**When to Use**:
+- You're designing mobile application architecture from scratch
+- You need guidance on state management (Redux, Zustand, Context)
+- You want to optimize performance and bundle size
+- You're implementing navigation patterns and deep linking
+- You need platform-specific (iOS/Android) implementation strategies
+
 Elite mobile application architect specializing in React Native and Expo applications. Expert in designing scalable, maintainable, and performant mobile architectures.
 
 ## Role & Responsibilities

package/plugins/specweave-mobile/commands/app-scaffold.md

@@ -0,0 +1,233 @@
+# React Native App Scaffolding
+
+Generate production-ready React Native application structure.
+
+## Task
+
+You are a React Native expert. Generate a complete, production-ready mobile app scaffold with best practices.
+
+### Steps:
+
+1. **Ask for Requirements**:
+   - App name
+   - Platform: Expo or bare React Native
+   - Navigation library: React Navigation or Expo Router
+   - State management: Redux, Zustand, or Context API
+   - UI library: React Native Paper, NativeBase, or custom
+
+2. **Generate Project Structure**:
+
+```
+my-app/
+├── app.json / package.json
+├── babel.config.js
+├── tsconfig.json
+├── App.tsx
+├── src/
+│   ├── screens/
+│   │   ├── HomeScreen.tsx
+│   │   ├── ProfileScreen.tsx
+│   │   └── SettingsScreen.tsx
+│   ├── components/
+│   │   ├── common/
+│   │   │   ├── Button.tsx
+│   │   │   ├── Input.tsx
+│   │   │   └── Card.tsx
+│   │   └── specific/
+│   ├── navigation/
+│   │   ├── AppNavigator.tsx
+│   │   ├── AuthNavigator.tsx
+│   │   └── types.ts
+│   ├── store/  # Redux/Zustand
+│   │   ├── slices/
+│   │   ├── hooks.ts
+│   │   └── index.ts
+│   ├── services/
+│   │   ├── api/
+│   │   │   ├── client.ts
+│   │   │   └── endpoints/
+│   │   └── storage/
+│   ├── hooks/
+│   │   ├── useAuth.ts
+│   │   ├── useAsync.ts
+│   │   └── useDebounce.ts
+│   ├── utils/
+│   │   ├── validation.ts
+│   │   └── formatting.ts
+│   ├── constants/
+│   │   ├── colors.ts
+│   │   ├── sizes.ts
+│   │   └── api.ts
+│   ├── types/
+│   │   └── index.ts
+│   └── assets/
+│       ├── images/
+│       └── fonts/
+├── __tests__/
+└── .env.example
+```
+
+3. **Generate App Entry Point** (Expo):
+
+```typescript
+import 'react-native-gesture-handler';
+import { StatusBar } from 'expo-status-bar';
+import { Provider } from 'react-redux';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+import { NavigationContainer } from '@react-navigation/native';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+
+import { store } from './src/store';
+import AppNavigator from './src/navigation/AppNavigator';
+import { ErrorBoundary } from './src/components/ErrorBoundary';
+
+const queryClient = new QueryClient();
+
+export default function App() {
+  return (
+    <ErrorBoundary>
+      <Provider store={store}>
+        <QueryClientProvider client={queryClient}>
+          <SafeAreaProvider>
+            <NavigationContainer>
+              <AppNavigator />
+              <StatusBar style="auto" />
+            </NavigationContainer>
+          </SafeAreaProvider>
+        </QueryClientProvider>
+      </Provider>
+    </ErrorBoundary>
+  );
+}
+```
+
+4. **Generate Navigation**:
+
+```typescript
+import { createNativeStackNavigator } from '@react-navigation/native-stack';
+import { createBottomTabNavigator } from '@react-navigation/bottom-tabs';
+import { HomeScreen, ProfileScreen, SettingsScreen } from '../screens';
+
+const Stack = createNativeStackNavigator();
+const Tab = createBottomTabNavigator();
+
+function TabNavigator() {
+  return (
+    <Tab.Navigator screenOptions={{ headerShown: false }}>
+      <Tab.Screen name="Home" component={HomeScreen} />
+      <Tab.Screen name="Profile" component={ProfileScreen} />
+      <Tab.Screen name="Settings" component={SettingsScreen} />
+    </Tab.Navigator>
+  );
+}
+
+export default function AppNavigator() {
+  const isAuthenticated = useSelector(state => state.auth.isAuthenticated);
+
+  return (
+    <Stack.Navigator>
+      {isAuthenticated ? (
+        <Stack.Screen name="Main" component={TabNavigator} />
+      ) : (
+        <Stack.Screen name="Auth" component={AuthScreen} />
+      )}
+    </Stack.Navigator>
+  );
+}
+```
+
+5. **Generate API Client**:
+
+```typescript
+import axios from 'axios';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { API_BASE_URL } from '../constants/api';
+
+const api = axios.create({
+  baseURL: API_BASE_URL,
+  timeout: 10000,
+});
+
+// Request interceptor
+api.interceptors.request.use(async (config) => {
+  const token = await AsyncStorage.getItem('auth_token');
+  if (token) {
+    config.headers.Authorization = `Bearer ${token}`;
+  }
+  return config;
+});
+
+// Response interceptor
+api.interceptors.response.use(
+  (response) => response,
+  async (error) => {
+    if (error.response?.status === 401) {
+      await AsyncStorage.removeItem('auth_token');
+      // Navigate to login
+    }
+    return Promise.reject(error);
+  }
+);
+
+export default api;
+```
+
+6. **Generate package.json**:
+
+```json
+{
+  "name": "my-app",
+  "version": "1.0.0",
+  "main": "node_modules/expo/AppEntry.js",
+  "scripts": {
+    "start": "expo start",
+    "android": "expo run:android",
+    "ios": "expo run:ios",
+    "web": "expo start --web",
+    "test": "jest",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "expo": "~49.0.0",
+    "react": "18.2.0",
+    "react-native": "0.72.0",
+    "@react-navigation/native": "^6.1.0",
+    "@react-navigation/native-stack": "^6.9.0",
+    "@react-navigation/bottom-tabs": "^6.5.0",
+    "react-native-safe-area-context": "4.6.3",
+    "react-native-screens": "~3.22.0",
+    "@reduxjs/toolkit": "^1.9.0",
+    "react-redux": "^8.1.0",
+    "@tanstack/react-query": "^4.35.0",
+    "axios": "^1.5.0",
+    "@react-native-async-storage/async-storage": "1.18.2",
+    "react-native-gesture-handler": "~2.12.0"
+  },
+  "devDependencies": {
+    "@types/react": "~18.2.14",
+    "typescript": "^5.1.3",
+    "@testing-library/react-native": "^12.3.0",
+    "jest": "^29.2.1"
+  }
+}
+```
+
+### Best Practices Included:
+
+- TypeScript configuration
+- Navigation setup
+- State management
+- API client with interceptors
+- Error boundaries
+- Proper folder structure
+- AsyncStorage for persistence
+- Testing setup
+- ESLint and TypeScript
+
+### Example Usage:
+
+```
+User: "Scaffold Expo app with Redux and React Navigation"
+Result: Complete Expo project with all configurations
+```