From 8879465553a51532919b9a7bf34306f8b76c6135 Mon Sep 17 00:00:00 2001
From: Seth Hobson <wshobson@gmail.com>
Date: Tue, 16 Dec 2025 16:26:42 -0500
Subject: [PATCH] docs: add new agents and skills to reference documentation

Add 5 new agents to docs/agents.md:
- service-mesh-expert, event-sourcing-architect, vector-database-engineer
- monorepo-architect, threat-modeling-expert

Update docs/agent-skills.md with all new skills:
- LLM Application Development: +4 vector database skills (8 total)
- Backend Development: +4 event sourcing skills (9 total)
- Cloud Infrastructure: +4 service mesh skills (8 total)
- Developer Essentials: +3 monorepo skills (11 total)
- Security Scanning: +4 threat modeling skills (5 total)

Add 10 new plugin skill sections:
- Accessibility Compliance, Business Analytics, Data Engineering
- Documentation Generation, Frontend Mobile Development, Game Development
- HR Legal Compliance, Incident Response, Quantitative Trading
- Systems Programming

Update model distribution to three-tier strategy (Opus/Sonnet/Haiku)
---
 docs/agent-skills.md | 106 +++++++++++++++++++++++++++++++++++++++++--
 docs/agents.md       |  10 +++-
 2 files changed, 109 insertions(+), 7 deletions(-)

diff --git a/docs/agent-skills.md b/docs/agent-skills.md
index f41b343..72176f6 100644
--- a/docs/agent-skills.md
+++ b/docs/agent-skills.md
@@ -21,7 +21,7 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 | **gitops-workflow** | Implement GitOps workflows with ArgoCD and Flux for automated, declarative deployments |
 | **k8s-security-policies** | Implement Kubernetes security policies including NetworkPolicy, PodSecurityPolicy, and RBAC |
 
-### LLM Application Development (4 skills)
+### LLM Application Development (8 skills)
 
 | Skill | Description |
 |-------|-------------|
@@ -29,8 +29,12 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 | **prompt-engineering-patterns** | Master advanced prompt engineering techniques for LLM performance and reliability |
 | **rag-implementation** | Build Retrieval-Augmented Generation systems with vector databases and semantic search |
 | **llm-evaluation** | Implement comprehensive evaluation strategies with automated metrics and benchmarking |
+| **embedding-strategies** | Design embedding pipelines for text, images, and multimodal content with optimal chunking |
+| **similarity-search-patterns** | Implement efficient similarity search with ANN algorithms and distance metrics |
+| **vector-index-tuning** | Optimize vector index performance with HNSW, IVF, and hybrid configurations |
+| **hybrid-search-implementation** | Combine vector and keyword search for improved retrieval accuracy |
 
-### Backend Development (5 skills)
+### Backend Development (9 skills)
 
 | Skill | Description |
 |-------|-------------|
@@ -39,8 +43,12 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 | **microservices-patterns** | Design microservices with service boundaries, event-driven communication, and resilience |
 | **workflow-orchestration-patterns** | Design durable workflows with Temporal for distributed systems, saga patterns, and state management |
 | **temporal-python-testing** | Test Temporal workflows with pytest, time-skipping, and mocking strategies for comprehensive coverage |
+| **event-store-design** | Design event stores with optimized schemas, snapshots, and stream partitioning |
+| **cqrs-implementation** | Implement CQRS with separate read/write models and eventual consistency patterns |
+| **projection-patterns** | Build efficient projections from event streams for read-optimized views |
+| **saga-orchestration** | Design distributed sagas with compensation logic and failure handling |
 
-### Developer Essentials (8 skills)
+### Developer Essentials (11 skills)
 
 | Skill | Description |
 |-------|-------------|
@@ -52,6 +60,9 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 | **auth-implementation-patterns** | Implement authentication and authorization with JWT, OAuth2, sessions, and RBAC |
 | **debugging-strategies** | Master systematic debugging techniques, profiling tools, and root cause analysis |
 | **monorepo-management** | Manage monorepos with Turborepo, Nx, and pnpm workspaces for scalable multi-package projects |
+| **nx-workspace-patterns** | Configure Nx workspaces with computation caching and affected commands |
+| **turborepo-caching** | Optimize Turborepo builds with remote caching and pipeline configuration |
+| **bazel-build-optimization** | Design Bazel builds with hermetic actions and remote execution |
 
 ### Blockchain & Web3 (4 skills)
 
