aigroup-workflow 2.1.2 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.codex/AGENTS.md +1 -1
- package/CLAUDE.md +1 -4
- package/README.md +333 -333
- package/cli/commands/init.mjs +20 -6
- package/cli/utils/scaffold.mjs +39 -9
- package/docs/red-flags.md +1 -1
- package/docs/rules/entropy.md +1 -1
- package/docs/rules/performance.md +1 -1
- package/docs/workflow-pipeline.md +1 -0
- package/manifests/install-modules.json +223 -133
- package/package.json +39 -39
- package/scripts/orchestration/lib/orchestrator.cjs +34 -0
- package/scripts/orchestration/session.cjs +24 -1
- package/skills/ai-ml/fine-tuning-expert/SKILL.md +162 -0
- package/skills/ai-ml/fine-tuning-expert/references/dataset-preparation.md +540 -0
- package/skills/ai-ml/fine-tuning-expert/references/deployment-optimization.md +673 -0
- package/skills/ai-ml/fine-tuning-expert/references/evaluation-metrics.md +597 -0
- package/skills/ai-ml/fine-tuning-expert/references/hyperparameter-tuning.md +565 -0
- package/skills/ai-ml/fine-tuning-expert/references/lora-peft.md +347 -0
- package/skills/ai-ml/ml-pipeline/SKILL.md +159 -0
- package/skills/ai-ml/ml-pipeline/references/experiment-tracking.md +833 -0
- package/skills/ai-ml/ml-pipeline/references/feature-engineering.md +631 -0
- package/skills/ai-ml/ml-pipeline/references/model-validation.md +978 -0
- package/skills/ai-ml/ml-pipeline/references/pipeline-orchestration.md +907 -0
- package/skills/ai-ml/ml-pipeline/references/training-pipelines.md +782 -0
- package/skills/ai-ml/rag-architect/SKILL.md +194 -0
- package/skills/ai-ml/rag-architect/references/chunking-strategies.md +878 -0
- package/skills/ai-ml/rag-architect/references/embedding-models.md +561 -0
- package/skills/ai-ml/rag-architect/references/rag-evaluation.md +833 -0
- package/skills/ai-ml/rag-architect/references/retrieval-optimization.md +795 -0
- package/skills/ai-ml/rag-architect/references/vector-databases.md +589 -0
- package/skills/ai-ml/spark-engineer/SKILL.md +148 -0
- package/skills/ai-ml/spark-engineer/references/partitioning-caching.md +543 -0
- package/skills/ai-ml/spark-engineer/references/performance-tuning.md +544 -0
- package/skills/ai-ml/spark-engineer/references/rdd-operations.md +599 -0
- package/skills/ai-ml/spark-engineer/references/spark-sql-dataframes.md +474 -0
- package/skills/ai-ml/spark-engineer/references/streaming-patterns.md +786 -0
- package/skills/backend/api-designer/SKILL.md +217 -0
- package/skills/backend/api-designer/references/error-handling.md +541 -0
- package/skills/backend/api-designer/references/openapi.md +824 -0
- package/skills/backend/api-designer/references/pagination.md +494 -0
- package/skills/backend/api-designer/references/rest-patterns.md +335 -0
- package/skills/backend/api-designer/references/versioning.md +391 -0
- package/skills/backend/architecture-designer/SKILL.md +117 -0
- package/skills/backend/architecture-designer/references/adr-template.md +116 -0
- package/skills/backend/architecture-designer/references/architecture-patterns.md +111 -0
- package/skills/backend/architecture-designer/references/database-selection.md +102 -0
- package/skills/backend/architecture-designer/references/nfr-checklist.md +112 -0
- package/skills/backend/architecture-designer/references/system-design.md +100 -0
- package/skills/backend/code-documenter/SKILL.md +147 -0
- package/skills/backend/code-documenter/references/api-docs-fastapi-django.md +166 -0
- package/skills/backend/code-documenter/references/api-docs-nestjs-express.md +220 -0
- package/skills/backend/code-documenter/references/coverage-reports.md +125 -0
- package/skills/backend/code-documenter/references/documentation-systems.md +333 -0
- package/skills/backend/code-documenter/references/interactive-api-docs.md +531 -0
- package/skills/backend/code-documenter/references/python-docstrings.md +121 -0
- package/skills/backend/code-documenter/references/typescript-jsdoc.md +145 -0
- package/skills/backend/code-documenter/references/user-guides-tutorials.md +530 -0
- package/skills/backend/debugging-wizard/SKILL.md +105 -0
- package/skills/backend/debugging-wizard/references/common-patterns.md +132 -0
- package/skills/backend/debugging-wizard/references/debugging-tools.md +140 -0
- package/skills/backend/debugging-wizard/references/quick-fixes.md +177 -0
- package/skills/backend/debugging-wizard/references/strategies.md +142 -0
- package/skills/backend/debugging-wizard/references/systematic-debugging.md +367 -0
- package/skills/backend/feature-forge/SKILL.md +98 -0
- package/skills/backend/feature-forge/references/acceptance-criteria.md +104 -0
- package/skills/backend/feature-forge/references/ears-syntax.md +99 -0
- package/skills/backend/feature-forge/references/interview-questions.md +150 -0
- package/skills/backend/feature-forge/references/pre-discovery-subagents.md +54 -0
- package/skills/backend/feature-forge/references/specification-template.md +103 -0
- package/skills/backend/fullstack-guardian/SKILL.md +105 -0
- package/skills/backend/fullstack-guardian/references/api-design-standards.md +307 -0
- package/skills/backend/fullstack-guardian/references/architecture-decisions.md +350 -0
- package/skills/backend/fullstack-guardian/references/backend-patterns.md +237 -0
- package/skills/backend/fullstack-guardian/references/common-patterns.md +134 -0
- package/skills/backend/fullstack-guardian/references/deliverables-checklist.md +354 -0
- package/skills/backend/fullstack-guardian/references/design-template.md +91 -0
- package/skills/backend/fullstack-guardian/references/error-handling.md +135 -0
- package/skills/backend/fullstack-guardian/references/frontend-patterns.md +340 -0
- package/skills/backend/fullstack-guardian/references/integration-patterns.md +333 -0
- package/skills/backend/fullstack-guardian/references/security-checklist.md +106 -0
- package/skills/backend/graphql-architect/SKILL.md +146 -0
- package/skills/backend/graphql-architect/references/federation.md +418 -0
- package/skills/backend/graphql-architect/references/migration-from-rest.md +1141 -0
- package/skills/backend/graphql-architect/references/resolvers.md +425 -0
- package/skills/backend/graphql-architect/references/schema-design.md +393 -0
- package/skills/backend/graphql-architect/references/security.md +569 -0
- package/skills/backend/graphql-architect/references/subscriptions.md +510 -0
- package/skills/backend/legacy-modernizer/SKILL.md +137 -0
- package/skills/backend/legacy-modernizer/references/legacy-testing.md +381 -0
- package/skills/backend/legacy-modernizer/references/migration-strategies.md +423 -0
- package/skills/backend/legacy-modernizer/references/refactoring-patterns.md +395 -0
- package/skills/backend/legacy-modernizer/references/strangler-fig-pattern.md +281 -0
- package/skills/backend/legacy-modernizer/references/system-assessment.md +487 -0
- package/skills/backend/microservices-architect/SKILL.md +164 -0
- package/skills/backend/microservices-architect/references/communication.md +499 -0
- package/skills/backend/microservices-architect/references/data.md +721 -0
- package/skills/backend/microservices-architect/references/decomposition.md +344 -0
- package/skills/backend/microservices-architect/references/observability.md +805 -0
- package/skills/backend/microservices-architect/references/patterns.md +603 -0
- package/skills/database/database-optimizer/SKILL.md +147 -0
- package/skills/database/database-optimizer/references/index-strategies.md +331 -0
- package/skills/database/database-optimizer/references/monitoring-analysis.md +501 -0
- package/skills/database/database-optimizer/references/mysql-tuning.md +452 -0
- package/skills/database/database-optimizer/references/postgresql-tuning.md +413 -0
- package/skills/database/database-optimizer/references/query-optimization.md +251 -0
- package/skills/database/postgres-pro/SKILL.md +152 -0
- package/skills/database/postgres-pro/references/extensions.md +404 -0
- package/skills/database/postgres-pro/references/jsonb.md +321 -0
- package/skills/database/postgres-pro/references/maintenance.md +481 -0
- package/skills/database/postgres-pro/references/performance.md +265 -0
- package/skills/database/postgres-pro/references/replication.md +446 -0
- package/skills/database/sql-pro/SKILL.md +129 -0
- package/skills/database/sql-pro/references/database-design.md +402 -0
- package/skills/database/sql-pro/references/dialect-differences.md +419 -0
- package/skills/database/sql-pro/references/optimization.md +384 -0
- package/skills/database/sql-pro/references/query-patterns.md +285 -0
- package/skills/database/sql-pro/references/window-functions.md +328 -0
- package/skills/dotnet/csharp-developer/SKILL.md +125 -0
- package/skills/dotnet/csharp-developer/references/aspnet-core.md +394 -0
- package/skills/dotnet/csharp-developer/references/blazor.md +553 -0
- package/skills/dotnet/csharp-developer/references/entity-framework.md +409 -0
- package/skills/dotnet/csharp-developer/references/modern-csharp.md +248 -0
- package/skills/dotnet/csharp-developer/references/performance.md +498 -0
- package/skills/dotnet/dotnet-core-expert/SKILL.md +138 -0
- package/skills/dotnet/dotnet-core-expert/references/authentication.md +546 -0
- package/skills/dotnet/dotnet-core-expert/references/clean-architecture.md +455 -0
- package/skills/dotnet/dotnet-core-expert/references/cloud-native.md +548 -0
- package/skills/dotnet/dotnet-core-expert/references/entity-framework.md +440 -0
- package/skills/dotnet/dotnet-core-expert/references/minimal-apis.md +319 -0
- package/skills/frontend/angular-architect/SKILL.md +152 -0
- package/skills/frontend/angular-architect/references/components.md +297 -0
- package/skills/frontend/angular-architect/references/ngrx.md +401 -0
- package/skills/frontend/angular-architect/references/routing.md +361 -0
- package/skills/frontend/angular-architect/references/rxjs.md +319 -0
- package/skills/frontend/angular-architect/references/testing.md +405 -0
- package/skills/frontend/flutter-expert/SKILL.md +138 -0
- package/skills/frontend/flutter-expert/references/bloc-state.md +259 -0
- package/skills/frontend/flutter-expert/references/gorouter-navigation.md +119 -0
- package/skills/frontend/flutter-expert/references/performance.md +99 -0
- package/skills/frontend/flutter-expert/references/project-structure.md +118 -0
- package/skills/frontend/flutter-expert/references/riverpod-state.md +130 -0
- package/skills/frontend/flutter-expert/references/widget-patterns.md +123 -0
- package/skills/frontend/nextjs-developer/SKILL.md +143 -0
- package/skills/frontend/nextjs-developer/references/app-router.md +311 -0
- package/skills/frontend/nextjs-developer/references/data-fetching.md +482 -0
- package/skills/frontend/nextjs-developer/references/deployment.md +545 -0
- package/skills/frontend/nextjs-developer/references/server-actions.md +462 -0
- package/skills/frontend/nextjs-developer/references/server-components.md +384 -0
- package/skills/frontend/react-expert/SKILL.md +149 -0
- package/skills/frontend/react-expert/references/hooks-patterns.md +162 -0
- package/skills/frontend/react-expert/references/migration-class-to-modern.md +1119 -0
- package/skills/frontend/react-expert/references/performance.md +168 -0
- package/skills/frontend/react-expert/references/react-19-features.md +174 -0
- package/skills/frontend/react-expert/references/server-components.md +143 -0
- package/skills/frontend/react-expert/references/state-management.md +171 -0
- package/skills/frontend/react-expert/references/testing-react.md +174 -0
- package/skills/frontend/react-native-expert/SKILL.md +185 -0
- package/skills/frontend/react-native-expert/references/expo-router.md +187 -0
- package/skills/frontend/react-native-expert/references/list-optimization.md +204 -0
- package/skills/frontend/react-native-expert/references/platform-handling.md +188 -0
- package/skills/frontend/react-native-expert/references/project-structure.md +171 -0
- package/skills/frontend/react-native-expert/references/storage-hooks.md +173 -0
- package/skills/frontend/vue-expert/SKILL.md +98 -0
- package/skills/frontend/vue-expert/references/build-tooling.md +480 -0
- package/skills/frontend/vue-expert/references/components.md +448 -0
- package/skills/frontend/vue-expert/references/composition-api.md +299 -0
- package/skills/frontend/vue-expert/references/mobile-hybrid.md +636 -0
- package/skills/frontend/vue-expert/references/nuxt.md +669 -0
- package/skills/frontend/vue-expert/references/state-management.md +449 -0
- package/skills/frontend/vue-expert/references/typescript.md +584 -0
- package/skills/frontend/vue-expert-js/SKILL.md +167 -0
- package/skills/frontend/vue-expert-js/references/component-architecture.md +219 -0
- package/skills/frontend/vue-expert-js/references/composables-patterns.md +183 -0
- package/skills/frontend/vue-expert-js/references/jsdoc-typing.md +535 -0
- package/skills/frontend/vue-expert-js/references/state-management.md +249 -0
- package/skills/frontend/vue-expert-js/references/testing-patterns.md +237 -0
- package/skills/go-rust-cpp/cpp-pro/SKILL.md +115 -0
- package/skills/go-rust-cpp/cpp-pro/references/build-tooling.md +440 -0
- package/skills/go-rust-cpp/cpp-pro/references/concurrency.md +437 -0
- package/skills/go-rust-cpp/cpp-pro/references/memory-performance.md +397 -0
- package/skills/go-rust-cpp/cpp-pro/references/modern-cpp.md +304 -0
- package/skills/go-rust-cpp/cpp-pro/references/templates.md +357 -0
- package/skills/go-rust-cpp/golang-pro/SKILL.md +122 -0
- package/skills/go-rust-cpp/golang-pro/references/concurrency.md +329 -0
- package/skills/go-rust-cpp/golang-pro/references/generics.md +442 -0
- package/skills/go-rust-cpp/golang-pro/references/interfaces.md +432 -0
- package/skills/go-rust-cpp/golang-pro/references/project-structure.md +477 -0
- package/skills/go-rust-cpp/golang-pro/references/testing.md +451 -0
- package/skills/go-rust-cpp/rust-engineer/SKILL.md +167 -0
- package/skills/go-rust-cpp/rust-engineer/references/async.md +458 -0
- package/skills/go-rust-cpp/rust-engineer/references/error-handling.md +334 -0
- package/skills/go-rust-cpp/rust-engineer/references/ownership.md +278 -0
- package/skills/go-rust-cpp/rust-engineer/references/testing.md +470 -0
- package/skills/go-rust-cpp/rust-engineer/references/traits.md +413 -0
- package/skills/infra/cli-developer/SKILL.md +113 -0
- package/skills/infra/cli-developer/references/design-patterns.md +221 -0
- package/skills/infra/cli-developer/references/go-cli.md +540 -0
- package/skills/infra/cli-developer/references/node-cli.md +383 -0
- package/skills/infra/cli-developer/references/python-cli.md +422 -0
- package/skills/infra/cli-developer/references/ux-patterns.md +448 -0
- package/skills/infra/cloud-architect/SKILL.md +216 -0
- package/skills/infra/cloud-architect/references/aws.md +394 -0
- package/skills/infra/cloud-architect/references/azure.md +562 -0
- package/skills/infra/cloud-architect/references/cost.md +582 -0
- package/skills/infra/cloud-architect/references/gcp.md +633 -0
- package/skills/infra/cloud-architect/references/multi-cloud.md +483 -0
- package/skills/infra/devops-engineer/SKILL.md +144 -0
- package/skills/infra/devops-engineer/references/deployment-strategies.md +241 -0
- package/skills/infra/devops-engineer/references/docker-patterns.md +113 -0
- package/skills/infra/devops-engineer/references/github-actions.md +139 -0
- package/skills/infra/devops-engineer/references/incident-response.md +331 -0
- package/skills/infra/devops-engineer/references/kubernetes.md +154 -0
- package/skills/infra/devops-engineer/references/platform-engineering.md +417 -0
- package/skills/infra/devops-engineer/references/release-automation.md +527 -0
- package/skills/infra/devops-engineer/references/terraform-iac.md +141 -0
- package/skills/infra/kubernetes-specialist/SKILL.md +241 -0
- package/skills/infra/kubernetes-specialist/references/configuration.md +452 -0
- package/skills/infra/kubernetes-specialist/references/cost-optimization.md +458 -0
- package/skills/infra/kubernetes-specialist/references/custom-operators.md +563 -0
- package/skills/infra/kubernetes-specialist/references/gitops.md +530 -0
- package/skills/infra/kubernetes-specialist/references/helm-charts.md +912 -0
- package/skills/infra/kubernetes-specialist/references/multi-cluster.md +507 -0
- package/skills/infra/kubernetes-specialist/references/networking.md +447 -0
- package/skills/infra/kubernetes-specialist/references/service-mesh.md +459 -0
- package/skills/infra/kubernetes-specialist/references/storage.md +535 -0
- package/skills/infra/kubernetes-specialist/references/troubleshooting.md +414 -0
- package/skills/infra/kubernetes-specialist/references/workloads.md +377 -0
- package/skills/infra/mcp-developer/SKILL.md +143 -0
- package/skills/infra/mcp-developer/references/protocol.md +244 -0
- package/skills/infra/mcp-developer/references/python-sdk.md +367 -0
- package/skills/infra/mcp-developer/references/resources.md +554 -0
- package/skills/infra/mcp-developer/references/tools.md +480 -0
- package/skills/infra/mcp-developer/references/typescript-sdk.md +350 -0
- package/skills/infra/monitoring-expert/SKILL.md +176 -0
- package/skills/infra/monitoring-expert/references/alerting-rules.md +141 -0
- package/skills/infra/monitoring-expert/references/application-profiling.md +331 -0
- package/skills/infra/monitoring-expert/references/capacity-planning.md +344 -0
- package/skills/infra/monitoring-expert/references/dashboards.md +126 -0
- package/skills/infra/monitoring-expert/references/opentelemetry.md +123 -0
- package/skills/infra/monitoring-expert/references/performance-testing.md +269 -0
- package/skills/infra/monitoring-expert/references/prometheus-metrics.md +136 -0
- package/skills/infra/monitoring-expert/references/structured-logging.md +142 -0
- package/skills/infra/sre-engineer/SKILL.md +181 -0
- package/skills/infra/sre-engineer/references/automation-toil.md +492 -0
- package/skills/infra/sre-engineer/references/error-budget-policy.md +334 -0
- package/skills/infra/sre-engineer/references/incident-chaos.md +576 -0
- package/skills/infra/sre-engineer/references/monitoring-alerting.md +424 -0
- package/skills/infra/sre-engineer/references/slo-sli-management.md +238 -0
- package/skills/infra/terraform-engineer/SKILL.md +143 -0
- package/skills/infra/terraform-engineer/references/best-practices.md +583 -0
- package/skills/infra/terraform-engineer/references/module-patterns.md +297 -0
- package/skills/infra/terraform-engineer/references/providers.md +452 -0
- package/skills/infra/terraform-engineer/references/state-management.md +371 -0
- package/skills/infra/terraform-engineer/references/testing.md +486 -0
- package/skills/infra/websocket-engineer/SKILL.md +168 -0
- package/skills/infra/websocket-engineer/references/alternatives.md +391 -0
- package/skills/infra/websocket-engineer/references/patterns.md +400 -0
- package/skills/infra/websocket-engineer/references/protocol.md +195 -0
- package/skills/infra/websocket-engineer/references/scaling.md +333 -0
- package/skills/infra/websocket-engineer/references/security.md +474 -0
- package/skills/java/java-architect/SKILL.md +132 -0
- package/skills/java/java-architect/references/jpa-optimization.md +393 -0
- package/skills/java/java-architect/references/reactive-webflux.md +356 -0
- package/skills/java/java-architect/references/spring-boot-setup.md +269 -0
- package/skills/java/java-architect/references/spring-security.md +445 -0
- package/skills/java/java-architect/references/testing-patterns.md +500 -0
- package/skills/java/kotlin-specialist/SKILL.md +147 -0
- package/skills/java/kotlin-specialist/references/android-compose.md +419 -0
- package/skills/java/kotlin-specialist/references/coroutines-flow.md +276 -0
- package/skills/java/kotlin-specialist/references/dsl-idioms.md +421 -0
- package/skills/java/kotlin-specialist/references/ktor-server.md +426 -0
- package/skills/java/kotlin-specialist/references/multiplatform-kmp.md +380 -0
- package/skills/java/spring-boot-engineer/SKILL.md +195 -0
- package/skills/java/spring-boot-engineer/references/cloud.md +498 -0
- package/skills/java/spring-boot-engineer/references/data.md +381 -0
- package/skills/java/spring-boot-engineer/references/security.md +459 -0
- package/skills/java/spring-boot-engineer/references/testing.md +545 -0
- package/skills/java/spring-boot-engineer/references/web.md +295 -0
- package/skills/javascript/javascript-pro/SKILL.md +132 -0
- package/skills/javascript/javascript-pro/references/async-patterns.md +334 -0
- package/skills/javascript/javascript-pro/references/browser-apis.md +398 -0
- package/skills/javascript/javascript-pro/references/modern-syntax.md +272 -0
- package/skills/javascript/javascript-pro/references/modules.md +357 -0
- package/skills/javascript/javascript-pro/references/node-essentials.md +471 -0
- package/skills/javascript/nestjs-expert/SKILL.md +206 -0
- package/skills/javascript/nestjs-expert/references/authentication.md +166 -0
- package/skills/javascript/nestjs-expert/references/controllers-routing.md +111 -0
- package/skills/javascript/nestjs-expert/references/dtos-validation.md +153 -0
- package/skills/javascript/nestjs-expert/references/migration-from-express.md +1237 -0
- package/skills/javascript/nestjs-expert/references/services-di.md +140 -0
- package/skills/javascript/nestjs-expert/references/testing-patterns.md +186 -0
- package/skills/javascript/typescript-pro/SKILL.md +145 -0
- package/skills/javascript/typescript-pro/references/advanced-types.md +259 -0
- package/skills/javascript/typescript-pro/references/configuration.md +445 -0
- package/skills/javascript/typescript-pro/references/patterns.md +484 -0
- package/skills/javascript/typescript-pro/references/type-guards.md +352 -0
- package/skills/javascript/typescript-pro/references/utility-types.md +329 -0
- package/skills/php/laravel-specialist/SKILL.md +262 -0
- package/skills/php/laravel-specialist/references/eloquent.md +351 -0
- package/skills/php/laravel-specialist/references/livewire.md +512 -0
- package/skills/php/laravel-specialist/references/queues.md +423 -0
- package/skills/php/laravel-specialist/references/routing.md +362 -0
- package/skills/php/laravel-specialist/references/testing.md +522 -0
- package/skills/php/php-pro/SKILL.md +206 -0
- package/skills/php/php-pro/references/async-patterns.md +412 -0
- package/skills/php/php-pro/references/laravel-patterns.md +377 -0
- package/skills/php/php-pro/references/modern-php-features.md +323 -0
- package/skills/php/php-pro/references/symfony-patterns.md +466 -0
- package/skills/php/php-pro/references/testing-quality.md +466 -0
- package/skills/python/django-expert/SKILL.md +162 -0
- package/skills/python/django-expert/references/authentication.md +145 -0
- package/skills/python/django-expert/references/drf-serializers.md +148 -0
- package/skills/python/django-expert/references/models-orm.md +151 -0
- package/skills/python/django-expert/references/testing-django.md +204 -0
- package/skills/python/django-expert/references/viewsets-views.md +153 -0
- package/skills/python/fastapi-expert/SKILL.md +185 -0
- package/skills/python/fastapi-expert/references/async-sqlalchemy.md +146 -0
- package/skills/python/fastapi-expert/references/authentication.md +159 -0
- package/skills/python/fastapi-expert/references/endpoints-routing.md +142 -0
- package/skills/python/fastapi-expert/references/migration-from-django.md +997 -0
- package/skills/python/fastapi-expert/references/pydantic-v2.md +135 -0
- package/skills/python/fastapi-expert/references/testing-async.md +159 -0
- package/skills/python/pandas-pro/SKILL.md +178 -0
- package/skills/python/pandas-pro/references/aggregation-groupby.md +545 -0
- package/skills/python/pandas-pro/references/data-cleaning.md +500 -0
- package/skills/python/pandas-pro/references/dataframe-operations.md +420 -0
- package/skills/python/pandas-pro/references/merging-joining.md +596 -0
- package/skills/python/pandas-pro/references/performance-optimization.md +597 -0
- package/skills/python/python-pro/SKILL.md +177 -0
- package/skills/python/python-pro/references/async-patterns.md +356 -0
- package/skills/python/python-pro/references/packaging.md +460 -0
- package/skills/python/python-pro/references/standard-library.md +378 -0
- package/skills/python/python-pro/references/testing.md +404 -0
- package/skills/python/python-pro/references/type-system.md +290 -0
- package/skills/quality/chaos-engineer/SKILL.md +182 -0
- package/skills/quality/chaos-engineer/references/chaos-tools.md +511 -0
- package/skills/quality/chaos-engineer/references/experiment-design.md +229 -0
- package/skills/quality/chaos-engineer/references/game-days.md +434 -0
- package/skills/quality/chaos-engineer/references/infrastructure-chaos.md +348 -0
- package/skills/quality/chaos-engineer/references/kubernetes-chaos.md +432 -0
- package/skills/quality/code-reviewer/SKILL.md +119 -0
- package/skills/quality/code-reviewer/references/common-issues.md +142 -0
- package/skills/quality/code-reviewer/references/feedback-examples.md +144 -0
- package/skills/quality/code-reviewer/references/receiving-feedback.md +238 -0
- package/skills/quality/code-reviewer/references/report-template.md +109 -0
- package/skills/quality/code-reviewer/references/review-checklist.md +88 -0
- package/skills/quality/code-reviewer/references/spec-compliance-review.md +258 -0
- package/skills/quality/playwright-expert/SKILL.md +169 -0
- package/skills/quality/playwright-expert/references/api-mocking.md +140 -0
- package/skills/quality/playwright-expert/references/configuration.md +155 -0
- package/skills/quality/playwright-expert/references/debugging-flaky.md +150 -0
- package/skills/quality/playwright-expert/references/page-object-model.md +152 -0
- package/skills/quality/playwright-expert/references/selectors-locators.md +119 -0
- package/skills/quality/secure-code-guardian/SKILL.md +191 -0
- package/skills/quality/secure-code-guardian/references/authentication.md +136 -0
- package/skills/quality/secure-code-guardian/references/input-validation.md +146 -0
- package/skills/quality/secure-code-guardian/references/owasp-prevention.md +135 -0
- package/skills/quality/secure-code-guardian/references/security-headers.md +133 -0
- package/skills/quality/secure-code-guardian/references/xss-csrf.md +157 -0
- package/skills/quality/security-reviewer/SKILL.md +103 -0
- package/skills/quality/security-reviewer/references/infrastructure-security.md +268 -0
- package/skills/quality/security-reviewer/references/penetration-testing.md +268 -0
- package/skills/quality/security-reviewer/references/report-template.md +170 -0
- package/skills/quality/security-reviewer/references/sast-tools.md +117 -0
- package/skills/quality/security-reviewer/references/secret-scanning.md +125 -0
- package/skills/quality/security-reviewer/references/vulnerability-patterns.md +152 -0
- package/skills/quality/tdd-guide/assets/sample_coverage_report.lcov +0 -0
- package/skills/quality/test-master/SKILL.md +94 -0
- package/skills/quality/test-master/references/automation-frameworks.md +294 -0
- package/skills/quality/test-master/references/e2e-testing.md +128 -0
- package/skills/quality/test-master/references/integration-testing.md +120 -0
- package/skills/quality/test-master/references/performance-testing.md +118 -0
- package/skills/quality/test-master/references/qa-methodology.md +247 -0
- package/skills/quality/test-master/references/security-testing.md +127 -0
- package/skills/quality/test-master/references/tdd-iron-laws.md +174 -0
- package/skills/quality/test-master/references/test-reports.md +104 -0
- package/skills/quality/test-master/references/testing-anti-patterns.md +231 -0
- package/skills/quality/test-master/references/unit-testing.md +113 -0
- package/skills/ruby/rails-expert/SKILL.md +154 -0
- package/skills/ruby/rails-expert/references/active-record.md +244 -0
- package/skills/ruby/rails-expert/references/api-development.md +401 -0
- package/skills/ruby/rails-expert/references/background-jobs.md +272 -0
- package/skills/ruby/rails-expert/references/hotwire-turbo.md +228 -0
- package/skills/ruby/rails-expert/references/rspec-testing.md +367 -0
- package/skills/swift/swift-expert/SKILL.md +163 -0
- package/skills/swift/swift-expert/references/async-concurrency.md +360 -0
- package/skills/swift/swift-expert/references/memory-performance.md +377 -0
- package/skills/swift/swift-expert/references/protocol-oriented.md +354 -0
- package/skills/swift/swift-expert/references/swiftui-patterns.md +291 -0
- package/skills/swift/swift-expert/references/testing-patterns.md +399 -0
- package/skills/workflow/brainstorming/SKILL.md +164 -0
- package/skills/workflow/brainstorming/scripts/helper.js +88 -0
- package/skills/workflow/brainstorming/scripts/start-server.sh +148 -0
- package/skills/workflow/brainstorming/scripts/stop-server.sh +56 -0
- package/skills/workflow/brainstorming/spec-document-reviewer-prompt.md +49 -0
- package/skills/workflow/brainstorming/visual-companion.md +287 -0
- package/skills/workflow/documentation/SKILL.md +45 -0
- package/skills/workflow/entropy-management/SKILL.md +115 -0
- package/skills/workflow/executing-plans/SKILL.md +70 -0
- package/skills/workflow/finishing-a-development-branch/SKILL.md +200 -0
- package/skills/workflow/receiving-code-review/SKILL.md +213 -0
- package/skills/workflow/requesting-code-review/SKILL.md +105 -0
- package/skills/workflow/requesting-code-review/code-reviewer.md +146 -0
- package/skills/workflow/requirement-engineering/SKILL.md +111 -0
- package/skills/workflow/systematic-debugging/CREATION-LOG.md +119 -0
- package/skills/workflow/systematic-debugging/SKILL.md +296 -0
- package/skills/workflow/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/skills/workflow/systematic-debugging/condition-based-waiting.md +115 -0
- package/skills/workflow/systematic-debugging/defense-in-depth.md +122 -0
- package/skills/workflow/systematic-debugging/find-polluter.sh +63 -0
- package/skills/workflow/systematic-debugging/root-cause-tracing.md +169 -0
- package/skills/workflow/systematic-debugging/test-academic.md +14 -0
- package/skills/workflow/systematic-debugging/test-pressure-1.md +58 -0
- package/skills/workflow/systematic-debugging/test-pressure-2.md +68 -0
- package/skills/workflow/systematic-debugging/test-pressure-3.md +69 -0
- package/skills/workflow/using-git-worktrees/SKILL.md +218 -0
- package/skills/workflow/verification-before-completion/SKILL.md +139 -0
- package/skills/workflow/writing-plans/SKILL.md +151 -0
- package/skills/workflow/writing-plans/plan-document-reviewer-prompt.md +49 -0
- package/skills/workflow/writing-skills/SKILL.md +655 -0
- package/skills/workflow/writing-skills/anthropic-best-practices.md +1150 -0
- package/skills/workflow/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
- package/skills/workflow/writing-skills/graphviz-conventions.dot +0 -0
- package/skills/workflow/writing-skills/persuasion-principles.md +187 -0
- package/skills/workflow/writing-skills/render-graphs.js +168 -0
- package/skills/workflow/writing-skills/testing-skills-with-subagents.md +384 -0
- package/skills/angular-architect/SKILL.md +0 -152
- package/skills/angular-architect/references/components.md +0 -297
- package/skills/angular-architect/references/ngrx.md +0 -401
- package/skills/angular-architect/references/routing.md +0 -361
- package/skills/angular-architect/references/rxjs.md +0 -319
- package/skills/angular-architect/references/testing.md +0 -405
- package/skills/api-designer/SKILL.md +0 -217
- package/skills/api-designer/references/error-handling.md +0 -541
- package/skills/api-designer/references/openapi.md +0 -824
- package/skills/api-designer/references/pagination.md +0 -494
- package/skills/api-designer/references/rest-patterns.md +0 -335
- package/skills/api-designer/references/versioning.md +0 -391
- package/skills/architecture-designer/SKILL.md +0 -117
- package/skills/architecture-designer/references/adr-template.md +0 -116
- package/skills/architecture-designer/references/architecture-patterns.md +0 -111
- package/skills/architecture-designer/references/database-selection.md +0 -102
- package/skills/architecture-designer/references/nfr-checklist.md +0 -112
- package/skills/architecture-designer/references/system-design.md +0 -100
- package/skills/brainstorming/SKILL.md +0 -164
- package/skills/brainstorming/scripts/helper.js +0 -88
- package/skills/brainstorming/scripts/start-server.sh +0 -148
- package/skills/brainstorming/scripts/stop-server.sh +0 -56
- package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
- package/skills/brainstorming/visual-companion.md +0 -287
- package/skills/chaos-engineer/SKILL.md +0 -182
- package/skills/chaos-engineer/references/chaos-tools.md +0 -511
- package/skills/chaos-engineer/references/experiment-design.md +0 -229
- package/skills/chaos-engineer/references/game-days.md +0 -434
- package/skills/chaos-engineer/references/infrastructure-chaos.md +0 -348
- package/skills/chaos-engineer/references/kubernetes-chaos.md +0 -432
- package/skills/cli-developer/SKILL.md +0 -113
- package/skills/cli-developer/references/design-patterns.md +0 -221
- package/skills/cli-developer/references/go-cli.md +0 -540
- package/skills/cli-developer/references/node-cli.md +0 -383
- package/skills/cli-developer/references/python-cli.md +0 -422
- package/skills/cli-developer/references/ux-patterns.md +0 -448
- package/skills/cloud-architect/SKILL.md +0 -216
- package/skills/cloud-architect/references/aws.md +0 -394
- package/skills/cloud-architect/references/azure.md +0 -562
- package/skills/cloud-architect/references/cost.md +0 -582
- package/skills/cloud-architect/references/gcp.md +0 -633
- package/skills/cloud-architect/references/multi-cloud.md +0 -483
- package/skills/code-documenter/SKILL.md +0 -147
- package/skills/code-documenter/references/api-docs-fastapi-django.md +0 -166
- package/skills/code-documenter/references/api-docs-nestjs-express.md +0 -220
- package/skills/code-documenter/references/coverage-reports.md +0 -125
- package/skills/code-documenter/references/documentation-systems.md +0 -333
- package/skills/code-documenter/references/interactive-api-docs.md +0 -531
- package/skills/code-documenter/references/python-docstrings.md +0 -121
- package/skills/code-documenter/references/typescript-jsdoc.md +0 -145
- package/skills/code-documenter/references/user-guides-tutorials.md +0 -530
- package/skills/code-reviewer/SKILL.md +0 -119
- package/skills/code-reviewer/references/common-issues.md +0 -142
- package/skills/code-reviewer/references/feedback-examples.md +0 -144
- package/skills/code-reviewer/references/receiving-feedback.md +0 -238
- package/skills/code-reviewer/references/report-template.md +0 -109
- package/skills/code-reviewer/references/review-checklist.md +0 -88
- package/skills/code-reviewer/references/spec-compliance-review.md +0 -258
- package/skills/cpp-pro/SKILL.md +0 -115
- package/skills/cpp-pro/references/build-tooling.md +0 -440
- package/skills/cpp-pro/references/concurrency.md +0 -437
- package/skills/cpp-pro/references/memory-performance.md +0 -397
- package/skills/cpp-pro/references/modern-cpp.md +0 -304
- package/skills/cpp-pro/references/templates.md +0 -357
- package/skills/csharp-developer/SKILL.md +0 -125
- package/skills/csharp-developer/references/aspnet-core.md +0 -394
- package/skills/csharp-developer/references/blazor.md +0 -553
- package/skills/csharp-developer/references/entity-framework.md +0 -409
- package/skills/csharp-developer/references/modern-csharp.md +0 -248
- package/skills/csharp-developer/references/performance.md +0 -498
- package/skills/database-optimizer/SKILL.md +0 -147
- package/skills/database-optimizer/references/index-strategies.md +0 -331
- package/skills/database-optimizer/references/monitoring-analysis.md +0 -501
- package/skills/database-optimizer/references/mysql-tuning.md +0 -452
- package/skills/database-optimizer/references/postgresql-tuning.md +0 -413
- package/skills/database-optimizer/references/query-optimization.md +0 -251
- package/skills/debugging-wizard/SKILL.md +0 -105
- package/skills/debugging-wizard/references/common-patterns.md +0 -132
- package/skills/debugging-wizard/references/debugging-tools.md +0 -140
- package/skills/debugging-wizard/references/quick-fixes.md +0 -177
- package/skills/debugging-wizard/references/strategies.md +0 -142
- package/skills/debugging-wizard/references/systematic-debugging.md +0 -367
- package/skills/devops-engineer/SKILL.md +0 -144
- package/skills/devops-engineer/references/deployment-strategies.md +0 -241
- package/skills/devops-engineer/references/docker-patterns.md +0 -113
- package/skills/devops-engineer/references/github-actions.md +0 -139
- package/skills/devops-engineer/references/incident-response.md +0 -331
- package/skills/devops-engineer/references/kubernetes.md +0 -154
- package/skills/devops-engineer/references/platform-engineering.md +0 -417
- package/skills/devops-engineer/references/release-automation.md +0 -527
- package/skills/devops-engineer/references/terraform-iac.md +0 -141
- package/skills/django-expert/SKILL.md +0 -162
- package/skills/django-expert/references/authentication.md +0 -145
- package/skills/django-expert/references/drf-serializers.md +0 -148
- package/skills/django-expert/references/models-orm.md +0 -151
- package/skills/django-expert/references/testing-django.md +0 -204
- package/skills/django-expert/references/viewsets-views.md +0 -153
- package/skills/documentation/SKILL.md +0 -45
- package/skills/dotnet-core-expert/SKILL.md +0 -138
- package/skills/dotnet-core-expert/references/authentication.md +0 -546
- package/skills/dotnet-core-expert/references/clean-architecture.md +0 -455
- package/skills/dotnet-core-expert/references/cloud-native.md +0 -548
- package/skills/dotnet-core-expert/references/entity-framework.md +0 -440
- package/skills/dotnet-core-expert/references/minimal-apis.md +0 -319
- package/skills/entropy-management/SKILL.md +0 -115
- package/skills/executing-plans/SKILL.md +0 -70
- package/skills/fastapi-expert/SKILL.md +0 -185
- package/skills/fastapi-expert/references/async-sqlalchemy.md +0 -146
- package/skills/fastapi-expert/references/authentication.md +0 -159
- package/skills/fastapi-expert/references/endpoints-routing.md +0 -142
- package/skills/fastapi-expert/references/migration-from-django.md +0 -997
- package/skills/fastapi-expert/references/pydantic-v2.md +0 -135
- package/skills/fastapi-expert/references/testing-async.md +0 -159
- package/skills/feature-forge/SKILL.md +0 -98
- package/skills/feature-forge/references/acceptance-criteria.md +0 -104
- package/skills/feature-forge/references/ears-syntax.md +0 -99
- package/skills/feature-forge/references/interview-questions.md +0 -150
- package/skills/feature-forge/references/pre-discovery-subagents.md +0 -54
- package/skills/feature-forge/references/specification-template.md +0 -103
- package/skills/fine-tuning-expert/SKILL.md +0 -162
- package/skills/fine-tuning-expert/references/dataset-preparation.md +0 -540
- package/skills/fine-tuning-expert/references/deployment-optimization.md +0 -673
- package/skills/fine-tuning-expert/references/evaluation-metrics.md +0 -597
- package/skills/fine-tuning-expert/references/hyperparameter-tuning.md +0 -565
- package/skills/fine-tuning-expert/references/lora-peft.md +0 -347
- package/skills/finishing-a-development-branch/SKILL.md +0 -200
- package/skills/flutter-expert/SKILL.md +0 -138
- package/skills/flutter-expert/references/bloc-state.md +0 -259
- package/skills/flutter-expert/references/gorouter-navigation.md +0 -119
- package/skills/flutter-expert/references/performance.md +0 -99
- package/skills/flutter-expert/references/project-structure.md +0 -118
- package/skills/flutter-expert/references/riverpod-state.md +0 -130
- package/skills/flutter-expert/references/widget-patterns.md +0 -123
- package/skills/fullstack-guardian/SKILL.md +0 -105
- package/skills/fullstack-guardian/references/api-design-standards.md +0 -307
- package/skills/fullstack-guardian/references/architecture-decisions.md +0 -350
- package/skills/fullstack-guardian/references/backend-patterns.md +0 -237
- package/skills/fullstack-guardian/references/common-patterns.md +0 -134
- package/skills/fullstack-guardian/references/deliverables-checklist.md +0 -354
- package/skills/fullstack-guardian/references/design-template.md +0 -91
- package/skills/fullstack-guardian/references/error-handling.md +0 -135
- package/skills/fullstack-guardian/references/frontend-patterns.md +0 -340
- package/skills/fullstack-guardian/references/integration-patterns.md +0 -333
- package/skills/fullstack-guardian/references/security-checklist.md +0 -106
- package/skills/golang-pro/SKILL.md +0 -122
- package/skills/golang-pro/references/concurrency.md +0 -329
- package/skills/golang-pro/references/generics.md +0 -442
- package/skills/golang-pro/references/interfaces.md +0 -432
- package/skills/golang-pro/references/project-structure.md +0 -477
- package/skills/golang-pro/references/testing.md +0 -451
- package/skills/graphql-architect/SKILL.md +0 -146
- package/skills/graphql-architect/references/federation.md +0 -418
- package/skills/graphql-architect/references/migration-from-rest.md +0 -1141
- package/skills/graphql-architect/references/resolvers.md +0 -425
- package/skills/graphql-architect/references/schema-design.md +0 -393
- package/skills/graphql-architect/references/security.md +0 -569
- package/skills/graphql-architect/references/subscriptions.md +0 -510
- package/skills/java-architect/SKILL.md +0 -132
- package/skills/java-architect/references/jpa-optimization.md +0 -393
- package/skills/java-architect/references/reactive-webflux.md +0 -356
- package/skills/java-architect/references/spring-boot-setup.md +0 -269
- package/skills/java-architect/references/spring-security.md +0 -445
- package/skills/java-architect/references/testing-patterns.md +0 -500
- package/skills/javascript-pro/SKILL.md +0 -132
- package/skills/javascript-pro/references/async-patterns.md +0 -334
- package/skills/javascript-pro/references/browser-apis.md +0 -398
- package/skills/javascript-pro/references/modern-syntax.md +0 -272
- package/skills/javascript-pro/references/modules.md +0 -357
- package/skills/javascript-pro/references/node-essentials.md +0 -471
- package/skills/kotlin-specialist/SKILL.md +0 -147
- package/skills/kotlin-specialist/references/android-compose.md +0 -419
- package/skills/kotlin-specialist/references/coroutines-flow.md +0 -276
- package/skills/kotlin-specialist/references/dsl-idioms.md +0 -421
- package/skills/kotlin-specialist/references/ktor-server.md +0 -426
- package/skills/kotlin-specialist/references/multiplatform-kmp.md +0 -380
- package/skills/kubernetes-specialist/SKILL.md +0 -241
- package/skills/kubernetes-specialist/references/configuration.md +0 -452
- package/skills/kubernetes-specialist/references/cost-optimization.md +0 -458
- package/skills/kubernetes-specialist/references/custom-operators.md +0 -563
- package/skills/kubernetes-specialist/references/gitops.md +0 -530
- package/skills/kubernetes-specialist/references/helm-charts.md +0 -912
- package/skills/kubernetes-specialist/references/multi-cluster.md +0 -507
- package/skills/kubernetes-specialist/references/networking.md +0 -447
- package/skills/kubernetes-specialist/references/service-mesh.md +0 -459
- package/skills/kubernetes-specialist/references/storage.md +0 -535
- package/skills/kubernetes-specialist/references/troubleshooting.md +0 -414
- package/skills/kubernetes-specialist/references/workloads.md +0 -377
- package/skills/laravel-specialist/SKILL.md +0 -262
- package/skills/laravel-specialist/references/eloquent.md +0 -351
- package/skills/laravel-specialist/references/livewire.md +0 -512
- package/skills/laravel-specialist/references/queues.md +0 -423
- package/skills/laravel-specialist/references/routing.md +0 -362
- package/skills/laravel-specialist/references/testing.md +0 -522
- package/skills/legacy-modernizer/SKILL.md +0 -137
- package/skills/legacy-modernizer/references/legacy-testing.md +0 -381
- package/skills/legacy-modernizer/references/migration-strategies.md +0 -423
- package/skills/legacy-modernizer/references/refactoring-patterns.md +0 -395
- package/skills/legacy-modernizer/references/strangler-fig-pattern.md +0 -281
- package/skills/legacy-modernizer/references/system-assessment.md +0 -487
- package/skills/mcp-developer/SKILL.md +0 -143
- package/skills/mcp-developer/references/protocol.md +0 -244
- package/skills/mcp-developer/references/python-sdk.md +0 -367
- package/skills/mcp-developer/references/resources.md +0 -554
- package/skills/mcp-developer/references/tools.md +0 -480
- package/skills/mcp-developer/references/typescript-sdk.md +0 -350
- package/skills/microservices-architect/SKILL.md +0 -164
- package/skills/microservices-architect/references/communication.md +0 -499
- package/skills/microservices-architect/references/data.md +0 -721
- package/skills/microservices-architect/references/decomposition.md +0 -344
- package/skills/microservices-architect/references/observability.md +0 -805
- package/skills/microservices-architect/references/patterns.md +0 -603
- package/skills/ml-pipeline/SKILL.md +0 -159
- package/skills/ml-pipeline/references/experiment-tracking.md +0 -833
- package/skills/ml-pipeline/references/feature-engineering.md +0 -631
- package/skills/ml-pipeline/references/model-validation.md +0 -978
- package/skills/ml-pipeline/references/pipeline-orchestration.md +0 -907
- package/skills/ml-pipeline/references/training-pipelines.md +0 -782
- package/skills/monitoring-expert/SKILL.md +0 -176
- package/skills/monitoring-expert/references/alerting-rules.md +0 -141
- package/skills/monitoring-expert/references/application-profiling.md +0 -331
- package/skills/monitoring-expert/references/capacity-planning.md +0 -344
- package/skills/monitoring-expert/references/dashboards.md +0 -126
- package/skills/monitoring-expert/references/opentelemetry.md +0 -123
- package/skills/monitoring-expert/references/performance-testing.md +0 -269
- package/skills/monitoring-expert/references/prometheus-metrics.md +0 -136
- package/skills/monitoring-expert/references/structured-logging.md +0 -142
- package/skills/nestjs-expert/SKILL.md +0 -206
- package/skills/nestjs-expert/references/authentication.md +0 -166
- package/skills/nestjs-expert/references/controllers-routing.md +0 -111
- package/skills/nestjs-expert/references/dtos-validation.md +0 -153
- package/skills/nestjs-expert/references/migration-from-express.md +0 -1237
- package/skills/nestjs-expert/references/services-di.md +0 -140
- package/skills/nestjs-expert/references/testing-patterns.md +0 -186
- package/skills/nextjs-developer/SKILL.md +0 -143
- package/skills/nextjs-developer/references/app-router.md +0 -311
- package/skills/nextjs-developer/references/data-fetching.md +0 -482
- package/skills/nextjs-developer/references/deployment.md +0 -545
- package/skills/nextjs-developer/references/server-actions.md +0 -462
- package/skills/nextjs-developer/references/server-components.md +0 -384
- package/skills/pandas-pro/SKILL.md +0 -178
- package/skills/pandas-pro/references/aggregation-groupby.md +0 -545
- package/skills/pandas-pro/references/data-cleaning.md +0 -500
- package/skills/pandas-pro/references/dataframe-operations.md +0 -420
- package/skills/pandas-pro/references/merging-joining.md +0 -596
- package/skills/pandas-pro/references/performance-optimization.md +0 -597
- package/skills/php-pro/SKILL.md +0 -206
- package/skills/php-pro/references/async-patterns.md +0 -412
- package/skills/php-pro/references/laravel-patterns.md +0 -377
- package/skills/php-pro/references/modern-php-features.md +0 -323
- package/skills/php-pro/references/symfony-patterns.md +0 -466
- package/skills/php-pro/references/testing-quality.md +0 -466
- package/skills/playwright-expert/SKILL.md +0 -169
- package/skills/playwright-expert/references/api-mocking.md +0 -140
- package/skills/playwright-expert/references/configuration.md +0 -155
- package/skills/playwright-expert/references/debugging-flaky.md +0 -150
- package/skills/playwright-expert/references/page-object-model.md +0 -152
- package/skills/playwright-expert/references/selectors-locators.md +0 -119
- package/skills/postgres-pro/SKILL.md +0 -152
- package/skills/postgres-pro/references/extensions.md +0 -404
- package/skills/postgres-pro/references/jsonb.md +0 -321
- package/skills/postgres-pro/references/maintenance.md +0 -481
- package/skills/postgres-pro/references/performance.md +0 -265
- package/skills/postgres-pro/references/replication.md +0 -446
- package/skills/python-pro/SKILL.md +0 -177
- package/skills/python-pro/references/async-patterns.md +0 -356
- package/skills/python-pro/references/packaging.md +0 -460
- package/skills/python-pro/references/standard-library.md +0 -378
- package/skills/python-pro/references/testing.md +0 -404
- package/skills/python-pro/references/type-system.md +0 -290
- package/skills/rag-architect/SKILL.md +0 -194
- package/skills/rag-architect/references/chunking-strategies.md +0 -878
- package/skills/rag-architect/references/embedding-models.md +0 -561
- package/skills/rag-architect/references/rag-evaluation.md +0 -833
- package/skills/rag-architect/references/retrieval-optimization.md +0 -795
- package/skills/rag-architect/references/vector-databases.md +0 -589
- package/skills/rails-expert/SKILL.md +0 -154
- package/skills/rails-expert/references/active-record.md +0 -244
- package/skills/rails-expert/references/api-development.md +0 -401
- package/skills/rails-expert/references/background-jobs.md +0 -272
- package/skills/rails-expert/references/hotwire-turbo.md +0 -228
- package/skills/rails-expert/references/rspec-testing.md +0 -367
- package/skills/react-expert/SKILL.md +0 -149
- package/skills/react-expert/references/hooks-patterns.md +0 -162
- package/skills/react-expert/references/migration-class-to-modern.md +0 -1119
- package/skills/react-expert/references/performance.md +0 -168
- package/skills/react-expert/references/react-19-features.md +0 -174
- package/skills/react-expert/references/server-components.md +0 -143
- package/skills/react-expert/references/state-management.md +0 -171
- package/skills/react-expert/references/testing-react.md +0 -174
- package/skills/react-native-expert/SKILL.md +0 -185
- package/skills/react-native-expert/references/expo-router.md +0 -187
- package/skills/react-native-expert/references/list-optimization.md +0 -204
- package/skills/react-native-expert/references/platform-handling.md +0 -188
- package/skills/react-native-expert/references/project-structure.md +0 -171
- package/skills/react-native-expert/references/storage-hooks.md +0 -173
- package/skills/receiving-code-review/SKILL.md +0 -213
- package/skills/requesting-code-review/SKILL.md +0 -105
- package/skills/requesting-code-review/code-reviewer.md +0 -146
- package/skills/requirement-engineering/SKILL.md +0 -111
- package/skills/rust-engineer/SKILL.md +0 -167
- package/skills/rust-engineer/references/async.md +0 -458
- package/skills/rust-engineer/references/error-handling.md +0 -334
- package/skills/rust-engineer/references/ownership.md +0 -278
- package/skills/rust-engineer/references/testing.md +0 -470
- package/skills/rust-engineer/references/traits.md +0 -413
- package/skills/secure-code-guardian/SKILL.md +0 -191
- package/skills/secure-code-guardian/references/authentication.md +0 -136
- package/skills/secure-code-guardian/references/input-validation.md +0 -146
- package/skills/secure-code-guardian/references/owasp-prevention.md +0 -135
- package/skills/secure-code-guardian/references/security-headers.md +0 -133
- package/skills/secure-code-guardian/references/xss-csrf.md +0 -157
- package/skills/security-reviewer/SKILL.md +0 -103
- package/skills/security-reviewer/references/infrastructure-security.md +0 -268
- package/skills/security-reviewer/references/penetration-testing.md +0 -268
- package/skills/security-reviewer/references/report-template.md +0 -170
- package/skills/security-reviewer/references/sast-tools.md +0 -117
- package/skills/security-reviewer/references/secret-scanning.md +0 -125
- package/skills/security-reviewer/references/vulnerability-patterns.md +0 -152
- package/skills/spark-engineer/SKILL.md +0 -148
- package/skills/spark-engineer/references/partitioning-caching.md +0 -543
- package/skills/spark-engineer/references/performance-tuning.md +0 -544
- package/skills/spark-engineer/references/rdd-operations.md +0 -599
- package/skills/spark-engineer/references/spark-sql-dataframes.md +0 -474
- package/skills/spark-engineer/references/streaming-patterns.md +0 -786
- package/skills/spring-boot-engineer/SKILL.md +0 -195
- package/skills/spring-boot-engineer/references/cloud.md +0 -498
- package/skills/spring-boot-engineer/references/data.md +0 -381
- package/skills/spring-boot-engineer/references/security.md +0 -459
- package/skills/spring-boot-engineer/references/testing.md +0 -545
- package/skills/spring-boot-engineer/references/web.md +0 -295
- package/skills/sql-pro/SKILL.md +0 -129
- package/skills/sql-pro/references/database-design.md +0 -402
- package/skills/sql-pro/references/dialect-differences.md +0 -419
- package/skills/sql-pro/references/optimization.md +0 -384
- package/skills/sql-pro/references/query-patterns.md +0 -285
- package/skills/sql-pro/references/window-functions.md +0 -328
- package/skills/sre-engineer/SKILL.md +0 -181
- package/skills/sre-engineer/references/automation-toil.md +0 -492
- package/skills/sre-engineer/references/error-budget-policy.md +0 -334
- package/skills/sre-engineer/references/incident-chaos.md +0 -576
- package/skills/sre-engineer/references/monitoring-alerting.md +0 -424
- package/skills/sre-engineer/references/slo-sli-management.md +0 -238
- package/skills/swift-expert/SKILL.md +0 -163
- package/skills/swift-expert/references/async-concurrency.md +0 -360
- package/skills/swift-expert/references/memory-performance.md +0 -377
- package/skills/swift-expert/references/protocol-oriented.md +0 -354
- package/skills/swift-expert/references/swiftui-patterns.md +0 -291
- package/skills/swift-expert/references/testing-patterns.md +0 -399
- package/skills/systematic-debugging/CREATION-LOG.md +0 -119
- package/skills/systematic-debugging/SKILL.md +0 -296
- package/skills/systematic-debugging/condition-based-waiting-example.ts +0 -158
- package/skills/systematic-debugging/condition-based-waiting.md +0 -115
- package/skills/systematic-debugging/defense-in-depth.md +0 -122
- package/skills/systematic-debugging/find-polluter.sh +0 -63
- package/skills/systematic-debugging/root-cause-tracing.md +0 -169
- package/skills/systematic-debugging/test-academic.md +0 -14
- package/skills/systematic-debugging/test-pressure-1.md +0 -58
- package/skills/systematic-debugging/test-pressure-2.md +0 -68
- package/skills/systematic-debugging/test-pressure-3.md +0 -69
- package/skills/tdd-guide/assets/sample_coverage_report.lcov +0 -56
- package/skills/terraform-engineer/SKILL.md +0 -143
- package/skills/terraform-engineer/references/best-practices.md +0 -583
- package/skills/terraform-engineer/references/module-patterns.md +0 -297
- package/skills/terraform-engineer/references/providers.md +0 -452
- package/skills/terraform-engineer/references/state-management.md +0 -371
- package/skills/terraform-engineer/references/testing.md +0 -486
- package/skills/test-master/SKILL.md +0 -94
- package/skills/test-master/references/automation-frameworks.md +0 -294
- package/skills/test-master/references/e2e-testing.md +0 -128
- package/skills/test-master/references/integration-testing.md +0 -120
- package/skills/test-master/references/performance-testing.md +0 -118
- package/skills/test-master/references/qa-methodology.md +0 -247
- package/skills/test-master/references/security-testing.md +0 -127
- package/skills/test-master/references/tdd-iron-laws.md +0 -174
- package/skills/test-master/references/test-reports.md +0 -104
- package/skills/test-master/references/testing-anti-patterns.md +0 -231
- package/skills/test-master/references/unit-testing.md +0 -113
- package/skills/typescript-pro/SKILL.md +0 -145
- package/skills/typescript-pro/references/advanced-types.md +0 -259
- package/skills/typescript-pro/references/configuration.md +0 -445
- package/skills/typescript-pro/references/patterns.md +0 -484
- package/skills/typescript-pro/references/type-guards.md +0 -352
- package/skills/typescript-pro/references/utility-types.md +0 -329
- package/skills/using-git-worktrees/SKILL.md +0 -218
- package/skills/verification-before-completion/SKILL.md +0 -139
- package/skills/vue-expert/SKILL.md +0 -98
- package/skills/vue-expert/references/build-tooling.md +0 -480
- package/skills/vue-expert/references/components.md +0 -448
- package/skills/vue-expert/references/composition-api.md +0 -299
- package/skills/vue-expert/references/mobile-hybrid.md +0 -636
- package/skills/vue-expert/references/nuxt.md +0 -669
- package/skills/vue-expert/references/state-management.md +0 -449
- package/skills/vue-expert/references/typescript.md +0 -584
- package/skills/vue-expert-js/SKILL.md +0 -167
- package/skills/vue-expert-js/references/component-architecture.md +0 -219
- package/skills/vue-expert-js/references/composables-patterns.md +0 -183
- package/skills/vue-expert-js/references/jsdoc-typing.md +0 -535
- package/skills/vue-expert-js/references/state-management.md +0 -249
- package/skills/vue-expert-js/references/testing-patterns.md +0 -237
- package/skills/websocket-engineer/SKILL.md +0 -168
- package/skills/websocket-engineer/references/alternatives.md +0 -391
- package/skills/websocket-engineer/references/patterns.md +0 -400
- package/skills/websocket-engineer/references/protocol.md +0 -195
- package/skills/websocket-engineer/references/scaling.md +0 -333
- package/skills/websocket-engineer/references/security.md +0 -474
- package/skills/writing-plans/SKILL.md +0 -151
- package/skills/writing-plans/plan-document-reviewer-prompt.md +0 -49
- package/skills/writing-skills/SKILL.md +0 -655
- package/skills/writing-skills/anthropic-best-practices.md +0 -1150
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +0 -189
- package/skills/writing-skills/graphviz-conventions.dot +0 -172
- package/skills/writing-skills/persuasion-principles.md +0 -187
- package/skills/writing-skills/render-graphs.js +0 -168
- package/skills/writing-skills/testing-skills-with-subagents.md +0 -384
- /package/skills/{design-commands → frontend/design-commands}/design.md +0 -0
- /package/skills/{design-commands → frontend/design-commands}/handoff.md +0 -0
- /package/skills/{design-commands → frontend/design-commands}/prototype.md +0 -0
- /package/skills/{design-commands → frontend/design-commands}/spec.md +0 -0
- /package/skills/{design-commands → frontend/design-commands}/style.md +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/SKILL.md +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/references/frontend_best_practices.md +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/references/nextjs_optimization_guide.md +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/references/react_patterns.md +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/scripts/bundle_analyzer.py +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/scripts/component_generator.py +0 -0
- /package/skills/{senior-frontend → frontend/senior-frontend}/scripts/frontend_scaffolder.py +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/SKILL.md +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/charts.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/colors.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/icons.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/landing.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/products.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/react-performance.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/astro.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/flutter.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/html-tailwind.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/jetpack-compose.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/nextjs.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/nuxt-ui.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/nuxtjs.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/react-native.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/react.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/shadcn.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/svelte.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/swiftui.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/vue.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/styles.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/typography.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/ui-reasoning.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/ux-guidelines.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/web-interface.csv +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/scripts/core.py +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/scripts/design_system.py +0 -0
- /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/scripts/search.py +0 -0
- /package/skills/{competitive-analysis → product/competitive-analysis}/SKILL.md +0 -0
- /package/skills/{meeting-notes → product/meeting-notes}/SKILL.md +0 -0
- /package/skills/{prd-template → product/prd-template}/SKILL.md +0 -0
- /package/skills/{stakeholder-update → product/stakeholder-update}/SKILL.md +0 -0
- /package/skills/{user-research-synthesis → product/user-research-synthesis}/SKILL.md +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/README.md +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/SKILL.md +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/references/qa_best_practices.md +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/references/test_automation_patterns.md +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/references/testing_strategies.md +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/scripts/coverage_analyzer.py +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/scripts/e2e_test_scaffolder.py +0 -0
- /package/skills/{senior-qa → quality/senior-qa}/scripts/test_suite_generator.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/HOW_TO_USE.md +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/README.md +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/SKILL.md +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/assets/expected_output.json +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/assets/sample_input_python.json +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/assets/sample_input_typescript.json +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/references/ci-integration.md +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/references/framework-guide.md +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/references/tdd-best-practices.md +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/coverage_analyzer.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/fixture_generator.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/format_detector.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/framework_adapter.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/metrics_calculator.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/output_formatter.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/tdd_workflow.py +0 -0
- /package/skills/{tdd-guide → quality/tdd-guide}/scripts/test_generator.py +0 -0
- /package/skills/{brainstorming → workflow/brainstorming}/scripts/frame-template.html +0 -0
- /package/skills/{brainstorming → workflow/brainstorming}/scripts/server.cjs +0 -0
|
@@ -1,833 +0,0 @@
|
|
|
1
|
-
# RAG Evaluation
|
|
2
|
-
|
|
3
|
-
---
|
|
4
|
-
|
|
5
|
-
## Evaluation Framework Overview
|
|
6
|
-
|
|
7
|
-
| Framework | Focus | Strengths | Use Case |
|
|
8
|
-
|-----------|-------|-----------|----------|
|
|
9
|
-
| **RAGAS** | RAG-specific metrics | Faithfulness, relevance | Production RAG evaluation |
|
|
10
|
-
| **TruLens** | LLM app observability | Tracing, feedback functions | Debugging and monitoring |
|
|
11
|
-
| **LangSmith** | LangChain ecosystem | Traces, datasets, testing | LangChain projects |
|
|
12
|
-
| **Custom** | Specific requirements | Full control | Domain-specific needs |
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## Core Metrics
|
|
17
|
-
|
|
18
|
-
### Retrieval Metrics
|
|
19
|
-
|
|
20
|
-
| Metric | Formula | What It Measures |
|
|
21
|
-
|--------|---------|------------------|
|
|
22
|
-
| **Precision@k** | Relevant in top-k / k | Are retrieved docs relevant? |
|
|
23
|
-
| **Recall@k** | Relevant in top-k / Total relevant | Did we get all relevant docs? |
|
|
24
|
-
| **MRR** | 1 / Rank of first relevant | How quickly do we find relevant? |
|
|
25
|
-
| **NDCG@k** | DCG@k / IDCG@k | Is ranking order correct? |
|
|
26
|
-
| **Hit Rate** | Queries with relevant in top-k / Total queries | Binary success rate |
|
|
27
|
-
|
|
28
|
-
### Generation Metrics
|
|
29
|
-
|
|
30
|
-
| Metric | What It Measures |
|
|
31
|
-
|--------|------------------|
|
|
32
|
-
| **Faithfulness** | Is answer grounded in retrieved context? |
|
|
33
|
-
| **Answer Relevance** | Does answer address the question? |
|
|
34
|
-
| **Context Relevance** | Is retrieved context relevant to question? |
|
|
35
|
-
| **Context Utilization** | How much context was actually used? |
|
|
36
|
-
|
|
37
|
-
---
|
|
38
|
-
|
|
39
|
-
## Implementing Core Metrics
|
|
40
|
-
|
|
41
|
-
### Precision, Recall, and Hit Rate
|
|
42
|
-
|
|
43
|
-
```python
|
|
44
|
-
from dataclasses import dataclass
|
|
45
|
-
from typing import Set
|
|
46
|
-
|
|
47
|
-
@dataclass
|
|
48
|
-
class RetrievalMetrics:
|
|
49
|
-
precision_at_k: float
|
|
50
|
-
recall_at_k: float
|
|
51
|
-
hit_rate: float
|
|
52
|
-
mrr: float
|
|
53
|
-
|
|
54
|
-
def calculate_retrieval_metrics(
|
|
55
|
-
retrieved_ids: list[str],
|
|
56
|
-
relevant_ids: set[str],
|
|
57
|
-
k: int
|
|
58
|
-
) -> RetrievalMetrics:
|
|
59
|
-
"""Calculate core retrieval metrics."""
|
|
60
|
-
top_k = retrieved_ids[:k]
|
|
61
|
-
top_k_set = set(top_k)
|
|
62
|
-
|
|
63
|
-
# Precision@k: relevant in top-k / k
|
|
64
|
-
relevant_in_top_k = len(top_k_set & relevant_ids)
|
|
65
|
-
precision = relevant_in_top_k / k if k > 0 else 0
|
|
66
|
-
|
|
67
|
-
# Recall@k: relevant in top-k / total relevant
|
|
68
|
-
recall = relevant_in_top_k / len(relevant_ids) if relevant_ids else 0
|
|
69
|
-
|
|
70
|
-
# Hit Rate: 1 if any relevant in top-k, else 0
|
|
71
|
-
hit_rate = 1.0 if relevant_in_top_k > 0 else 0.0
|
|
72
|
-
|
|
73
|
-
# MRR: 1 / rank of first relevant result
|
|
74
|
-
mrr = 0.0
|
|
75
|
-
for i, doc_id in enumerate(top_k, 1):
|
|
76
|
-
if doc_id in relevant_ids:
|
|
77
|
-
mrr = 1.0 / i
|
|
78
|
-
break
|
|
79
|
-
|
|
80
|
-
return RetrievalMetrics(
|
|
81
|
-
precision_at_k=precision,
|
|
82
|
-
recall_at_k=recall,
|
|
83
|
-
hit_rate=hit_rate,
|
|
84
|
-
mrr=mrr
|
|
85
|
-
)
|
|
86
|
-
|
|
87
|
-
# Usage
|
|
88
|
-
retrieved = ["doc1", "doc2", "doc3", "doc4", "doc5"]
|
|
89
|
-
relevant = {"doc2", "doc5", "doc7"} # Ground truth
|
|
90
|
-
|
|
91
|
-
metrics = calculate_retrieval_metrics(retrieved, relevant, k=5)
|
|
92
|
-
print(f"Precision@5: {metrics.precision_at_k:.2f}") # 2/5 = 0.40
|
|
93
|
-
print(f"Recall@5: {metrics.recall_at_k:.2f}") # 2/3 = 0.67
|
|
94
|
-
print(f"MRR: {metrics.mrr:.2f}") # 1/2 = 0.50
|
|
95
|
-
```
|
|
96
|
-
|
|
97
|
-
### NDCG (Normalized Discounted Cumulative Gain)
|
|
98
|
-
|
|
99
|
-
```python
|
|
100
|
-
import numpy as np
|
|
101
|
-
|
|
102
|
-
def dcg_at_k(relevance_scores: list[float], k: int) -> float:
|
|
103
|
-
"""Calculate Discounted Cumulative Gain."""
|
|
104
|
-
relevance_scores = np.array(relevance_scores[:k])
|
|
105
|
-
if len(relevance_scores) == 0:
|
|
106
|
-
return 0.0
|
|
107
|
-
|
|
108
|
-
# DCG = sum(rel_i / log2(i + 1)) for i in 1..k
|
|
109
|
-
discounts = np.log2(np.arange(2, len(relevance_scores) + 2))
|
|
110
|
-
return np.sum(relevance_scores / discounts)
|
|
111
|
-
|
|
112
|
-
def ndcg_at_k(
|
|
113
|
-
retrieved_ids: list[str],
|
|
114
|
-
relevance_scores: dict[str, float],
|
|
115
|
-
k: int
|
|
116
|
-
) -> float:
|
|
117
|
-
"""
|
|
118
|
-
Calculate NDCG@k.
|
|
119
|
-
relevance_scores: dict mapping doc_id to relevance (e.g., 0, 1, 2, 3)
|
|
120
|
-
"""
|
|
121
|
-
# Get relevance scores for retrieved docs
|
|
122
|
-
retrieved_relevance = [
|
|
123
|
-
relevance_scores.get(doc_id, 0)
|
|
124
|
-
for doc_id in retrieved_ids[:k]
|
|
125
|
-
]
|
|
126
|
-
|
|
127
|
-
# Calculate DCG for retrieved order
|
|
128
|
-
dcg = dcg_at_k(retrieved_relevance, k)
|
|
129
|
-
|
|
130
|
-
# Calculate ideal DCG (perfect ranking)
|
|
131
|
-
ideal_relevance = sorted(relevance_scores.values(), reverse=True)[:k]
|
|
132
|
-
idcg = dcg_at_k(ideal_relevance, k)
|
|
133
|
-
|
|
134
|
-
return dcg / idcg if idcg > 0 else 0.0
|
|
135
|
-
|
|
136
|
-
# Usage with graded relevance
|
|
137
|
-
retrieved = ["doc1", "doc2", "doc3", "doc4", "doc5"]
|
|
138
|
-
relevance = {
|
|
139
|
-
"doc1": 0, # Not relevant
|
|
140
|
-
"doc2": 3, # Highly relevant
|
|
141
|
-
"doc3": 1, # Somewhat relevant
|
|
142
|
-
"doc5": 2, # Relevant
|
|
143
|
-
"doc7": 3, # Highly relevant (not retrieved)
|
|
144
|
-
}
|
|
145
|
-
|
|
146
|
-
ndcg = ndcg_at_k(retrieved, relevance, k=5)
|
|
147
|
-
print(f"NDCG@5: {ndcg:.3f}")
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
---
|
|
151
|
-
|
|
152
|
-
## RAGAS Framework
|
|
153
|
-
|
|
154
|
-
### Installation and Setup
|
|
155
|
-
|
|
156
|
-
```python
|
|
157
|
-
# pip install ragas
|
|
158
|
-
|
|
159
|
-
from ragas import evaluate
|
|
160
|
-
from ragas.metrics import (
|
|
161
|
-
faithfulness,
|
|
162
|
-
answer_relevancy,
|
|
163
|
-
context_precision,
|
|
164
|
-
context_recall,
|
|
165
|
-
context_utilization,
|
|
166
|
-
)
|
|
167
|
-
from datasets import Dataset
|
|
168
|
-
|
|
169
|
-
# Prepare evaluation dataset
|
|
170
|
-
eval_data = {
|
|
171
|
-
"question": [
|
|
172
|
-
"What is the capital of France?",
|
|
173
|
-
"How do I install Python?"
|
|
174
|
-
],
|
|
175
|
-
"answer": [
|
|
176
|
-
"The capital of France is Paris.",
|
|
177
|
-
"You can install Python by downloading it from python.org."
|
|
178
|
-
],
|
|
179
|
-
"contexts": [
|
|
180
|
-
["Paris is the capital and largest city of France."],
|
|
181
|
-
["Python can be installed from the official website python.org.",
|
|
182
|
-
"You can also use package managers like brew or apt."]
|
|
183
|
-
],
|
|
184
|
-
"ground_truth": [
|
|
185
|
-
"Paris is the capital of France.",
|
|
186
|
-
"Install Python from python.org or use a package manager."
|
|
187
|
-
]
|
|
188
|
-
}
|
|
189
|
-
|
|
190
|
-
dataset = Dataset.from_dict(eval_data)
|
|
191
|
-
|
|
192
|
-
# Run evaluation
|
|
193
|
-
results = evaluate(
|
|
194
|
-
dataset,
|
|
195
|
-
metrics=[
|
|
196
|
-
faithfulness,
|
|
197
|
-
answer_relevancy,
|
|
198
|
-
context_precision,
|
|
199
|
-
context_recall,
|
|
200
|
-
]
|
|
201
|
-
)
|
|
202
|
-
|
|
203
|
-
print(results)
|
|
204
|
-
# {'faithfulness': 0.95, 'answer_relevancy': 0.88, ...}
|
|
205
|
-
```
|
|
206
|
-
|
|
207
|
-
### Custom RAGAS Evaluation
|
|
208
|
-
|
|
209
|
-
```python
|
|
210
|
-
from ragas.metrics import Metric
|
|
211
|
-
from ragas.llms import LangchainLLM
|
|
212
|
-
from langchain_openai import ChatOpenAI
|
|
213
|
-
|
|
214
|
-
# Use custom LLM
|
|
215
|
-
custom_llm = LangchainLLM(llm=ChatOpenAI(model="gpt-4o-mini"))
|
|
216
|
-
|
|
217
|
-
# Evaluate with custom settings
|
|
218
|
-
results = evaluate(
|
|
219
|
-
dataset,
|
|
220
|
-
metrics=[faithfulness, answer_relevancy],
|
|
221
|
-
llm=custom_llm,
|
|
222
|
-
raise_exceptions=False # Continue on errors
|
|
223
|
-
)
|
|
224
|
-
|
|
225
|
-
# Per-sample scores
|
|
226
|
-
for i, row in enumerate(results.to_pandas().itertuples()):
|
|
227
|
-
print(f"Q{i+1}: Faithfulness={row.faithfulness:.2f}, "
|
|
228
|
-
f"Relevancy={row.answer_relevancy:.2f}")
|
|
229
|
-
```
|
|
230
|
-
|
|
231
|
-
### RAGAS Metrics Explained
|
|
232
|
-
|
|
233
|
-
```python
|
|
234
|
-
"""
|
|
235
|
-
RAGAS Core Metrics:
|
|
236
|
-
|
|
237
|
-
1. Faithfulness (0-1):
|
|
238
|
-
- Measures if answer is grounded in context
|
|
239
|
-
- LLM extracts claims from answer, verifies against context
|
|
240
|
-
- High score = answer doesn't hallucinate
|
|
241
|
-
|
|
242
|
-
2. Answer Relevancy (0-1):
|
|
243
|
-
- Measures if answer addresses the question
|
|
244
|
-
- Generates questions from answer, compares to original
|
|
245
|
-
- High score = answer is on-topic
|
|
246
|
-
|
|
247
|
-
3. Context Precision (0-1):
|
|
248
|
-
- Measures if retrieved contexts are relevant
|
|
249
|
-
- Ranks contexts by relevance, calculates precision at each rank
|
|
250
|
-
- High score = top contexts are most relevant
|
|
251
|
-
|
|
252
|
-
4. Context Recall (0-1):
|
|
253
|
-
- Measures if all ground truth info is in context
|
|
254
|
-
- Checks if ground truth sentences are supported by context
|
|
255
|
-
- High score = context contains needed information
|
|
256
|
-
"""
|
|
257
|
-
|
|
258
|
-
# Debugging low scores
|
|
259
|
-
def diagnose_ragas_scores(results_df):
|
|
260
|
-
"""Identify problematic samples."""
|
|
261
|
-
issues = []
|
|
262
|
-
|
|
263
|
-
for idx, row in results_df.iterrows():
|
|
264
|
-
if row.get('faithfulness', 1) < 0.5:
|
|
265
|
-
issues.append({
|
|
266
|
-
"index": idx,
|
|
267
|
-
"issue": "Low faithfulness - answer may contain hallucinations",
|
|
268
|
-
"question": row['question'],
|
|
269
|
-
"answer": row['answer'][:200]
|
|
270
|
-
})
|
|
271
|
-
|
|
272
|
-
if row.get('context_recall', 1) < 0.5:
|
|
273
|
-
issues.append({
|
|
274
|
-
"index": idx,
|
|
275
|
-
"issue": "Low context recall - retrieval missing relevant docs",
|
|
276
|
-
"question": row['question']
|
|
277
|
-
})
|
|
278
|
-
|
|
279
|
-
return issues
|
|
280
|
-
```
|
|
281
|
-
|
|
282
|
-
---
|
|
283
|
-
|
|
284
|
-
## TruLens Evaluation
|
|
285
|
-
|
|
286
|
-
### Setup and Basic Usage
|
|
287
|
-
|
|
288
|
-
```python
|
|
289
|
-
# pip install trulens-eval
|
|
290
|
-
|
|
291
|
-
from trulens_eval import Tru, TruChain, Feedback
|
|
292
|
-
from trulens_eval.feedback import Groundedness
|
|
293
|
-
from trulens_eval.feedback.provider import OpenAI as fOpenAI
|
|
294
|
-
|
|
295
|
-
# Initialize TruLens
|
|
296
|
-
tru = Tru()
|
|
297
|
-
|
|
298
|
-
# Create feedback provider
|
|
299
|
-
provider = fOpenAI()
|
|
300
|
-
|
|
301
|
-
# Define feedback functions
|
|
302
|
-
f_groundedness = Feedback(
|
|
303
|
-
provider.groundedness_measure_with_cot_reasons,
|
|
304
|
-
name="Groundedness"
|
|
305
|
-
).on(
|
|
306
|
-
TruChain.select_context().node.text # Retrieved context
|
|
307
|
-
).on_output()
|
|
308
|
-
|
|
309
|
-
f_relevance = Feedback(
|
|
310
|
-
provider.relevance_with_cot_reasons,
|
|
311
|
-
name="Answer Relevance"
|
|
312
|
-
).on_input().on_output()
|
|
313
|
-
|
|
314
|
-
f_context_relevance = Feedback(
|
|
315
|
-
provider.context_relevance_with_cot_reasons,
|
|
316
|
-
name="Context Relevance"
|
|
317
|
-
).on_input().on(
|
|
318
|
-
TruChain.select_context().node.text
|
|
319
|
-
)
|
|
320
|
-
|
|
321
|
-
# Wrap your RAG chain
|
|
322
|
-
from langchain.chains import RetrievalQA
|
|
323
|
-
|
|
324
|
-
rag_chain = RetrievalQA.from_chain_type(
|
|
325
|
-
llm=llm,
|
|
326
|
-
retriever=vector_store.as_retriever()
|
|
327
|
-
)
|
|
328
|
-
|
|
329
|
-
tru_recorder = TruChain(
|
|
330
|
-
rag_chain,
|
|
331
|
-
app_id="rag-v1",
|
|
332
|
-
feedbacks=[f_groundedness, f_relevance, f_context_relevance]
|
|
333
|
-
)
|
|
334
|
-
|
|
335
|
-
# Run with recording
|
|
336
|
-
with tru_recorder as recording:
|
|
337
|
-
response = rag_chain.invoke({"query": "How do I configure authentication?"})
|
|
338
|
-
|
|
339
|
-
# View results
|
|
340
|
-
tru.run_dashboard() # Opens web UI
|
|
341
|
-
# Or get programmatically
|
|
342
|
-
records = tru.get_records_and_feedback(app_ids=["rag-v1"])
|
|
343
|
-
```
|
|
344
|
-
|
|
345
|
-
### Custom Feedback Functions
|
|
346
|
-
|
|
347
|
-
```python
|
|
348
|
-
from trulens_eval import Feedback, Select
|
|
349
|
-
|
|
350
|
-
def custom_citation_check(response: str, context: str) -> float:
|
|
351
|
-
"""Check if response cites sources from context."""
|
|
352
|
-
# Extract citations from response (e.g., [1], [Source: X])
|
|
353
|
-
import re
|
|
354
|
-
citations = re.findall(r'\[[\d\w\s:]+\]', response)
|
|
355
|
-
|
|
356
|
-
if not citations:
|
|
357
|
-
return 0.0 # No citations
|
|
358
|
-
|
|
359
|
-
# Verify citations reference actual context
|
|
360
|
-
valid_citations = sum(1 for c in citations if c.lower() in context.lower())
|
|
361
|
-
return valid_citations / len(citations)
|
|
362
|
-
|
|
363
|
-
f_citation = Feedback(
|
|
364
|
-
custom_citation_check,
|
|
365
|
-
name="Citation Accuracy"
|
|
366
|
-
).on_output().on(Select.RecordCalls.retriever.get_relevant_documents.rets.page_content)
|
|
367
|
-
```
|
|
368
|
-
|
|
369
|
-
---
|
|
370
|
-
|
|
371
|
-
## Building Custom Evaluation Pipelines
|
|
372
|
-
|
|
373
|
-
### LLM-as-Judge Evaluation
|
|
374
|
-
|
|
375
|
-
```python
|
|
376
|
-
from openai import OpenAI
|
|
377
|
-
from dataclasses import dataclass
|
|
378
|
-
from typing import Literal
|
|
379
|
-
|
|
380
|
-
client = OpenAI()
|
|
381
|
-
|
|
382
|
-
@dataclass
|
|
383
|
-
class EvalResult:
|
|
384
|
-
score: float
|
|
385
|
-
reasoning: str
|
|
386
|
-
criteria: str
|
|
387
|
-
|
|
388
|
-
def evaluate_with_llm(
|
|
389
|
-
question: str,
|
|
390
|
-
answer: str,
|
|
391
|
-
context: str,
|
|
392
|
-
criteria: Literal["faithfulness", "relevance", "completeness"]
|
|
393
|
-
) -> EvalResult:
|
|
394
|
-
"""Use LLM as judge for evaluation."""
|
|
395
|
-
|
|
396
|
-
criteria_prompts = {
|
|
397
|
-
"faithfulness": """
|
|
398
|
-
Evaluate if the answer is fully supported by the provided context.
|
|
399
|
-
Score 1.0 if every claim in the answer is verifiable from context.
|
|
400
|
-
Score 0.5 if most claims are supported but some are not.
|
|
401
|
-
Score 0.0 if the answer contains significant unsupported claims.
|
|
402
|
-
""",
|
|
403
|
-
"relevance": """
|
|
404
|
-
Evaluate if the answer directly addresses the question.
|
|
405
|
-
Score 1.0 if the answer fully addresses the question.
|
|
406
|
-
Score 0.5 if the answer partially addresses the question.
|
|
407
|
-
Score 0.0 if the answer is off-topic or doesn't address the question.
|
|
408
|
-
""",
|
|
409
|
-
"completeness": """
|
|
410
|
-
Evaluate if the answer covers all aspects of the question.
|
|
411
|
-
Score 1.0 if the answer is comprehensive and complete.
|
|
412
|
-
Score 0.5 if the answer covers main points but misses details.
|
|
413
|
-
Score 0.0 if the answer is significantly incomplete.
|
|
414
|
-
"""
|
|
415
|
-
}
|
|
416
|
-
|
|
417
|
-
response = client.chat.completions.create(
|
|
418
|
-
model="gpt-4o-mini",
|
|
419
|
-
messages=[
|
|
420
|
-
{
|
|
421
|
-
"role": "system",
|
|
422
|
-
"content": f"""You are an expert evaluator for RAG systems.
|
|
423
|
-
{criteria_prompts[criteria]}
|
|
424
|
-
|
|
425
|
-
Respond in JSON format:
|
|
426
|
-
{{"score": <0.0-1.0>, "reasoning": "<explanation>"}}"""
|
|
427
|
-
},
|
|
428
|
-
{
|
|
429
|
-
"role": "user",
|
|
430
|
-
"content": f"""Question: {question}
|
|
431
|
-
|
|
432
|
-
Context:
|
|
433
|
-
{context}
|
|
434
|
-
|
|
435
|
-
Answer: {answer}
|
|
436
|
-
|
|
437
|
-
Evaluate the answer for {criteria}:"""
|
|
438
|
-
}
|
|
439
|
-
],
|
|
440
|
-
response_format={"type": "json_object"}
|
|
441
|
-
)
|
|
442
|
-
|
|
443
|
-
import json
|
|
444
|
-
result = json.loads(response.choices[0].message.content)
|
|
445
|
-
|
|
446
|
-
return EvalResult(
|
|
447
|
-
score=result["score"],
|
|
448
|
-
reasoning=result["reasoning"],
|
|
449
|
-
criteria=criteria
|
|
450
|
-
)
|
|
451
|
-
|
|
452
|
-
# Usage
|
|
453
|
-
eval_result = evaluate_with_llm(
|
|
454
|
-
question="How do I configure OAuth2?",
|
|
455
|
-
answer="Configure OAuth2 by setting client_id and client_secret in config.yaml.",
|
|
456
|
-
context="OAuth2 configuration requires client_id, client_secret, and redirect_uri in config.yaml.",
|
|
457
|
-
criteria="faithfulness"
|
|
458
|
-
)
|
|
459
|
-
print(f"Faithfulness: {eval_result.score:.2f}")
|
|
460
|
-
print(f"Reasoning: {eval_result.reasoning}")
|
|
461
|
-
```
|
|
462
|
-
|
|
463
|
-
### Batch Evaluation Pipeline
|
|
464
|
-
|
|
465
|
-
```python
|
|
466
|
-
import asyncio
|
|
467
|
-
from tqdm.asyncio import tqdm_asyncio
|
|
468
|
-
|
|
469
|
-
async def evaluate_batch(
|
|
470
|
-
test_cases: list[dict],
|
|
471
|
-
retriever,
|
|
472
|
-
generator,
|
|
473
|
-
metrics: list[str] = ["precision", "faithfulness", "relevance"]
|
|
474
|
-
) -> dict:
|
|
475
|
-
"""Run batch evaluation on test cases."""
|
|
476
|
-
|
|
477
|
-
results = {
|
|
478
|
-
"per_sample": [],
|
|
479
|
-
"aggregated": {}
|
|
480
|
-
}
|
|
481
|
-
|
|
482
|
-
async def evaluate_single(case: dict) -> dict:
|
|
483
|
-
# Retrieve
|
|
484
|
-
retrieved = await retriever.aretrieve(case["question"])
|
|
485
|
-
retrieved_ids = [r.id for r in retrieved]
|
|
486
|
-
|
|
487
|
-
# Generate
|
|
488
|
-
answer = await generator.agenerate(
|
|
489
|
-
question=case["question"],
|
|
490
|
-
context=[r.text for r in retrieved]
|
|
491
|
-
)
|
|
492
|
-
|
|
493
|
-
# Calculate metrics
|
|
494
|
-
sample_result = {
|
|
495
|
-
"question": case["question"],
|
|
496
|
-
"answer": answer,
|
|
497
|
-
"retrieved_ids": retrieved_ids
|
|
498
|
-
}
|
|
499
|
-
|
|
500
|
-
if "relevant_ids" in case and "precision" in metrics:
|
|
501
|
-
retrieval_metrics = calculate_retrieval_metrics(
|
|
502
|
-
retrieved_ids,
|
|
503
|
-
set(case["relevant_ids"]),
|
|
504
|
-
k=5
|
|
505
|
-
)
|
|
506
|
-
sample_result["precision@5"] = retrieval_metrics.precision_at_k
|
|
507
|
-
sample_result["recall@5"] = retrieval_metrics.recall_at_k
|
|
508
|
-
|
|
509
|
-
if "faithfulness" in metrics:
|
|
510
|
-
faith_eval = evaluate_with_llm(
|
|
511
|
-
case["question"],
|
|
512
|
-
answer,
|
|
513
|
-
"\n".join([r.text for r in retrieved]),
|
|
514
|
-
"faithfulness"
|
|
515
|
-
)
|
|
516
|
-
sample_result["faithfulness"] = faith_eval.score
|
|
517
|
-
|
|
518
|
-
return sample_result
|
|
519
|
-
|
|
520
|
-
# Run evaluations concurrently
|
|
521
|
-
tasks = [evaluate_single(case) for case in test_cases]
|
|
522
|
-
results["per_sample"] = await tqdm_asyncio.gather(*tasks)
|
|
523
|
-
|
|
524
|
-
# Aggregate results
|
|
525
|
-
for metric in ["precision@5", "recall@5", "faithfulness"]:
|
|
526
|
-
scores = [r.get(metric) for r in results["per_sample"] if r.get(metric) is not None]
|
|
527
|
-
if scores:
|
|
528
|
-
results["aggregated"][metric] = {
|
|
529
|
-
"mean": sum(scores) / len(scores),
|
|
530
|
-
"min": min(scores),
|
|
531
|
-
"max": max(scores)
|
|
532
|
-
}
|
|
533
|
-
|
|
534
|
-
return results
|
|
535
|
-
```
|
|
536
|
-
|
|
537
|
-
---
|
|
538
|
-
|
|
539
|
-
## Debugging Poor Retrieval
|
|
540
|
-
|
|
541
|
-
### Retrieval Diagnostics
|
|
542
|
-
|
|
543
|
-
```python
|
|
544
|
-
def diagnose_retrieval(
|
|
545
|
-
query: str,
|
|
546
|
-
retrieved_docs: list,
|
|
547
|
-
expected_docs: list,
|
|
548
|
-
embedding_model
|
|
549
|
-
) -> dict:
|
|
550
|
-
"""Diagnose why retrieval might be failing."""
|
|
551
|
-
|
|
552
|
-
query_embedding = embedding_model.encode(query)
|
|
553
|
-
retrieved_embeddings = [embedding_model.encode(d) for d in retrieved_docs]
|
|
554
|
-
expected_embeddings = [embedding_model.encode(d) for d in expected_docs]
|
|
555
|
-
|
|
556
|
-
from sklearn.metrics.pairwise import cosine_similarity
|
|
557
|
-
import numpy as np
|
|
558
|
-
|
|
559
|
-
diagnosis = {
|
|
560
|
-
"query": query,
|
|
561
|
-
"issues": []
|
|
562
|
-
}
|
|
563
|
-
|
|
564
|
-
# Check query-document similarity
|
|
565
|
-
for i, (doc, emb) in enumerate(zip(retrieved_docs, retrieved_embeddings)):
|
|
566
|
-
sim = cosine_similarity([query_embedding], [emb])[0][0]
|
|
567
|
-
if sim < 0.5:
|
|
568
|
-
diagnosis["issues"].append({
|
|
569
|
-
"type": "low_similarity",
|
|
570
|
-
"doc_index": i,
|
|
571
|
-
"similarity": float(sim),
|
|
572
|
-
"doc_preview": doc[:100]
|
|
573
|
-
})
|
|
574
|
-
|
|
575
|
-
# Check if expected docs would score higher
|
|
576
|
-
for i, (doc, emb) in enumerate(zip(expected_docs, expected_embeddings)):
|
|
577
|
-
sim = cosine_similarity([query_embedding], [emb])[0][0]
|
|
578
|
-
retrieved_max_sim = max(
|
|
579
|
-
cosine_similarity([query_embedding], [e])[0][0]
|
|
580
|
-
for e in retrieved_embeddings
|
|
581
|
-
)
|
|
582
|
-
|
|
583
|
-
if sim > retrieved_max_sim:
|
|
584
|
-
diagnosis["issues"].append({
|
|
585
|
-
"type": "missed_better_doc",
|
|
586
|
-
"expected_doc_index": i,
|
|
587
|
-
"expected_sim": float(sim),
|
|
588
|
-
"best_retrieved_sim": float(retrieved_max_sim),
|
|
589
|
-
"doc_preview": doc[:100]
|
|
590
|
-
})
|
|
591
|
-
|
|
592
|
-
# Check for vocabulary mismatch
|
|
593
|
-
query_terms = set(query.lower().split())
|
|
594
|
-
for i, doc in enumerate(retrieved_docs):
|
|
595
|
-
doc_terms = set(doc.lower().split())
|
|
596
|
-
overlap = query_terms & doc_terms
|
|
597
|
-
if len(overlap) < len(query_terms) * 0.3:
|
|
598
|
-
diagnosis["issues"].append({
|
|
599
|
-
"type": "vocabulary_mismatch",
|
|
600
|
-
"doc_index": i,
|
|
601
|
-
"query_terms": list(query_terms),
|
|
602
|
-
"overlapping_terms": list(overlap)
|
|
603
|
-
})
|
|
604
|
-
|
|
605
|
-
return diagnosis
|
|
606
|
-
|
|
607
|
-
# Usage
|
|
608
|
-
diagnosis = diagnose_retrieval(
|
|
609
|
-
query="How to configure OAuth authentication",
|
|
610
|
-
retrieved_docs=retrieved_texts,
|
|
611
|
-
expected_docs=expected_texts,
|
|
612
|
-
embedding_model=sentence_transformer
|
|
613
|
-
)
|
|
614
|
-
|
|
615
|
-
for issue in diagnosis["issues"]:
|
|
616
|
-
print(f"Issue: {issue['type']}")
|
|
617
|
-
print(f"Details: {issue}")
|
|
618
|
-
```
|
|
619
|
-
|
|
620
|
-
### Query Analysis
|
|
621
|
-
|
|
622
|
-
```python
|
|
623
|
-
def analyze_query_performance(
|
|
624
|
-
query_logs: list[dict],
|
|
625
|
-
threshold_precision: float = 0.6
|
|
626
|
-
) -> dict:
|
|
627
|
-
"""Analyze query patterns to find systematic issues."""
|
|
628
|
-
|
|
629
|
-
analysis = {
|
|
630
|
-
"total_queries": len(query_logs),
|
|
631
|
-
"low_performing": [],
|
|
632
|
-
"patterns": {}
|
|
633
|
-
}
|
|
634
|
-
|
|
635
|
-
for log in query_logs:
|
|
636
|
-
if log.get("precision@5", 1.0) < threshold_precision:
|
|
637
|
-
analysis["low_performing"].append(log)
|
|
638
|
-
|
|
639
|
-
# Analyze low-performing queries
|
|
640
|
-
if analysis["low_performing"]:
|
|
641
|
-
# Check for common patterns
|
|
642
|
-
low_perf_queries = [l["query"] for l in analysis["low_performing"]]
|
|
643
|
-
|
|
644
|
-
# Query length analysis
|
|
645
|
-
avg_length = sum(len(q.split()) for q in low_perf_queries) / len(low_perf_queries)
|
|
646
|
-
analysis["patterns"]["avg_low_perf_query_length"] = avg_length
|
|
647
|
-
|
|
648
|
-
# Common terms in failing queries
|
|
649
|
-
from collections import Counter
|
|
650
|
-
all_terms = []
|
|
651
|
-
for q in low_perf_queries:
|
|
652
|
-
all_terms.extend(q.lower().split())
|
|
653
|
-
analysis["patterns"]["common_failing_terms"] = Counter(all_terms).most_common(10)
|
|
654
|
-
|
|
655
|
-
# Question type analysis
|
|
656
|
-
question_words = ["how", "what", "why", "when", "where", "who"]
|
|
657
|
-
question_types = Counter()
|
|
658
|
-
for q in low_perf_queries:
|
|
659
|
-
for qw in question_words:
|
|
660
|
-
if q.lower().startswith(qw):
|
|
661
|
-
question_types[qw] += 1
|
|
662
|
-
break
|
|
663
|
-
else:
|
|
664
|
-
question_types["other"] += 1
|
|
665
|
-
analysis["patterns"]["failing_question_types"] = dict(question_types)
|
|
666
|
-
|
|
667
|
-
return analysis
|
|
668
|
-
```
|
|
669
|
-
|
|
670
|
-
---
|
|
671
|
-
|
|
672
|
-
## Continuous Monitoring
|
|
673
|
-
|
|
674
|
-
### Production Metrics Dashboard
|
|
675
|
-
|
|
676
|
-
```python
|
|
677
|
-
import time
|
|
678
|
-
from dataclasses import dataclass, field
|
|
679
|
-
from collections import deque
|
|
680
|
-
from threading import Lock
|
|
681
|
-
|
|
682
|
-
@dataclass
|
|
683
|
-
class RAGMetricsCollector:
|
|
684
|
-
"""Collect and track RAG metrics in production."""
|
|
685
|
-
|
|
686
|
-
window_size: int = 1000
|
|
687
|
-
_latencies: deque = field(default_factory=lambda: deque(maxlen=1000))
|
|
688
|
-
_retrieval_scores: deque = field(default_factory=lambda: deque(maxlen=1000))
|
|
689
|
-
_generation_scores: deque = field(default_factory=lambda: deque(maxlen=1000))
|
|
690
|
-
_lock: Lock = field(default_factory=Lock)
|
|
691
|
-
|
|
692
|
-
def record_query(
|
|
693
|
-
self,
|
|
694
|
-
latency_ms: float,
|
|
695
|
-
retrieval_score: float | None = None,
|
|
696
|
-
generation_score: float | None = None
|
|
697
|
-
):
|
|
698
|
-
"""Record metrics for a single query."""
|
|
699
|
-
with self._lock:
|
|
700
|
-
self._latencies.append(latency_ms)
|
|
701
|
-
if retrieval_score is not None:
|
|
702
|
-
self._retrieval_scores.append(retrieval_score)
|
|
703
|
-
if generation_score is not None:
|
|
704
|
-
self._generation_scores.append(generation_score)
|
|
705
|
-
|
|
706
|
-
def get_summary(self) -> dict:
|
|
707
|
-
"""Get current metrics summary."""
|
|
708
|
-
with self._lock:
|
|
709
|
-
import numpy as np
|
|
710
|
-
|
|
711
|
-
summary = {
|
|
712
|
-
"queries_in_window": len(self._latencies),
|
|
713
|
-
"latency": {
|
|
714
|
-
"p50": np.percentile(self._latencies, 50) if self._latencies else 0,
|
|
715
|
-
"p95": np.percentile(self._latencies, 95) if self._latencies else 0,
|
|
716
|
-
"p99": np.percentile(self._latencies, 99) if self._latencies else 0,
|
|
717
|
-
},
|
|
718
|
-
"retrieval_score": {
|
|
719
|
-
"mean": np.mean(self._retrieval_scores) if self._retrieval_scores else 0,
|
|
720
|
-
"std": np.std(self._retrieval_scores) if self._retrieval_scores else 0,
|
|
721
|
-
},
|
|
722
|
-
"generation_score": {
|
|
723
|
-
"mean": np.mean(self._generation_scores) if self._generation_scores else 0,
|
|
724
|
-
"std": np.std(self._generation_scores) if self._generation_scores else 0,
|
|
725
|
-
}
|
|
726
|
-
}
|
|
727
|
-
|
|
728
|
-
return summary
|
|
729
|
-
|
|
730
|
-
# Usage
|
|
731
|
-
metrics = RAGMetricsCollector()
|
|
732
|
-
|
|
733
|
-
# In your RAG endpoint
|
|
734
|
-
start = time.time()
|
|
735
|
-
response = rag_pipeline.query(question)
|
|
736
|
-
latency = (time.time() - start) * 1000
|
|
737
|
-
|
|
738
|
-
metrics.record_query(
|
|
739
|
-
latency_ms=latency,
|
|
740
|
-
retrieval_score=response.get("retrieval_score"),
|
|
741
|
-
generation_score=response.get("generation_score")
|
|
742
|
-
)
|
|
743
|
-
|
|
744
|
-
# Periodically check
|
|
745
|
-
print(metrics.get_summary())
|
|
746
|
-
```
|
|
747
|
-
|
|
748
|
-
### Alerting on Quality Degradation
|
|
749
|
-
|
|
750
|
-
```python
|
|
751
|
-
class RAGQualityMonitor:
|
|
752
|
-
"""Monitor RAG quality and alert on degradation."""
|
|
753
|
-
|
|
754
|
-
def __init__(
|
|
755
|
-
self,
|
|
756
|
-
baseline_precision: float = 0.8,
|
|
757
|
-
alert_threshold: float = 0.1, # Alert if drops by 10%
|
|
758
|
-
window_size: int = 100
|
|
759
|
-
):
|
|
760
|
-
self.baseline = baseline_precision
|
|
761
|
-
self.threshold = alert_threshold
|
|
762
|
-
self.window_size = window_size
|
|
763
|
-
self.recent_scores = deque(maxlen=window_size)
|
|
764
|
-
|
|
765
|
-
def record_score(self, precision: float) -> dict | None:
|
|
766
|
-
"""Record score and return alert if quality degraded."""
|
|
767
|
-
self.recent_scores.append(precision)
|
|
768
|
-
|
|
769
|
-
if len(self.recent_scores) < self.window_size // 2:
|
|
770
|
-
return None # Not enough data
|
|
771
|
-
|
|
772
|
-
current_mean = sum(self.recent_scores) / len(self.recent_scores)
|
|
773
|
-
degradation = self.baseline - current_mean
|
|
774
|
-
|
|
775
|
-
if degradation > self.threshold:
|
|
776
|
-
return {
|
|
777
|
-
"alert": "QUALITY_DEGRADATION",
|
|
778
|
-
"baseline": self.baseline,
|
|
779
|
-
"current": current_mean,
|
|
780
|
-
"degradation": degradation,
|
|
781
|
-
"window_size": len(self.recent_scores)
|
|
782
|
-
}
|
|
783
|
-
|
|
784
|
-
return None
|
|
785
|
-
|
|
786
|
-
# Usage
|
|
787
|
-
monitor = RAGQualityMonitor(baseline_precision=0.85)
|
|
788
|
-
|
|
789
|
-
for query_result in production_queries:
|
|
790
|
-
alert = monitor.record_score(query_result["precision@5"])
|
|
791
|
-
if alert:
|
|
792
|
-
send_alert(alert) # Slack, PagerDuty, etc.
|
|
793
|
-
```
|
|
794
|
-
|
|
795
|
-
---
|
|
796
|
-
|
|
797
|
-
## Evaluation Best Practices
|
|
798
|
-
|
|
799
|
-
| Practice | Description |
|
|
800
|
-
|----------|-------------|
|
|
801
|
-
| **Golden test set** | Maintain 50-200 curated Q&A pairs with ground truth |
|
|
802
|
-
| **Stratified sampling** | Include diverse query types in test set |
|
|
803
|
-
| **Human baselines** | Compare LLM judges against human annotators |
|
|
804
|
-
| **Version control** | Track evaluation results alongside model versions |
|
|
805
|
-
| **Regular re-evaluation** | Re-run golden tests on every retrieval change |
|
|
806
|
-
| **A/B testing** | Compare new retrieval strategies on live traffic |
|
|
807
|
-
|
|
808
|
-
---
|
|
809
|
-
|
|
810
|
-
## Quick Reference
|
|
811
|
-
|
|
812
|
-
| Goal | Metric | Target |
|
|
813
|
-
|------|--------|--------|
|
|
814
|
-
| Are docs relevant? | Precision@5 | > 0.7 |
|
|
815
|
-
| Did we get all docs? | Recall@5 | > 0.8 |
|
|
816
|
-
| Is ranking good? | NDCG@5 | > 0.7 |
|
|
817
|
-
| Is answer grounded? | Faithfulness | > 0.9 |
|
|
818
|
-
| Does answer fit question? | Answer Relevance | > 0.8 |
|
|
819
|
-
| Is context useful? | Context Relevance | > 0.7 |
|
|
820
|
-
|
|
821
|
-
| Framework | Best For |
|
|
822
|
-
|-----------|----------|
|
|
823
|
-
| RAGAS | Quick RAG-specific evaluation |
|
|
824
|
-
| TruLens | Production monitoring and tracing |
|
|
825
|
-
| Custom LLM-judge | Domain-specific criteria |
|
|
826
|
-
| Manual annotation | Ground truth creation |
|
|
827
|
-
|
|
828
|
-
## Related Skills
|
|
829
|
-
|
|
830
|
-
- **RAG Architect** - System design
|
|
831
|
-
- **ML Pipeline** - Evaluation automation
|
|
832
|
-
- **Data Scientist** - Statistical analysis
|
|
833
|
-
- **Monitoring Expert** - Production observability
|