aigroup-workflow 2.2.0 → 2.2.2

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 (645) hide show
  1. package/.claude/commands/fix-build.md +10 -5
  2. package/.claude/commands/init-project.md +13 -8
  3. package/.claude/commands/plan.md +15 -8
  4. package/.claude/commands/review.md +12 -6
  5. package/.claude/commands/tdd.md +11 -5
  6. package/.claude/commands/workflow-start.md +20 -11
  7. package/.claude/settings.json +28 -0
  8. package/.codex/agents/architect.toml +207 -0
  9. package/.codex/agents/build-error-resolver.toml +110 -0
  10. package/.codex/agents/code-reviewer.toml +233 -0
  11. package/.codex/agents/doc-updater.toml +103 -0
  12. package/.codex/agents/e2e-runner.toml +103 -0
  13. package/.codex/agents/get-current-datetime.toml +23 -0
  14. package/.codex/agents/init-architect.toml +181 -0
  15. package/.codex/agents/planner.toml +208 -0
  16. package/.codex/agents/refactor-cleaner.toml +81 -0
  17. package/.codex/agents/rust-reviewer.toml +90 -0
  18. package/.codex/agents/security-reviewer.toml +104 -0
  19. package/.codex/agents/tdd-guide.toml +87 -0
  20. package/AGENTS.md +2 -2
  21. package/CLAUDE.md +23 -1
  22. package/LICENSE +20 -20
  23. package/README.md +333 -333
  24. package/agents/a11y-architect.md +141 -141
  25. package/agents/architect.md +211 -211
  26. package/agents/build-error-resolver.md +114 -114
  27. package/agents/chief-of-staff.md +151 -151
  28. package/agents/code-architect.md +71 -71
  29. package/agents/code-explorer.md +69 -69
  30. package/agents/code-reviewer.md +237 -237
  31. package/agents/code-simplifier.md +47 -47
  32. package/agents/comment-analyzer.md +45 -45
  33. package/agents/conversation-analyzer.md +52 -52
  34. package/agents/cpp-build-resolver.md +90 -90
  35. package/agents/cpp-reviewer.md +72 -72
  36. package/agents/csharp-reviewer.md +101 -101
  37. package/agents/dart-build-resolver.md +201 -201
  38. package/agents/database-reviewer.md +91 -91
  39. package/agents/doc-updater.md +107 -107
  40. package/agents/docs-lookup.md +68 -68
  41. package/agents/e2e-runner.md +107 -107
  42. package/agents/flutter-reviewer.md +243 -243
  43. package/agents/gan-evaluator.md +209 -209
  44. package/agents/gan-generator.md +131 -131
  45. package/agents/gan-planner.md +99 -99
  46. package/agents/get-current-datetime.md +26 -26
  47. package/agents/go-build-resolver.md +94 -94
  48. package/agents/go-reviewer.md +76 -76
  49. package/agents/harness-optimizer.md +35 -35
  50. package/agents/healthcare-reviewer.md +83 -83
  51. package/agents/java-build-resolver.md +153 -153
  52. package/agents/java-reviewer.md +92 -92
  53. package/agents/kotlin-build-resolver.md +118 -118
  54. package/agents/kotlin-reviewer.md +159 -159
  55. package/agents/loop-operator.md +36 -36
  56. package/agents/opensource-forker.md +198 -198
  57. package/agents/opensource-packager.md +249 -249
  58. package/agents/opensource-sanitizer.md +188 -188
  59. package/agents/performance-optimizer.md +446 -446
  60. package/agents/planner.md +212 -212
  61. package/agents/pr-test-analyzer.md +45 -45
  62. package/agents/python-reviewer.md +98 -98
  63. package/agents/pytorch-build-resolver.md +120 -120
  64. package/agents/refactor-cleaner.md +85 -85
  65. package/agents/rust-build-resolver.md +148 -148
  66. package/agents/rust-reviewer.md +94 -94
  67. package/agents/security-reviewer.md +108 -108
  68. package/agents/seo-specialist.md +59 -59
  69. package/agents/silent-failure-hunter.md +50 -50
  70. package/agents/tdd-guide.md +91 -91
  71. package/agents/type-design-analyzer.md +41 -41
  72. package/agents/typescript-reviewer.md +112 -112
  73. package/cli/commands/update.mjs +1 -1
  74. package/cli/utils/scaffold.mjs +53 -0
  75. package/docs/rules/agents.md +166 -50
  76. package/docs/rules/cpp/coding-style.md +44 -44
  77. package/docs/rules/cpp/hooks.md +39 -39
  78. package/docs/rules/cpp/patterns.md +51 -51
  79. package/docs/rules/cpp/security.md +51 -51
  80. package/docs/rules/cpp/testing.md +44 -44
  81. package/docs/rules/csharp/coding-style.md +72 -72
  82. package/docs/rules/csharp/hooks.md +25 -25
  83. package/docs/rules/csharp/patterns.md +50 -50
  84. package/docs/rules/csharp/security.md +58 -58
  85. package/docs/rules/csharp/testing.md +46 -46
  86. package/docs/rules/dart/coding-style.md +159 -159
  87. package/docs/rules/dart/hooks.md +66 -66
  88. package/docs/rules/dart/patterns.md +261 -261
  89. package/docs/rules/dart/security.md +135 -135
  90. package/docs/rules/dart/testing.md +215 -215
  91. package/docs/rules/golang/coding-style.md +32 -32
  92. package/docs/rules/golang/hooks.md +17 -17
  93. package/docs/rules/golang/patterns.md +45 -45
  94. package/docs/rules/golang/security.md +34 -34
  95. package/docs/rules/golang/testing.md +31 -31
  96. package/docs/rules/java/coding-style.md +114 -114
  97. package/docs/rules/java/hooks.md +18 -18
  98. package/docs/rules/java/patterns.md +146 -146
  99. package/docs/rules/java/security.md +100 -100
  100. package/docs/rules/java/testing.md +131 -131
  101. package/docs/rules/kotlin/coding-style.md +86 -86
  102. package/docs/rules/kotlin/hooks.md +17 -17
  103. package/docs/rules/kotlin/patterns.md +146 -146
  104. package/docs/rules/kotlin/security.md +82 -82
  105. package/docs/rules/kotlin/testing.md +128 -128
  106. package/docs/rules/perl/coding-style.md +46 -46
  107. package/docs/rules/perl/hooks.md +22 -22
  108. package/docs/rules/perl/patterns.md +76 -76
  109. package/docs/rules/perl/security.md +69 -69
  110. package/docs/rules/perl/testing.md +54 -54
  111. package/docs/rules/php/coding-style.md +40 -40
  112. package/docs/rules/php/hooks.md +24 -24
  113. package/docs/rules/php/patterns.md +33 -33
  114. package/docs/rules/php/security.md +37 -37
  115. package/docs/rules/php/testing.md +39 -39
  116. package/docs/rules/python/coding-style.md +42 -42
  117. package/docs/rules/python/hooks.md +19 -19
  118. package/docs/rules/python/patterns.md +39 -39
  119. package/docs/rules/python/security.md +30 -30
  120. package/docs/rules/python/testing.md +38 -38
  121. package/docs/rules/rust/coding-style.md +151 -151
  122. package/docs/rules/rust/hooks.md +16 -16
  123. package/docs/rules/rust/patterns.md +168 -168
  124. package/docs/rules/rust/security.md +141 -141
  125. package/docs/rules/rust/testing.md +154 -154
  126. package/docs/rules/swift/coding-style.md +47 -47
  127. package/docs/rules/swift/hooks.md +20 -20
  128. package/docs/rules/swift/patterns.md +66 -66
  129. package/docs/rules/swift/security.md +33 -33
  130. package/docs/rules/swift/testing.md +45 -45
  131. package/docs/rules/typescript/coding-style.md +199 -199
  132. package/docs/rules/typescript/hooks.md +22 -22
  133. package/docs/rules/typescript/patterns.md +52 -52
  134. package/docs/rules/typescript/security.md +28 -28
  135. package/docs/rules/typescript/testing.md +18 -18
  136. package/docs/rules/web/coding-style.md +96 -96
  137. package/docs/rules/web/design-quality.md +62 -62
  138. package/docs/rules/web/hooks.md +120 -120
  139. package/docs/rules/web/patterns.md +79 -79
  140. package/docs/rules/web/performance.md +64 -64
  141. package/docs/rules/web/security.md +57 -57
  142. package/docs/rules/web/testing.md +55 -55
  143. package/docs/templates/README.md +36 -36
  144. package/docs/templates/ai-project-final.md +124 -124
  145. package/docs/templates/ai-project.md +105 -105
  146. package/docs/templates/api.md +157 -157
  147. package/docs/templates/bug.md +62 -62
  148. package/docs/templates/code-review.md +87 -87
  149. package/docs/templates/generic.md +116 -116
  150. package/docs/templates/implementation-plan.md +1 -1
  151. package/docs/templates/meeting.md +68 -68
  152. package/docs/templates/prd.md +98 -98
  153. package/docs/templates/ui.md +134 -134
  154. package/docs/workflow-pipeline.md +11 -10
  155. package/package.json +40 -39
  156. package/scripts/hooks/checks/orchestration-artifacts.cjs +28 -23
  157. package/scripts/hooks/checks/workflow-state.cjs +4 -5
  158. package/scripts/orchestration/lib/orchestrator.cjs +344 -117
  159. package/scripts/orchestration/lib/validate.cjs +145 -0
  160. package/scripts/orchestration/session.cjs +88 -44
  161. package/skills/SUPERPOWERS-LICENSE +21 -21
  162. package/skills/ai-ml/fine-tuning-expert/SKILL.md +162 -162
  163. package/skills/ai-ml/fine-tuning-expert/references/dataset-preparation.md +540 -540
  164. package/skills/ai-ml/fine-tuning-expert/references/deployment-optimization.md +673 -673
  165. package/skills/ai-ml/fine-tuning-expert/references/evaluation-metrics.md +597 -597
  166. package/skills/ai-ml/fine-tuning-expert/references/hyperparameter-tuning.md +565 -565
  167. package/skills/ai-ml/fine-tuning-expert/references/lora-peft.md +347 -347
  168. package/skills/ai-ml/ml-pipeline/SKILL.md +159 -159
  169. package/skills/ai-ml/ml-pipeline/references/experiment-tracking.md +833 -833
  170. package/skills/ai-ml/ml-pipeline/references/feature-engineering.md +631 -631
  171. package/skills/ai-ml/ml-pipeline/references/model-validation.md +978 -978
  172. package/skills/ai-ml/ml-pipeline/references/pipeline-orchestration.md +907 -907
  173. package/skills/ai-ml/ml-pipeline/references/training-pipelines.md +782 -782
  174. package/skills/ai-ml/rag-architect/SKILL.md +194 -194
  175. package/skills/ai-ml/rag-architect/references/chunking-strategies.md +878 -878
  176. package/skills/ai-ml/rag-architect/references/embedding-models.md +561 -561
  177. package/skills/ai-ml/rag-architect/references/rag-evaluation.md +833 -833
  178. package/skills/ai-ml/rag-architect/references/retrieval-optimization.md +795 -795
  179. package/skills/ai-ml/rag-architect/references/vector-databases.md +589 -589
  180. package/skills/ai-ml/spark-engineer/SKILL.md +148 -148
  181. package/skills/ai-ml/spark-engineer/references/partitioning-caching.md +543 -543
  182. package/skills/ai-ml/spark-engineer/references/performance-tuning.md +544 -544
  183. package/skills/ai-ml/spark-engineer/references/rdd-operations.md +599 -599
  184. package/skills/ai-ml/spark-engineer/references/spark-sql-dataframes.md +474 -474
  185. package/skills/ai-ml/spark-engineer/references/streaming-patterns.md +786 -786
  186. package/skills/backend/api-designer/SKILL.md +217 -217
  187. package/skills/backend/api-designer/references/error-handling.md +541 -541
  188. package/skills/backend/api-designer/references/openapi.md +824 -824
  189. package/skills/backend/api-designer/references/pagination.md +494 -494
  190. package/skills/backend/api-designer/references/rest-patterns.md +335 -335
  191. package/skills/backend/api-designer/references/versioning.md +391 -391
  192. package/skills/backend/architecture-designer/SKILL.md +117 -117
  193. package/skills/backend/architecture-designer/references/adr-template.md +116 -116
  194. package/skills/backend/architecture-designer/references/architecture-patterns.md +111 -111
  195. package/skills/backend/architecture-designer/references/database-selection.md +102 -102
  196. package/skills/backend/architecture-designer/references/nfr-checklist.md +112 -112
  197. package/skills/backend/architecture-designer/references/system-design.md +100 -100
  198. package/skills/backend/code-documenter/SKILL.md +147 -147
  199. package/skills/backend/code-documenter/references/api-docs-fastapi-django.md +166 -166
  200. package/skills/backend/code-documenter/references/api-docs-nestjs-express.md +220 -220
  201. package/skills/backend/code-documenter/references/coverage-reports.md +125 -125
  202. package/skills/backend/code-documenter/references/documentation-systems.md +333 -333
  203. package/skills/backend/code-documenter/references/interactive-api-docs.md +531 -531
  204. package/skills/backend/code-documenter/references/python-docstrings.md +121 -121
  205. package/skills/backend/code-documenter/references/typescript-jsdoc.md +145 -145
  206. package/skills/backend/code-documenter/references/user-guides-tutorials.md +530 -530
  207. package/skills/backend/debugging-wizard/SKILL.md +105 -105
  208. package/skills/backend/debugging-wizard/references/common-patterns.md +132 -132
  209. package/skills/backend/debugging-wizard/references/debugging-tools.md +140 -140
  210. package/skills/backend/debugging-wizard/references/quick-fixes.md +177 -177
  211. package/skills/backend/debugging-wizard/references/strategies.md +142 -142
  212. package/skills/backend/debugging-wizard/references/systematic-debugging.md +367 -367
  213. package/skills/backend/feature-forge/SKILL.md +98 -98
  214. package/skills/backend/feature-forge/references/acceptance-criteria.md +104 -104
  215. package/skills/backend/feature-forge/references/ears-syntax.md +99 -99
  216. package/skills/backend/feature-forge/references/interview-questions.md +150 -150
  217. package/skills/backend/feature-forge/references/pre-discovery-subagents.md +54 -54
  218. package/skills/backend/feature-forge/references/specification-template.md +103 -103
  219. package/skills/backend/fullstack-guardian/SKILL.md +105 -105
  220. package/skills/backend/fullstack-guardian/references/api-design-standards.md +307 -307
  221. package/skills/backend/fullstack-guardian/references/architecture-decisions.md +350 -350
  222. package/skills/backend/fullstack-guardian/references/backend-patterns.md +237 -237
  223. package/skills/backend/fullstack-guardian/references/common-patterns.md +134 -134
  224. package/skills/backend/fullstack-guardian/references/deliverables-checklist.md +354 -354
  225. package/skills/backend/fullstack-guardian/references/design-template.md +91 -91
  226. package/skills/backend/fullstack-guardian/references/error-handling.md +135 -135
  227. package/skills/backend/fullstack-guardian/references/frontend-patterns.md +340 -340
  228. package/skills/backend/fullstack-guardian/references/integration-patterns.md +333 -333
  229. package/skills/backend/fullstack-guardian/references/security-checklist.md +106 -106
  230. package/skills/backend/graphql-architect/SKILL.md +146 -146
  231. package/skills/backend/graphql-architect/references/federation.md +418 -418
  232. package/skills/backend/graphql-architect/references/migration-from-rest.md +1141 -1141
  233. package/skills/backend/graphql-architect/references/resolvers.md +425 -425
  234. package/skills/backend/graphql-architect/references/schema-design.md +393 -393
  235. package/skills/backend/graphql-architect/references/security.md +569 -569
  236. package/skills/backend/graphql-architect/references/subscriptions.md +510 -510
  237. package/skills/backend/legacy-modernizer/SKILL.md +137 -137
  238. package/skills/backend/legacy-modernizer/references/legacy-testing.md +381 -381
  239. package/skills/backend/legacy-modernizer/references/migration-strategies.md +423 -423
  240. package/skills/backend/legacy-modernizer/references/refactoring-patterns.md +395 -395
  241. package/skills/backend/legacy-modernizer/references/strangler-fig-pattern.md +281 -281
  242. package/skills/backend/legacy-modernizer/references/system-assessment.md +487 -487
  243. package/skills/backend/microservices-architect/SKILL.md +164 -164
  244. package/skills/backend/microservices-architect/references/communication.md +499 -499
  245. package/skills/backend/microservices-architect/references/data.md +721 -721
  246. package/skills/backend/microservices-architect/references/decomposition.md +344 -344
  247. package/skills/backend/microservices-architect/references/observability.md +805 -805
  248. package/skills/backend/microservices-architect/references/patterns.md +603 -603
  249. package/skills/database/database-optimizer/SKILL.md +147 -147
  250. package/skills/database/database-optimizer/references/index-strategies.md +331 -331
  251. package/skills/database/database-optimizer/references/monitoring-analysis.md +501 -501
  252. package/skills/database/database-optimizer/references/mysql-tuning.md +452 -452
  253. package/skills/database/database-optimizer/references/postgresql-tuning.md +413 -413
  254. package/skills/database/database-optimizer/references/query-optimization.md +251 -251
  255. package/skills/database/postgres-pro/SKILL.md +152 -152
  256. package/skills/database/postgres-pro/references/extensions.md +404 -404
  257. package/skills/database/postgres-pro/references/jsonb.md +321 -321
  258. package/skills/database/postgres-pro/references/maintenance.md +481 -481
  259. package/skills/database/postgres-pro/references/performance.md +265 -265
  260. package/skills/database/postgres-pro/references/replication.md +446 -446
  261. package/skills/database/sql-pro/SKILL.md +129 -129
  262. package/skills/database/sql-pro/references/database-design.md +402 -402
  263. package/skills/database/sql-pro/references/dialect-differences.md +419 -419
  264. package/skills/database/sql-pro/references/optimization.md +384 -384
  265. package/skills/database/sql-pro/references/query-patterns.md +285 -285
  266. package/skills/database/sql-pro/references/window-functions.md +328 -328
  267. package/skills/dotnet/csharp-developer/SKILL.md +125 -125
  268. package/skills/dotnet/csharp-developer/references/aspnet-core.md +394 -394
  269. package/skills/dotnet/csharp-developer/references/blazor.md +553 -553
  270. package/skills/dotnet/csharp-developer/references/entity-framework.md +409 -409
  271. package/skills/dotnet/csharp-developer/references/modern-csharp.md +248 -248
  272. package/skills/dotnet/csharp-developer/references/performance.md +498 -498
  273. package/skills/dotnet/dotnet-core-expert/SKILL.md +138 -138
  274. package/skills/dotnet/dotnet-core-expert/references/authentication.md +546 -546
  275. package/skills/dotnet/dotnet-core-expert/references/clean-architecture.md +455 -455
  276. package/skills/dotnet/dotnet-core-expert/references/cloud-native.md +548 -548
  277. package/skills/dotnet/dotnet-core-expert/references/entity-framework.md +440 -440
  278. package/skills/dotnet/dotnet-core-expert/references/minimal-apis.md +319 -319
  279. package/skills/frontend/angular-architect/SKILL.md +152 -152
  280. package/skills/frontend/angular-architect/references/components.md +297 -297
  281. package/skills/frontend/angular-architect/references/ngrx.md +401 -401
  282. package/skills/frontend/angular-architect/references/routing.md +361 -361
  283. package/skills/frontend/angular-architect/references/rxjs.md +319 -319
  284. package/skills/frontend/angular-architect/references/testing.md +405 -405
  285. package/skills/frontend/design-commands/design.md +91 -91
  286. package/skills/frontend/design-commands/handoff.md +97 -97
  287. package/skills/frontend/design-commands/prototype.md +120 -120
  288. package/skills/frontend/design-commands/spec.md +160 -160
  289. package/skills/frontend/design-commands/style.md +78 -78
  290. package/skills/frontend/flutter-expert/SKILL.md +138 -138
  291. package/skills/frontend/flutter-expert/references/bloc-state.md +259 -259
  292. package/skills/frontend/flutter-expert/references/gorouter-navigation.md +119 -119
  293. package/skills/frontend/flutter-expert/references/performance.md +99 -99
  294. package/skills/frontend/flutter-expert/references/project-structure.md +118 -118
  295. package/skills/frontend/flutter-expert/references/riverpod-state.md +130 -130
  296. package/skills/frontend/flutter-expert/references/widget-patterns.md +123 -123
  297. package/skills/frontend/nextjs-developer/SKILL.md +143 -143
  298. package/skills/frontend/nextjs-developer/references/app-router.md +311 -311
  299. package/skills/frontend/nextjs-developer/references/data-fetching.md +482 -482
  300. package/skills/frontend/nextjs-developer/references/deployment.md +545 -545
  301. package/skills/frontend/nextjs-developer/references/server-actions.md +462 -462
  302. package/skills/frontend/nextjs-developer/references/server-components.md +384 -384
  303. package/skills/frontend/react-expert/SKILL.md +149 -149
  304. package/skills/frontend/react-expert/references/hooks-patterns.md +162 -162
  305. package/skills/frontend/react-expert/references/migration-class-to-modern.md +1119 -1119
  306. package/skills/frontend/react-expert/references/performance.md +168 -168
  307. package/skills/frontend/react-expert/references/react-19-features.md +174 -174
  308. package/skills/frontend/react-expert/references/server-components.md +143 -143
  309. package/skills/frontend/react-expert/references/state-management.md +171 -171
  310. package/skills/frontend/react-expert/references/testing-react.md +174 -174
  311. package/skills/frontend/react-native-expert/SKILL.md +185 -185
  312. package/skills/frontend/react-native-expert/references/expo-router.md +187 -187
  313. package/skills/frontend/react-native-expert/references/list-optimization.md +204 -204
  314. package/skills/frontend/react-native-expert/references/platform-handling.md +188 -188
  315. package/skills/frontend/react-native-expert/references/project-structure.md +171 -171
  316. package/skills/frontend/react-native-expert/references/storage-hooks.md +173 -173
  317. package/skills/frontend/senior-frontend/SKILL.md +477 -477
  318. package/skills/frontend/senior-frontend/references/frontend_best_practices.md +806 -806
  319. package/skills/frontend/senior-frontend/references/nextjs_optimization_guide.md +724 -724
  320. package/skills/frontend/senior-frontend/references/react_patterns.md +746 -746
  321. package/skills/frontend/senior-frontend/scripts/bundle_analyzer.py +407 -407
  322. package/skills/frontend/senior-frontend/scripts/component_generator.py +329 -329
  323. package/skills/frontend/senior-frontend/scripts/frontend_scaffolder.py +1005 -1005
  324. package/skills/frontend/ui-ux-pro-max/SKILL.md +386 -386
  325. package/skills/frontend/ui-ux-pro-max/data/charts.csv +26 -26
  326. package/skills/frontend/ui-ux-pro-max/data/colors.csv +97 -97
  327. package/skills/frontend/ui-ux-pro-max/data/icons.csv +101 -101
  328. package/skills/frontend/ui-ux-pro-max/data/landing.csv +31 -31
  329. package/skills/frontend/ui-ux-pro-max/data/products.csv +96 -96
  330. package/skills/frontend/ui-ux-pro-max/data/react-performance.csv +45 -45
  331. package/skills/frontend/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  332. package/skills/frontend/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
  333. package/skills/frontend/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
  334. package/skills/frontend/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  335. package/skills/frontend/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
  336. package/skills/frontend/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  337. package/skills/frontend/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  338. package/skills/frontend/ui-ux-pro-max/data/stacks/react-native.csv +52 -52
  339. package/skills/frontend/ui-ux-pro-max/data/stacks/react.csv +54 -54
  340. package/skills/frontend/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  341. package/skills/frontend/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
  342. package/skills/frontend/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
  343. package/skills/frontend/ui-ux-pro-max/data/stacks/vue.csv +50 -50
  344. package/skills/frontend/ui-ux-pro-max/data/styles.csv +68 -68
  345. package/skills/frontend/ui-ux-pro-max/data/typography.csv +57 -57
  346. package/skills/frontend/ui-ux-pro-max/data/ui-reasoning.csv +101 -101
  347. package/skills/frontend/ui-ux-pro-max/data/ux-guidelines.csv +99 -99
  348. package/skills/frontend/ui-ux-pro-max/data/web-interface.csv +31 -31
  349. package/skills/frontend/ui-ux-pro-max/scripts/core.py +253 -253
  350. package/skills/frontend/ui-ux-pro-max/scripts/design_system.py +1067 -1067
  351. package/skills/frontend/ui-ux-pro-max/scripts/search.py +114 -114
  352. package/skills/frontend/vue-expert/SKILL.md +98 -98
  353. package/skills/frontend/vue-expert/references/build-tooling.md +480 -480
  354. package/skills/frontend/vue-expert/references/components.md +448 -448
  355. package/skills/frontend/vue-expert/references/composition-api.md +299 -299
  356. package/skills/frontend/vue-expert/references/mobile-hybrid.md +636 -636
  357. package/skills/frontend/vue-expert/references/nuxt.md +669 -669
  358. package/skills/frontend/vue-expert/references/state-management.md +449 -449
  359. package/skills/frontend/vue-expert/references/typescript.md +584 -584
  360. package/skills/frontend/vue-expert-js/SKILL.md +167 -167
  361. package/skills/frontend/vue-expert-js/references/component-architecture.md +219 -219
  362. package/skills/frontend/vue-expert-js/references/composables-patterns.md +183 -183
  363. package/skills/frontend/vue-expert-js/references/jsdoc-typing.md +535 -535
  364. package/skills/frontend/vue-expert-js/references/state-management.md +249 -249
  365. package/skills/frontend/vue-expert-js/references/testing-patterns.md +237 -237
  366. package/skills/go-rust-cpp/cpp-pro/SKILL.md +115 -115
  367. package/skills/go-rust-cpp/cpp-pro/references/build-tooling.md +440 -440
  368. package/skills/go-rust-cpp/cpp-pro/references/concurrency.md +437 -437
  369. package/skills/go-rust-cpp/cpp-pro/references/memory-performance.md +397 -397
  370. package/skills/go-rust-cpp/cpp-pro/references/modern-cpp.md +304 -304
  371. package/skills/go-rust-cpp/cpp-pro/references/templates.md +357 -357
  372. package/skills/go-rust-cpp/golang-pro/SKILL.md +122 -122
  373. package/skills/go-rust-cpp/golang-pro/references/concurrency.md +329 -329
  374. package/skills/go-rust-cpp/golang-pro/references/generics.md +442 -442
  375. package/skills/go-rust-cpp/golang-pro/references/interfaces.md +432 -432
  376. package/skills/go-rust-cpp/golang-pro/references/project-structure.md +477 -477
  377. package/skills/go-rust-cpp/golang-pro/references/testing.md +451 -451
  378. package/skills/go-rust-cpp/rust-engineer/SKILL.md +167 -167
  379. package/skills/go-rust-cpp/rust-engineer/references/async.md +458 -458
  380. package/skills/go-rust-cpp/rust-engineer/references/error-handling.md +334 -334
  381. package/skills/go-rust-cpp/rust-engineer/references/ownership.md +278 -278
  382. package/skills/go-rust-cpp/rust-engineer/references/testing.md +470 -470
  383. package/skills/go-rust-cpp/rust-engineer/references/traits.md +413 -413
  384. package/skills/infra/cli-developer/SKILL.md +113 -113
  385. package/skills/infra/cli-developer/references/design-patterns.md +221 -221
  386. package/skills/infra/cli-developer/references/go-cli.md +540 -540
  387. package/skills/infra/cli-developer/references/node-cli.md +383 -383
  388. package/skills/infra/cli-developer/references/python-cli.md +422 -422
  389. package/skills/infra/cli-developer/references/ux-patterns.md +448 -448
  390. package/skills/infra/cloud-architect/SKILL.md +216 -216
  391. package/skills/infra/cloud-architect/references/aws.md +394 -394
  392. package/skills/infra/cloud-architect/references/azure.md +562 -562
  393. package/skills/infra/cloud-architect/references/cost.md +582 -582
  394. package/skills/infra/cloud-architect/references/gcp.md +633 -633
  395. package/skills/infra/cloud-architect/references/multi-cloud.md +483 -483
  396. package/skills/infra/devops-engineer/SKILL.md +144 -144
  397. package/skills/infra/devops-engineer/references/deployment-strategies.md +241 -241
  398. package/skills/infra/devops-engineer/references/docker-patterns.md +113 -113
  399. package/skills/infra/devops-engineer/references/github-actions.md +139 -139
  400. package/skills/infra/devops-engineer/references/incident-response.md +331 -331
  401. package/skills/infra/devops-engineer/references/kubernetes.md +154 -154
  402. package/skills/infra/devops-engineer/references/platform-engineering.md +417 -417
  403. package/skills/infra/devops-engineer/references/release-automation.md +527 -527
  404. package/skills/infra/devops-engineer/references/terraform-iac.md +141 -141
  405. package/skills/infra/kubernetes-specialist/SKILL.md +241 -241
  406. package/skills/infra/kubernetes-specialist/references/configuration.md +452 -452
  407. package/skills/infra/kubernetes-specialist/references/cost-optimization.md +458 -458
  408. package/skills/infra/kubernetes-specialist/references/custom-operators.md +563 -563
  409. package/skills/infra/kubernetes-specialist/references/gitops.md +530 -530
  410. package/skills/infra/kubernetes-specialist/references/helm-charts.md +912 -912
  411. package/skills/infra/kubernetes-specialist/references/multi-cluster.md +507 -507
  412. package/skills/infra/kubernetes-specialist/references/networking.md +447 -447
  413. package/skills/infra/kubernetes-specialist/references/service-mesh.md +459 -459
  414. package/skills/infra/kubernetes-specialist/references/storage.md +535 -535
  415. package/skills/infra/kubernetes-specialist/references/troubleshooting.md +414 -414
  416. package/skills/infra/kubernetes-specialist/references/workloads.md +377 -377
  417. package/skills/infra/mcp-developer/SKILL.md +143 -143
  418. package/skills/infra/mcp-developer/references/protocol.md +244 -244
  419. package/skills/infra/mcp-developer/references/python-sdk.md +367 -367
  420. package/skills/infra/mcp-developer/references/resources.md +554 -554
  421. package/skills/infra/mcp-developer/references/tools.md +480 -480
  422. package/skills/infra/mcp-developer/references/typescript-sdk.md +350 -350
  423. package/skills/infra/monitoring-expert/SKILL.md +176 -176
  424. package/skills/infra/monitoring-expert/references/alerting-rules.md +141 -141
  425. package/skills/infra/monitoring-expert/references/application-profiling.md +331 -331
  426. package/skills/infra/monitoring-expert/references/capacity-planning.md +344 -344
  427. package/skills/infra/monitoring-expert/references/dashboards.md +126 -126
  428. package/skills/infra/monitoring-expert/references/opentelemetry.md +123 -123
  429. package/skills/infra/monitoring-expert/references/performance-testing.md +269 -269
  430. package/skills/infra/monitoring-expert/references/prometheus-metrics.md +136 -136
  431. package/skills/infra/monitoring-expert/references/structured-logging.md +142 -142
  432. package/skills/infra/sre-engineer/SKILL.md +181 -181
  433. package/skills/infra/sre-engineer/references/automation-toil.md +492 -492
  434. package/skills/infra/sre-engineer/references/error-budget-policy.md +334 -334
  435. package/skills/infra/sre-engineer/references/incident-chaos.md +576 -576
  436. package/skills/infra/sre-engineer/references/monitoring-alerting.md +424 -424
  437. package/skills/infra/sre-engineer/references/slo-sli-management.md +238 -238
  438. package/skills/infra/terraform-engineer/SKILL.md +143 -143
  439. package/skills/infra/terraform-engineer/references/best-practices.md +583 -583
  440. package/skills/infra/terraform-engineer/references/module-patterns.md +297 -297
  441. package/skills/infra/terraform-engineer/references/providers.md +452 -452
  442. package/skills/infra/terraform-engineer/references/state-management.md +371 -371
  443. package/skills/infra/terraform-engineer/references/testing.md +486 -486
  444. package/skills/infra/websocket-engineer/SKILL.md +168 -168
  445. package/skills/infra/websocket-engineer/references/alternatives.md +391 -391
  446. package/skills/infra/websocket-engineer/references/patterns.md +400 -400
  447. package/skills/infra/websocket-engineer/references/protocol.md +195 -195
  448. package/skills/infra/websocket-engineer/references/scaling.md +333 -333
  449. package/skills/infra/websocket-engineer/references/security.md +474 -474
  450. package/skills/java/java-architect/SKILL.md +132 -132
  451. package/skills/java/java-architect/references/jpa-optimization.md +393 -393
  452. package/skills/java/java-architect/references/reactive-webflux.md +356 -356
  453. package/skills/java/java-architect/references/spring-boot-setup.md +269 -269
  454. package/skills/java/java-architect/references/spring-security.md +445 -445
  455. package/skills/java/java-architect/references/testing-patterns.md +500 -500
  456. package/skills/java/kotlin-specialist/SKILL.md +147 -147
  457. package/skills/java/kotlin-specialist/references/android-compose.md +419 -419
  458. package/skills/java/kotlin-specialist/references/coroutines-flow.md +276 -276
  459. package/skills/java/kotlin-specialist/references/dsl-idioms.md +421 -421
  460. package/skills/java/kotlin-specialist/references/ktor-server.md +426 -426
  461. package/skills/java/kotlin-specialist/references/multiplatform-kmp.md +380 -380
  462. package/skills/java/spring-boot-engineer/SKILL.md +195 -195
  463. package/skills/java/spring-boot-engineer/references/cloud.md +498 -498
  464. package/skills/java/spring-boot-engineer/references/data.md +381 -381
  465. package/skills/java/spring-boot-engineer/references/security.md +459 -459
  466. package/skills/java/spring-boot-engineer/references/testing.md +545 -545
  467. package/skills/java/spring-boot-engineer/references/web.md +295 -295
  468. package/skills/javascript/javascript-pro/SKILL.md +132 -132
  469. package/skills/javascript/javascript-pro/references/async-patterns.md +334 -334
  470. package/skills/javascript/javascript-pro/references/browser-apis.md +398 -398
  471. package/skills/javascript/javascript-pro/references/modern-syntax.md +272 -272
  472. package/skills/javascript/javascript-pro/references/modules.md +357 -357
  473. package/skills/javascript/javascript-pro/references/node-essentials.md +471 -471
  474. package/skills/javascript/nestjs-expert/SKILL.md +206 -206
  475. package/skills/javascript/nestjs-expert/references/authentication.md +166 -166
  476. package/skills/javascript/nestjs-expert/references/controllers-routing.md +111 -111
  477. package/skills/javascript/nestjs-expert/references/dtos-validation.md +153 -153
  478. package/skills/javascript/nestjs-expert/references/migration-from-express.md +1237 -1237
  479. package/skills/javascript/nestjs-expert/references/services-di.md +140 -140
  480. package/skills/javascript/nestjs-expert/references/testing-patterns.md +186 -186
  481. package/skills/javascript/typescript-pro/SKILL.md +145 -145
  482. package/skills/javascript/typescript-pro/references/advanced-types.md +259 -259
  483. package/skills/javascript/typescript-pro/references/configuration.md +445 -445
  484. package/skills/javascript/typescript-pro/references/patterns.md +484 -484
  485. package/skills/javascript/typescript-pro/references/type-guards.md +352 -352
  486. package/skills/javascript/typescript-pro/references/utility-types.md +329 -329
  487. package/skills/php/laravel-specialist/SKILL.md +262 -262
  488. package/skills/php/laravel-specialist/references/eloquent.md +351 -351
  489. package/skills/php/laravel-specialist/references/livewire.md +512 -512
  490. package/skills/php/laravel-specialist/references/queues.md +423 -423
  491. package/skills/php/laravel-specialist/references/routing.md +362 -362
  492. package/skills/php/laravel-specialist/references/testing.md +522 -522
  493. package/skills/php/php-pro/SKILL.md +206 -206
  494. package/skills/php/php-pro/references/async-patterns.md +412 -412
  495. package/skills/php/php-pro/references/laravel-patterns.md +377 -377
  496. package/skills/php/php-pro/references/modern-php-features.md +323 -323
  497. package/skills/php/php-pro/references/symfony-patterns.md +466 -466
  498. package/skills/php/php-pro/references/testing-quality.md +466 -466
  499. package/skills/product/competitive-analysis/SKILL.md +257 -257
  500. package/skills/product/meeting-notes/SKILL.md +266 -266
  501. package/skills/product/prd-template/SKILL.md +150 -150
  502. package/skills/product/stakeholder-update/SKILL.md +225 -225
  503. package/skills/product/user-research-synthesis/SKILL.md +235 -235
  504. package/skills/python/django-expert/SKILL.md +162 -162
  505. package/skills/python/django-expert/references/authentication.md +145 -145
  506. package/skills/python/django-expert/references/drf-serializers.md +148 -148
  507. package/skills/python/django-expert/references/models-orm.md +151 -151
  508. package/skills/python/django-expert/references/testing-django.md +204 -204
  509. package/skills/python/django-expert/references/viewsets-views.md +153 -153
  510. package/skills/python/fastapi-expert/SKILL.md +185 -185
  511. package/skills/python/fastapi-expert/references/async-sqlalchemy.md +146 -146
  512. package/skills/python/fastapi-expert/references/authentication.md +159 -159
  513. package/skills/python/fastapi-expert/references/endpoints-routing.md +142 -142
  514. package/skills/python/fastapi-expert/references/migration-from-django.md +996 -996
  515. package/skills/python/fastapi-expert/references/pydantic-v2.md +135 -135
  516. package/skills/python/fastapi-expert/references/testing-async.md +159 -159
  517. package/skills/python/pandas-pro/SKILL.md +178 -178
  518. package/skills/python/pandas-pro/references/aggregation-groupby.md +545 -545
  519. package/skills/python/pandas-pro/references/data-cleaning.md +500 -500
  520. package/skills/python/pandas-pro/references/dataframe-operations.md +420 -420
  521. package/skills/python/pandas-pro/references/merging-joining.md +596 -596
  522. package/skills/python/pandas-pro/references/performance-optimization.md +597 -597
  523. package/skills/python/python-pro/SKILL.md +177 -177
  524. package/skills/python/python-pro/references/async-patterns.md +356 -356
  525. package/skills/python/python-pro/references/packaging.md +460 -460
  526. package/skills/python/python-pro/references/standard-library.md +378 -378
  527. package/skills/python/python-pro/references/testing.md +404 -404
  528. package/skills/python/python-pro/references/type-system.md +290 -290
  529. package/skills/quality/chaos-engineer/SKILL.md +182 -182
  530. package/skills/quality/chaos-engineer/references/chaos-tools.md +511 -511
  531. package/skills/quality/chaos-engineer/references/experiment-design.md +229 -229
  532. package/skills/quality/chaos-engineer/references/game-days.md +434 -434
  533. package/skills/quality/chaos-engineer/references/infrastructure-chaos.md +348 -348
  534. package/skills/quality/chaos-engineer/references/kubernetes-chaos.md +432 -432
  535. package/skills/quality/code-reviewer/SKILL.md +119 -119
  536. package/skills/quality/code-reviewer/references/common-issues.md +142 -142
  537. package/skills/quality/code-reviewer/references/feedback-examples.md +144 -144
  538. package/skills/quality/code-reviewer/references/receiving-feedback.md +238 -238
  539. package/skills/quality/code-reviewer/references/report-template.md +109 -109
  540. package/skills/quality/code-reviewer/references/review-checklist.md +88 -88
  541. package/skills/quality/code-reviewer/references/spec-compliance-review.md +258 -258
  542. package/skills/quality/playwright-expert/SKILL.md +169 -169
  543. package/skills/quality/playwright-expert/references/api-mocking.md +140 -140
  544. package/skills/quality/playwright-expert/references/configuration.md +155 -155
  545. package/skills/quality/playwright-expert/references/debugging-flaky.md +150 -150
  546. package/skills/quality/playwright-expert/references/page-object-model.md +152 -152
  547. package/skills/quality/playwright-expert/references/selectors-locators.md +119 -119
  548. package/skills/quality/secure-code-guardian/SKILL.md +191 -191
  549. package/skills/quality/secure-code-guardian/references/authentication.md +136 -136
  550. package/skills/quality/secure-code-guardian/references/input-validation.md +146 -146
  551. package/skills/quality/secure-code-guardian/references/owasp-prevention.md +135 -135
  552. package/skills/quality/secure-code-guardian/references/security-headers.md +133 -133
  553. package/skills/quality/secure-code-guardian/references/xss-csrf.md +157 -157
  554. package/skills/quality/security-reviewer/SKILL.md +103 -103
  555. package/skills/quality/security-reviewer/references/infrastructure-security.md +268 -268
  556. package/skills/quality/security-reviewer/references/penetration-testing.md +268 -268
  557. package/skills/quality/security-reviewer/references/report-template.md +170 -170
  558. package/skills/quality/security-reviewer/references/sast-tools.md +117 -117
  559. package/skills/quality/security-reviewer/references/secret-scanning.md +125 -125
  560. package/skills/quality/security-reviewer/references/vulnerability-patterns.md +152 -152
  561. package/skills/quality/senior-qa/README.md +196 -196
  562. package/skills/quality/senior-qa/SKILL.md +399 -399
  563. package/skills/quality/senior-qa/references/qa_best_practices.md +964 -964
  564. package/skills/quality/senior-qa/references/test_automation_patterns.md +1009 -1009
  565. package/skills/quality/senior-qa/references/testing_strategies.md +649 -649
  566. package/skills/quality/senior-qa/scripts/coverage_analyzer.py +836 -836
  567. package/skills/quality/senior-qa/scripts/e2e_test_scaffolder.py +820 -820
  568. package/skills/quality/senior-qa/scripts/test_suite_generator.py +605 -605
  569. package/skills/quality/tdd-guide/HOW_TO_USE.md +313 -313
  570. package/skills/quality/tdd-guide/README.md +680 -680
  571. package/skills/quality/tdd-guide/SKILL.md +122 -122
  572. package/skills/quality/tdd-guide/assets/expected_output.json +77 -77
  573. package/skills/quality/tdd-guide/assets/sample_input_python.json +39 -39
  574. package/skills/quality/tdd-guide/assets/sample_input_typescript.json +36 -36
  575. package/skills/quality/tdd-guide/references/ci-integration.md +195 -195
  576. package/skills/quality/tdd-guide/references/framework-guide.md +206 -206
  577. package/skills/quality/tdd-guide/references/tdd-best-practices.md +128 -128
  578. package/skills/quality/tdd-guide/scripts/coverage_analyzer.py +434 -434
  579. package/skills/quality/tdd-guide/scripts/fixture_generator.py +440 -440
  580. package/skills/quality/tdd-guide/scripts/format_detector.py +384 -384
  581. package/skills/quality/tdd-guide/scripts/framework_adapter.py +428 -428
  582. package/skills/quality/tdd-guide/scripts/metrics_calculator.py +456 -456
  583. package/skills/quality/tdd-guide/scripts/output_formatter.py +354 -354
  584. package/skills/quality/tdd-guide/scripts/tdd_workflow.py +474 -474
  585. package/skills/quality/tdd-guide/scripts/test_generator.py +438 -438
  586. package/skills/quality/test-master/SKILL.md +94 -94
  587. package/skills/quality/test-master/references/automation-frameworks.md +294 -294
  588. package/skills/quality/test-master/references/e2e-testing.md +128 -128
  589. package/skills/quality/test-master/references/integration-testing.md +120 -120
  590. package/skills/quality/test-master/references/performance-testing.md +118 -118
  591. package/skills/quality/test-master/references/qa-methodology.md +247 -247
  592. package/skills/quality/test-master/references/security-testing.md +127 -127
  593. package/skills/quality/test-master/references/tdd-iron-laws.md +174 -174
  594. package/skills/quality/test-master/references/test-reports.md +104 -104
  595. package/skills/quality/test-master/references/testing-anti-patterns.md +231 -231
  596. package/skills/quality/test-master/references/unit-testing.md +113 -113
  597. package/skills/ruby/rails-expert/SKILL.md +154 -154
  598. package/skills/ruby/rails-expert/references/active-record.md +244 -244
  599. package/skills/ruby/rails-expert/references/api-development.md +401 -401
  600. package/skills/ruby/rails-expert/references/background-jobs.md +272 -272
  601. package/skills/ruby/rails-expert/references/hotwire-turbo.md +228 -228
  602. package/skills/ruby/rails-expert/references/rspec-testing.md +367 -367
  603. package/skills/swift/swift-expert/SKILL.md +163 -163
  604. package/skills/swift/swift-expert/references/async-concurrency.md +360 -360
  605. package/skills/swift/swift-expert/references/memory-performance.md +377 -377
  606. package/skills/swift/swift-expert/references/protocol-oriented.md +354 -354
  607. package/skills/swift/swift-expert/references/swiftui-patterns.md +291 -291
  608. package/skills/swift/swift-expert/references/testing-patterns.md +399 -399
  609. package/skills/workflow/brainstorming/SKILL.md +164 -164
  610. package/skills/workflow/brainstorming/scripts/frame-template.html +214 -214
  611. package/skills/workflow/brainstorming/scripts/helper.js +88 -88
  612. package/skills/workflow/brainstorming/scripts/server.cjs +354 -354
  613. package/skills/workflow/brainstorming/scripts/start-server.sh +148 -148
  614. package/skills/workflow/brainstorming/scripts/stop-server.sh +56 -56
  615. package/skills/workflow/brainstorming/spec-document-reviewer-prompt.md +49 -49
  616. package/skills/workflow/brainstorming/visual-companion.md +287 -287
  617. package/skills/workflow/documentation/SKILL.md +45 -45
  618. package/skills/workflow/entropy-management/SKILL.md +115 -115
  619. package/skills/workflow/executing-plans/SKILL.md +70 -70
  620. package/skills/workflow/finishing-a-development-branch/SKILL.md +200 -200
  621. package/skills/workflow/receiving-code-review/SKILL.md +213 -213
  622. package/skills/workflow/requesting-code-review/SKILL.md +105 -105
  623. package/skills/workflow/requesting-code-review/code-reviewer.md +146 -146
  624. package/skills/workflow/requirement-engineering/SKILL.md +111 -111
  625. package/skills/workflow/systematic-debugging/CREATION-LOG.md +119 -119
  626. package/skills/workflow/systematic-debugging/SKILL.md +296 -296
  627. package/skills/workflow/systematic-debugging/condition-based-waiting-example.ts +158 -158
  628. package/skills/workflow/systematic-debugging/condition-based-waiting.md +115 -115
  629. package/skills/workflow/systematic-debugging/defense-in-depth.md +122 -122
  630. package/skills/workflow/systematic-debugging/find-polluter.sh +63 -63
  631. package/skills/workflow/systematic-debugging/root-cause-tracing.md +169 -169
  632. package/skills/workflow/systematic-debugging/test-academic.md +14 -14
  633. package/skills/workflow/systematic-debugging/test-pressure-1.md +58 -58
  634. package/skills/workflow/systematic-debugging/test-pressure-2.md +68 -68
  635. package/skills/workflow/systematic-debugging/test-pressure-3.md +69 -69
  636. package/skills/workflow/using-git-worktrees/SKILL.md +218 -218
  637. package/skills/workflow/verification-before-completion/SKILL.md +139 -139
  638. package/skills/workflow/writing-plans/SKILL.md +151 -151
  639. package/skills/workflow/writing-plans/plan-document-reviewer-prompt.md +49 -49
  640. package/skills/workflow/writing-skills/SKILL.md +655 -655
  641. package/skills/workflow/writing-skills/anthropic-best-practices.md +1150 -1150
  642. package/skills/workflow/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -189
  643. package/skills/workflow/writing-skills/persuasion-principles.md +187 -187
  644. package/skills/workflow/writing-skills/render-graphs.js +168 -168
  645. package/skills/workflow/writing-skills/testing-skills-with-subagents.md +384 -384
