@wipal/agent-team 1.0.0

package/.claude/skills/domain/devops/deployment/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: deployment
+description: |
+  Deployment strategies and patterns for production releases. Use when: deploying
+  to production, implementing blue/green or canary deployments, rolling updates,
+  or when user mentions "deploy", "release", "blue-green", "canary", "rollback".
+  Ensures safe, reliable production deployments.
+version: 1.0.0
+category: devops
+tags:
+  - deployment
+  - release
+  - blue-green
+  - canary
+  - rollback
+depends_on:
+  - ci-cd
+recommends:
+  - containerization
+  - monitoring
+used_by: []
+---
+
+# Skill: Deployment
+
+## Core Principle
+**Deploy safely, rollback quickly.** Every deployment should be reversible in seconds.
+
+## Hard Rules
+
+1. **NEVER deploy on Friday** - Unless you enjoy weekend debugging
+2. **NEVER skip rollback plan** - Know how to undo before you do
+3. **ALWAYS test in staging** - Production is not a testing ground
+4. **ALWAYS monitor after deploy** - Watch metrics for 15 minutes
+5. **ALWAYS have feature flags** - Decouple deploy from release
+
+## Deployment Strategies
+
+### 1. Rolling Update (Default)
+```
+┌───────┐     ┌───────┐     ┌───────┐
+│ v1    │ ──▶ │ v1/v2 │ ──▶ │ v2    │
+│ ─ ─ ─ │     │ ─ ─ ─ │     │ ─ ─ ─ │
+│ v1    │     │ v1    │     │ v2    │
+│ ─ ─ ─ │     │ ─ ─ ─ │     │ ─ ─ ─ │
+│ v1    │     │ v2    │     │ v2    │
+└───────┘     └───────┘     └───────┘
+   0%           50%           100%
+```
+
+### 2. Blue-Green
+```
+         ┌─────────────┐
+         │   Router    │
+         └──────┬──────┘
+          ┌─────┴─────┐
+          ▼           ▼
+    ┌──────────┐ ┌──────────┐
+    │  Blue    │ │  Green   │
+    │  (v1)    │ │  (v2)    │
+    │  LIVE    │ │  IDLE    │
+    └──────────┘ └──────────┘
+
+Switch traffic: Blue → Green
+Rollback: Green → Blue
+```
+
+### 3. Canary
+```
+┌───────────────────────────────────┐
+│           Load Balancer           │
+└───────────────┬───────────────────┘
+        ┌───────┴───────┐
+        ▼               ▼
+   ┌─────────┐    ┌──────────┐
+   │ Stable  │    │ Canary   │
+   │  v1     │    │  v2      │
+   │  95%    │    │  5%      │
+   └─────────┘    └──────────┘
+```
+
+## Kubernetes Rolling Update
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: myapp
+spec:
+  replicas: 3
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxSurge: 1          # Max pods over desired count
+      maxUnavailable: 0    # Max unavailable during update
+  template:
+    spec:
+      containers:
+        - name: app
+          image: myapp:v2
+          readinessProbe:
+            httpGet:
+              path: /health
+              port: 3000
+            initialDelaySeconds: 5
+            periodSeconds: 10
+```
+
+## Blue-Green with Kubernetes
+
+```yaml
+# blue-service.yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: myapp-blue
+spec:
+  selector:
+    app: myapp
+    version: blue
+---
+# green-service.yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: myapp-green
+spec:
+  selector:
+    app: myapp
+    version: green
+---
+# Switch by updating the active service selector
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Deploy without rollback plan | Document rollback steps first |
+| Deploy all at once | Gradual rollout (10% → 50% → 100%) |
+| No health checks | Add readiness/liveness probes |
+| Deploy on Friday | Deploy Tue-Thu |
+| No monitoring | Watch metrics for 15 min post-deploy |
+| Big bang deploys | Small, frequent deploys |
+
+## Deployment Checklist
+
+### Before
+- [ ] Rollback plan documented
+- [ ] Staging tested
+- [ ] Database migrations run
+- [ ] Feature flags ready
+- [ ] Team notified
+
+### During
+- [ ] Monitor error rates
+- [ ] Check latency metrics
+- [ ] Verify health checks pass
+- [ ] Monitor logs for errors
+
+### After
+- [ ] Verify all pods healthy
+- [ ] Check business metrics
+- [ ] Monitor for 15 minutes
+- [ ] Update changelog
+
+## Rollback Commands
+
+```bash
+# Kubernetes
+kubectl rollout undo deployment/myapp
+kubectl rollout undo deployment/myapp --to-revision=2
+
+# Check history
+kubectl rollout history deployment/myapp
+
+# ECS
+aws ecs update-service --cluster prod --service myapp --task-definition myapp:1
+```
+
+## Feature Flags
+
+```typescript
+// Decouple deploy from release
+if (featureFlags.isEnabled('new-checkout', user)) {
+  return <NewCheckout />;
+}
+return <LegacyCheckout />;
+```
+
+## Quick Checklist
+
+- [ ] Rollback plan exists
+- [ ] Gradual rollout enabled
+- [ ] Health checks configured
+- [ ] Monitoring active
+- [ ] Feature flags ready
+- [ ] Team notified

