aigroup-workflow 2.1.1 → 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.
Files changed (914) hide show
  1. package/.codex/AGENTS.md +1 -1
  2. package/CLAUDE.md +1 -4
  3. package/README.md +333 -333
  4. package/cli/commands/init.mjs +20 -6
  5. package/cli/utils/scaffold.mjs +39 -9
  6. package/docs/red-flags.md +1 -1
  7. package/docs/rules/coding-style.md +21 -1
  8. package/docs/rules/entropy.md +1 -1
  9. package/docs/rules/performance.md +1 -1
  10. package/docs/workflow-pipeline.md +1 -0
  11. package/manifests/install-modules.json +223 -133
  12. package/package.json +39 -39
  13. package/scripts/orchestration/lib/orchestrator.cjs +34 -0
  14. package/scripts/orchestration/session.cjs +24 -1
  15. package/skills/ai-ml/fine-tuning-expert/SKILL.md +162 -0
  16. package/skills/ai-ml/fine-tuning-expert/references/dataset-preparation.md +540 -0
  17. package/skills/ai-ml/fine-tuning-expert/references/deployment-optimization.md +673 -0
  18. package/skills/ai-ml/fine-tuning-expert/references/evaluation-metrics.md +597 -0
  19. package/skills/ai-ml/fine-tuning-expert/references/hyperparameter-tuning.md +565 -0
  20. package/skills/ai-ml/fine-tuning-expert/references/lora-peft.md +347 -0
  21. package/skills/ai-ml/ml-pipeline/SKILL.md +159 -0
  22. package/skills/ai-ml/ml-pipeline/references/experiment-tracking.md +833 -0
  23. package/skills/ai-ml/ml-pipeline/references/feature-engineering.md +631 -0
  24. package/skills/ai-ml/ml-pipeline/references/model-validation.md +978 -0
  25. package/skills/ai-ml/ml-pipeline/references/pipeline-orchestration.md +907 -0
  26. package/skills/ai-ml/ml-pipeline/references/training-pipelines.md +782 -0
  27. package/skills/ai-ml/rag-architect/SKILL.md +194 -0
  28. package/skills/ai-ml/rag-architect/references/chunking-strategies.md +878 -0
  29. package/skills/ai-ml/rag-architect/references/embedding-models.md +561 -0
  30. package/skills/ai-ml/rag-architect/references/rag-evaluation.md +833 -0
  31. package/skills/ai-ml/rag-architect/references/retrieval-optimization.md +795 -0
  32. package/skills/ai-ml/rag-architect/references/vector-databases.md +589 -0
  33. package/skills/ai-ml/spark-engineer/SKILL.md +148 -0
  34. package/skills/ai-ml/spark-engineer/references/partitioning-caching.md +543 -0
  35. package/skills/ai-ml/spark-engineer/references/performance-tuning.md +544 -0
  36. package/skills/ai-ml/spark-engineer/references/rdd-operations.md +599 -0
  37. package/skills/ai-ml/spark-engineer/references/spark-sql-dataframes.md +474 -0
  38. package/skills/ai-ml/spark-engineer/references/streaming-patterns.md +786 -0
  39. package/skills/backend/api-designer/SKILL.md +217 -0
  40. package/skills/backend/api-designer/references/error-handling.md +541 -0
  41. package/skills/backend/api-designer/references/openapi.md +824 -0
  42. package/skills/backend/api-designer/references/pagination.md +494 -0
  43. package/skills/backend/api-designer/references/rest-patterns.md +335 -0
  44. package/skills/backend/api-designer/references/versioning.md +391 -0
  45. package/skills/backend/architecture-designer/SKILL.md +117 -0
  46. package/skills/backend/architecture-designer/references/adr-template.md +116 -0
  47. package/skills/backend/architecture-designer/references/architecture-patterns.md +111 -0
  48. package/skills/backend/architecture-designer/references/database-selection.md +102 -0
  49. package/skills/backend/architecture-designer/references/nfr-checklist.md +112 -0
  50. package/skills/backend/architecture-designer/references/system-design.md +100 -0
  51. package/skills/backend/code-documenter/SKILL.md +147 -0
  52. package/skills/backend/code-documenter/references/api-docs-fastapi-django.md +166 -0
  53. package/skills/backend/code-documenter/references/api-docs-nestjs-express.md +220 -0
  54. package/skills/backend/code-documenter/references/coverage-reports.md +125 -0
  55. package/skills/backend/code-documenter/references/documentation-systems.md +333 -0
  56. package/skills/backend/code-documenter/references/interactive-api-docs.md +531 -0
  57. package/skills/backend/code-documenter/references/python-docstrings.md +121 -0
  58. package/skills/backend/code-documenter/references/typescript-jsdoc.md +145 -0
  59. package/skills/backend/code-documenter/references/user-guides-tutorials.md +530 -0
  60. package/skills/backend/debugging-wizard/SKILL.md +105 -0
  61. package/skills/backend/debugging-wizard/references/common-patterns.md +132 -0
  62. package/skills/backend/debugging-wizard/references/debugging-tools.md +140 -0
  63. package/skills/backend/debugging-wizard/references/quick-fixes.md +177 -0
  64. package/skills/backend/debugging-wizard/references/strategies.md +142 -0
  65. package/skills/backend/debugging-wizard/references/systematic-debugging.md +367 -0
  66. package/skills/backend/feature-forge/SKILL.md +98 -0
  67. package/skills/backend/feature-forge/references/acceptance-criteria.md +104 -0
  68. package/skills/backend/feature-forge/references/ears-syntax.md +99 -0
  69. package/skills/backend/feature-forge/references/interview-questions.md +150 -0
  70. package/skills/backend/feature-forge/references/pre-discovery-subagents.md +54 -0
  71. package/skills/backend/feature-forge/references/specification-template.md +103 -0
  72. package/skills/backend/fullstack-guardian/SKILL.md +105 -0
  73. package/skills/backend/fullstack-guardian/references/api-design-standards.md +307 -0
  74. package/skills/backend/fullstack-guardian/references/architecture-decisions.md +350 -0
  75. package/skills/backend/fullstack-guardian/references/backend-patterns.md +237 -0
  76. package/skills/backend/fullstack-guardian/references/common-patterns.md +134 -0
  77. package/skills/backend/fullstack-guardian/references/deliverables-checklist.md +354 -0
  78. package/skills/backend/fullstack-guardian/references/design-template.md +91 -0
  79. package/skills/backend/fullstack-guardian/references/error-handling.md +135 -0
  80. package/skills/backend/fullstack-guardian/references/frontend-patterns.md +340 -0
  81. package/skills/backend/fullstack-guardian/references/integration-patterns.md +333 -0
  82. package/skills/backend/fullstack-guardian/references/security-checklist.md +106 -0
  83. package/skills/backend/graphql-architect/SKILL.md +146 -0
  84. package/skills/backend/graphql-architect/references/federation.md +418 -0
  85. package/skills/backend/graphql-architect/references/migration-from-rest.md +1141 -0
  86. package/skills/backend/graphql-architect/references/resolvers.md +425 -0
  87. package/skills/backend/graphql-architect/references/schema-design.md +393 -0
  88. package/skills/backend/graphql-architect/references/security.md +569 -0
  89. package/skills/backend/graphql-architect/references/subscriptions.md +510 -0
  90. package/skills/backend/legacy-modernizer/SKILL.md +137 -0
  91. package/skills/backend/legacy-modernizer/references/legacy-testing.md +381 -0
  92. package/skills/backend/legacy-modernizer/references/migration-strategies.md +423 -0
  93. package/skills/backend/legacy-modernizer/references/refactoring-patterns.md +395 -0
  94. package/skills/backend/legacy-modernizer/references/strangler-fig-pattern.md +281 -0
  95. package/skills/backend/legacy-modernizer/references/system-assessment.md +487 -0
  96. package/skills/backend/microservices-architect/SKILL.md +164 -0
  97. package/skills/backend/microservices-architect/references/communication.md +499 -0
  98. package/skills/backend/microservices-architect/references/data.md +721 -0
  99. package/skills/backend/microservices-architect/references/decomposition.md +344 -0
  100. package/skills/backend/microservices-architect/references/observability.md +805 -0
  101. package/skills/backend/microservices-architect/references/patterns.md +603 -0
  102. package/skills/database/database-optimizer/SKILL.md +147 -0
  103. package/skills/database/database-optimizer/references/index-strategies.md +331 -0
  104. package/skills/database/database-optimizer/references/monitoring-analysis.md +501 -0
  105. package/skills/database/database-optimizer/references/mysql-tuning.md +452 -0
  106. package/skills/database/database-optimizer/references/postgresql-tuning.md +413 -0
  107. package/skills/database/database-optimizer/references/query-optimization.md +251 -0
  108. package/skills/database/postgres-pro/SKILL.md +152 -0
  109. package/skills/database/postgres-pro/references/extensions.md +404 -0
  110. package/skills/database/postgres-pro/references/jsonb.md +321 -0
  111. package/skills/database/postgres-pro/references/maintenance.md +481 -0
  112. package/skills/database/postgres-pro/references/performance.md +265 -0
  113. package/skills/database/postgres-pro/references/replication.md +446 -0
  114. package/skills/database/sql-pro/SKILL.md +129 -0
  115. package/skills/database/sql-pro/references/database-design.md +402 -0
  116. package/skills/database/sql-pro/references/dialect-differences.md +419 -0
  117. package/skills/database/sql-pro/references/optimization.md +384 -0
  118. package/skills/database/sql-pro/references/query-patterns.md +285 -0
  119. package/skills/database/sql-pro/references/window-functions.md +328 -0
  120. package/skills/dotnet/csharp-developer/SKILL.md +125 -0
  121. package/skills/dotnet/csharp-developer/references/aspnet-core.md +394 -0
  122. package/skills/dotnet/csharp-developer/references/blazor.md +553 -0
  123. package/skills/dotnet/csharp-developer/references/entity-framework.md +409 -0
  124. package/skills/dotnet/csharp-developer/references/modern-csharp.md +248 -0
  125. package/skills/dotnet/csharp-developer/references/performance.md +498 -0
  126. package/skills/dotnet/dotnet-core-expert/SKILL.md +138 -0
  127. package/skills/dotnet/dotnet-core-expert/references/authentication.md +546 -0
  128. package/skills/dotnet/dotnet-core-expert/references/clean-architecture.md +455 -0
  129. package/skills/dotnet/dotnet-core-expert/references/cloud-native.md +548 -0
  130. package/skills/dotnet/dotnet-core-expert/references/entity-framework.md +440 -0
  131. package/skills/dotnet/dotnet-core-expert/references/minimal-apis.md +319 -0
  132. package/skills/frontend/angular-architect/SKILL.md +152 -0
  133. package/skills/frontend/angular-architect/references/components.md +297 -0
  134. package/skills/frontend/angular-architect/references/ngrx.md +401 -0
  135. package/skills/frontend/angular-architect/references/routing.md +361 -0
  136. package/skills/frontend/angular-architect/references/rxjs.md +319 -0
  137. package/skills/frontend/angular-architect/references/testing.md +405 -0
  138. package/skills/frontend/flutter-expert/SKILL.md +138 -0
  139. package/skills/frontend/flutter-expert/references/bloc-state.md +259 -0
  140. package/skills/frontend/flutter-expert/references/gorouter-navigation.md +119 -0
  141. package/skills/frontend/flutter-expert/references/performance.md +99 -0
  142. package/skills/frontend/flutter-expert/references/project-structure.md +118 -0
  143. package/skills/frontend/flutter-expert/references/riverpod-state.md +130 -0
  144. package/skills/frontend/flutter-expert/references/widget-patterns.md +123 -0
  145. package/skills/frontend/nextjs-developer/SKILL.md +143 -0
  146. package/skills/frontend/nextjs-developer/references/app-router.md +311 -0
  147. package/skills/frontend/nextjs-developer/references/data-fetching.md +482 -0
  148. package/skills/frontend/nextjs-developer/references/deployment.md +545 -0
  149. package/skills/frontend/nextjs-developer/references/server-actions.md +462 -0
  150. package/skills/frontend/nextjs-developer/references/server-components.md +384 -0
  151. package/skills/frontend/react-expert/SKILL.md +149 -0
  152. package/skills/frontend/react-expert/references/hooks-patterns.md +162 -0
  153. package/skills/frontend/react-expert/references/migration-class-to-modern.md +1119 -0
  154. package/skills/frontend/react-expert/references/performance.md +168 -0
  155. package/skills/frontend/react-expert/references/react-19-features.md +174 -0
  156. package/skills/frontend/react-expert/references/server-components.md +143 -0
  157. package/skills/frontend/react-expert/references/state-management.md +171 -0
  158. package/skills/frontend/react-expert/references/testing-react.md +174 -0
  159. package/skills/frontend/react-native-expert/SKILL.md +185 -0
  160. package/skills/frontend/react-native-expert/references/expo-router.md +187 -0
  161. package/skills/frontend/react-native-expert/references/list-optimization.md +204 -0
  162. package/skills/frontend/react-native-expert/references/platform-handling.md +188 -0
  163. package/skills/frontend/react-native-expert/references/project-structure.md +171 -0
  164. package/skills/frontend/react-native-expert/references/storage-hooks.md +173 -0
  165. package/skills/frontend/vue-expert/SKILL.md +98 -0
  166. package/skills/frontend/vue-expert/references/build-tooling.md +480 -0
  167. package/skills/frontend/vue-expert/references/components.md +448 -0
  168. package/skills/frontend/vue-expert/references/composition-api.md +299 -0
  169. package/skills/frontend/vue-expert/references/mobile-hybrid.md +636 -0
  170. package/skills/frontend/vue-expert/references/nuxt.md +669 -0
  171. package/skills/frontend/vue-expert/references/state-management.md +449 -0
  172. package/skills/frontend/vue-expert/references/typescript.md +584 -0
  173. package/skills/frontend/vue-expert-js/SKILL.md +167 -0
  174. package/skills/frontend/vue-expert-js/references/component-architecture.md +219 -0
  175. package/skills/frontend/vue-expert-js/references/composables-patterns.md +183 -0
  176. package/skills/frontend/vue-expert-js/references/jsdoc-typing.md +535 -0
  177. package/skills/frontend/vue-expert-js/references/state-management.md +249 -0
  178. package/skills/frontend/vue-expert-js/references/testing-patterns.md +237 -0
  179. package/skills/go-rust-cpp/cpp-pro/SKILL.md +115 -0
  180. package/skills/go-rust-cpp/cpp-pro/references/build-tooling.md +440 -0
  181. package/skills/go-rust-cpp/cpp-pro/references/concurrency.md +437 -0
  182. package/skills/go-rust-cpp/cpp-pro/references/memory-performance.md +397 -0
  183. package/skills/go-rust-cpp/cpp-pro/references/modern-cpp.md +304 -0
  184. package/skills/go-rust-cpp/cpp-pro/references/templates.md +357 -0
  185. package/skills/go-rust-cpp/golang-pro/SKILL.md +122 -0
  186. package/skills/go-rust-cpp/golang-pro/references/concurrency.md +329 -0
  187. package/skills/go-rust-cpp/golang-pro/references/generics.md +442 -0
  188. package/skills/go-rust-cpp/golang-pro/references/interfaces.md +432 -0
  189. package/skills/go-rust-cpp/golang-pro/references/project-structure.md +477 -0
  190. package/skills/go-rust-cpp/golang-pro/references/testing.md +451 -0
  191. package/skills/go-rust-cpp/rust-engineer/SKILL.md +167 -0
  192. package/skills/go-rust-cpp/rust-engineer/references/async.md +458 -0
  193. package/skills/go-rust-cpp/rust-engineer/references/error-handling.md +334 -0
  194. package/skills/go-rust-cpp/rust-engineer/references/ownership.md +278 -0
  195. package/skills/go-rust-cpp/rust-engineer/references/testing.md +470 -0
  196. package/skills/go-rust-cpp/rust-engineer/references/traits.md +413 -0
  197. package/skills/infra/cli-developer/SKILL.md +113 -0
  198. package/skills/infra/cli-developer/references/design-patterns.md +221 -0
  199. package/skills/infra/cli-developer/references/go-cli.md +540 -0
  200. package/skills/infra/cli-developer/references/node-cli.md +383 -0
  201. package/skills/infra/cli-developer/references/python-cli.md +422 -0
  202. package/skills/infra/cli-developer/references/ux-patterns.md +448 -0
  203. package/skills/infra/cloud-architect/SKILL.md +216 -0
  204. package/skills/infra/cloud-architect/references/aws.md +394 -0
  205. package/skills/infra/cloud-architect/references/azure.md +562 -0
  206. package/skills/infra/cloud-architect/references/cost.md +582 -0
  207. package/skills/infra/cloud-architect/references/gcp.md +633 -0
  208. package/skills/infra/cloud-architect/references/multi-cloud.md +483 -0
  209. package/skills/infra/devops-engineer/SKILL.md +144 -0
  210. package/skills/infra/devops-engineer/references/deployment-strategies.md +241 -0
  211. package/skills/infra/devops-engineer/references/docker-patterns.md +113 -0
  212. package/skills/infra/devops-engineer/references/github-actions.md +139 -0
  213. package/skills/infra/devops-engineer/references/incident-response.md +331 -0
  214. package/skills/infra/devops-engineer/references/kubernetes.md +154 -0
  215. package/skills/infra/devops-engineer/references/platform-engineering.md +417 -0
  216. package/skills/infra/devops-engineer/references/release-automation.md +527 -0
  217. package/skills/infra/devops-engineer/references/terraform-iac.md +141 -0
  218. package/skills/infra/kubernetes-specialist/SKILL.md +241 -0
  219. package/skills/infra/kubernetes-specialist/references/configuration.md +452 -0
  220. package/skills/infra/kubernetes-specialist/references/cost-optimization.md +458 -0
  221. package/skills/infra/kubernetes-specialist/references/custom-operators.md +563 -0
  222. package/skills/infra/kubernetes-specialist/references/gitops.md +530 -0
  223. package/skills/infra/kubernetes-specialist/references/helm-charts.md +912 -0
  224. package/skills/infra/kubernetes-specialist/references/multi-cluster.md +507 -0
  225. package/skills/infra/kubernetes-specialist/references/networking.md +447 -0
  226. package/skills/infra/kubernetes-specialist/references/service-mesh.md +459 -0
  227. package/skills/infra/kubernetes-specialist/references/storage.md +535 -0
  228. package/skills/infra/kubernetes-specialist/references/troubleshooting.md +414 -0
  229. package/skills/infra/kubernetes-specialist/references/workloads.md +377 -0
  230. package/skills/infra/mcp-developer/SKILL.md +143 -0
  231. package/skills/infra/mcp-developer/references/protocol.md +244 -0
  232. package/skills/infra/mcp-developer/references/python-sdk.md +367 -0
  233. package/skills/infra/mcp-developer/references/resources.md +554 -0
  234. package/skills/infra/mcp-developer/references/tools.md +480 -0
  235. package/skills/infra/mcp-developer/references/typescript-sdk.md +350 -0
  236. package/skills/infra/monitoring-expert/SKILL.md +176 -0
  237. package/skills/infra/monitoring-expert/references/alerting-rules.md +141 -0
  238. package/skills/infra/monitoring-expert/references/application-profiling.md +331 -0
  239. package/skills/infra/monitoring-expert/references/capacity-planning.md +344 -0
  240. package/skills/infra/monitoring-expert/references/dashboards.md +126 -0
  241. package/skills/infra/monitoring-expert/references/opentelemetry.md +123 -0
  242. package/skills/infra/monitoring-expert/references/performance-testing.md +269 -0
  243. package/skills/infra/monitoring-expert/references/prometheus-metrics.md +136 -0
  244. package/skills/infra/monitoring-expert/references/structured-logging.md +142 -0
  245. package/skills/infra/sre-engineer/SKILL.md +181 -0
  246. package/skills/infra/sre-engineer/references/automation-toil.md +492 -0
  247. package/skills/infra/sre-engineer/references/error-budget-policy.md +334 -0
  248. package/skills/infra/sre-engineer/references/incident-chaos.md +576 -0
  249. package/skills/infra/sre-engineer/references/monitoring-alerting.md +424 -0
  250. package/skills/infra/sre-engineer/references/slo-sli-management.md +238 -0
  251. package/skills/infra/terraform-engineer/SKILL.md +143 -0
  252. package/skills/infra/terraform-engineer/references/best-practices.md +583 -0
  253. package/skills/infra/terraform-engineer/references/module-patterns.md +297 -0
  254. package/skills/infra/terraform-engineer/references/providers.md +452 -0
  255. package/skills/infra/terraform-engineer/references/state-management.md +371 -0
  256. package/skills/infra/terraform-engineer/references/testing.md +486 -0
  257. package/skills/infra/websocket-engineer/SKILL.md +168 -0
  258. package/skills/infra/websocket-engineer/references/alternatives.md +391 -0
  259. package/skills/infra/websocket-engineer/references/patterns.md +400 -0
  260. package/skills/infra/websocket-engineer/references/protocol.md +195 -0
  261. package/skills/infra/websocket-engineer/references/scaling.md +333 -0
  262. package/skills/infra/websocket-engineer/references/security.md +474 -0
  263. package/skills/java/java-architect/SKILL.md +132 -0
  264. package/skills/java/java-architect/references/jpa-optimization.md +393 -0
  265. package/skills/java/java-architect/references/reactive-webflux.md +356 -0
  266. package/skills/java/java-architect/references/spring-boot-setup.md +269 -0
  267. package/skills/java/java-architect/references/spring-security.md +445 -0
  268. package/skills/java/java-architect/references/testing-patterns.md +500 -0
  269. package/skills/java/kotlin-specialist/SKILL.md +147 -0
  270. package/skills/java/kotlin-specialist/references/android-compose.md +419 -0
  271. package/skills/java/kotlin-specialist/references/coroutines-flow.md +276 -0
  272. package/skills/java/kotlin-specialist/references/dsl-idioms.md +421 -0
  273. package/skills/java/kotlin-specialist/references/ktor-server.md +426 -0
  274. package/skills/java/kotlin-specialist/references/multiplatform-kmp.md +380 -0
  275. package/skills/java/spring-boot-engineer/SKILL.md +195 -0
  276. package/skills/java/spring-boot-engineer/references/cloud.md +498 -0
  277. package/skills/java/spring-boot-engineer/references/data.md +381 -0
  278. package/skills/java/spring-boot-engineer/references/security.md +459 -0
  279. package/skills/java/spring-boot-engineer/references/testing.md +545 -0
  280. package/skills/java/spring-boot-engineer/references/web.md +295 -0
  281. package/skills/javascript/javascript-pro/SKILL.md +132 -0
  282. package/skills/javascript/javascript-pro/references/async-patterns.md +334 -0
  283. package/skills/javascript/javascript-pro/references/browser-apis.md +398 -0
  284. package/skills/javascript/javascript-pro/references/modern-syntax.md +272 -0
  285. package/skills/javascript/javascript-pro/references/modules.md +357 -0
  286. package/skills/javascript/javascript-pro/references/node-essentials.md +471 -0
  287. package/skills/javascript/nestjs-expert/SKILL.md +206 -0
  288. package/skills/javascript/nestjs-expert/references/authentication.md +166 -0
  289. package/skills/javascript/nestjs-expert/references/controllers-routing.md +111 -0
  290. package/skills/javascript/nestjs-expert/references/dtos-validation.md +153 -0
  291. package/skills/javascript/nestjs-expert/references/migration-from-express.md +1237 -0
  292. package/skills/javascript/nestjs-expert/references/services-di.md +140 -0
  293. package/skills/javascript/nestjs-expert/references/testing-patterns.md +186 -0
  294. package/skills/javascript/typescript-pro/SKILL.md +145 -0
  295. package/skills/javascript/typescript-pro/references/advanced-types.md +259 -0
  296. package/skills/javascript/typescript-pro/references/configuration.md +445 -0
  297. package/skills/javascript/typescript-pro/references/patterns.md +484 -0
  298. package/skills/javascript/typescript-pro/references/type-guards.md +352 -0
  299. package/skills/javascript/typescript-pro/references/utility-types.md +329 -0
  300. package/skills/php/laravel-specialist/SKILL.md +262 -0
  301. package/skills/php/laravel-specialist/references/eloquent.md +351 -0
  302. package/skills/php/laravel-specialist/references/livewire.md +512 -0
  303. package/skills/php/laravel-specialist/references/queues.md +423 -0
  304. package/skills/php/laravel-specialist/references/routing.md +362 -0
  305. package/skills/php/laravel-specialist/references/testing.md +522 -0
  306. package/skills/php/php-pro/SKILL.md +206 -0
  307. package/skills/php/php-pro/references/async-patterns.md +412 -0
  308. package/skills/php/php-pro/references/laravel-patterns.md +377 -0
  309. package/skills/php/php-pro/references/modern-php-features.md +323 -0
  310. package/skills/php/php-pro/references/symfony-patterns.md +466 -0
  311. package/skills/php/php-pro/references/testing-quality.md +466 -0
  312. package/skills/python/django-expert/SKILL.md +162 -0
  313. package/skills/python/django-expert/references/authentication.md +145 -0
  314. package/skills/python/django-expert/references/drf-serializers.md +148 -0
  315. package/skills/python/django-expert/references/models-orm.md +151 -0
  316. package/skills/python/django-expert/references/testing-django.md +204 -0
  317. package/skills/python/django-expert/references/viewsets-views.md +153 -0
  318. package/skills/python/fastapi-expert/SKILL.md +185 -0
  319. package/skills/python/fastapi-expert/references/async-sqlalchemy.md +146 -0
  320. package/skills/python/fastapi-expert/references/authentication.md +159 -0
  321. package/skills/python/fastapi-expert/references/endpoints-routing.md +142 -0
  322. package/skills/python/fastapi-expert/references/migration-from-django.md +997 -0
  323. package/skills/python/fastapi-expert/references/pydantic-v2.md +135 -0
  324. package/skills/python/fastapi-expert/references/testing-async.md +159 -0
  325. package/skills/python/pandas-pro/SKILL.md +178 -0
  326. package/skills/python/pandas-pro/references/aggregation-groupby.md +545 -0
  327. package/skills/python/pandas-pro/references/data-cleaning.md +500 -0
  328. package/skills/python/pandas-pro/references/dataframe-operations.md +420 -0
  329. package/skills/python/pandas-pro/references/merging-joining.md +596 -0
  330. package/skills/python/pandas-pro/references/performance-optimization.md +597 -0
  331. package/skills/python/python-pro/SKILL.md +177 -0
  332. package/skills/python/python-pro/references/async-patterns.md +356 -0
  333. package/skills/python/python-pro/references/packaging.md +460 -0
  334. package/skills/python/python-pro/references/standard-library.md +378 -0
  335. package/skills/python/python-pro/references/testing.md +404 -0
  336. package/skills/python/python-pro/references/type-system.md +290 -0
  337. package/skills/quality/chaos-engineer/SKILL.md +182 -0
  338. package/skills/quality/chaos-engineer/references/chaos-tools.md +511 -0
  339. package/skills/quality/chaos-engineer/references/experiment-design.md +229 -0
  340. package/skills/quality/chaos-engineer/references/game-days.md +434 -0
  341. package/skills/quality/chaos-engineer/references/infrastructure-chaos.md +348 -0
  342. package/skills/quality/chaos-engineer/references/kubernetes-chaos.md +432 -0
  343. package/skills/quality/code-reviewer/SKILL.md +119 -0
  344. package/skills/quality/code-reviewer/references/common-issues.md +142 -0
  345. package/skills/quality/code-reviewer/references/feedback-examples.md +144 -0
  346. package/skills/quality/code-reviewer/references/receiving-feedback.md +238 -0
  347. package/skills/quality/code-reviewer/references/report-template.md +109 -0
  348. package/skills/quality/code-reviewer/references/review-checklist.md +88 -0
  349. package/skills/quality/code-reviewer/references/spec-compliance-review.md +258 -0
  350. package/skills/quality/playwright-expert/SKILL.md +169 -0
  351. package/skills/quality/playwright-expert/references/api-mocking.md +140 -0
  352. package/skills/quality/playwright-expert/references/configuration.md +155 -0
  353. package/skills/quality/playwright-expert/references/debugging-flaky.md +150 -0
  354. package/skills/quality/playwright-expert/references/page-object-model.md +152 -0
  355. package/skills/quality/playwright-expert/references/selectors-locators.md +119 -0
  356. package/skills/quality/secure-code-guardian/SKILL.md +191 -0
  357. package/skills/quality/secure-code-guardian/references/authentication.md +136 -0
  358. package/skills/quality/secure-code-guardian/references/input-validation.md +146 -0
  359. package/skills/quality/secure-code-guardian/references/owasp-prevention.md +135 -0
  360. package/skills/quality/secure-code-guardian/references/security-headers.md +133 -0
  361. package/skills/quality/secure-code-guardian/references/xss-csrf.md +157 -0
  362. package/skills/quality/security-reviewer/SKILL.md +103 -0
  363. package/skills/quality/security-reviewer/references/infrastructure-security.md +268 -0
  364. package/skills/quality/security-reviewer/references/penetration-testing.md +268 -0
  365. package/skills/quality/security-reviewer/references/report-template.md +170 -0
  366. package/skills/quality/security-reviewer/references/sast-tools.md +117 -0
  367. package/skills/quality/security-reviewer/references/secret-scanning.md +125 -0
  368. package/skills/quality/security-reviewer/references/vulnerability-patterns.md +152 -0
  369. package/skills/quality/tdd-guide/assets/sample_coverage_report.lcov +0 -0
  370. package/skills/quality/test-master/SKILL.md +94 -0
  371. package/skills/quality/test-master/references/automation-frameworks.md +294 -0
  372. package/skills/quality/test-master/references/e2e-testing.md +128 -0
  373. package/skills/quality/test-master/references/integration-testing.md +120 -0
  374. package/skills/quality/test-master/references/performance-testing.md +118 -0
  375. package/skills/quality/test-master/references/qa-methodology.md +247 -0
  376. package/skills/quality/test-master/references/security-testing.md +127 -0
  377. package/skills/quality/test-master/references/tdd-iron-laws.md +174 -0
  378. package/skills/quality/test-master/references/test-reports.md +104 -0
  379. package/skills/quality/test-master/references/testing-anti-patterns.md +231 -0
  380. package/skills/quality/test-master/references/unit-testing.md +113 -0
  381. package/skills/ruby/rails-expert/SKILL.md +154 -0
  382. package/skills/ruby/rails-expert/references/active-record.md +244 -0
  383. package/skills/ruby/rails-expert/references/api-development.md +401 -0
  384. package/skills/ruby/rails-expert/references/background-jobs.md +272 -0
  385. package/skills/ruby/rails-expert/references/hotwire-turbo.md +228 -0
  386. package/skills/ruby/rails-expert/references/rspec-testing.md +367 -0
  387. package/skills/swift/swift-expert/SKILL.md +163 -0
  388. package/skills/swift/swift-expert/references/async-concurrency.md +360 -0
  389. package/skills/swift/swift-expert/references/memory-performance.md +377 -0
  390. package/skills/swift/swift-expert/references/protocol-oriented.md +354 -0
  391. package/skills/swift/swift-expert/references/swiftui-patterns.md +291 -0
  392. package/skills/swift/swift-expert/references/testing-patterns.md +399 -0
  393. package/skills/workflow/brainstorming/SKILL.md +164 -0
  394. package/skills/workflow/brainstorming/scripts/helper.js +88 -0
  395. package/skills/workflow/brainstorming/scripts/start-server.sh +148 -0
  396. package/skills/workflow/brainstorming/scripts/stop-server.sh +56 -0
  397. package/skills/workflow/brainstorming/spec-document-reviewer-prompt.md +49 -0
  398. package/skills/workflow/brainstorming/visual-companion.md +287 -0
  399. package/skills/workflow/documentation/SKILL.md +45 -0
  400. package/skills/workflow/entropy-management/SKILL.md +115 -0
  401. package/skills/workflow/executing-plans/SKILL.md +70 -0
  402. package/skills/workflow/finishing-a-development-branch/SKILL.md +200 -0
  403. package/skills/workflow/receiving-code-review/SKILL.md +213 -0
  404. package/skills/workflow/requesting-code-review/SKILL.md +105 -0
  405. package/skills/workflow/requesting-code-review/code-reviewer.md +146 -0
  406. package/skills/workflow/requirement-engineering/SKILL.md +111 -0
  407. package/skills/workflow/systematic-debugging/CREATION-LOG.md +119 -0
  408. package/skills/workflow/systematic-debugging/SKILL.md +296 -0
  409. package/skills/workflow/systematic-debugging/condition-based-waiting-example.ts +158 -0
  410. package/skills/workflow/systematic-debugging/condition-based-waiting.md +115 -0
  411. package/skills/workflow/systematic-debugging/defense-in-depth.md +122 -0
  412. package/skills/workflow/systematic-debugging/find-polluter.sh +63 -0
  413. package/skills/workflow/systematic-debugging/root-cause-tracing.md +169 -0
  414. package/skills/workflow/systematic-debugging/test-academic.md +14 -0
  415. package/skills/workflow/systematic-debugging/test-pressure-1.md +58 -0
  416. package/skills/workflow/systematic-debugging/test-pressure-2.md +68 -0
  417. package/skills/workflow/systematic-debugging/test-pressure-3.md +69 -0
  418. package/skills/workflow/using-git-worktrees/SKILL.md +218 -0
  419. package/skills/workflow/verification-before-completion/SKILL.md +139 -0
  420. package/skills/workflow/writing-plans/SKILL.md +151 -0
  421. package/skills/workflow/writing-plans/plan-document-reviewer-prompt.md +49 -0
  422. package/skills/workflow/writing-skills/SKILL.md +655 -0
  423. package/skills/workflow/writing-skills/anthropic-best-practices.md +1150 -0
  424. package/skills/workflow/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
  425. package/skills/workflow/writing-skills/graphviz-conventions.dot +0 -0
  426. package/skills/workflow/writing-skills/persuasion-principles.md +187 -0
  427. package/skills/workflow/writing-skills/render-graphs.js +168 -0
  428. package/skills/workflow/writing-skills/testing-skills-with-subagents.md +384 -0
  429. package/skills/angular-architect/SKILL.md +0 -152
  430. package/skills/angular-architect/references/components.md +0 -297
  431. package/skills/angular-architect/references/ngrx.md +0 -401
  432. package/skills/angular-architect/references/routing.md +0 -361
  433. package/skills/angular-architect/references/rxjs.md +0 -319
  434. package/skills/angular-architect/references/testing.md +0 -405
  435. package/skills/api-designer/SKILL.md +0 -217
  436. package/skills/api-designer/references/error-handling.md +0 -541
  437. package/skills/api-designer/references/openapi.md +0 -824
  438. package/skills/api-designer/references/pagination.md +0 -494
  439. package/skills/api-designer/references/rest-patterns.md +0 -335
  440. package/skills/api-designer/references/versioning.md +0 -391
  441. package/skills/architecture-designer/SKILL.md +0 -117
  442. package/skills/architecture-designer/references/adr-template.md +0 -116
  443. package/skills/architecture-designer/references/architecture-patterns.md +0 -111
  444. package/skills/architecture-designer/references/database-selection.md +0 -102
  445. package/skills/architecture-designer/references/nfr-checklist.md +0 -112
  446. package/skills/architecture-designer/references/system-design.md +0 -100
  447. package/skills/brainstorming/SKILL.md +0 -164
  448. package/skills/brainstorming/scripts/helper.js +0 -88
  449. package/skills/brainstorming/scripts/start-server.sh +0 -148
  450. package/skills/brainstorming/scripts/stop-server.sh +0 -56
  451. package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -49
  452. package/skills/brainstorming/visual-companion.md +0 -287
  453. package/skills/chaos-engineer/SKILL.md +0 -182
  454. package/skills/chaos-engineer/references/chaos-tools.md +0 -511
  455. package/skills/chaos-engineer/references/experiment-design.md +0 -229
  456. package/skills/chaos-engineer/references/game-days.md +0 -434
  457. package/skills/chaos-engineer/references/infrastructure-chaos.md +0 -348
  458. package/skills/chaos-engineer/references/kubernetes-chaos.md +0 -432
  459. package/skills/cli-developer/SKILL.md +0 -113
  460. package/skills/cli-developer/references/design-patterns.md +0 -221
  461. package/skills/cli-developer/references/go-cli.md +0 -540
  462. package/skills/cli-developer/references/node-cli.md +0 -383
  463. package/skills/cli-developer/references/python-cli.md +0 -422
  464. package/skills/cli-developer/references/ux-patterns.md +0 -448
  465. package/skills/cloud-architect/SKILL.md +0 -216
  466. package/skills/cloud-architect/references/aws.md +0 -394
  467. package/skills/cloud-architect/references/azure.md +0 -562
  468. package/skills/cloud-architect/references/cost.md +0 -582
  469. package/skills/cloud-architect/references/gcp.md +0 -633
  470. package/skills/cloud-architect/references/multi-cloud.md +0 -483
  471. package/skills/code-documenter/SKILL.md +0 -147
  472. package/skills/code-documenter/references/api-docs-fastapi-django.md +0 -166
  473. package/skills/code-documenter/references/api-docs-nestjs-express.md +0 -220
  474. package/skills/code-documenter/references/coverage-reports.md +0 -125
  475. package/skills/code-documenter/references/documentation-systems.md +0 -333
  476. package/skills/code-documenter/references/interactive-api-docs.md +0 -531
  477. package/skills/code-documenter/references/python-docstrings.md +0 -121
  478. package/skills/code-documenter/references/typescript-jsdoc.md +0 -145
  479. package/skills/code-documenter/references/user-guides-tutorials.md +0 -530
  480. package/skills/code-reviewer/SKILL.md +0 -119
  481. package/skills/code-reviewer/references/common-issues.md +0 -142
  482. package/skills/code-reviewer/references/feedback-examples.md +0 -144
  483. package/skills/code-reviewer/references/receiving-feedback.md +0 -238
  484. package/skills/code-reviewer/references/report-template.md +0 -109
  485. package/skills/code-reviewer/references/review-checklist.md +0 -88
  486. package/skills/code-reviewer/references/spec-compliance-review.md +0 -258
  487. package/skills/cpp-pro/SKILL.md +0 -115
  488. package/skills/cpp-pro/references/build-tooling.md +0 -440
  489. package/skills/cpp-pro/references/concurrency.md +0 -437
  490. package/skills/cpp-pro/references/memory-performance.md +0 -397
  491. package/skills/cpp-pro/references/modern-cpp.md +0 -304
  492. package/skills/cpp-pro/references/templates.md +0 -357
  493. package/skills/csharp-developer/SKILL.md +0 -125
  494. package/skills/csharp-developer/references/aspnet-core.md +0 -394
  495. package/skills/csharp-developer/references/blazor.md +0 -553
  496. package/skills/csharp-developer/references/entity-framework.md +0 -409
  497. package/skills/csharp-developer/references/modern-csharp.md +0 -248
  498. package/skills/csharp-developer/references/performance.md +0 -498
  499. package/skills/database-optimizer/SKILL.md +0 -147
  500. package/skills/database-optimizer/references/index-strategies.md +0 -331
  501. package/skills/database-optimizer/references/monitoring-analysis.md +0 -501
  502. package/skills/database-optimizer/references/mysql-tuning.md +0 -452
  503. package/skills/database-optimizer/references/postgresql-tuning.md +0 -413
  504. package/skills/database-optimizer/references/query-optimization.md +0 -251
  505. package/skills/debugging-wizard/SKILL.md +0 -105
  506. package/skills/debugging-wizard/references/common-patterns.md +0 -132
  507. package/skills/debugging-wizard/references/debugging-tools.md +0 -140
  508. package/skills/debugging-wizard/references/quick-fixes.md +0 -177
  509. package/skills/debugging-wizard/references/strategies.md +0 -142
  510. package/skills/debugging-wizard/references/systematic-debugging.md +0 -367
  511. package/skills/devops-engineer/SKILL.md +0 -144
  512. package/skills/devops-engineer/references/deployment-strategies.md +0 -241
  513. package/skills/devops-engineer/references/docker-patterns.md +0 -113
  514. package/skills/devops-engineer/references/github-actions.md +0 -139
  515. package/skills/devops-engineer/references/incident-response.md +0 -331
  516. package/skills/devops-engineer/references/kubernetes.md +0 -154
  517. package/skills/devops-engineer/references/platform-engineering.md +0 -417
  518. package/skills/devops-engineer/references/release-automation.md +0 -527
  519. package/skills/devops-engineer/references/terraform-iac.md +0 -141
  520. package/skills/django-expert/SKILL.md +0 -162
  521. package/skills/django-expert/references/authentication.md +0 -145
  522. package/skills/django-expert/references/drf-serializers.md +0 -148
  523. package/skills/django-expert/references/models-orm.md +0 -151
  524. package/skills/django-expert/references/testing-django.md +0 -204
  525. package/skills/django-expert/references/viewsets-views.md +0 -153
  526. package/skills/documentation/SKILL.md +0 -45
  527. package/skills/dotnet-core-expert/SKILL.md +0 -138
  528. package/skills/dotnet-core-expert/references/authentication.md +0 -546
  529. package/skills/dotnet-core-expert/references/clean-architecture.md +0 -455
  530. package/skills/dotnet-core-expert/references/cloud-native.md +0 -548
  531. package/skills/dotnet-core-expert/references/entity-framework.md +0 -440
  532. package/skills/dotnet-core-expert/references/minimal-apis.md +0 -319
  533. package/skills/entropy-management/SKILL.md +0 -115
  534. package/skills/executing-plans/SKILL.md +0 -70
  535. package/skills/fastapi-expert/SKILL.md +0 -185
  536. package/skills/fastapi-expert/references/async-sqlalchemy.md +0 -146
  537. package/skills/fastapi-expert/references/authentication.md +0 -159
  538. package/skills/fastapi-expert/references/endpoints-routing.md +0 -142
  539. package/skills/fastapi-expert/references/migration-from-django.md +0 -997
  540. package/skills/fastapi-expert/references/pydantic-v2.md +0 -135
  541. package/skills/fastapi-expert/references/testing-async.md +0 -159
  542. package/skills/feature-forge/SKILL.md +0 -98
  543. package/skills/feature-forge/references/acceptance-criteria.md +0 -104
  544. package/skills/feature-forge/references/ears-syntax.md +0 -99
  545. package/skills/feature-forge/references/interview-questions.md +0 -150
  546. package/skills/feature-forge/references/pre-discovery-subagents.md +0 -54
  547. package/skills/feature-forge/references/specification-template.md +0 -103
  548. package/skills/fine-tuning-expert/SKILL.md +0 -162
  549. package/skills/fine-tuning-expert/references/dataset-preparation.md +0 -540
  550. package/skills/fine-tuning-expert/references/deployment-optimization.md +0 -673
  551. package/skills/fine-tuning-expert/references/evaluation-metrics.md +0 -597
  552. package/skills/fine-tuning-expert/references/hyperparameter-tuning.md +0 -565
  553. package/skills/fine-tuning-expert/references/lora-peft.md +0 -347
  554. package/skills/finishing-a-development-branch/SKILL.md +0 -200
  555. package/skills/flutter-expert/SKILL.md +0 -138
  556. package/skills/flutter-expert/references/bloc-state.md +0 -259
  557. package/skills/flutter-expert/references/gorouter-navigation.md +0 -119
  558. package/skills/flutter-expert/references/performance.md +0 -99
  559. package/skills/flutter-expert/references/project-structure.md +0 -118
  560. package/skills/flutter-expert/references/riverpod-state.md +0 -130
  561. package/skills/flutter-expert/references/widget-patterns.md +0 -123
  562. package/skills/fullstack-guardian/SKILL.md +0 -105
  563. package/skills/fullstack-guardian/references/api-design-standards.md +0 -307
  564. package/skills/fullstack-guardian/references/architecture-decisions.md +0 -350
  565. package/skills/fullstack-guardian/references/backend-patterns.md +0 -237
  566. package/skills/fullstack-guardian/references/common-patterns.md +0 -134
  567. package/skills/fullstack-guardian/references/deliverables-checklist.md +0 -354
  568. package/skills/fullstack-guardian/references/design-template.md +0 -91
  569. package/skills/fullstack-guardian/references/error-handling.md +0 -135
  570. package/skills/fullstack-guardian/references/frontend-patterns.md +0 -340
  571. package/skills/fullstack-guardian/references/integration-patterns.md +0 -333
  572. package/skills/fullstack-guardian/references/security-checklist.md +0 -106
  573. package/skills/golang-pro/SKILL.md +0 -122
  574. package/skills/golang-pro/references/concurrency.md +0 -329
  575. package/skills/golang-pro/references/generics.md +0 -442
  576. package/skills/golang-pro/references/interfaces.md +0 -432
  577. package/skills/golang-pro/references/project-structure.md +0 -477
  578. package/skills/golang-pro/references/testing.md +0 -451
  579. package/skills/graphql-architect/SKILL.md +0 -146
  580. package/skills/graphql-architect/references/federation.md +0 -418
  581. package/skills/graphql-architect/references/migration-from-rest.md +0 -1141
  582. package/skills/graphql-architect/references/resolvers.md +0 -425
  583. package/skills/graphql-architect/references/schema-design.md +0 -393
  584. package/skills/graphql-architect/references/security.md +0 -569
  585. package/skills/graphql-architect/references/subscriptions.md +0 -510
  586. package/skills/java-architect/SKILL.md +0 -132
  587. package/skills/java-architect/references/jpa-optimization.md +0 -393
  588. package/skills/java-architect/references/reactive-webflux.md +0 -356
  589. package/skills/java-architect/references/spring-boot-setup.md +0 -269
  590. package/skills/java-architect/references/spring-security.md +0 -445
  591. package/skills/java-architect/references/testing-patterns.md +0 -500
  592. package/skills/javascript-pro/SKILL.md +0 -132
  593. package/skills/javascript-pro/references/async-patterns.md +0 -334
  594. package/skills/javascript-pro/references/browser-apis.md +0 -398
  595. package/skills/javascript-pro/references/modern-syntax.md +0 -272
  596. package/skills/javascript-pro/references/modules.md +0 -357
  597. package/skills/javascript-pro/references/node-essentials.md +0 -471
  598. package/skills/kotlin-specialist/SKILL.md +0 -147
  599. package/skills/kotlin-specialist/references/android-compose.md +0 -419
  600. package/skills/kotlin-specialist/references/coroutines-flow.md +0 -276
  601. package/skills/kotlin-specialist/references/dsl-idioms.md +0 -421
  602. package/skills/kotlin-specialist/references/ktor-server.md +0 -426
  603. package/skills/kotlin-specialist/references/multiplatform-kmp.md +0 -380
  604. package/skills/kubernetes-specialist/SKILL.md +0 -241
  605. package/skills/kubernetes-specialist/references/configuration.md +0 -452
  606. package/skills/kubernetes-specialist/references/cost-optimization.md +0 -458
  607. package/skills/kubernetes-specialist/references/custom-operators.md +0 -563
  608. package/skills/kubernetes-specialist/references/gitops.md +0 -530
  609. package/skills/kubernetes-specialist/references/helm-charts.md +0 -912
  610. package/skills/kubernetes-specialist/references/multi-cluster.md +0 -507
  611. package/skills/kubernetes-specialist/references/networking.md +0 -447
  612. package/skills/kubernetes-specialist/references/service-mesh.md +0 -459
  613. package/skills/kubernetes-specialist/references/storage.md +0 -535
  614. package/skills/kubernetes-specialist/references/troubleshooting.md +0 -414
  615. package/skills/kubernetes-specialist/references/workloads.md +0 -377
  616. package/skills/laravel-specialist/SKILL.md +0 -262
  617. package/skills/laravel-specialist/references/eloquent.md +0 -351
  618. package/skills/laravel-specialist/references/livewire.md +0 -512
  619. package/skills/laravel-specialist/references/queues.md +0 -423
  620. package/skills/laravel-specialist/references/routing.md +0 -362
  621. package/skills/laravel-specialist/references/testing.md +0 -522
  622. package/skills/legacy-modernizer/SKILL.md +0 -137
  623. package/skills/legacy-modernizer/references/legacy-testing.md +0 -381
  624. package/skills/legacy-modernizer/references/migration-strategies.md +0 -423
  625. package/skills/legacy-modernizer/references/refactoring-patterns.md +0 -395
  626. package/skills/legacy-modernizer/references/strangler-fig-pattern.md +0 -281
  627. package/skills/legacy-modernizer/references/system-assessment.md +0 -487
  628. package/skills/mcp-developer/SKILL.md +0 -143
  629. package/skills/mcp-developer/references/protocol.md +0 -244
  630. package/skills/mcp-developer/references/python-sdk.md +0 -367
  631. package/skills/mcp-developer/references/resources.md +0 -554
  632. package/skills/mcp-developer/references/tools.md +0 -480
  633. package/skills/mcp-developer/references/typescript-sdk.md +0 -350
  634. package/skills/microservices-architect/SKILL.md +0 -164
  635. package/skills/microservices-architect/references/communication.md +0 -499
  636. package/skills/microservices-architect/references/data.md +0 -721
  637. package/skills/microservices-architect/references/decomposition.md +0 -344
  638. package/skills/microservices-architect/references/observability.md +0 -805
  639. package/skills/microservices-architect/references/patterns.md +0 -603
  640. package/skills/ml-pipeline/SKILL.md +0 -159
  641. package/skills/ml-pipeline/references/experiment-tracking.md +0 -833
  642. package/skills/ml-pipeline/references/feature-engineering.md +0 -631
  643. package/skills/ml-pipeline/references/model-validation.md +0 -978
  644. package/skills/ml-pipeline/references/pipeline-orchestration.md +0 -907
  645. package/skills/ml-pipeline/references/training-pipelines.md +0 -782
  646. package/skills/monitoring-expert/SKILL.md +0 -176
  647. package/skills/monitoring-expert/references/alerting-rules.md +0 -141
  648. package/skills/monitoring-expert/references/application-profiling.md +0 -331
  649. package/skills/monitoring-expert/references/capacity-planning.md +0 -344
  650. package/skills/monitoring-expert/references/dashboards.md +0 -126
  651. package/skills/monitoring-expert/references/opentelemetry.md +0 -123
  652. package/skills/monitoring-expert/references/performance-testing.md +0 -269
  653. package/skills/monitoring-expert/references/prometheus-metrics.md +0 -136
  654. package/skills/monitoring-expert/references/structured-logging.md +0 -142
  655. package/skills/nestjs-expert/SKILL.md +0 -206
  656. package/skills/nestjs-expert/references/authentication.md +0 -166
  657. package/skills/nestjs-expert/references/controllers-routing.md +0 -111
  658. package/skills/nestjs-expert/references/dtos-validation.md +0 -153
  659. package/skills/nestjs-expert/references/migration-from-express.md +0 -1237
  660. package/skills/nestjs-expert/references/services-di.md +0 -140
  661. package/skills/nestjs-expert/references/testing-patterns.md +0 -186
  662. package/skills/nextjs-developer/SKILL.md +0 -143
  663. package/skills/nextjs-developer/references/app-router.md +0 -311
  664. package/skills/nextjs-developer/references/data-fetching.md +0 -482
  665. package/skills/nextjs-developer/references/deployment.md +0 -545
  666. package/skills/nextjs-developer/references/server-actions.md +0 -462
  667. package/skills/nextjs-developer/references/server-components.md +0 -384
  668. package/skills/pandas-pro/SKILL.md +0 -178
  669. package/skills/pandas-pro/references/aggregation-groupby.md +0 -545
  670. package/skills/pandas-pro/references/data-cleaning.md +0 -500
  671. package/skills/pandas-pro/references/dataframe-operations.md +0 -420
  672. package/skills/pandas-pro/references/merging-joining.md +0 -596
  673. package/skills/pandas-pro/references/performance-optimization.md +0 -597
  674. package/skills/php-pro/SKILL.md +0 -206
  675. package/skills/php-pro/references/async-patterns.md +0 -412
  676. package/skills/php-pro/references/laravel-patterns.md +0 -377
  677. package/skills/php-pro/references/modern-php-features.md +0 -323
  678. package/skills/php-pro/references/symfony-patterns.md +0 -466
  679. package/skills/php-pro/references/testing-quality.md +0 -466
  680. package/skills/playwright-expert/SKILL.md +0 -169
  681. package/skills/playwright-expert/references/api-mocking.md +0 -140
  682. package/skills/playwright-expert/references/configuration.md +0 -155
  683. package/skills/playwright-expert/references/debugging-flaky.md +0 -150
  684. package/skills/playwright-expert/references/page-object-model.md +0 -152
  685. package/skills/playwright-expert/references/selectors-locators.md +0 -119
  686. package/skills/postgres-pro/SKILL.md +0 -152
  687. package/skills/postgres-pro/references/extensions.md +0 -404
  688. package/skills/postgres-pro/references/jsonb.md +0 -321
  689. package/skills/postgres-pro/references/maintenance.md +0 -481
  690. package/skills/postgres-pro/references/performance.md +0 -265
  691. package/skills/postgres-pro/references/replication.md +0 -446
  692. package/skills/python-pro/SKILL.md +0 -177
  693. package/skills/python-pro/references/async-patterns.md +0 -356
  694. package/skills/python-pro/references/packaging.md +0 -460
  695. package/skills/python-pro/references/standard-library.md +0 -378
  696. package/skills/python-pro/references/testing.md +0 -404
  697. package/skills/python-pro/references/type-system.md +0 -290
  698. package/skills/rag-architect/SKILL.md +0 -194
  699. package/skills/rag-architect/references/chunking-strategies.md +0 -878
  700. package/skills/rag-architect/references/embedding-models.md +0 -561
  701. package/skills/rag-architect/references/rag-evaluation.md +0 -833
  702. package/skills/rag-architect/references/retrieval-optimization.md +0 -795
  703. package/skills/rag-architect/references/vector-databases.md +0 -589
  704. package/skills/rails-expert/SKILL.md +0 -154
  705. package/skills/rails-expert/references/active-record.md +0 -244
  706. package/skills/rails-expert/references/api-development.md +0 -401
  707. package/skills/rails-expert/references/background-jobs.md +0 -272
  708. package/skills/rails-expert/references/hotwire-turbo.md +0 -228
  709. package/skills/rails-expert/references/rspec-testing.md +0 -367
  710. package/skills/react-expert/SKILL.md +0 -149
  711. package/skills/react-expert/references/hooks-patterns.md +0 -162
  712. package/skills/react-expert/references/migration-class-to-modern.md +0 -1119
  713. package/skills/react-expert/references/performance.md +0 -168
  714. package/skills/react-expert/references/react-19-features.md +0 -174
  715. package/skills/react-expert/references/server-components.md +0 -143
  716. package/skills/react-expert/references/state-management.md +0 -171
  717. package/skills/react-expert/references/testing-react.md +0 -174
  718. package/skills/react-native-expert/SKILL.md +0 -185
  719. package/skills/react-native-expert/references/expo-router.md +0 -187
  720. package/skills/react-native-expert/references/list-optimization.md +0 -204
  721. package/skills/react-native-expert/references/platform-handling.md +0 -188
  722. package/skills/react-native-expert/references/project-structure.md +0 -171
  723. package/skills/react-native-expert/references/storage-hooks.md +0 -173
  724. package/skills/receiving-code-review/SKILL.md +0 -213
  725. package/skills/requesting-code-review/SKILL.md +0 -105
  726. package/skills/requesting-code-review/code-reviewer.md +0 -146
  727. package/skills/requirement-engineering/SKILL.md +0 -111
  728. package/skills/rust-engineer/SKILL.md +0 -167
  729. package/skills/rust-engineer/references/async.md +0 -458
  730. package/skills/rust-engineer/references/error-handling.md +0 -334
  731. package/skills/rust-engineer/references/ownership.md +0 -278
  732. package/skills/rust-engineer/references/testing.md +0 -470
  733. package/skills/rust-engineer/references/traits.md +0 -413
  734. package/skills/secure-code-guardian/SKILL.md +0 -191
  735. package/skills/secure-code-guardian/references/authentication.md +0 -136
  736. package/skills/secure-code-guardian/references/input-validation.md +0 -146
  737. package/skills/secure-code-guardian/references/owasp-prevention.md +0 -135
  738. package/skills/secure-code-guardian/references/security-headers.md +0 -133
  739. package/skills/secure-code-guardian/references/xss-csrf.md +0 -157
  740. package/skills/security-reviewer/SKILL.md +0 -103
  741. package/skills/security-reviewer/references/infrastructure-security.md +0 -268
  742. package/skills/security-reviewer/references/penetration-testing.md +0 -268
  743. package/skills/security-reviewer/references/report-template.md +0 -170
  744. package/skills/security-reviewer/references/sast-tools.md +0 -117
  745. package/skills/security-reviewer/references/secret-scanning.md +0 -125
  746. package/skills/security-reviewer/references/vulnerability-patterns.md +0 -152
  747. package/skills/spark-engineer/SKILL.md +0 -148
  748. package/skills/spark-engineer/references/partitioning-caching.md +0 -543
  749. package/skills/spark-engineer/references/performance-tuning.md +0 -544
  750. package/skills/spark-engineer/references/rdd-operations.md +0 -599
  751. package/skills/spark-engineer/references/spark-sql-dataframes.md +0 -474
  752. package/skills/spark-engineer/references/streaming-patterns.md +0 -786
  753. package/skills/spring-boot-engineer/SKILL.md +0 -195
  754. package/skills/spring-boot-engineer/references/cloud.md +0 -498
  755. package/skills/spring-boot-engineer/references/data.md +0 -381
  756. package/skills/spring-boot-engineer/references/security.md +0 -459
  757. package/skills/spring-boot-engineer/references/testing.md +0 -545
  758. package/skills/spring-boot-engineer/references/web.md +0 -295
  759. package/skills/sql-pro/SKILL.md +0 -129
  760. package/skills/sql-pro/references/database-design.md +0 -402
  761. package/skills/sql-pro/references/dialect-differences.md +0 -419
  762. package/skills/sql-pro/references/optimization.md +0 -384
  763. package/skills/sql-pro/references/query-patterns.md +0 -285
  764. package/skills/sql-pro/references/window-functions.md +0 -328
  765. package/skills/sre-engineer/SKILL.md +0 -181
  766. package/skills/sre-engineer/references/automation-toil.md +0 -492
  767. package/skills/sre-engineer/references/error-budget-policy.md +0 -334
  768. package/skills/sre-engineer/references/incident-chaos.md +0 -576
  769. package/skills/sre-engineer/references/monitoring-alerting.md +0 -424
  770. package/skills/sre-engineer/references/slo-sli-management.md +0 -238
  771. package/skills/swift-expert/SKILL.md +0 -163
  772. package/skills/swift-expert/references/async-concurrency.md +0 -360
  773. package/skills/swift-expert/references/memory-performance.md +0 -377
  774. package/skills/swift-expert/references/protocol-oriented.md +0 -354
  775. package/skills/swift-expert/references/swiftui-patterns.md +0 -291
  776. package/skills/swift-expert/references/testing-patterns.md +0 -399
  777. package/skills/systematic-debugging/CREATION-LOG.md +0 -119
  778. package/skills/systematic-debugging/SKILL.md +0 -296
  779. package/skills/systematic-debugging/condition-based-waiting-example.ts +0 -158
  780. package/skills/systematic-debugging/condition-based-waiting.md +0 -115
  781. package/skills/systematic-debugging/defense-in-depth.md +0 -122
  782. package/skills/systematic-debugging/find-polluter.sh +0 -63
  783. package/skills/systematic-debugging/root-cause-tracing.md +0 -169
  784. package/skills/systematic-debugging/test-academic.md +0 -14
  785. package/skills/systematic-debugging/test-pressure-1.md +0 -58
  786. package/skills/systematic-debugging/test-pressure-2.md +0 -68
  787. package/skills/systematic-debugging/test-pressure-3.md +0 -69
  788. package/skills/tdd-guide/assets/sample_coverage_report.lcov +0 -56
  789. package/skills/terraform-engineer/SKILL.md +0 -143
  790. package/skills/terraform-engineer/references/best-practices.md +0 -583
  791. package/skills/terraform-engineer/references/module-patterns.md +0 -297
  792. package/skills/terraform-engineer/references/providers.md +0 -452
  793. package/skills/terraform-engineer/references/state-management.md +0 -371
  794. package/skills/terraform-engineer/references/testing.md +0 -486
  795. package/skills/test-master/SKILL.md +0 -94
  796. package/skills/test-master/references/automation-frameworks.md +0 -294
  797. package/skills/test-master/references/e2e-testing.md +0 -128
  798. package/skills/test-master/references/integration-testing.md +0 -120
  799. package/skills/test-master/references/performance-testing.md +0 -118
  800. package/skills/test-master/references/qa-methodology.md +0 -247
  801. package/skills/test-master/references/security-testing.md +0 -127
  802. package/skills/test-master/references/tdd-iron-laws.md +0 -174
  803. package/skills/test-master/references/test-reports.md +0 -104
  804. package/skills/test-master/references/testing-anti-patterns.md +0 -231
  805. package/skills/test-master/references/unit-testing.md +0 -113
  806. package/skills/typescript-pro/SKILL.md +0 -145
  807. package/skills/typescript-pro/references/advanced-types.md +0 -259
  808. package/skills/typescript-pro/references/configuration.md +0 -445
  809. package/skills/typescript-pro/references/patterns.md +0 -484
  810. package/skills/typescript-pro/references/type-guards.md +0 -352
  811. package/skills/typescript-pro/references/utility-types.md +0 -329
  812. package/skills/using-git-worktrees/SKILL.md +0 -218
  813. package/skills/verification-before-completion/SKILL.md +0 -139
  814. package/skills/vue-expert/SKILL.md +0 -98
  815. package/skills/vue-expert/references/build-tooling.md +0 -480
  816. package/skills/vue-expert/references/components.md +0 -448
  817. package/skills/vue-expert/references/composition-api.md +0 -299
  818. package/skills/vue-expert/references/mobile-hybrid.md +0 -636
  819. package/skills/vue-expert/references/nuxt.md +0 -669
  820. package/skills/vue-expert/references/state-management.md +0 -449
  821. package/skills/vue-expert/references/typescript.md +0 -584
  822. package/skills/vue-expert-js/SKILL.md +0 -167
  823. package/skills/vue-expert-js/references/component-architecture.md +0 -219
  824. package/skills/vue-expert-js/references/composables-patterns.md +0 -183
  825. package/skills/vue-expert-js/references/jsdoc-typing.md +0 -535
  826. package/skills/vue-expert-js/references/state-management.md +0 -249
  827. package/skills/vue-expert-js/references/testing-patterns.md +0 -237
  828. package/skills/websocket-engineer/SKILL.md +0 -168
  829. package/skills/websocket-engineer/references/alternatives.md +0 -391
  830. package/skills/websocket-engineer/references/patterns.md +0 -400
  831. package/skills/websocket-engineer/references/protocol.md +0 -195
  832. package/skills/websocket-engineer/references/scaling.md +0 -333
  833. package/skills/websocket-engineer/references/security.md +0 -474
  834. package/skills/writing-plans/SKILL.md +0 -151
  835. package/skills/writing-plans/plan-document-reviewer-prompt.md +0 -49
  836. package/skills/writing-skills/SKILL.md +0 -655
  837. package/skills/writing-skills/anthropic-best-practices.md +0 -1150
  838. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +0 -189
  839. package/skills/writing-skills/graphviz-conventions.dot +0 -172
  840. package/skills/writing-skills/persuasion-principles.md +0 -187
  841. package/skills/writing-skills/render-graphs.js +0 -168
  842. package/skills/writing-skills/testing-skills-with-subagents.md +0 -384
  843. /package/skills/{design-commands → frontend/design-commands}/design.md +0 -0
  844. /package/skills/{design-commands → frontend/design-commands}/handoff.md +0 -0
  845. /package/skills/{design-commands → frontend/design-commands}/prototype.md +0 -0
  846. /package/skills/{design-commands → frontend/design-commands}/spec.md +0 -0
  847. /package/skills/{design-commands → frontend/design-commands}/style.md +0 -0
  848. /package/skills/{senior-frontend → frontend/senior-frontend}/SKILL.md +0 -0
  849. /package/skills/{senior-frontend → frontend/senior-frontend}/references/frontend_best_practices.md +0 -0
  850. /package/skills/{senior-frontend → frontend/senior-frontend}/references/nextjs_optimization_guide.md +0 -0
  851. /package/skills/{senior-frontend → frontend/senior-frontend}/references/react_patterns.md +0 -0
  852. /package/skills/{senior-frontend → frontend/senior-frontend}/scripts/bundle_analyzer.py +0 -0
  853. /package/skills/{senior-frontend → frontend/senior-frontend}/scripts/component_generator.py +0 -0
  854. /package/skills/{senior-frontend → frontend/senior-frontend}/scripts/frontend_scaffolder.py +0 -0
  855. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/SKILL.md +0 -0
  856. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/charts.csv +0 -0
  857. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/colors.csv +0 -0
  858. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/icons.csv +0 -0
  859. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/landing.csv +0 -0
  860. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/products.csv +0 -0
  861. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/react-performance.csv +0 -0
  862. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/astro.csv +0 -0
  863. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/flutter.csv +0 -0
  864. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/html-tailwind.csv +0 -0
  865. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/jetpack-compose.csv +0 -0
  866. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/nextjs.csv +0 -0
  867. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/nuxt-ui.csv +0 -0
  868. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/nuxtjs.csv +0 -0
  869. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/react-native.csv +0 -0
  870. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/react.csv +0 -0
  871. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/shadcn.csv +0 -0
  872. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/svelte.csv +0 -0
  873. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/swiftui.csv +0 -0
  874. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/stacks/vue.csv +0 -0
  875. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/styles.csv +0 -0
  876. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/typography.csv +0 -0
  877. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/ui-reasoning.csv +0 -0
  878. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/ux-guidelines.csv +0 -0
  879. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/data/web-interface.csv +0 -0
  880. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/scripts/core.py +0 -0
  881. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/scripts/design_system.py +0 -0
  882. /package/skills/{ui-ux-pro-max → frontend/ui-ux-pro-max}/scripts/search.py +0 -0
  883. /package/skills/{competitive-analysis → product/competitive-analysis}/SKILL.md +0 -0
  884. /package/skills/{meeting-notes → product/meeting-notes}/SKILL.md +0 -0
  885. /package/skills/{prd-template → product/prd-template}/SKILL.md +0 -0
  886. /package/skills/{stakeholder-update → product/stakeholder-update}/SKILL.md +0 -0
  887. /package/skills/{user-research-synthesis → product/user-research-synthesis}/SKILL.md +0 -0
  888. /package/skills/{senior-qa → quality/senior-qa}/README.md +0 -0
  889. /package/skills/{senior-qa → quality/senior-qa}/SKILL.md +0 -0
  890. /package/skills/{senior-qa → quality/senior-qa}/references/qa_best_practices.md +0 -0
  891. /package/skills/{senior-qa → quality/senior-qa}/references/test_automation_patterns.md +0 -0
  892. /package/skills/{senior-qa → quality/senior-qa}/references/testing_strategies.md +0 -0
  893. /package/skills/{senior-qa → quality/senior-qa}/scripts/coverage_analyzer.py +0 -0
  894. /package/skills/{senior-qa → quality/senior-qa}/scripts/e2e_test_scaffolder.py +0 -0
  895. /package/skills/{senior-qa → quality/senior-qa}/scripts/test_suite_generator.py +0 -0
  896. /package/skills/{tdd-guide → quality/tdd-guide}/HOW_TO_USE.md +0 -0
  897. /package/skills/{tdd-guide → quality/tdd-guide}/README.md +0 -0
  898. /package/skills/{tdd-guide → quality/tdd-guide}/SKILL.md +0 -0
  899. /package/skills/{tdd-guide → quality/tdd-guide}/assets/expected_output.json +0 -0
  900. /package/skills/{tdd-guide → quality/tdd-guide}/assets/sample_input_python.json +0 -0
  901. /package/skills/{tdd-guide → quality/tdd-guide}/assets/sample_input_typescript.json +0 -0
  902. /package/skills/{tdd-guide → quality/tdd-guide}/references/ci-integration.md +0 -0
  903. /package/skills/{tdd-guide → quality/tdd-guide}/references/framework-guide.md +0 -0
  904. /package/skills/{tdd-guide → quality/tdd-guide}/references/tdd-best-practices.md +0 -0
  905. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/coverage_analyzer.py +0 -0
  906. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/fixture_generator.py +0 -0
  907. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/format_detector.py +0 -0
  908. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/framework_adapter.py +0 -0
  909. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/metrics_calculator.py +0 -0
  910. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/output_formatter.py +0 -0
  911. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/tdd_workflow.py +0 -0
  912. /package/skills/{tdd-guide → quality/tdd-guide}/scripts/test_generator.py +0 -0
  913. /package/skills/{brainstorming → workflow/brainstorming}/scripts/frame-template.html +0 -0
  914. /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