@@ -1,501 +1,501 @@
1
- # Monitoring and Analysis
2
-
3
- ## PostgreSQL Monitoring
4
-
5
- ### Essential Extensions
6
-
7
- ```sql
8
- -- Install performance monitoring extensions
9
- CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
10
- CREATE EXTENSION IF NOT EXISTS pg_buffercache;
11
- CREATE EXTENSION IF NOT EXISTS pg_trgm; -- For similarity searches
12
-
13
- -- Reset statistics
14
- SELECT pg_stat_statements_reset();
15
- SELECT pg_stat_reset();
16
- ```
17
-
18
- ### Query Performance Tracking
19
-
20
- ```sql
21
- -- Top queries by total time
22
- SELECT
23
- substring(query, 1, 100) as short_query,
24
- round(total_exec_time::numeric, 2) as total_time_ms,
25
- calls,
26
- round(mean_exec_time::numeric, 2) as mean_time_ms,
27
- round(stddev_exec_time::numeric, 2) as stddev_ms,
28
- round((100 * total_exec_time / sum(total_exec_time) OVER ())::numeric, 2) as pct_total
29
- FROM pg_stat_statements
30
- WHERE query NOT LIKE '%pg_stat_statements%'
31
- ORDER BY total_exec_time DESC
32
- LIMIT 20;
33
-
34
- -- Queries with high variance
35
- SELECT
36
- substring(query, 1, 100) as short_query,
37
- calls,
38
- round(mean_exec_time::numeric, 2) as mean_ms,
39
- round(stddev_exec_time::numeric, 2) as stddev_ms,
40
- round(max_exec_time::numeric, 2) as max_ms,
41
- round((stddev_exec_time / NULLIF(mean_exec_time, 0))::numeric, 2) as coeff_var
42
- FROM pg_stat_statements
43
- WHERE calls > 100
44
- AND stddev_exec_time > mean_exec_time * 0.5
45
- ORDER BY stddev_exec_time DESC
46
- LIMIT 20;
47
-
48
- -- I/O intensive queries
49
- SELECT
50
- substring(query, 1, 100) as short_query,
51
- calls,
52
- shared_blks_hit,
53
- shared_blks_read,
54
- shared_blks_written,
55
- round((shared_blks_read::numeric / NULLIF(calls, 0)), 2) as reads_per_call,
56
- round((shared_blks_hit / NULLIF(shared_blks_hit + shared_blks_read, 0)::numeric * 100), 2) as cache_hit_pct
57
- FROM pg_stat_statements
58
- WHERE shared_blks_read > 0
59
- ORDER BY shared_blks_read DESC
60
- LIMIT 20;
61
- ```
62
-
63
- ### Connection and Lock Monitoring
64
-
65
- ```sql
66
- -- Current activity
67
- SELECT
68
- pid,
69
- usename,
70
- application_name,
71
- client_addr,
72
- state,
73
- state_change,
74
- query_start,
75
- now() - query_start as duration,
76
- wait_event_type,
77
- wait_event,
78
- substring(query, 1, 100) as query
79
- FROM pg_stat_activity
80
- WHERE state != 'idle'
81
- ORDER BY query_start;
82
-
83
- -- Blocking queries
84
- SELECT
85
- blocked_locks.pid AS blocked_pid,
86
- blocked_activity.usename AS blocked_user,
87
- blocking_locks.pid AS blocking_pid,
88
- blocking_activity.usename AS blocking_user,
89
- blocked_activity.query AS blocked_query,
90
- blocking_activity.query AS blocking_query,
91
- blocked_activity.application_name AS blocked_app
92
- FROM pg_catalog.pg_locks blocked_locks
93
- JOIN pg_catalog.pg_stat_activity blocked_activity ON blocked_activity.pid = blocked_locks.pid
94
- JOIN pg_catalog.pg_locks blocking_locks
95
- ON blocking_locks.locktype = blocked_locks.locktype
96
- AND blocking_locks.database IS NOT DISTINCT FROM blocked_locks.database
97
- AND blocking_locks.relation IS NOT DISTINCT FROM blocked_locks.relation
98
- AND blocking_locks.page IS NOT DISTINCT FROM blocked_locks.page
99
- AND blocking_locks.tuple IS NOT DISTINCT FROM blocked_locks.tuple
100
- AND blocking_locks.virtualxid IS NOT DISTINCT FROM blocked_locks.virtualxid
101
- AND blocking_locks.transactionid IS NOT DISTINCT FROM blocked_locks.transactionid
102
- AND blocking_locks.classid IS NOT DISTINCT FROM blocked_locks.classid
103
- AND blocking_locks.objid IS NOT DISTINCT FROM blocked_locks.objid
104
- AND blocking_locks.objsubid IS NOT DISTINCT FROM blocked_locks.objsubid
105
- AND blocking_locks.pid != blocked_locks.pid
106
- JOIN pg_catalog.pg_stat_activity blocking_activity ON blocking_activity.pid = blocking_locks.pid
107
- WHERE NOT blocked_locks.granted;
108
-
109
- -- Wait events summary
110
- SELECT
111
- wait_event_type,
112
- wait_event,
113
- count(*) as waiting_connections
114
- FROM pg_stat_activity
115
- WHERE wait_event IS NOT NULL
116
- GROUP BY wait_event_type, wait_event
117
- ORDER BY waiting_connections DESC;
118
- ```
119
-
120
- ### Table and Index Statistics
121
-
122
- ```sql
123
- -- Table bloat and dead tuples
124
- SELECT
125
- schemaname,
126
- tablename,
127
- pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) as total_size,
128
- n_live_tup,
129
- n_dead_tup,
130
- round(n_dead_tup * 100.0 / NULLIF(n_live_tup + n_dead_tup, 0), 2) as dead_pct,
131
- last_vacuum,
132
- last_autovacuum,
133
- last_analyze,
134
- last_autoanalyze
135
- FROM pg_stat_user_tables
136
- WHERE n_live_tup > 1000
137
- ORDER BY n_dead_tup DESC;
138
-
139
- -- Index usage and efficiency
140
- SELECT
141
- schemaname,
142
- tablename,
143
- indexname,
144
- idx_scan,
145
- idx_tup_read,
146
- idx_tup_fetch,
147
- pg_size_pretty(pg_relation_size(indexrelid)) as size,
148
- CASE
149
- WHEN idx_scan = 0 THEN 'UNUSED'
150
- WHEN idx_tup_read = 0 THEN 'NEVER_READ'
151
- ELSE 'ACTIVE'
152
- END as status
153
- FROM pg_stat_user_indexes
154
- ORDER BY pg_relation_size(indexrelid) DESC;
155
-
156
- -- Sequential scans on large tables
157
- SELECT
158
- schemaname,
159
- tablename,
160
- seq_scan,
161
- seq_tup_read,
162
- idx_scan,
163
- n_live_tup,
164
- pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) as size
165
- FROM pg_stat_user_tables
166
- WHERE seq_scan > 0
167
- AND n_live_tup > 10000
168
- AND seq_tup_read / NULLIF(seq_scan, 0) > 10000
169
- ORDER BY seq_tup_read DESC;
170
- ```
171
-
172
- ### Database Statistics
173
-
174
- ```sql
175
- -- Database size and activity
176
- SELECT
177
- datname,
178
- pg_size_pretty(pg_database_size(datname)) as size,
179
- numbackends as connections,
180
- xact_commit,
181
- xact_rollback,
182
- round(xact_rollback * 100.0 / NULLIF(xact_commit + xact_rollback, 0), 2) as rollback_pct,
183
- blks_read,
184
- blks_hit,
185
- round(blks_hit * 100.0 / NULLIF(blks_hit + blks_read, 0), 2) as cache_hit_pct
186
- FROM pg_stat_database
187
- WHERE datname NOT IN ('template0', 'template1', 'postgres')
188
- ORDER BY pg_database_size(datname) DESC;
189
-
190
- -- Checkpoint and bgwriter statistics
191
- SELECT
192
- checkpoints_timed,
193
- checkpoints_req,
194
- checkpoint_write_time,
195
- checkpoint_sync_time,
196
- buffers_checkpoint,
197
- buffers_clean,
198
- buffers_backend,
199
- buffers_alloc,
200
- round(100.0 * checkpoints_req / NULLIF(checkpoints_timed + checkpoints_req, 0), 2) as req_checkpoint_pct
201
- FROM pg_stat_bgwriter;
202
- ```
203
-
204
- ## MySQL Monitoring
205
-
206
- ### Performance Schema Queries
207
-
208
- ```sql
209
- -- Top statements by total latency
210
- SELECT
211
- DIGEST_TEXT as query,
212
- COUNT_STAR as exec_count,
213
- ROUND(AVG_TIMER_WAIT / 1000000000000, 3) as avg_sec,
214
- ROUND(SUM_TIMER_WAIT / 1000000000000, 3) as total_sec,
215
- ROUND(MAX_TIMER_WAIT / 1000000000000, 3) as max_sec,
216
- ROUND((SUM_TIMER_WAIT / SUM(SUM_TIMER_WAIT) OVER ()) * 100, 2) as pct_total
217
- FROM performance_schema.events_statements_summary_by_digest
218
- WHERE SCHEMA_NAME NOT IN ('performance_schema', 'mysql', 'sys')
219
- ORDER BY SUM_TIMER_WAIT DESC
220
- LIMIT 20;
221
-
222
- -- Statements with full table scans
223
- SELECT
224
- OBJECT_SCHEMA as db,
225
- OBJECT_NAME as tbl,
226
- COUNT_STAR as exec_count,
227
- SUM_NO_INDEX_USED as full_scans,
228
- SUM_NO_GOOD_INDEX_USED as bad_index
229
- FROM performance_schema.table_io_waits_summary_by_index_usage
230
- WHERE INDEX_NAME IS NULL
231
- AND OBJECT_SCHEMA NOT IN ('performance_schema', 'mysql', 'sys')
232
- AND COUNT_STAR > 0
233
- ORDER BY SUM_NO_INDEX_USED DESC;
234
-
235
- -- Table I/O statistics
236
- SELECT
237
- OBJECT_SCHEMA,
238
- OBJECT_NAME,
239
- COUNT_READ,
240
- COUNT_WRITE,
241
- COUNT_FETCH,
242
- COUNT_INSERT,
243
- COUNT_UPDATE,
244
- COUNT_DELETE,
245
- ROUND(SUM_TIMER_WAIT / 1000000000000, 3) as total_latency_sec
246
- FROM performance_schema.table_io_waits_summary_by_table
247
- WHERE OBJECT_SCHEMA NOT IN ('performance_schema', 'mysql', 'sys')
248
- ORDER BY SUM_TIMER_WAIT DESC
249
- LIMIT 20;
250
- ```
251
-
252
- ### InnoDB Status Monitoring
253
-
254
- ```sql
255
- -- InnoDB buffer pool status
256
- SELECT
257
- POOL_ID,
258
- POOL_SIZE,
259
- FREE_BUFFERS,
260
- DATABASE_PAGES,
261
- OLD_DATABASE_PAGES,
262
- MODIFIED_DATABASE_PAGES,
263
- PENDING_DECOMPRESS,
264
- PENDING_READS,
265
- PENDING_FLUSH_LRU,
266
- PENDING_FLUSH_LIST
267
- FROM information_schema.INNODB_BUFFER_POOL_STATS;
268
-
269
- -- InnoDB lock waits
270
- SELECT
271
- r.trx_id as waiting_trx,
272
- r.trx_mysql_thread_id as waiting_thread,
273
- r.trx_query as waiting_query,
274
- b.trx_id as blocking_trx,
275
- b.trx_mysql_thread_id as blocking_thread,
276
- b.trx_query as blocking_query
277
- FROM information_schema.innodb_lock_waits w
278
- INNER JOIN information_schema.innodb_trx b ON b.trx_id = w.blocking_trx_id
279
- INNER JOIN information_schema.innodb_trx r ON r.trx_id = w.requesting_trx_id;
280
-
281
- -- Long-running transactions
282
- SELECT
283
- trx_id,
284
- trx_state,
285
- trx_started,
286
- TIMESTAMPDIFF(SECOND, trx_started, NOW()) as duration_sec,
287
- trx_requested_lock_id,
288
- trx_mysql_thread_id,
289
- trx_query
290
- FROM information_schema.innodb_trx
291
- WHERE TIMESTAMPDIFF(SECOND, trx_started, NOW()) > 60
292
- ORDER BY trx_started;
293
- ```
294
-
295
- ### Connection and Process Monitoring
296
-
297
- ```sql
298
- -- Current connections by state
299
- SELECT
300
- command,
301
- state,
302
- COUNT(*) as connections,
303
- MAX(time) as max_time_sec
304
- FROM information_schema.processlist
305
- GROUP BY command, state
306
- ORDER BY connections DESC;
307
-
308
- -- Long-running queries
309
- SELECT
310
- id,
311
- user,
312
- host,
313
- db,
314
- command,
315
- time,
316
- state,
317
- LEFT(info, 100) as query
318
- FROM information_schema.processlist
319
- WHERE command != 'Sleep'
320
- AND time > 10
321
- ORDER BY time DESC;
322
-
323
- -- Connection usage
324
- SHOW STATUS LIKE 'Threads_%';
325
- SHOW STATUS LIKE 'Max_used_connections';
326
- SHOW VARIABLES LIKE 'max_connections';
327
- ```
328
-
329
- ### System Status Variables
330
-
331
- ```sql
332
- -- Key buffer efficiency (MyISAM)
333
- SHOW STATUS LIKE 'Key_%';
334
-
335
- -- InnoDB metrics
336
- SHOW STATUS LIKE 'Innodb_buffer_pool_%';
337
- SHOW STATUS LIKE 'Innodb_rows_%';
338
- SHOW STATUS LIKE 'Innodb_data_%';
339
-
340
- -- Table locks
341
- SHOW STATUS LIKE 'Table_locks_%';
342
-
343
- -- Temporary tables
344
- SHOW STATUS LIKE 'Created_tmp_%';
345
-
346
- -- Thread cache
347
- SHOW STATUS LIKE 'Threads_%';
348
- SHOW STATUS LIKE 'Connections';
349
-
350
- -- Query cache (MySQL 5.7)
351
- SHOW STATUS LIKE 'Qcache_%';
352
- ```
353
-
354
- ## Cross-Platform Monitoring
355
-
356
- ### Resource Utilization
357
-
358
- ```sql
359
- -- PostgreSQL: Database size growth
360
- SELECT
361
- current_database() as database,
362
- pg_size_pretty(pg_database_size(current_database())) as size,
363
- (SELECT pg_size_pretty(sum(pg_total_relation_size(schemaname||'.'||tablename)))
364
- FROM pg_tables
365
- WHERE schemaname = 'public') as public_schema_size;
366
-
367
- -- MySQL: Database size
368
- SELECT
369
- table_schema as database,
370
- ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) as size_mb
371
- FROM information_schema.tables
372
- WHERE table_schema NOT IN ('information_schema', 'performance_schema', 'mysql', 'sys')
373
- GROUP BY table_schema
374
- ORDER BY size_mb DESC;
375
- ```
376
-
377
- ### Health Check Queries
378
-
379
- ```sql
380
- -- PostgreSQL: Overall health
381
- SELECT
382
- 'connections' as metric,
383
- count(*) as current,
384
- current_setting('max_connections')::int as max
385
- FROM pg_stat_activity
386
- UNION ALL
387
- SELECT
388
- 'cache_hit_ratio',
389
- round((sum(heap_blks_hit) / NULLIF(sum(heap_blks_hit) + sum(heap_blks_read), 0) * 100)::numeric, 2),
390
- 95
391
- FROM pg_statio_user_tables
392
- UNION ALL
393
- SELECT
394
- 'database_size_gb',
395
- round((pg_database_size(current_database()) / 1024.0 / 1024.0 / 1024.0)::numeric, 2),
396
- NULL;
397
-
398
- -- MySQL: Overall health
399
- SELECT 'connections' as metric,
400
- (SELECT COUNT(*) FROM information_schema.processlist) as current,
401
- @@max_connections as max
402
- UNION ALL
403
- SELECT 'buffer_pool_hit_ratio',
404
- ROUND((1 - (
405
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
406
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
407
- )) * 100, 2),
408
- 95
409
- UNION ALL
410
- SELECT 'slow_queries',
411
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Slow_queries'),
412
- NULL;
413
- ```
414
-
415
- ## Alert Thresholds
416
-
417
- ### PostgreSQL Alerts
418
-
419
- ```sql
420
- -- Connection pool nearing capacity
421
- SELECT
422
- count(*) as current_connections,
423
- current_setting('max_connections')::int as max_connections,
424
- CASE
425
- WHEN count(*) > current_setting('max_connections')::int * 0.9 THEN 'CRITICAL'
426
- WHEN count(*) > current_setting('max_connections')::int * 0.8 THEN 'WARNING'
427
- ELSE 'OK'
428
- END as status
429
- FROM pg_stat_activity;
430
-
431
- -- Cache hit ratio degradation
432
- WITH cache_stats AS (
433
- SELECT
434
- round((sum(heap_blks_hit) / NULLIF(sum(heap_blks_hit) + sum(heap_blks_read), 0) * 100)::numeric, 2) as hit_ratio
435
- FROM pg_statio_user_tables
436
- )
437
- SELECT
438
- hit_ratio,
439
- CASE
440
- WHEN hit_ratio < 90 THEN 'CRITICAL'
441
- WHEN hit_ratio < 95 THEN 'WARNING'
442
- ELSE 'OK'
443
- END as status
444
- FROM cache_stats;
445
-
446
- -- Replication lag (on standby)
447
- SELECT
448
- CASE
449
- WHEN pg_last_wal_receive_lsn() = pg_last_wal_replay_lsn() THEN 0
450
- ELSE EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))
451
- END as lag_seconds,
452
- CASE
453
- WHEN EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp())) > 60 THEN 'CRITICAL'
454
- WHEN EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp())) > 10 THEN 'WARNING'
455
- ELSE 'OK'
456
- END as status;
457
- ```
458
-
459
- ### MySQL Alerts
460
-
461
- ```sql
462
- -- InnoDB buffer pool efficiency
463
- SELECT
464
- ROUND((1 - (
465
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
466
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
467
- )) * 100, 2) as buffer_pool_hit_ratio,
468
- CASE
469
- WHEN (1 - (
470
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
471
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
472
- )) * 100 < 90 THEN 'CRITICAL'
473
- WHEN (1 - (
474
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
475
- (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
476
- )) * 100 < 95 THEN 'WARNING'
477
- ELSE 'OK'
478
- END as status;
479
-
480
- -- Replication lag (on replica)
481
- SELECT
482
- Seconds_Behind_Master as lag_seconds,
483
- CASE
484
- WHEN Slave_IO_Running = 'No' OR Slave_SQL_Running = 'No' THEN 'CRITICAL - Replication stopped'
485
- WHEN Seconds_Behind_Master > 300 THEN 'CRITICAL'
486
- WHEN Seconds_Behind_Master > 60 THEN 'WARNING'
487
- ELSE 'OK'
488
- END as status
489
- FROM (SHOW SLAVE STATUS) s;
490
- ```
491
-
492
- ## Monitoring Best Practices
493
-
494
- 1. **Establish baselines** - Record normal performance metrics
495
- 2. **Track trends** - Monitor daily/weekly patterns
496
- 3. **Set thresholds** - Define warning and critical levels
497
- 4. **Automate alerts** - Use monitoring tools (Prometheus, Grafana, Datadog)
498
- 5. **Regular reviews** - Weekly performance analysis meetings
499
- 6. **Document changes** - Track configuration and schema modifications
500
- 7. **Capacity planning** - Monitor growth and forecast needs
501
- 8. **Test queries** - Validate optimizations in staging first
1
+ # Monitoring and Analysis
2
+
3
+ ## PostgreSQL Monitoring
4
+
5
+ ### Essential Extensions
6
+
7
+ ```sql
8
+ -- Install performance monitoring extensions
9
+ CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
10
+ CREATE EXTENSION IF NOT EXISTS pg_buffercache;
11
+ CREATE EXTENSION IF NOT EXISTS pg_trgm; -- For similarity searches
12
+
13
+ -- Reset statistics
14
+ SELECT pg_stat_statements_reset();
15
+ SELECT pg_stat_reset();
16
+ ```
17
+
18
+ ### Query Performance Tracking
19
+
20
+ ```sql
21
+ -- Top queries by total time
22
+ SELECT
23
+ substring(query, 1, 100) as short_query,
24
+ round(total_exec_time::numeric, 2) as total_time_ms,
25
+ calls,
26
+ round(mean_exec_time::numeric, 2) as mean_time_ms,
27
+ round(stddev_exec_time::numeric, 2) as stddev_ms,
28
+ round((100 * total_exec_time / sum(total_exec_time) OVER ())::numeric, 2) as pct_total
29
+ FROM pg_stat_statements
30
+ WHERE query NOT LIKE '%pg_stat_statements%'
31
+ ORDER BY total_exec_time DESC
32
+ LIMIT 20;
33
+
34
+ -- Queries with high variance
35
+ SELECT
36
+ substring(query, 1, 100) as short_query,
37
+ calls,
38
+ round(mean_exec_time::numeric, 2) as mean_ms,
39
+ round(stddev_exec_time::numeric, 2) as stddev_ms,
40
+ round(max_exec_time::numeric, 2) as max_ms,
41
+ round((stddev_exec_time / NULLIF(mean_exec_time, 0))::numeric, 2) as coeff_var
42
+ FROM pg_stat_statements
43
+ WHERE calls > 100
44
+ AND stddev_exec_time > mean_exec_time * 0.5
45
+ ORDER BY stddev_exec_time DESC
46
+ LIMIT 20;
47
+
48
+ -- I/O intensive queries
49
+ SELECT
50
+ substring(query, 1, 100) as short_query,
51
+ calls,
52
+ shared_blks_hit,
53
+ shared_blks_read,
54
+ shared_blks_written,
55
+ round((shared_blks_read::numeric / NULLIF(calls, 0)), 2) as reads_per_call,
56
+ round((shared_blks_hit / NULLIF(shared_blks_hit + shared_blks_read, 0)::numeric * 100), 2) as cache_hit_pct
57
+ FROM pg_stat_statements
58
+ WHERE shared_blks_read > 0
59
+ ORDER BY shared_blks_read DESC
60
+ LIMIT 20;
61
+ ```
62
+
63
+ ### Connection and Lock Monitoring
64
+
65
+ ```sql
66
+ -- Current activity
67
+ SELECT
68
+ pid,
69
+ usename,
70
+ application_name,
71
+ client_addr,
72
+ state,
73
+ state_change,
74
+ query_start,
75
+ now() - query_start as duration,
76
+ wait_event_type,
77
+ wait_event,
78
+ substring(query, 1, 100) as query
79
+ FROM pg_stat_activity
80
+ WHERE state != 'idle'
81
+ ORDER BY query_start;
82
+
83
+ -- Blocking queries
84
+ SELECT
85
+ blocked_locks.pid AS blocked_pid,
86
+ blocked_activity.usename AS blocked_user,
87
+ blocking_locks.pid AS blocking_pid,
88
+ blocking_activity.usename AS blocking_user,
89
+ blocked_activity.query AS blocked_query,
90
+ blocking_activity.query AS blocking_query,
91
+ blocked_activity.application_name AS blocked_app
92
+ FROM pg_catalog.pg_locks blocked_locks
93
+ JOIN pg_catalog.pg_stat_activity blocked_activity ON blocked_activity.pid = blocked_locks.pid
94
+ JOIN pg_catalog.pg_locks blocking_locks
95
+ ON blocking_locks.locktype = blocked_locks.locktype
96
+ AND blocking_locks.database IS NOT DISTINCT FROM blocked_locks.database
97
+ AND blocking_locks.relation IS NOT DISTINCT FROM blocked_locks.relation
98
+ AND blocking_locks.page IS NOT DISTINCT FROM blocked_locks.page
99
+ AND blocking_locks.tuple IS NOT DISTINCT FROM blocked_locks.tuple
100
+ AND blocking_locks.virtualxid IS NOT DISTINCT FROM blocked_locks.virtualxid
101
+ AND blocking_locks.transactionid IS NOT DISTINCT FROM blocked_locks.transactionid
102
+ AND blocking_locks.classid IS NOT DISTINCT FROM blocked_locks.classid
103
+ AND blocking_locks.objid IS NOT DISTINCT FROM blocked_locks.objid
104
+ AND blocking_locks.objsubid IS NOT DISTINCT FROM blocked_locks.objsubid
105
+ AND blocking_locks.pid != blocked_locks.pid
106
+ JOIN pg_catalog.pg_stat_activity blocking_activity ON blocking_activity.pid = blocking_locks.pid
107
+ WHERE NOT blocked_locks.granted;
108
+
109
+ -- Wait events summary
110
+ SELECT
111
+ wait_event_type,
112
+ wait_event,
113
+ count(*) as waiting_connections
114
+ FROM pg_stat_activity
115
+ WHERE wait_event IS NOT NULL
116
+ GROUP BY wait_event_type, wait_event
117
+ ORDER BY waiting_connections DESC;
118
+ ```
119
+
120
+ ### Table and Index Statistics
121
+
122
+ ```sql
123
+ -- Table bloat and dead tuples
124
+ SELECT
125
+ schemaname,
126
+ tablename,
127
+ pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) as total_size,
128
+ n_live_tup,
129
+ n_dead_tup,
130
+ round(n_dead_tup * 100.0 / NULLIF(n_live_tup + n_dead_tup, 0), 2) as dead_pct,
131
+ last_vacuum,
132
+ last_autovacuum,
133
+ last_analyze,
134
+ last_autoanalyze
135
+ FROM pg_stat_user_tables
136
+ WHERE n_live_tup > 1000
137
+ ORDER BY n_dead_tup DESC;
138
+
139
+ -- Index usage and efficiency
140
+ SELECT
141
+ schemaname,
142
+ tablename,
143
+ indexname,
144
+ idx_scan,
145
+ idx_tup_read,
146
+ idx_tup_fetch,
147
+ pg_size_pretty(pg_relation_size(indexrelid)) as size,
148
+ CASE
149
+ WHEN idx_scan = 0 THEN 'UNUSED'
150
+ WHEN idx_tup_read = 0 THEN 'NEVER_READ'
151
+ ELSE 'ACTIVE'
152
+ END as status
153
+ FROM pg_stat_user_indexes
154
+ ORDER BY pg_relation_size(indexrelid) DESC;
155
+
156
+ -- Sequential scans on large tables
157
+ SELECT
158
+ schemaname,
159
+ tablename,
160
+ seq_scan,
161
+ seq_tup_read,
162
+ idx_scan,
163
+ n_live_tup,
164
+ pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename)) as size
165
+ FROM pg_stat_user_tables
166
+ WHERE seq_scan > 0
167
+ AND n_live_tup > 10000
168
+ AND seq_tup_read / NULLIF(seq_scan, 0) > 10000
169
+ ORDER BY seq_tup_read DESC;
170
+ ```
171
+
172
+ ### Database Statistics
173
+
174
+ ```sql
175
+ -- Database size and activity
176
+ SELECT
177
+ datname,
178
+ pg_size_pretty(pg_database_size(datname)) as size,
179
+ numbackends as connections,
180
+ xact_commit,
181
+ xact_rollback,
182
+ round(xact_rollback * 100.0 / NULLIF(xact_commit + xact_rollback, 0), 2) as rollback_pct,
183
+ blks_read,
184
+ blks_hit,
185
+ round(blks_hit * 100.0 / NULLIF(blks_hit + blks_read, 0), 2) as cache_hit_pct
186
+ FROM pg_stat_database
187
+ WHERE datname NOT IN ('template0', 'template1', 'postgres')
188
+ ORDER BY pg_database_size(datname) DESC;
189
+
190
+ -- Checkpoint and bgwriter statistics
191
+ SELECT
192
+ checkpoints_timed,
193
+ checkpoints_req,
194
+ checkpoint_write_time,
195
+ checkpoint_sync_time,
196
+ buffers_checkpoint,
197
+ buffers_clean,
198
+ buffers_backend,
199
+ buffers_alloc,
200
+ round(100.0 * checkpoints_req / NULLIF(checkpoints_timed + checkpoints_req, 0), 2) as req_checkpoint_pct
201
+ FROM pg_stat_bgwriter;
202
+ ```
203
+
204
+ ## MySQL Monitoring
205
+
206
+ ### Performance Schema Queries
207
+
208
+ ```sql
209
+ -- Top statements by total latency
210
+ SELECT
211
+ DIGEST_TEXT as query,
212
+ COUNT_STAR as exec_count,
213
+ ROUND(AVG_TIMER_WAIT / 1000000000000, 3) as avg_sec,
214
+ ROUND(SUM_TIMER_WAIT / 1000000000000, 3) as total_sec,
215
+ ROUND(MAX_TIMER_WAIT / 1000000000000, 3) as max_sec,
216
+ ROUND((SUM_TIMER_WAIT / SUM(SUM_TIMER_WAIT) OVER ()) * 100, 2) as pct_total
217
+ FROM performance_schema.events_statements_summary_by_digest
218
+ WHERE SCHEMA_NAME NOT IN ('performance_schema', 'mysql', 'sys')
219
+ ORDER BY SUM_TIMER_WAIT DESC
220
+ LIMIT 20;
221
+
222
+ -- Statements with full table scans
223
+ SELECT
224
+ OBJECT_SCHEMA as db,
225
+ OBJECT_NAME as tbl,
226
+ COUNT_STAR as exec_count,
227
+ SUM_NO_INDEX_USED as full_scans,
228
+ SUM_NO_GOOD_INDEX_USED as bad_index
229
+ FROM performance_schema.table_io_waits_summary_by_index_usage
230
+ WHERE INDEX_NAME IS NULL
231
+ AND OBJECT_SCHEMA NOT IN ('performance_schema', 'mysql', 'sys')
232
+ AND COUNT_STAR > 0
233
+ ORDER BY SUM_NO_INDEX_USED DESC;
234
+
235
+ -- Table I/O statistics
236
+ SELECT
237
+ OBJECT_SCHEMA,
238
+ OBJECT_NAME,
239
+ COUNT_READ,
240
+ COUNT_WRITE,
241
+ COUNT_FETCH,
242
+ COUNT_INSERT,
243
+ COUNT_UPDATE,
244
+ COUNT_DELETE,
245
+ ROUND(SUM_TIMER_WAIT / 1000000000000, 3) as total_latency_sec
246
+ FROM performance_schema.table_io_waits_summary_by_table
247
+ WHERE OBJECT_SCHEMA NOT IN ('performance_schema', 'mysql', 'sys')
248
+ ORDER BY SUM_TIMER_WAIT DESC
249
+ LIMIT 20;
250
+ ```
251
+
252
+ ### InnoDB Status Monitoring
253
+
254
+ ```sql
255
+ -- InnoDB buffer pool status
256
+ SELECT
257
+ POOL_ID,
258
+ POOL_SIZE,
259
+ FREE_BUFFERS,
260
+ DATABASE_PAGES,
261
+ OLD_DATABASE_PAGES,
262
+ MODIFIED_DATABASE_PAGES,
263
+ PENDING_DECOMPRESS,
264
+ PENDING_READS,
265
+ PENDING_FLUSH_LRU,
266
+ PENDING_FLUSH_LIST
267
+ FROM information_schema.INNODB_BUFFER_POOL_STATS;
268
+
269
+ -- InnoDB lock waits
270
+ SELECT
271
+ r.trx_id as waiting_trx,
272
+ r.trx_mysql_thread_id as waiting_thread,
273
+ r.trx_query as waiting_query,
274
+ b.trx_id as blocking_trx,
275
+ b.trx_mysql_thread_id as blocking_thread,
276
+ b.trx_query as blocking_query
277
+ FROM information_schema.innodb_lock_waits w
278
+ INNER JOIN information_schema.innodb_trx b ON b.trx_id = w.blocking_trx_id
279
+ INNER JOIN information_schema.innodb_trx r ON r.trx_id = w.requesting_trx_id;
280
+
281
+ -- Long-running transactions
282
+ SELECT
283
+ trx_id,
284
+ trx_state,
285
+ trx_started,
286
+ TIMESTAMPDIFF(SECOND, trx_started, NOW()) as duration_sec,
287
+ trx_requested_lock_id,
288
+ trx_mysql_thread_id,
289
+ trx_query
290
+ FROM information_schema.innodb_trx
291
+ WHERE TIMESTAMPDIFF(SECOND, trx_started, NOW()) > 60
292
+ ORDER BY trx_started;
293
+ ```
294
+
295
+ ### Connection and Process Monitoring
296
+
297
+ ```sql
298
+ -- Current connections by state
299
+ SELECT
300
+ command,
301
+ state,
302
+ COUNT(*) as connections,
303
+ MAX(time) as max_time_sec
304
+ FROM information_schema.processlist
305
+ GROUP BY command, state
306
+ ORDER BY connections DESC;
307
+
308
+ -- Long-running queries
309
+ SELECT
310
+ id,
311
+ user,
312
+ host,
313
+ db,
314
+ command,
315
+ time,
316
+ state,
317
+ LEFT(info, 100) as query
318
+ FROM information_schema.processlist
319
+ WHERE command != 'Sleep'
320
+ AND time > 10
321
+ ORDER BY time DESC;
322
+
323
+ -- Connection usage
324
+ SHOW STATUS LIKE 'Threads_%';
325
+ SHOW STATUS LIKE 'Max_used_connections';
326
+ SHOW VARIABLES LIKE 'max_connections';
327
+ ```
328
+
329
+ ### System Status Variables
330
+
331
+ ```sql
332
+ -- Key buffer efficiency (MyISAM)
333
+ SHOW STATUS LIKE 'Key_%';
334
+
335
+ -- InnoDB metrics
336
+ SHOW STATUS LIKE 'Innodb_buffer_pool_%';
337
+ SHOW STATUS LIKE 'Innodb_rows_%';
338
+ SHOW STATUS LIKE 'Innodb_data_%';
339
+
340
+ -- Table locks
341
+ SHOW STATUS LIKE 'Table_locks_%';
342
+
343
+ -- Temporary tables
344
+ SHOW STATUS LIKE 'Created_tmp_%';
345
+
346
+ -- Thread cache
347
+ SHOW STATUS LIKE 'Threads_%';
348
+ SHOW STATUS LIKE 'Connections';
349
+
350
+ -- Query cache (MySQL 5.7)
351
+ SHOW STATUS LIKE 'Qcache_%';
352
+ ```
353
+
354
+ ## Cross-Platform Monitoring
355
+
356
+ ### Resource Utilization
357
+
358
+ ```sql
359
+ -- PostgreSQL: Database size growth
360
+ SELECT
361
+ current_database() as database,
362
+ pg_size_pretty(pg_database_size(current_database())) as size,
363
+ (SELECT pg_size_pretty(sum(pg_total_relation_size(schemaname||'.'||tablename)))
364
+ FROM pg_tables
365
+ WHERE schemaname = 'public') as public_schema_size;
366
+
367
+ -- MySQL: Database size
368
+ SELECT
369
+ table_schema as database,
370
+ ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) as size_mb
371
+ FROM information_schema.tables
372
+ WHERE table_schema NOT IN ('information_schema', 'performance_schema', 'mysql', 'sys')
373
+ GROUP BY table_schema
374
+ ORDER BY size_mb DESC;
375
+ ```
376
+
377
+ ### Health Check Queries
378
+
379
+ ```sql
380
+ -- PostgreSQL: Overall health
381
+ SELECT
382
+ 'connections' as metric,
383
+ count(*) as current,
384
+ current_setting('max_connections')::int as max
385
+ FROM pg_stat_activity
386
+ UNION ALL
387
+ SELECT
388
+ 'cache_hit_ratio',
389
+ round((sum(heap_blks_hit) / NULLIF(sum(heap_blks_hit) + sum(heap_blks_read), 0) * 100)::numeric, 2),
390
+ 95
391
+ FROM pg_statio_user_tables
392
+ UNION ALL
393
+ SELECT
394
+ 'database_size_gb',
395
+ round((pg_database_size(current_database()) / 1024.0 / 1024.0 / 1024.0)::numeric, 2),
396
+ NULL;
397
+
398
+ -- MySQL: Overall health
399
+ SELECT 'connections' as metric,
400
+ (SELECT COUNT(*) FROM information_schema.processlist) as current,
401
+ @@max_connections as max
402
+ UNION ALL
403
+ SELECT 'buffer_pool_hit_ratio',
404
+ ROUND((1 - (
405
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
406
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
407
+ )) * 100, 2),
408
+ 95
409
+ UNION ALL
410
+ SELECT 'slow_queries',
411
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Slow_queries'),
412
+ NULL;
413
+ ```
414
+
415
+ ## Alert Thresholds
416
+
417
+ ### PostgreSQL Alerts
418
+
419
+ ```sql
420
+ -- Connection pool nearing capacity
421
+ SELECT
422
+ count(*) as current_connections,
423
+ current_setting('max_connections')::int as max_connections,
424
+ CASE
425
+ WHEN count(*) > current_setting('max_connections')::int * 0.9 THEN 'CRITICAL'
426
+ WHEN count(*) > current_setting('max_connections')::int * 0.8 THEN 'WARNING'
427
+ ELSE 'OK'
428
+ END as status
429
+ FROM pg_stat_activity;
430
+
431
+ -- Cache hit ratio degradation
432
+ WITH cache_stats AS (
433
+ SELECT
434
+ round((sum(heap_blks_hit) / NULLIF(sum(heap_blks_hit) + sum(heap_blks_read), 0) * 100)::numeric, 2) as hit_ratio
435
+ FROM pg_statio_user_tables
436
+ )
437
+ SELECT
438
+ hit_ratio,
439
+ CASE
440
+ WHEN hit_ratio < 90 THEN 'CRITICAL'
441
+ WHEN hit_ratio < 95 THEN 'WARNING'
442
+ ELSE 'OK'
443
+ END as status
444
+ FROM cache_stats;
445
+
446
+ -- Replication lag (on standby)
447
+ SELECT
448
+ CASE
449
+ WHEN pg_last_wal_receive_lsn() = pg_last_wal_replay_lsn() THEN 0
450
+ ELSE EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))
451
+ END as lag_seconds,
452
+ CASE
453
+ WHEN EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp())) > 60 THEN 'CRITICAL'
454
+ WHEN EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp())) > 10 THEN 'WARNING'
455
+ ELSE 'OK'
456
+ END as status;
457
+ ```
458
+
459
+ ### MySQL Alerts
460
+
461
+ ```sql
462
+ -- InnoDB buffer pool efficiency
463
+ SELECT
464
+ ROUND((1 - (
465
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
466
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
467
+ )) * 100, 2) as buffer_pool_hit_ratio,
468
+ CASE
469
+ WHEN (1 - (
470
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
471
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
472
+ )) * 100 < 90 THEN 'CRITICAL'
473
+ WHEN (1 - (
474
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_reads') /
475
+ (SELECT VARIABLE_VALUE FROM performance_schema.global_status WHERE VARIABLE_NAME = 'Innodb_buffer_pool_read_requests')
476
+ )) * 100 < 95 THEN 'WARNING'
477
+ ELSE 'OK'
478
+ END as status;
479
+
480
+ -- Replication lag (on replica)
481
+ SELECT
482
+ Seconds_Behind_Master as lag_seconds,
483
+ CASE
484
+ WHEN Slave_IO_Running = 'No' OR Slave_SQL_Running = 'No' THEN 'CRITICAL - Replication stopped'
485
+ WHEN Seconds_Behind_Master > 300 THEN 'CRITICAL'
486
+ WHEN Seconds_Behind_Master > 60 THEN 'WARNING'
487
+ ELSE 'OK'
488
+ END as status
489
+ FROM (SHOW SLAVE STATUS) s;
490
+ ```
491
+
492
+ ## Monitoring Best Practices
493
+
494
+ 1. **Establish baselines** - Record normal performance metrics
495
+ 2. **Track trends** - Monitor daily/weekly patterns
496
+ 3. **Set thresholds** - Define warning and critical levels
497
+ 4. **Automate alerts** - Use monitoring tools (Prometheus, Grafana, Datadog)
498
+ 5. **Regular reviews** - Weekly performance analysis meetings
499
+ 6. **Document changes** - Track configuration and schema modifications
500
+ 7. **Capacity planning** - Monitor growth and forecast needs
501
+ 8. **Test queries** - Validate optimizations in staging first