specweave 0.23.16 → 0.24.0

package/plugins/specweave-cost-optimizer/skills/cloud-pricing/SKILL.md

@@ -0,0 +1,325 @@
+---
+name: cloud-pricing
+description: Expert knowledge of cloud provider pricing models for AWS, Azure, GCP covering compute, storage, database, networking, and serverless services. Includes 2025 pricing data, regional differences, free tiers, pricing calculators, and cost comparison across providers. Activates for cloud pricing, how much does it cost, price comparison, AWS vs Azure vs GCP pricing, pricing calculator, estimate costs, regional pricing, free tier, what's cheaper.
+---
+
+# Cloud Pricing Expert
+
+Expert knowledge of cloud provider pricing models across AWS, Azure, and GCP with current 2025 pricing data.
+
+## Compute Pricing (2025)
+
+### AWS EC2 (us-east-1)
+```yaml
+t3.micro:   $0.0104/hour  (2 vCPU, 1GB)
+t3.small:   $0.0208/hour  (2 vCPU, 2GB)
+t3.medium:  $0.0416/hour  (2 vCPU, 4GB)
+t3.large:   $0.0832/hour  (2 vCPU, 8GB)
+m5.large:   $0.096/hour   (2 vCPU, 8GB)
+c5.large:   $0.085/hour   (2 vCPU, 4GB) - compute-optimized
+r5.large:   $0.126/hour   (2 vCPU, 16GB) - memory-optimized
+
+Spot pricing: 50-90% discount (variable)
+Reserved (1yr): 35-40% discount
+Reserved (3yr): 60-65% discount
+Savings Plans: 30-70% discount (flexible)
+```
+
+### Azure VMs (East US)
+```yaml
+B1s:     $0.0104/hour  (1 vCPU, 1GB) - burstable
+B2s:     $0.0416/hour  (2 vCPU, 4GB)
+D2s v5:  $0.096/hour   (2 vCPU, 8GB)
+F2s v2:  $0.085/hour   (2 vCPU, 4GB) - compute-optimized
+E2s v5:  $0.126/hour   (2 vCPU, 16GB) - memory-optimized
+
+Spot: 50-90% discount
+Reserved (1yr): 40% discount  
+Reserved (3yr): 62% discount
+```
+
+### GCP Compute Engine (us-central1)
+```yaml
+e2-micro:   $0.0084/hour  (0.25-2 vCPU, 1GB)
+e2-small:   $0.0168/hour  (0.5-2 vCPU, 2GB)
+e2-medium:  $0.0335/hour  (1-2 vCPU, 4GB)
+n2-standard-2: $0.0971/hour (2 vCPU, 8GB)
+c2-standard-4: $0.2088/hour (4 vCPU, 16GB) - compute
+
+Preemptible: 60-91% discount
+Committed (1yr): 37% discount
+Committed (3yr): 55% discount
+```
+
+## Serverless Pricing
+
+### AWS Lambda
+```yaml
+Requests: $0.20 per 1M requests
+Compute:
+  - $0.0000166667 per GB-second
+  - 128MB, 1s = $0.0000021
+  - 1024MB, 1s = $0.0000166667
+
+Free tier: 1M requests, 400K GB-seconds/month
+
+Example: 10M requests, 512MB, 200ms avg
+  = 10M * $0.20/1M + 10M * 0.5GB * 0.2s * $0.0000166667
+  = $2 + $16.67 = $18.67/month
+```
+
+### Azure Functions
+```yaml
+Consumption Plan:
+  - $0.20 per 1M executions
+  - $0.000016 per GB-second
+  
+Premium Plan (always-on):
+  - EP1: $0.2065/hour (1 vCPU, 3.5GB)
+  - EP2: $0.413/hour (2 vCPU, 7GB)
+
+Free tier: 1M requests, 400K GB-seconds
+```
+
+### GCP Cloud Functions
+```yaml
+Invocations: $0.40 per 1M invocations
+Compute: $0.0000025 per GB-second
+Networking: $0.12/GB egress
+
+Free tier: 2M invocations, 400K GB-seconds
+```
+
+## Storage Pricing
+
+### AWS S3 (us-east-1)
+```yaml
+Standard:           $0.023/GB/month
+Standard-IA:        $0.0125/GB  (54% cheaper, min 128KB, 30 days)
+Glacier Instant:    $0.004/GB   (83% cheaper, min 128KB, 90 days)
+Glacier Flexible:   $0.0036/GB  (84% cheaper, 90 days, 1-5min retrieval)
+Deep Archive:       $0.00099/GB (96% cheaper, 180 days, 12hr retrieval)
+
+Requests:
+  - PUT/COPY/POST: $0.005 per 1K requests
+  - GET/SELECT: $0.0004 per 1K requests
+
+Data Transfer: $0.09/GB out to internet (first 10TB)
+```
+
+### Azure Blob Storage
+```yaml
+Hot:     $0.0184/GB  (frequent access)
+Cool:    $0.01/GB    (min 30 days)
+Archive: $0.00099/GB (min 180 days, 15hr retrieval)
+
+Transactions:
+  - Write: $0.05 per 10K
+  - Read: $0.004 per 10K
+```
+
+### GCP Cloud Storage
+```yaml
+Standard:  $0.020/GB
+Nearline:  $0.010/GB (min 30 days)
+Coldline:  $0.004/GB (min 90 days)
+Archive:   $0.0012/GB (min 365 days)
+
+Operations: $0.05 per 10K Class A (write)
+            $0.004 per 10K Class B (read)
+```
+
+## Database Pricing
+
+### AWS RDS PostgreSQL (db.t3.medium)
+```yaml
+On-demand:      $0.068/hour ($49.64/month)
+Reserved 1yr:   $0.043/hour (37% savings)
+Reserved 3yr:   $0.029/hour (57% savings)
+
+Storage (gp3): $0.115/GB/month
+Backup:        $0.095/GB/month
+
+Aurora Serverless: $0.12 per ACU-hour (auto-scaling)
+```
+
+### Azure SQL Database
+```yaml
+General Purpose (2 vCore):
+  - Provisioned: $0.5556/hour ($406/month)
+  - Serverless: $0.75-1.50/vCore-hour (auto-pause)
+  
+Storage: $0.115/GB/month
+```
+
+### GCP Cloud SQL PostgreSQL
+```yaml
+db-n1-standard-1 (1 vCPU, 3.75GB):
+  - On-demand: $0.0413/hour ($30.15/month)
+  - Committed 1yr: 37% discount
+  
+Storage (SSD): $0.17/GB/month
+```
+
+### DynamoDB / Cosmos DB / Firestore
+```yaml
+DynamoDB (us-east-1):
+  - On-demand: $1.25 per 1M read, $1.25 per 1M write
+  - Provisioned: $0.00065/hour per RCU, $0.00065/hour per WCU
+  - Storage: $0.25/GB
+
+Cosmos DB:
+  - Provisioned: $0.008/hour per 100 RU/s
+  - Serverless: $0.25 per 1M RU
+  
+Firestore:
+  - Reads: $0.06 per 100K
+  - Writes: $0.18 per 100K
+  - Storage: $0.18/GB
+```
+
+## Networking Pricing
+
+### Data Transfer (AWS, per GB)
+```yaml
+Internet egress (us-east-1):
+  - First 10TB:    $0.09/GB
+  - 10-50TB:       $0.085/GB
+  - 50-150TB:      $0.070/GB
+  
+Cross-region:      $0.02/GB
+Same AZ:           Free
+VPC peering:       $0.01/GB
+
+NAT Gateway:
+  - $0.045/hour
+  - $0.045/GB processed
+```
+
+### CDN Pricing
+```yaml
+CloudFront (per GB):
+  - First 10TB:  $0.085/GB
+  - 10-50TB:     $0.080/GB
+  
+Azure CDN:
+  - First 10TB:  $0.081/GB
+  
+Cloud CDN:
+  - First 10TB:  $0.085/GB
+```
+
+## Price Comparison Examples
+
+### Example 1: Simple Web Application
+```typescript
+const requirements = {
+  compute: '2 x t3.medium (24/7)',
+  storage: '100GB SSD',
+  database: 'PostgreSQL (db.t3.medium)',
+  traffic: '1TB/month egress',
+};
+
+const costs = {
+  aws: {
+    ec2: 2 * 0.0416 * 730 = 60.74,
+    ebs: 100 * 0.10 = 10,
+    rds: 49.64 + (20 * 0.115) = 51.94,
+    transfer: 1000 * 0.09 = 90,
+    total: 212.68,
+  },
+  azure: {
+    vm: 2 * 0.0416 * 730 = 60.74,
+    disk: 100 * 0.048 = 4.80,
+    sql: 406, // Managed SQL more expensive
+    transfer: 1000 * 0.087 = 87,
+    total: 558.54,
+  },
+  gcp: {
+    compute: 2 * 0.0335 * 730 = 48.91,
+    disk: 100 * 0.17 = 17,
+    sql: 30.15 + (20 * 0.17) = 33.55,
+    transfer: 1000 * 0.12 = 120,
+    total: 219.46,
+  },
+};
+
+// Winner: AWS ($212.68/month)
+// With Reserved Instances (1yr): $140/month (34% savings)
+```
+
+### Example 2: Serverless API
+```typescript
+const requirements = {
+  requests: '50M/month',
+  avgDuration: '200ms',
+  avgMemory: '512MB',
+};
+
+const lambda = {
+  requests: 50 * 0.20 = 10,
+  compute: 50e6 * 0.5 * 0.2 * 0.0000166667 = 83.33,
+  total: 93.33,
+};
+
+const azureFunctions = {
+  executions: 50 * 0.20 = 10,
+  compute: 50e6 * 0.5 * 0.2 * 0.000016 = 80,
+  total: 90,
+};
+
+const cloudFunctions = {
+  invocations: 50 * 0.40 = 20,
+  compute: 50e6 * 0.5 * 0.2 * 0.0000025 = 12.5,
+  networking: 1000 * 0.12 = 120, // 1TB egress
+  total: 152.50,
+};
+
+// Winner: Azure Functions ($90/month)
+```
+
+## Free Tiers (Always Free, 2025)
+
+### AWS
+```yaml
+EC2: 750 hours/month t2.micro (1 year)
+Lambda: 1M requests, 400K GB-seconds
+S3: 5GB storage (12 months)
+DynamoDB: 25GB storage, 25 read/write units
+RDS: 750 hours db.t2.micro (12 months)
+CloudFront: 1TB transfer (12 months)
+```
+
+### Azure
+```yaml
+App Service: 10 web apps
+Functions: 1M requests/month
+Blob Storage: 5GB (12 months)
+Cosmos DB: 1000 RU/s, 25GB
+SQL Database: 100K vCore-seconds (12 months)
+```
+
+### GCP
+```yaml
+Compute: 1 f1-micro instance (744 hours/month)
+Cloud Functions: 2M invocations, 400K GB-seconds
+Cloud Storage: 5GB standard
+Cloud Run: 2M requests, 360K GB-seconds
+Firestore: 1GB storage, 50K reads, 20K writes
+```
+
+## Pricing Calculators
+
+**AWS Pricing Calculator**: https://calculator.aws
+**Azure Pricing Calculator**: https://azure.microsoft.com/pricing/calculator
+**GCP Pricing Calculator**: https://cloud.google.com/products/calculator
+
+## Regional Pricing Differences
+
+**Most Expensive**: Asia Pacific (Tokyo, Sydney)
+**Cheapest**: US regions (us-east-1, us-west-2)
+**Middle**: Europe (eu-west-1, eu-central-1)
+
+Difference: 10-30% higher in APAC vs US East
+
+Make informed pricing decisions with up-to-date cost data!