@@ -71,7 +82,7 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 | **gitlab-ci-patterns** | Build GitLab CI/CD pipelines with multi-stage workflows and distributed runners |
 | **secrets-management** | Implement secure secrets management using Vault, AWS Secrets Manager, or native solutions |
 
-### Cloud Infrastructure (4 skills)
+### Cloud Infrastructure (8 skills)
 
 | Skill | Description |
 |-------|-------------|
@@ -79,6 +90,10 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 | **multi-cloud-architecture** | Design multi-cloud architectures avoiding vendor lock-in |
 | **hybrid-cloud-networking** | Configure secure connectivity between on-premises and cloud platforms |
 | **cost-optimization** | Optimize cloud costs through rightsizing, tagging, and reserved instances |
+| **istio-traffic-management** | Configure Istio traffic routing, load balancing, and canary deployments |
+| **linkerd-patterns** | Implement Linkerd service mesh with automatic mTLS and traffic splitting |
+| **mtls-configuration** | Design zero-trust mTLS architectures with certificate management |
+| **service-mesh-observability** | Build comprehensive observability with distributed tracing and metrics |
 
 ### Framework Migration (4 skills)
 
@@ -138,11 +153,92 @@ Skills provide Claude with deep expertise in specific domains without loading ev
 |-------|-------------|
 | **ml-pipeline-workflow** | Build end-to-end MLOps pipelines from data preparation through deployment |
 
-### Security Scanning (1 skill)
+### Security Scanning (5 skills)
 
 | Skill | Description |
 |-------|-------------|
 | **sast-configuration** | Configure Static Application Security Testing tools for vulnerability detection |
+| **stride-analysis-patterns** | Apply STRIDE methodology to identify spoofing, tampering, and other threats |
+| **attack-tree-construction** | Build attack trees mapping threat scenarios to vulnerabilities |
+| **security-requirement-extraction** | Derive security requirements from threat models with acceptance criteria |
+| **threat-mitigation-mapping** | Map threats to mitigations with prioritized remediation plans |
+
+### Accessibility Compliance (2 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **wcag-audit-patterns** | Conduct WCAG 2.2 accessibility audits with automated and manual testing |
+| **screen-reader-testing** | Test screen reader compatibility across NVDA, JAWS, and VoiceOver |
+
+### Business Analytics (2 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **kpi-dashboard-design** | Design executive dashboards with actionable KPIs and drill-down capabilities |
+| **data-storytelling** | Transform data insights into compelling narratives for stakeholders |
+
+### Data Engineering (4 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **spark-optimization** | Optimize Apache Spark jobs with partitioning, caching, and broadcast joins |
+| **dbt-transformation-patterns** | Build dbt models with incremental strategies and testing |
+| **airflow-dag-patterns** | Design Airflow DAGs with proper dependencies and error handling |
+| **data-quality-frameworks** | Implement data quality checks with Great Expectations and custom validators |
+
+### Documentation Generation (3 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **openapi-spec-generation** | Generate OpenAPI 3.1 specifications from code with complete schemas |
+| **changelog-automation** | Automate changelog generation from conventional commits |
+| **architecture-decision-records** | Write ADRs documenting architectural decisions and trade-offs |
+
+### Frontend Mobile Development (4 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **react-state-management** | Implement state management with Zustand, Jotai, and React Query |
+| **nextjs-app-router-patterns** | Build Next.js 14+ apps with App Router, RSC, and streaming |
+| **tailwind-design-system** | Create design systems with Tailwind CSS and component libraries |
+| **react-native-architecture** | Architect React Native apps with navigation and native modules |
+
+### Game Development (2 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **unity-ecs-patterns** | Implement Unity ECS for high-performance game systems |
+| **godot-gdscript-patterns** | Build Godot games with GDScript best practices and scene composition |
+
+### HR Legal Compliance (2 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **gdpr-data-handling** | Implement GDPR-compliant data processing with consent management |
+| **employment-contract-templates** | Generate employment contracts with jurisdiction-specific clauses |
+
+### Incident Response (3 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **postmortem-writing** | Write blameless postmortems with root cause analysis and action items |
+| **incident-runbook-templates** | Create runbooks for common incident scenarios with escalation paths |
+| **on-call-handoff-patterns** | Design on-call handoffs with context preservation and alert routing |
+
+### Quantitative Trading (2 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **backtesting-frameworks** | Build backtesting systems with realistic slippage and transaction costs |
+| **risk-metrics-calculation** | Calculate VaR, Sharpe ratio, and drawdown metrics for portfolios |
+
+### Systems Programming (3 skills)
+
+| Skill | Description |
+|-------|-------------|
+| **rust-async-patterns** | Implement async Rust with Tokio, futures, and proper error handling |
+| **go-concurrency-patterns** | Design Go concurrency with channels, worker pools, and context cancellation |
+| **memory-safety-patterns** | Write memory-safe code with ownership, bounds checking, and sanitizers |
 
 ## How Skills Work
 