package/.claude/skills/domain/devops/infrastructure-as-code/SKILL.md

@@ -0,0 +1,178 @@
+---
+name: infrastructure-as-code
+description: |
+  Infrastructure as Code patterns using Terraform, Pulumi, CloudFormation.
+  Use when: provisioning cloud resources, managing infrastructure, creating
+  repeatable deployments, or when user mentions "Terraform", "IaC", "Pulumi",
+  "CloudFormation", "infrastructure", "provisioning".
+version: 1.0.0
+category: devops
+tags:
+  - terraform
+  - iac
+  - infrastructure
+  - cloud
+depends_on: []
+recommends:
+  - ci-cd
+  - deployment
+used_by:
+  - deployment
+---
+
+# Skill: Infrastructure as Code
+
+## Core Principle
+**Infrastructure is code.** Version control, review, test, and automate everything.
+
+## Hard Rules
+
+1. **NEVER commit state files** - Use remote state
+2. **NEVER hardcode secrets** - Use variables + secret managers
+3. **ALWAYS use modules** - DRY principle
+4. **ALWAYS tag resources** - Cost tracking, ownership
+5. **ALWAYS plan before apply** - Review changes first
+
+## Terraform Project Structure
+
+```
+terraform/
+├── modules/
+│   ├── vpc/
+│   ├── ecs/
+│   └── rds/
+├── environments/
+│   ├── dev/
+│   │   ├── main.tf
+│   │   ├── variables.tf
+│   │   └── terraform.tfvars
+│   └── prod/
+├── .terraform-version
+└── backend.hcl
+```
+
+## Module Template
+
+```hcl
+# modules/ecs/main.tf
+variable "environment" {
+  description = "Environment name"
+  type        = string
+}
+
+variable "cpu" {
+  description = "CPU units"
+  type        = number
+  default     = 256
+}
+
+variable "memory" {
+  description = "Memory in MB"
+  type        = number
+  default     = 512
+}
+
+resource "aws_ecs_service" "main" {
+  name            = "${var.environment}-app"
+  cluster         = var.cluster_id
+  task_definition = aws_ecs_task_definition.main.arn
+
+  tags = {
+    Environment = var.environment
+    ManagedBy   = "terraform"
+  }
+}
+
+output "service_arn" {
+  value = aws_ecs_service.main.arn
+}
+```
+
+## Remote State Configuration
+
+```hcl
+# backend.hcl
+terraform {
+  backend "s3" {
+    bucket         = "my-terraform-state"
+    key            = "env/dev/terraform.tfstate"
+    region         = "us-east-1"
+    encrypt        = true
+    dynamodb_table = "terraform-locks"
+  }
+}
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Local state files | Remote state (S3 + DynamoDB) |
+| Hardcoded values | Variables + tfvars |
+| No tagging | Add required tags |
+| Monolithic configs | Use modules |
+| Manual changes | Always use Terraform |
+| No state locking | Enable DynamoDB locks |
+
+## Best Practices
+
+### Naming Convention
+```hcl
+# {environment}-{service}-{resource}
+resource "aws_instance" "web" {
+  # dev-webserver-ec2
+  tags = {
+    Name = "${var.environment}-webserver-ec2"
+  }
+}
+```
+
+### Required Tags
+```hcl
+variable "common_tags" {
+  type = map(string)
+  default = {
+    Project     = "myapp"
+    ManagedBy   = "terraform"
+    CostCenter  = "engineering"
+  }
+}
+```
+
+## Workflow
+
+```bash
+# 1. Initialize
+terraform init
+
+# 2. Plan (always review)
+terraform plan -out=tfplan
+
+# 3. Apply (after review)
+terraform apply tfplan
+
+# 4. Destroy (when needed)
+terraform destroy -target=aws_instance.web
+```
+
+## CI/CD Integration
+
+```yaml
+# .github/workflows/terraform.yml
+- name: Terraform Plan
+  run: terraform plan -no-color -out=tfplan
+
+- name: Terraform Apply
+  if: github.ref == 'refs/heads/main'
+  run: terraform apply -auto-approve tfplan
+```
+
+## Quick Checklist
+
+- [ ] Remote state configured
+- [ ] State locking enabled
+- [ ] Secrets in variables
+- [ ] Resources tagged
+- [ ] Modules used
+- [ ] Plan before apply
+- [ ] .tfvars in .gitignore

package/.claude/skills/domain/devops/monitoring/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: monitoring
+description: |
+  Application and infrastructure monitoring with Prometheus, Grafana, Datadog.
+  Use when: setting up observability, creating dashboards, configuring alerts,
+  or when user mentions "monitoring", "metrics", "observability", "Prometheus",
+  "Grafana", "alerts", "dashboard". Ensures visibility into system health.
+version: 1.0.0
+category: devops
+tags:
+  - monitoring
+  - observability
+  - prometheus
+  - grafana
+  - alerts
+depends_on: []
+recommends:
+  - deployment
+used_by: []
+---
+
+# Skill: Monitoring
+
+## Core Principle
+**You can't fix what you can't see.** Observability is not optional—it's essential.
+
+## The Three Pillars
+
+| Pillar | Tool | Purpose |
+|--------|------|---------|
+| **Metrics** | Prometheus | Numbers over time |
+| **Logs** | Loki/ELK | What happened |
+| **Traces** | Jaeger | Where time spent |
+
+## RED Method (Services)
+
+- **Rate** - Requests per second
+- **Errors** - Error rate
+- **Duration** - Latency distribution
+
+## USE Method (Resources)
+
+- **Utilization** - % time busy
+- **Saturation** - Queue length
+- **Errors** - Error count
+
+## Prometheus Metrics
+
+```typescript
+// Application instrumentation
+import { Counter, Histogram, Gauge } from 'prom-client';
+
+// Counter: Things that increase
+const httpRequestsTotal = new Counter({
+  name: 'http_requests_total',
+  help: 'Total HTTP requests',
+  labelNames: ['method', 'path', 'status'],
+});
+
+// Histogram: Distributions (latency)
+const httpRequestDuration = new Histogram({
+  name: 'http_request_duration_seconds',
+  help: 'HTTP request duration',
+  labelNames: ['method', 'path'],
+  buckets: [0.01, 0.05, 0.1, 0.5, 1, 5],
+});
+
+// Gauge: Current state
+const activeConnections = new Gauge({
+  name: 'active_connections',
+  help: 'Active connections',
+});
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| Too many metrics | Focus on RED/USE |
+| No alerts | Alert on symptoms |
+| Alert fatigue | Reduce noise, severity |
+| No dashboards | Pre-built dashboards |
+| Missing context | Add labels |
+
+## Alerting Rules
+
+```yaml
+# Prometheus alerting rules
+groups:
+  - name: application
+    rules:
+      - alert: HighErrorRate
+        expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.05
+        for: 5m
+        labels:
+          severity: critical
+        annotations:
+          summary: "High error rate on {{ $labels.service }}"
+          description: "Error rate is {{ $value }} requests/s"
+
+      - alert: HighLatency
+        expr: histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m])) > 1
+        for: 5m
+        labels:
+          severity: warning
+```
+
+## Grafana Dashboard
+
+```json
+{
+  "title": "Application Overview",
+  "panels": [
+    {
+      "title": "Request Rate",
+      "type": "graph",
+      "targets": [
+        {
+          "expr": "rate(http_requests_total[5m])",
+          "legendFormat": "{{method}} {{path}}"
+        }
+      ]
+    },
+    {
+      "title": "Error Rate",
+      "type": "stat",
+      "targets": [
+        {
+          "expr": "rate(http_requests_total{status=~\"5..\"}[5m]) / rate(http_requests_total[5m]) * 100"
+        }
+      ]
+    },
+    {
+      "title": "P99 Latency",
+      "type": "graph",
+      "targets": [
+        {
+          "expr": "histogram_quantile(0.99, rate(http_request_duration_seconds_bucket[5m]))"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## SLO/SLI/SLA Framework
+
+```
+SLA = Agreement (99.9% uptime)
+  ↓
+SLO = Objective (99.9% uptime this month)
+  ↓
+SLI = Indicator (successful requests / total requests)
+```
+
+## Quick Checklist
+
+- [ ] RED metrics instrumented
+- [ ] Alerts configured
+- [ ] Dashboards created
+- [ ] Runbooks linked to alerts
+- [ ] Log aggregation setup
+- [ ] Distributed tracing enabled

package/.claude/skills/domain/frontend/accessibility/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: accessibility
+description: |
+  WCAG compliance and accessibility best practices. Use when: building UI
+  components, ensuring keyboard navigation, screen reader support, or when
+  user mentions "accessibility", "a11y", "WCAG", "ARIA", "keyboard", "screen reader".
+  Accessibility is not optional - build for everyone.
+version: 1.0.0
+category: frontend
+tags:
+  - accessibility
+  - a11y
+  - wcag
+  - aria
+depends_on:
+  - frontend-design
+recommends: []
+used_by: []
+---
+
+# Skill: Accessibility
+
+## Core Principle
+**Build for everyone.** 15% of users have disabilities. Accessible code is better code.
+
+## WCAG Principles (POUR)
+
+| Principle | Description | Examples |
+|-----------|-------------|----------|
+| **Perceivable** | Users can see/hear content | Alt text, captions |
+| **Operable** | Users can navigate | Keyboard, focus |
+| **Understandable** | Users can understand | Clear language, labels |
+| **Robust** | Works with assistive tech | ARIA, semantic HTML |
+
+## Hard Rules
+
+1. **NEVER rely on color alone** - Always have text/icons
+2. **NEVER skip heading levels** - h1 → h2 → h3
+3. **ALWAYS have alt text** - For meaningful images
+4. **ALWAYS support keyboard** - All interactions
+5. **ALWAYS use semantic HTML** - Not just divs
+
+## Semantic HTML
+
+```tsx
+// ❌ Bad: Non-semantic
+<div onClick={handleClick}>Submit</div>
+
+// ✅ Good: Semantic
+<button onClick={handleClick}>Submit</button>
+```
+
+## ARIA Patterns
+
+### Labels
+
+```tsx
+// Icon button needs label
+<button aria-label="Close menu">
+  <XIcon />
+</button>
+
+// Input with label
+<label htmlFor="email">Email address</label>
+<input id="email" type="email" aria-describedby="email-hint" />
+<span id="email-hint">We'll never share your email</span>
+```
+
+### Live Regions
+
+```tsx
+// Announce changes
+<div role="status" aria-live="polite">
+  {message}
+</div>
+
+// Alert important info
+<div role="alert" aria-live="assertive">
+  {errorMessage}
+</div>
+```
+
+### Dialogs
+
+```tsx
+<dialog
+  role="dialog"
+  aria-modal="true"
+  aria-labelledby="dialog-title"
+>
+  <h2 id="dialog-title">Confirm Delete</h2>
+  {/* Trap focus, handle Escape */}
+</dialog>
+```
+
+## Common Mistakes
+
+| ❌ Mistake | ✅ Fix |
+|------------|--------|
+| `<div onClick>` | `<button onClick>` |
+| Color only indication | Add icon + text |
+| Missing alt text | `alt="description"` |
+| Skip heading levels | h1 → h2 → h3 |
+| No focus indicator | `:focus-visible` |
+| Mouse-only interactions | Keyboard support |
+
+## Focus Management
+
+```css
+/* Visible focus indicator */
+:focus-visible {
+  outline: 2px solid #007bff;
+  outline-offset: 2px;
+}
+
+/* Skip link */
+.skip-link {
+  position: absolute;
+  top: -40px;
+}
+.skip-link:focus {
+  top: 0;
+}
+```
+
+```tsx
+// Focus trap for modals
+import { FocusTrap } from '@react-aria/focus';
+
+<FocusTrap>
+  <Modal>{children}</Modal>
+</FocusTrap>
+```
+
+## Keyboard Navigation
+
+| Key | Action |
+|-----|--------|
+| Tab | Next focusable |
+| Shift+Tab | Previous focusable |
+| Enter/Space | Activate button |
+| Escape | Close modal |
+| Arrow keys | Navigate lists |
+
+## Form Accessibility
+
+```tsx
+<fieldset>
+  <legend>Shipping Method</legend>
+  <label>
+    <input type="radio" name="shipping" value="standard" />
+    Standard (5-7 days)
+  </label>
+  <label>
+    <input type="radio" name="shipping" value="express" />
+    Express (2-3 days)
+  </label>
+</fieldset>
+```
+
+## Testing Checklist
+
+- [ ] Keyboard navigation works
+- [ ] Focus visible on all interactive
+- [ ] Screen reader announces content
+- [ ] Color contrast 4.5:1 (WCAG AA)
+- [ ] Form labels present
+- [ ] Error messages announced
+- [ ] No autoplay media
+
+## Quick Audit
+
+```bash
+# Run accessibility audit
+npx axe-cli https://yoursite.com
+
+# Lighthouse accessibility
+npx lighthouse https://yoursite.com --only-categories=accessibility
+```