package/plugins/specweave-cost-optimizer/skills/cost-optimization/SKILL.md

@@ -0,0 +1,337 @@
+---
+name: cost-optimization
+description: Expert cloud cost optimization strategies for AWS, Azure, GCP, and serverless platforms. Covers FinOps principles, right-sizing, reserved instances, savings plans, spot instances, storage optimization, database cost reduction, serverless cost modeling, budget management, cost allocation, chargeback models, and continuous cost optimization. Activates for cost optimization, cloud costs, reduce costs, save money, finops, cost analysis, budget overrun, expensive cloud bill, cost savings, reserved instances, spot instances, savings plans, right-sizing, cost allocation tags, chargeback, showback.
+---
+
+# Cloud Cost Optimization Expert
+
+You are an expert FinOps engineer specializing in cloud cost optimization across AWS, Azure, and GCP with deep knowledge of 2024/2025 pricing models and optimization strategies.
+
+## Core Expertise
+
+### 1. FinOps Principles
+
+**Foundation**:
+- Visibility: Centralized cost reporting
+- Optimization: Continuous improvement
+- Accountability: Team ownership
+- Forecasting: Predictive budgeting
+
+**FinOps Phases**:
+1. **Inform**: Visibility, allocation, benchmarking
+2. **Optimize**: Right-sizing, commitment discounts, waste reduction
+3. **Operate**: Continuous automation, governance
+
+### 2. Compute Cost Optimization
+
+**EC2/VM/Compute Engine**:
+- Right-sizing (CPU, memory, network utilization analysis)
+- Reserved Instances (1-year, 3-year commitments, 30-70% savings)
+- Savings Plans (compute, EC2, flexible commitments)
+- Spot/Preemptible Instances (50-90% discounts for fault-tolerant workloads)
+- Auto-scaling groups (scale to demand)
+- Graviton/Ampere processors (20-40% price-performance improvement)
+
+**Container Optimization**:
+- ECS/EKS/AKS/GKE: Fargate vs EC2 cost comparison
+- Kubernetes: Pod autoscaling (HPA, VPA, KEDA)
+- Spot nodes for batch workloads
+- Right-size pod resource requests/limits
+
+### 3. Serverless Cost Optimization
+
+**AWS Lambda / Azure Functions / Cloud Functions**:
+```typescript
+// Memory optimization (more memory = faster CPU = potentially cheaper)
+const optimization = {
+  function: 'imageProcessor',
+  currentConfig: { memory: 512, duration: 5000, cost: 0.00001667 },
+  optimalConfig: { memory: 1024, duration: 2800, cost: 0.00001456 },
+  savings: 12.6, // % per invocation
+};
+
+// Optimization strategies
+- Memory tuning (128MB - 10GB)
+- Provisioned concurrency vs on-demand (predictable latency)
+- Duration optimization (faster code = cheaper)
+- Avoid VPC Lambda unless needed (NAT costs)
+- Use Lambda SnapStart (Java) or container reuse
+- Batch processing vs streaming
+```
+
+**API Gateway / App Gateway**:
+- HTTP API vs REST API (70% cheaper)
+- Caching responses (reduce backend invocations)
+- Request throttling
+
+### 4. Storage Cost Optimization
+
+**S3 / Blob Storage / Cloud Storage**:
+```yaml
+Lifecycle Policies:
+  - Standard (frequent access): $0.023/GB/month
+  - Infrequent Access: $0.0125/GB (54% cheaper, min 30 days)
+  - Glacier Instant Retrieval: $0.004/GB (83% cheaper)
+  - Glacier Flexible: $0.0036/GB (84% cheaper, 1-5min retrieval)
+  - Deep Archive: $0.00099/GB (96% cheaper, 12hr retrieval)
+
+Optimization:
+  - Auto-transition to IA after 30 days
+  - Archive logs to Glacier after 90 days
+  - Deep Archive compliance data after 1 year
+  - Delete old data (7-year retention)
+  - Intelligent-Tiering for unpredictable access
+```
+
+**EBS / Managed Disks / Persistent Disk**:
+- gp3 vs gp2 (20% cheaper, 20% faster baseline)
+- Snapshot lifecycle management (delete old AMIs)
+- Resize volumes (no over-provisioning)
+- Throughput optimization (gp3 customizable)
+
+### 5. Database Cost Optimization
+
+**RDS / SQL Database / Cloud SQL**:
+```typescript
+const optimizations = [
+  {
+    strategy: 'Reserved Instances',
+    savings: '35-65%',
+    commitment: '1 or 3 years',
+  },
+  {
+    strategy: 'Right-size instance',
+    savings: '30-50%',
+    action: 'Monitor CPU, IOPS, connections',
+  },
+  {
+    strategy: 'Aurora Serverless',
+    savings: '90% for intermittent workloads',
+    useCases: ['Dev/test', 'Seasonal apps'],
+  },
+  {
+    strategy: 'Read replicas',
+    savings: 'Offload reads, smaller primary',
+    useCases: ['Analytics', 'Reporting'],
+  },
+];
+```
+
+**DynamoDB / Cosmos DB / Firestore**:
+- On-demand vs provisioned (predictable traffic = provisioned)
+- Reserved capacity (1-year commitment, 50% savings)
+- TTL for automatic data deletion
+- Sparse indexes (reduce storage)
+
+### 6. Networking Cost Optimization
+
+**Data Transfer**:
+```yaml
+Costs (AWS us-east-1):
+  - Internet egress: $0.09/GB (first 10TB)
+  - Inter-region: $0.02/GB
+  - Same AZ: Free
+  - VPC peering: $0.01/GB
+  - NAT Gateway: $0.045/GB + $0.045/hour
+
+Optimization:
+  - Use CloudFront/CDN (caching reduces origin requests)
+  - Same-region architecture (avoid cross-region)
+  - VPC endpoints for AWS services (no NAT costs)
+  - Direct Connect for high-volume transfers
+  - Compress data before transfer
+```
+
+### 7. Cost Allocation & Tagging
+
+**Tagging Strategy**:
+```yaml
+required_tags:
+  Environment: [prod, staging, dev]
+  Team: [platform, api, frontend]
+  Project: [alpha, beta]
+  CostCenter: [engineering, product]
+  Owner: [email]
+
+enforcement:
+  - AWS Config rules (deny untagged resources)
+  - Terraform validation
+  - Monthly untagged resource report
+```
+
+**Chargeback Model**:
+```typescript
+interface Chargeback {
+  team: string;
+  month: string;
+  costs: {
+    compute: number;
+    storage: number;
+    network: number;
+    database: number;
+  };
+  budget: number;
+  variance: number; // %
+  recommendations: string[];
+}
+
+// Show-back (informational) vs Chargeback (actual billing)
+```
+
+### 8. Savings Plans & Commitments
+
+**AWS Savings Plans**:
+- Compute Savings Plans (most flexible, EC2 + Fargate + Lambda)
+- EC2 Instance Savings Plans (specific instance family)
+- SageMaker Savings Plans
+
+**Azure Reserved Instances**:
+- VM Reserved Instances
+- SQL Database reserved capacity
+- Cosmos DB reserved capacity
+
+**GCP Committed Use Discounts**:
+- Compute Engine CUDs (1-year, 3-year)
+- Cloud SQL commitments
+
+**Decision Matrix**:
+```typescript
+// When to use Reserved Instances vs Savings Plans
+const decision = (usage: UsagePattern) => {
+  if (usage.consistency > 70 && usage.predictable) {
+    return 'Reserved Instances'; // Max savings, no flexibility
+  } else if (usage.consistency > 50 && usage.variesByType) {
+    return 'Savings Plans'; // Good savings, flexible
+  } else {
+    return 'On-demand + Spot'; // Unpredictable workloads
+  }
+};
+```
+
+### 9. Cost Anomaly Detection
+
+**Alert Thresholds**:
+```yaml
+anomaly_detection:
+  - metric: daily_cost
+    threshold: 20%  # Alert if 20% above baseline
+    baseline: 7-day rolling average
+    
+  - metric: service_cost
+    threshold: 50%  # Alert if service cost spikes
+    baseline: Previous month
+    
+budgets:
+  - name: Production
+    limit: 30000
+    alerts: [80%, 90%, 100%]
+```
+
+### 10. Continuous Optimization
+
+**Monthly Cadence**:
+```markdown
+Week 1: Cost Review
+- Compare to budget
+- Identify anomalies
+- Tag compliance check
+
+Week 2: Optimization Planning
+- Review right-sizing recommendations
+- Evaluate RI/SP coverage
+- Identify waste (idle resources)
+
+Week 3: Implementation
+- Execute approved optimizations
+- Purchase commitments
+- Clean up waste
+
+Week 4: Validation
+- Measure savings
+- Update forecasts
+- Report to stakeholders
+```
+
+## Best Practices
+
+### Quick Wins (Immediate Savings)
+
+1. **Terminate Idle Resources**: 5-15% savings
+   - Stopped instances older than 7 days
+   - Unattached EBS volumes
+   - Unused Load Balancers
+   - Old snapshots/AMIs
+
+2. **Right-size Over-provisioned**: 15-30% savings
+   - Instances with < 20% CPU utilization
+   - Over-provisioned memory
+   - Excessive IOPS
+
+3. **Storage Lifecycle**: 20-50% savings
+   - S3/Blob lifecycle policies
+   - Delete old logs/backups
+   - Compress data
+
+4. **Reserved Instance Coverage**: 30-70% savings
+   - Purchase for steady-state workloads
+   - Start with 1-year commitments
+   - Analyze 3-month usage trends
+
+### Architecture Patterns for Cost
+
+**Serverless-First**:
+- No idle costs (pay per use)
+- Auto-scaling included
+- Best for: APIs, ETL, event processing
+
+**Spot/Preemptible for Batch**:
+- 50-90% discounts
+- Best for: CI/CD, data processing, ML training
+
+**Multi-tier Storage**:
+- Hot (frequently accessed) → Standard
+- Warm (occasional) → IA/Cool
+- Cold (archive) → Glacier/Archive
+
+### Common Mistakes
+
+❌ **Don't**:
+- Over-provision "just in case"
+- Ignore tagging discipline
+- Purchase 3-year RIs without analysis
+- Run production 24/7 without auto-scaling
+- Store all data in highest-cost tier
+
+✅ **Do**:
+- Monitor and right-size continuously
+- Tag everything for cost allocation
+- Start with 1-year commitments
+- Use auto-scaling + schedule-based scaling
+- Implement storage lifecycle policies
+
+## Tools & Resources
+
+**AWS**:
+- Cost Explorer (historical analysis)
+- Compute Optimizer (right-sizing)
+- Trusted Advisor (best practices)
+- Cost Anomaly Detection
+
+**Azure**:
+- Cost Management + Billing
+- Azure Advisor (recommendations)
+- Azure Pricing Calculator
+
+**GCP**:
+- Cloud Billing Reports
+- Recommender (optimization suggestions)
+- Active Assist
+
+**Third-party**:
+- CloudHealth, CloudCheckr (multi-cloud)
+- Spot.io (spot instance management)
+- Vantage, CloudZero (cost visibility)
+
+**Calculate ROI**: Savings vs engineer time spent optimizing
+
+You are ready to optimize cloud costs like a FinOps expert!

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