diff --git a/docs/agents.md b/docs/agents.md
index 4e5b5e0..a0861f0 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -17,6 +17,9 @@ Complete reference for all **99 specialized AI agents** organized by category wi
 | [cloud-architect](../plugins/cloud-infrastructure/agents/cloud-architect.md) | opus | AWS/Azure/GCP infrastructure design and cost optimization |
 | [hybrid-cloud-architect](../plugins/cloud-infrastructure/agents/hybrid-cloud-architect.md) | opus | Multi-cloud strategies across cloud and on-premises environments |
 | [kubernetes-architect](../plugins/kubernetes-operations/agents/kubernetes-architect.md) | opus | Cloud-native infrastructure with Kubernetes and GitOps |
+| [service-mesh-expert](../plugins/cloud-infrastructure/agents/service-mesh-expert.md) | opus | Istio/Linkerd service mesh architecture, mTLS, and traffic management |
+| [event-sourcing-architect](../plugins/backend-development/agents/event-sourcing-architect.md) | opus | Event sourcing, CQRS patterns, event stores, and saga orchestration |
+| [monorepo-architect](../plugins/developer-essentials/agents/monorepo-architect.md) | opus | Monorepo tooling with Nx, Turborepo, Bazel, and workspace optimization |
 
 #### UI/UX & Mobile
 
@@ -107,6 +110,7 @@ Complete reference for all **99 specialized AI agents** organized by category wi
 | [backend-security-coder](../plugins/data-validation-suite/agents/backend-security-coder.md) | opus | Secure backend coding practices, API security implementation |
 | [frontend-security-coder](../plugins/frontend-mobile-security/agents/frontend-security-coder.md) | opus | XSS prevention, CSP implementation, client-side security |
 | [mobile-security-coder](../plugins/frontend-mobile-security/agents/mobile-security-coder.md) | opus | Mobile security patterns, WebView security, biometric auth |
+| [threat-modeling-expert](../plugins/security-scanning/agents/threat-modeling-expert.md) | opus | STRIDE threat modeling, attack trees, and security requirements |
 
 #### Testing & Debugging
 
@@ -142,6 +146,7 @@ Complete reference for all **99 specialized AI agents** organized by category wi
 | [ml-engineer](../plugins/machine-learning-ops/agents/ml-engineer.md) | opus | ML pipelines, model serving, feature engineering |
 | [mlops-engineer](../plugins/machine-learning-ops/agents/mlops-engineer.md) | opus | ML infrastructure, experiment tracking, model registries |
 | [prompt-engineer](../plugins/llm-application-dev/agents/prompt-engineer.md) | opus | LLM prompt optimization and engineering |
+| [vector-database-engineer](../plugins/llm-application-dev/agents/vector-database-engineer.md) | opus | Vector databases, embeddings, similarity search, and hybrid retrieval |
 
 ### Documentation & Technical Writing
 
@@ -215,8 +220,9 @@ Agents are assigned to specific Claude models based on task complexity and compu
 
 | Model | Agent Count | Use Case |
 |-------|-------------|----------|
-| Haiku | 48 | Fast execution tasks: testing, documentation, ops, database optimization, business |
-| Sonnet | 100 | Complex reasoning, architecture, language expertise, orchestration, security |
+| Opus | 42 | Critical architecture, security, code review, production coding |
+| Sonnet | 39 | Complex tasks, support with intelligence |
+| Haiku | 18 | Fast operational tasks |
 
 ### Model Selection Criteria