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)
This commit is contained in:
Seth Hobson
2025-12-16 16:26:42 -05:00
parent 01d93fc227
commit 8879465553
2 changed files with 109 additions and 7 deletions

View File

@@ -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 | | **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 | | **k8s-security-policies** | Implement Kubernetes security policies including NetworkPolicy, PodSecurityPolicy, and RBAC |
### LLM Application Development (4 skills) ### LLM Application Development (8 skills)
| Skill | Description | | 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 | | **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 | | **rag-implementation** | Build Retrieval-Augmented Generation systems with vector databases and semantic search |
| **llm-evaluation** | Implement comprehensive evaluation strategies with automated metrics and benchmarking | | **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 | | 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 | | **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 | | **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 | | **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 | | 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 | | **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 | | **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 | | **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) ### 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 | | **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 | | **secrets-management** | Implement secure secrets management using Vault, AWS Secrets Manager, or native solutions |
### Cloud Infrastructure (4 skills) ### Cloud Infrastructure (8 skills)
| Skill | Description | | 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 | | **multi-cloud-architecture** | Design multi-cloud architectures avoiding vendor lock-in |
| **hybrid-cloud-networking** | Configure secure connectivity between on-premises and cloud platforms | | **hybrid-cloud-networking** | Configure secure connectivity between on-premises and cloud platforms |
| **cost-optimization** | Optimize cloud costs through rightsizing, tagging, and reserved instances | | **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) ### 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 | | **ml-pipeline-workflow** | Build end-to-end MLOps pipelines from data preparation through deployment |
### Security Scanning (1 skill) ### Security Scanning (5 skills)
| Skill | Description | | Skill | Description |
|-------|-------------| |-------|-------------|
| **sast-configuration** | Configure Static Application Security Testing tools for vulnerability detection | | **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 ## How Skills Work

View File

@@ -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 | | [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 | | [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 | | [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 #### 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 | | [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 | | [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 | | [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 #### 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 | | [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 | | [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 | | [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 ### 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 | | Model | Agent Count | Use Case |
|-------|-------------|----------| |-------|-------------|----------|
| Haiku | 48 | Fast execution tasks: testing, documentation, ops, database optimization, business | | Opus | 42 | Critical architecture, security, code review, production coding |
| Sonnet | 100 | Complex reasoning, architecture, language expertise, orchestration, security | | Sonnet | 39 | Complex tasks, support with intelligence |
| Haiku | 18 | Fast operational tasks |
### Model Selection Criteria ### Model Selection Criteria