@@ -1,7 +1,7 @@
 {
   "name": "specweave-diagrams",
   "description": "Architecture diagram generation with Mermaid following C4 Model conventions. Creates C4 Context/Container/Component diagrams, sequence diagrams, ER diagrams, and deployment diagrams. SpecWeave-aware for HLD/LLD documentation.",
-  "version": "0.22.14",
+  "version": "0.24.0",
   "author": {
     "name": "SpecWeave Team",
     "url": "https://spec-weave.com"

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

@@ -8,6 +8,29 @@ cost_profile: hybrid
 fallback_behavior: auto
 ---
 
+## 🚀 How to Invoke This Agent
+
+**Subagent Type**: `specweave-diagrams:diagrams-architect:diagrams-architect`
+
+**Usage Example**:
+
+```typescript
+Task({
+  subagent_type: "specweave-diagrams:diagrams-architect:diagrams-architect",
+  prompt: "Your task description here",
+  model: "haiku" // optional: haiku, sonnet, opus
+});
+```
+
+**Naming Convention**: `{plugin}:{directory}:{yaml-name}`
+- **Plugin**: specweave-diagrams
+- **Directory**: diagrams-architect
+- **YAML Name**: diagrams-architect
+
+**When to Use**:
+- [TODO: Describe specific use cases for this agent]
+- [TODO: When should this agent be invoked instead of others?]
+- [TODO: What problems does this agent solve?]
 # Diagrams Architect Agent
 
 You are an expert diagram architect specializing in creating production-quality Mermaid diagrams following the C4 Model and SpecWeave conventions.