skillfullstack 0.0.0-stage → 1.0.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 (775) hide show
  1. package/.skillsRegistry/catalog.json +231 -0
  2. package/AGENTS.md +89 -0
  3. package/README.md +210 -2
  4. package/bin/index.js +508 -0
  5. package/package.json +57 -4
  6. package/skills/backend/apiEngineering/SKILL.md +102 -0
  7. package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
  8. package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
  9. package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
  10. package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
  11. package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
  12. package/skills/backend/apiEngineering/policies/performance.md +39 -0
  13. package/skills/backend/apiEngineering/policies/security.md +36 -0
  14. package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
  15. package/skills/backend/apiEngineering/references/apiReference.md +3 -0
  16. package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
  17. package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
  18. package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
  19. package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
  20. package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
  21. package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
  22. package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
  23. package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
  24. package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
  25. package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
  26. package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
  27. package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
  28. package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
  29. package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
  30. package/skills/backend/databaseArchitecture/SKILL.md +118 -0
  31. package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
  32. package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
  33. package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
  34. package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
  35. package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
  36. package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
  37. package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
  38. package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
  39. package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
  40. package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
  41. package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
  42. package/skills/backend/databaseArchitecture/policies/security.md +26 -0
  43. package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
  44. package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
  45. package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
  46. package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
  47. package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
  48. package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
  49. package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
  50. package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
  51. package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
  52. package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
  53. package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
  54. package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
  55. package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
  56. package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
  57. package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
  58. package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
  59. package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
  60. package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
  61. package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
  62. package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
  63. package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
  64. package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
  65. package/skills/backend/golangStandard/SKILL.md +155 -0
  66. package/skills/backend/golangStandard/evals/goVerification.json +14 -0
  67. package/skills/backend/golangStandard/references/apiReference.md +3 -0
  68. package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
  69. package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
  70. package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
  71. package/skills/backend/pythonStandard/SKILL.md +138 -0
  72. package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
  73. package/skills/backend/pythonStandard/references/apiReference.md +3 -0
  74. package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
  75. package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
  76. package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
  77. package/skills/backend/upstash/SKILL.md +98 -0
  78. package/skills/backend/upstash/evals/upstashVerification.json +14 -0
  79. package/skills/backend/upstash/references/apiReference.md +3 -0
  80. package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
  81. package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
  82. package/skills/backend/upstash/references/workflowPatterns.md +35 -0
  83. package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
  84. package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
  85. package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
  86. package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
  87. package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
  88. package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
  89. package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
  90. package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
  91. package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
  92. package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
  93. package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
  94. package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
  95. package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
  96. package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
  97. package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
  98. package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
  99. package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
  100. package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
  101. package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
  102. package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
  103. package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
  104. package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
  105. package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
  106. package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
  107. package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
  108. package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
  109. package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
  110. package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
  111. package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
  112. package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
  113. package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
  114. package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
  115. package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
  116. package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
  117. package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
  118. package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
  119. package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
  120. package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
  121. package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
  122. package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
  123. package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
  124. package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
  125. package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
  126. package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
  127. package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
  128. package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
  129. package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
  130. package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
  131. package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
  132. package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
  133. package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
  134. package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
  135. package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
  136. package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
  137. package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
  138. package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
  139. package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
  140. package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
  141. package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
  142. package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
  143. package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
  144. package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
  145. package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
  146. package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
  147. package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
  148. package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
  149. package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
  150. package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
  151. package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
  152. package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
  153. package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
  154. package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
  155. package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
  156. package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
  157. package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
  158. package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
  159. package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
  160. package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
  161. package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
  162. package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
  163. package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
  164. package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
  165. package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
  166. package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
  167. package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
  168. package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
  169. package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
  170. package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
  171. package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
  172. package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
  173. package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
  174. package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
  175. package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
  176. package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
  177. package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
  178. package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
  179. package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
  180. package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
  181. package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
  182. package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
  183. package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
  184. package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
  185. package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
  186. package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
  187. package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
  188. package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
  189. package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
  190. package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
  191. package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
  192. package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
  193. package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
  194. package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
  195. package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
  196. package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
  197. package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
  198. package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
  199. package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
  200. package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
  201. package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
  202. package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
  203. package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
  204. package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
  205. package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
  206. package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
  207. package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
  208. package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
  209. package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
  210. package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
  211. package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
  212. package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
  213. package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
  214. package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
  215. package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
  216. package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
  217. package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
  218. package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
  219. package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
  220. package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
  221. package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
  222. package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
  223. package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
  224. package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
  225. package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
  226. package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
  227. package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
  228. package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
  229. package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
  230. package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
  231. package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
  232. package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
  233. package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
  234. package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
  235. package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
  236. package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
  237. package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
  238. package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
  239. package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
  240. package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
  241. package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
  242. package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
  243. package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
  244. package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
  245. package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
  246. package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
  247. package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
  248. package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
  249. package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
  250. package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
  251. package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
  252. package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
  253. package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
  254. package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
  255. package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
  256. package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
  257. package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
  258. package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
  259. package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
  260. package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
  261. package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
  262. package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
  263. package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
  264. package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
  265. package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
  266. package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
  267. package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
  268. package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
  269. package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
  270. package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
  271. package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
  272. package/skills/frontend/astro/SKILL.md +327 -0
  273. package/skills/frontend/astro/assets/README.md +71 -0
  274. package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
  275. package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
  276. package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
  277. package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
  278. package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
  279. package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
  280. package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
  281. package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
  282. package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
  283. package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
  284. package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
  285. package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
  286. package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
  287. package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
  288. package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
  289. package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
  290. package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
  291. package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
  292. package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
  293. package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
  294. package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
  295. package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
  296. package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
  297. package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
  298. package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
  299. package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
  300. package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
  301. package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
  302. package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
  303. package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
  304. package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
  305. package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
  306. package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
  307. package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
  308. package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
  309. package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
  310. package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
  311. package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
  312. package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
  313. package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
  314. package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
  315. package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
  316. package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
  317. package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
  318. package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
  319. package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
  320. package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
  321. package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
  322. package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
  323. package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
  324. package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
  325. package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
  326. package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
  327. package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
  328. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
  329. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
  330. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
  331. package/skills/frontend/astro/assets/welcome/courses.md +46 -0
  332. package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
  333. package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
  334. package/skills/frontend/astro/evals/evals.json +66 -0
  335. package/skills/frontend/astro/references/contentCollections.md +164 -0
  336. package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
  337. package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
  338. package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
  339. package/skills/frontend/generativeUi/SKILL.md +128 -0
  340. package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
  341. package/skills/frontend/generativeUi/references/apiReference.md +3 -0
  342. package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
  343. package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
  344. package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
  345. package/skills/frontend/nextjs/SKILL.md +138 -0
  346. package/skills/frontend/nextjs/assets/README.md +67 -0
  347. package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
  348. package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
  349. package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
  350. package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
  351. package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
  352. package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
  353. package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
  354. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
  355. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
  356. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
  357. package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
  358. package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
  359. package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
  360. package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
  361. package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
  362. package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
  363. package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
  364. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
  365. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
  366. package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
  367. package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
  368. package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
  369. package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
  370. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
  371. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
  372. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
  373. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
  374. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
  375. package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
  376. package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
  377. package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
  378. package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
  379. package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
  380. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
  381. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
  382. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
  383. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
  384. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
  385. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
  386. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
  387. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
  388. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
  389. package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
  390. package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
  391. package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
  392. package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
  393. package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
  394. package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
  395. package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
  396. package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
  397. package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
  398. package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
  399. package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
  400. package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
  401. package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
  402. package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
  403. package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
  404. package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
  405. package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
  406. package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
  407. package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
  408. package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
  409. package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
  410. package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
  411. package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
  412. package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
  413. package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
  414. package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
  415. package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
  416. package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
  417. package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
  418. package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
  419. package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
  420. package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
  421. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
  422. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
  423. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
  424. package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
  425. package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
  426. package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
  427. package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
  428. package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
  429. package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
  430. package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
  431. package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
  432. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
  433. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
  434. package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
  435. package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
  436. package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
  437. package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
  438. package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
  439. package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
  440. package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
  441. package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
  442. package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
  443. package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
  444. package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
  445. package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
  446. package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
  447. package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
  448. package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
  449. package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
  450. package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
  451. package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
  452. package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
  453. package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
  454. package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
  455. package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
  456. package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
  457. package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
  458. package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
  459. package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
  460. package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
  461. package/skills/frontend/nextjs/assets/glossary.md +315 -0
  462. package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
  463. package/skills/frontend/nextjs/references/apiReference.md +3 -0
  464. package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
  465. package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
  466. package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
  467. package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
  468. package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
  469. package/skills/frontend/shadcn-ui/SKILL.md +102 -0
  470. package/skills/frontend/shadcn-ui/assets/README.md +82 -0
  471. package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
  472. package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
  473. package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
  474. package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
  475. package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
  476. package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
  477. package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
  478. package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
  479. package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
  480. package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
  481. package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
  482. package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
  483. package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
  484. package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
  485. package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
  486. package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
  487. package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
  488. package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
  489. package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
  490. package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
  491. package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
  492. package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
  493. package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
  494. package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
  495. package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
  496. package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
  497. package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
  498. package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
  499. package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
  500. package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
  501. package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
  502. package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
  503. package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
  504. package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
  505. package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
  506. package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
  507. package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
  508. package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
  509. package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
  510. package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
  511. package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
  512. package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
  513. package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
  514. package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
  515. package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
  516. package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
  517. package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
  518. package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
  519. package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
  520. package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
  521. package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
  522. package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
  523. package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
  524. package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
  525. package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
  526. package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
  527. package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
  528. package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
  529. package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
  530. package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
  531. package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
  532. package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
  533. package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
  534. package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
  535. package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
  536. package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
  537. package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
  538. package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
  539. package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
  540. package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
  541. package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
  542. package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
  543. package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
  544. package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
  545. package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
  546. package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
  547. package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
  548. package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
  549. package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
  550. package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
  551. package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
  552. package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
  553. package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
  554. package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
  555. package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
  556. package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
  557. package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
  558. package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
  559. package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
  560. package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
  561. package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
  562. package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
  563. package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
  564. package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
  565. package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
  566. package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
  567. package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
  568. package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
  569. package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
  570. package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
  571. package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
  572. package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
  573. package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
  574. package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
  575. package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
  576. package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
  577. package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
  578. package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
  579. package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
  580. package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
  581. package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
  582. package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
  583. package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
  584. package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
  585. package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
  586. package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
  587. package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
  588. package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
  589. package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
  590. package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
  591. package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
  592. package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
  593. package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
  594. package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
  595. package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
  596. package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
  597. package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
  598. package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
  599. package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
  600. package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
  601. package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
  602. package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
  603. package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
  604. package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
  605. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
  606. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
  607. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
  608. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
  609. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
  610. package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
  611. package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
  612. package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
  613. package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
  614. package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
  615. package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
  616. package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
  617. package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
  618. package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
  619. package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
  620. package/skills/github/assets/README.md +39 -0
  621. package/skills/github/assets/cli/gh-environment.md +87 -0
  622. package/skills/github/assets/cli/gh-formatting.md +156 -0
  623. package/skills/github/assets/cli/gh-reference.md +2363 -0
  624. package/skills/github/assets/docs-api/github-docs-api.md +60 -0
  625. package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
  626. package/skills/github/assets/rest-api/actions-variables.md +1247 -0
  627. package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
  628. package/skills/github/assets/rest-api/actions-workflows.md +348 -0
  629. package/skills/github/assets/rest-api/authenticating.md +174 -0
  630. package/skills/github/assets/rest-api/branches.md +727 -0
  631. package/skills/github/assets/rest-api/checks-runs.md +1013 -0
  632. package/skills/github/assets/rest-api/checks-suites.md +1142 -0
  633. package/skills/github/assets/rest-api/code-scanning.md +2957 -0
  634. package/skills/github/assets/rest-api/collaborators.md +547 -0
  635. package/skills/github/assets/rest-api/commits.md +957 -0
  636. package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
  637. package/skills/github/assets/rest-api/orgs.md +1172 -0
  638. package/skills/github/assets/rest-api/overview.md +875 -0
  639. package/skills/github/assets/rest-api/pull-reviews.md +722 -0
  640. package/skills/github/assets/rest-api/pulls.md +1605 -0
  641. package/skills/github/assets/rest-api/quickstart.md +344 -0
  642. package/skills/github/assets/rest-api/releases.md +650 -0
  643. package/skills/github/assets/rest-api/repos.md +2957 -0
  644. package/skills/github/assets/rest-api/rules.md +1507 -0
  645. package/skills/github/assets/rest-api/secret-scanning.md +947 -0
  646. package/skills/github/assets/rest-api/teams.md +1690 -0
  647. package/skills/github/githubAction/SKILL.md +159 -0
  648. package/skills/github/githubAction/assets/README.md +38 -0
  649. package/skills/github/githubAction/assets/reference/contexts.md +918 -0
  650. package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
  651. package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
  652. package/skills/github/githubAction/assets/reference/expressions.md +441 -0
  653. package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
  654. package/skills/github/githubAction/assets/reference/variables.md +149 -0
  655. package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
  656. package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
  657. package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
  658. package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
  659. package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
  660. package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
  661. package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
  662. package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
  663. package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
  664. package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
  665. package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
  666. package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
  667. package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
  668. package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
  669. package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
  670. package/skills/github/githubAction/evals/actionVerification.json +14 -0
  671. package/skills/github/githubAction/references/apiReference.md +3 -0
  672. package/skills/github/githubAction/references/workflowPatterns.md +81 -0
  673. package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
  674. package/skills/github/githubQuality/SKILL.md +136 -0
  675. package/skills/github/githubQuality/assets/README.md +24 -0
  676. package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
  677. package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
  678. package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
  679. package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
  680. package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
  681. package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
  682. package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
  683. package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
  684. package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
  685. package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
  686. package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
  687. package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
  688. package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
  689. package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
  690. package/skills/github/githubQuality/references/apiReference.md +3 -0
  691. package/skills/github/githubQuality/references/codeownersExample.md +26 -0
  692. package/skills/github/githubQuality/references/prTemplate.md +20 -0
  693. package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
  694. package/skills/github/githubSecurity/SKILL.md +170 -0
  695. package/skills/github/githubSecurity/assets/README.md +32 -0
  696. package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
  697. package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
  698. package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
  699. package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
  700. package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
  701. package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
  702. package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
  703. package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
  704. package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
  705. package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
  706. package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
  707. package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
  708. package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
  709. package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
  710. package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
  711. package/skills/github/githubSecurity/references/apiReference.md +3 -0
  712. package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
  713. package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
  714. package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
  715. package/skills/github/githubSetup/SKILL.md +137 -0
  716. package/skills/github/githubSetup/assets/README.md +40 -0
  717. package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
  718. package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
  719. package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
  720. package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
  721. package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
  722. package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
  723. package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
  724. package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
  725. package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
  726. package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
  727. package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
  728. package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
  729. package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
  730. package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
  731. package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
  732. package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
  733. package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
  734. package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
  735. package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
  736. package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
  737. package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
  738. package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
  739. package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
  740. package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
  741. package/skills/github/githubSetup/evals/setupVerification.json +14 -0
  742. package/skills/github/githubSetup/references/apiReference.md +3 -0
  743. package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
  744. package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
  745. package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
  746. package/skills/github/githubTeam/SKILL.md +115 -0
  747. package/skills/github/githubTeam/assets/README.md +21 -0
  748. package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
  749. package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
  750. package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
  751. package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
  752. package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
  753. package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
  754. package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
  755. package/skills/github/githubTeam/evals/teamVerification.json +14 -0
  756. package/skills/github/githubTeam/references/apiReference.md +3 -0
  757. package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
  758. package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
  759. package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
  760. package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
  761. package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
  762. package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
  763. package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
  764. package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
  765. package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
  766. package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
  767. package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
  768. package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
  769. package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
  770. package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
  771. package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
  772. package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
  773. package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
  774. package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
  775. package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
@@ -0,0 +1,118 @@
1
+ ---
2
+ name: databaseArchitecture
3
+ description: Universal database architecture system covering relational normalization, NoSQL/OLAP selection, sharding, ACID concurrency, and zero-downtime schema migrations
4
+ version: 2026.11
5
+ last-verified: 2026-11-16
6
+ slash-commands:
7
+ - command: /db-architecture
8
+ description: Full database architecture orchestrator from workload analysis to verification
9
+ argument-hint: "[--workload=oltp|olap|hybrid] [--scale=records]"
10
+ - command: /db-design
11
+ description: Conceptual, logical, and physical data modeling with ERDs
12
+ argument-hint: "[--entities=list] [--level=conceptual|logical|physical]"
13
+ - command: /db-normalize
14
+ description: Relational normalization audit (1NF to BCNF) and controlled denormalization
15
+ argument-hint: "[--schema=path] [--target=3nf|bcnf]"
16
+ - command: /db-select
17
+ description: Workload-driven database taxonomy selection and polyglot trade-offs
18
+ argument-hint: "[--workload=description] [--access=patterns]"
19
+ - command: /db-scale
20
+ description: Partitioning, sharding, replication, and distributed consistency planning
21
+ argument-hint: "[--strategy=partition|shard|replica] [--key=column]"
22
+ - command: /db-audit
23
+ description: Schema audit for missing keys, unindexed foreign keys, and anti-patterns
24
+ argument-hint: "[--sql=schema.sql] [--strict]"
25
+ - command: /db-migration
26
+ description: Zero-downtime expand-contract migration and rollback plan generation
27
+ argument-hint: "[--change=description] [--table=name]"
28
+ ---
29
+
30
+ # Database Architecture Engineering System (2026 Standards)
31
+
32
+ Enterprise engineering methodology for designing, modeling, scaling, auditing, and governing database architectures across relational, non-relational, distributed, and analytical data systems.
33
+
34
+ ---
35
+
36
+ ## 1. Twenty-Four Non-Negotiable Engineering Laws
37
+
38
+ 1. **Workload First**: Never select a database before understanding data volume, read/write ratios, latency SLOs, and access patterns.
39
+ 2. **Distinct Disciplines**: Never confuse relational normalization with document or distributed database modeling.
40
+ 3. **Justified Denormalization**: Never denormalize without an explicit, measured read/write bottleneck and a consistency reconciliation plan.
41
+ 4. **Mandatory Identity**: Never create a table without an immutable primary key; evaluate index locality (UUIDv7 vs BIGINT).
42
+ 5. **Database-Level Integrity**: Never leave critical data integrity dependent solely on application validation. Enforce NOT NULL, CHECK, UNIQUE, and FOREIGN KEY constraints in the engine.
43
+ 6. **Judicious Indexing**: Never introduce speculative indexes. Every index incurs write amplification and storage overhead.
44
+ 7. **Simpler Scaling First**: Never recommend sharding before exhausting query optimization, indexing, connection pooling, and read replicas.
45
+ 8. **Replication is NOT Backup**: Never assume replication protects against accidental deletion, corruption, or ransomware.
46
+ 9. **Mandatory Disaster Recovery**: Never deploy a database to production without tested point-in-time recovery (PITR) procedures and verified restore drills.
47
+ 10. **Zero Secrets in Code**: Never hardcode database credentials, connection strings, or encryption keys in source code or repositories.
48
+ 11. **Expand-and-Contract Migrations**: Never execute destructive DDL migrations in a single step. All schema changes must be backward-compatible with running application code.
49
+ 12. **Transaction Scoping**: Never keep database transactions open across external HTTP requests, slow I/O, or message broker dispatch.
50
+ 13. **Measure Before Optimizing**: Never claim a performance optimization without `EXPLAIN (ANALYZE, BUFFERS)` execution plan evidence.
51
+ 14. **Portability Awareness**: Never rely on proprietary database extensions without evaluating operational vendor lock-in.
52
+ 15. **Polyglot Justification**: Never introduce multiple database engines without accounting for cross-engine synchronization, distributed transactions, and operational complexity.
53
+ 16. **Data Lifecycle Planning**: Never accumulate unbounded records without explicit retention, downsampling, and archival policies.
54
+ 17. **No Guesses on Scale**: Never treat unverified capacity estimates as production benchmarks.
55
+ 18. **Evidence of Readiness**: Never certify production readiness without passing the pre-flight verification checklist.
56
+ 19. **Entity Naming Standards**: Tables must use lowercase `snake_case` plural nouns (`order_items`, `customers`). Generic names (`data`, `info`, `items`, `temp`) and prefixes (`tbl_`) are strictly forbidden.
57
+ 20. **Lean Schema Law (YAGNI)**: Never add a column until proven necessary by an active business requirement or query pattern. Speculative "just in case" fields and unstructured catch-all columns (`misc`, `extra_data`) are prohibited.
58
+ 21. **Pre-Creation Security Gate**: No table may be created without completing the pre-creation security checklist (PII classification, tenant isolation `tenant_id`, credential hashing, and RLS review).
59
+ 22. **Tenant-Aware Composite Foreign Keys**: In multi-tenant databases, foreign keys between tenant-owned entities must enforce composite foreign keys `(tenant_id, target_id) REFERENCES target_table(tenant_id, id)` to prevent cross-tenant record linking.
60
+ 23. **Temporal Concurrency Protection**: Booking, scheduling, and occupancy tables must enforce PostgreSQL Exclusion Constraints (`EXCLUDE USING gist ... WITH &&`) to prevent overlapping resource allocations.
61
+ 24. **Complete RLS & Policy Symmetry**: Every table with Row-Level Security enabled must define explicit policies for `SELECT`, `INSERT`, `UPDATE`, and `DELETE` with `WITH CHECK` constraints and `FORCE ROW LEVEL SECURITY`.
62
+
63
+ ---
64
+
65
+ ## 2. Six-Stage Execution Lifecycle
66
+
67
+ ```mermaid
68
+ flowchart LR
69
+ U["1. Understand"] --> I["2. Inspect"]
70
+ I --> P["3. Plan"]
71
+ P --> E["4. Execute"]
72
+ E --> V["5. Validate"]
73
+ V --> R["6. Report"]
74
+ ```
75
+
76
+ ### Stage 1: Understand
77
+ - Clarify workload characteristics: OLTP (transactional) vs OLAP (analytical) vs Hybrid.
78
+ - Profile volume: Total rows, read/write ratio (e.g. 90/10 vs 50/50), peak IOPS, latency targets (p95 < 20ms).
79
+ - Define consistency requirements: Strict serializability vs Read-your-writes vs Eventual consistency.
80
+
81
+ ### Stage 2: Inspect
82
+ - Audit existing schemas, constraints, and indexes using `python3 scripts/auditDatabaseSchema.py`.
83
+ - Analyze slow query logs, N+1 query patterns, and connection pool saturation metrics.
84
+
85
+ ### Stage 3: Plan
86
+ - Generate Architecture Decision Record ([templates/adrTemplate.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/templates/adrTemplate.md)).
87
+ - Create conceptual $\rightarrow$ logical $\rightarrow$ physical data models.
88
+ - Apply relational normalization (1NF through BCNF) or query-driven NoSQL design ([references/normalizationTheory.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/normalizationTheory.md)).
89
+ - Complete the mandatory **Pre-Creation Table & Security Gate** ([policies/tableCreationChecklist.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md)): Verify entity justification, enforce `snake_case` plural naming, verify YAGNI lean columns, and complete security threat review.
90
+ - Design indexing and partitioning strategy ([references/indexingOptimization.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/indexingOptimization.md)).
91
+
92
+ ### Stage 4: Execute
93
+ - Author DDL schemas strictly adhering to [policies/tableCreationChecklist.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md), [policies/integrity.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/integrity.md), and [policies/security.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/security.md).
94
+ - Create zero-downtime migration scripts following the expand-and-contract protocol ([templates/migrationPlan.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/templates/migrationPlan.md)).
95
+ - Configure connection pools and transaction boundaries ([references/transactionConcurrency.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/transactionConcurrency.md)).
96
+
97
+ ### Stage 5: Validate
98
+ 1. Run schema and constraint linter: `python3 scripts/auditDatabaseSchema.py --schema=schema.sql --strict`.
99
+ 2. Run migration safety analyzer: `python3 scripts/analyzeMigration.py --migration=migration.sql`.
100
+ 3. Inspect index suitability and check unindexed foreign keys: `python3 scripts/inspectDatabaseIndexes.py --schema=schema.sql`.
101
+ 4. Assert all tests pass in `evals/evalDatabaseArchitecture.py`.
102
+
103
+ ### Stage 6: Report
104
+ Produce the comprehensive database architecture report:
105
+ - Entity Relationship Diagram (ERD) and physical schema definitions.
106
+ - Index and partition execution evidence.
107
+ - Backup, recovery (RPO/RTO), and disaster recovery validation.
108
+
109
+ ---
110
+
111
+ ## 3. Core Architecture Separation
112
+
113
+ | Architectural Layer | Location & Purpose |
114
+ | :--- | :--- |
115
+ | **Policies** | [policies/mandatory.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/mandatory.md), [policies/tableCreationChecklist.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md), [policies/integrity.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/integrity.md), [policies/normalization.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/normalization.md), [policies/security.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/security.md), [policies/performance.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/performance.md), [policies/migration.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/migration.md), [policies/recovery.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/policies/recovery.md) — Enforceable rulebooks. |
116
+ | **Methods & References** | [references/normalizationTheory.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/normalizationTheory.md), [references/databaseTaxonomy.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/databaseTaxonomy.md), [references/dataModelingLifecycle.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md), [references/scalabilitySharding.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/scalabilitySharding.md), [references/indexingOptimization.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/indexingOptimization.md), [references/transactionConcurrency.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/transactionConcurrency.md), [references/analyticsWarehousing.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/analyticsWarehousing.md), [references/backupDisasterRecovery.md](file:///Users/prasangaramanpokharel/projects/SkillFullStack/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md) — Deep theory & guides. |
117
+ | **Automation Tooling** | `scripts/auditDatabaseSchema.py`, `scripts/analyzeMigration.py`, `scripts/inspectDatabaseIndexes.py` — Deterministic CLI analysis tools. |
118
+ | **Templates** | `templates/adrTemplate.md`, `templates/migrationPlan.md`, `templates/databaseChecklist.md` — Enterprise blueprints. |
@@ -0,0 +1,85 @@
1
+ #!/usr/bin/env python3
2
+ """
3
+ evalDatabaseArchitecture.py
4
+ Evaluates the diagnostic and analysis scripts in databaseArchitecture:
5
+ - auditDatabaseSchema.py
6
+ - analyzeMigration.py
7
+ - inspectDatabaseIndexes.py
8
+ """
9
+
10
+ import subprocess
11
+ import json
12
+ import os
13
+ import sys
14
+
15
+ BASE_DIR = os.path.dirname(os.path.abspath(__file__))
16
+ SCRIPTS_DIR = os.path.join(BASE_DIR, "..", "scripts")
17
+ FIXTURES_DIR = os.path.join(BASE_DIR, "fixtures")
18
+
19
+ def test_audit_valid_schema():
20
+ script = os.path.join(SCRIPTS_DIR, "auditDatabaseSchema.py")
21
+ fixture = os.path.join(FIXTURES_DIR, "validSchema.sql")
22
+ res = subprocess.run([sys.executable, script, "--schema", fixture], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
23
+ assert res.returncode == 0, f"Expected 0 for valid schema, got {res.returncode}: {res.stderr}"
24
+ data = json.loads(res.stdout)
25
+ assert data["isCompliant"] is True
26
+ print(" test_audit_valid_schema passed")
27
+
28
+ def test_audit_invalid_schema():
29
+ script = os.path.join(SCRIPTS_DIR, "auditDatabaseSchema.py")
30
+ fixture = os.path.join(FIXTURES_DIR, "invalidSchema.sql")
31
+ res = subprocess.run([sys.executable, script, "--schema", fixture], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
32
+ assert res.returncode == 1, "Expected 1 for invalid schema"
33
+ data = json.loads(res.stdout)
34
+ assert data["isCompliant"] is False
35
+ rules = [f["rule"] for f in data["findings"]]
36
+ assert "PRIMARY_KEY_REQUIRED" in rules
37
+ assert "TABLE_NAMING_HUNGARIAN_PREFIX" in rules
38
+ assert "SPECULATIVE_CATCHALL_COLUMN" in rules
39
+ assert "INCOMPLETE_RLS_POLICY" in rules
40
+ assert "CROSS_TENANT_FK_VULNERABILITY" in rules
41
+ assert "MISSING_EXCLUSION_CONSTRAINT" in rules
42
+ print(" test_audit_invalid_schema passed")
43
+
44
+ def test_analyze_safe_migration():
45
+ script = os.path.join(SCRIPTS_DIR, "analyzeMigration.py")
46
+ fixture = os.path.join(FIXTURES_DIR, "safeMigration.sql")
47
+ res = subprocess.run([sys.executable, script, "--migration", fixture], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
48
+ assert res.returncode == 0, f"Expected 0 for safe migration, got {res.returncode}: {res.stderr}"
49
+ data = json.loads(res.stdout)
50
+ assert data["isSafeForZeroDowntime"] is True
51
+ print(" test_analyze_safe_migration passed")
52
+
53
+ def test_analyze_dangerous_migration():
54
+ script = os.path.join(SCRIPTS_DIR, "analyzeMigration.py")
55
+ fixture = os.path.join(FIXTURES_DIR, "dangerousMigration.sql")
56
+ res = subprocess.run([sys.executable, script, "--migration", fixture], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
57
+ assert res.returncode == 1, "Expected 1 for dangerous migration"
58
+ data = json.loads(res.stdout)
59
+ assert data["isSafeForZeroDowntime"] is False
60
+ ops = [f["operation"] for f in data["findings"]]
61
+ assert "DROP_COLUMN" in ops
62
+ assert "RENAME_COLUMN" in ops
63
+ assert "BLOCKING_INDEX_CREATION" in ops
64
+ print(" test_analyze_dangerous_migration passed")
65
+
66
+ def test_inspect_indexes():
67
+ script = os.path.join(SCRIPTS_DIR, "inspectDatabaseIndexes.py")
68
+ valid_fixture = os.path.join(FIXTURES_DIR, "validSchema.sql")
69
+ res_valid = subprocess.run([sys.executable, script, "--schema", valid_fixture], stdout=subprocess.PIPE, text=True, check=True)
70
+ data_valid = json.loads(res_valid.stdout)
71
+ assert data_valid["unindexedFkCount"] == 0
72
+
73
+ invalid_fixture = os.path.join(FIXTURES_DIR, "invalidSchema.sql")
74
+ res_invalid = subprocess.run([sys.executable, script, "--schema", invalid_fixture], stdout=subprocess.PIPE, text=True, check=True)
75
+ data_invalid = json.loads(res_invalid.stdout)
76
+ assert data_invalid["unindexedFkCount"] > 0
77
+ print(" test_inspect_indexes passed")
78
+
79
+ if __name__ == "__main__":
80
+ test_audit_valid_schema()
81
+ test_audit_invalid_schema()
82
+ test_analyze_safe_migration()
83
+ test_analyze_dangerous_migration()
84
+ test_inspect_indexes()
85
+ print("All databaseArchitecture evals passed successfully!")
@@ -0,0 +1,4 @@
1
+ -- Dangerous Breaking Migration (Exclusive Locks & Immediate Downtime)
2
+ ALTER TABLE orders DROP COLUMN old_notes;
3
+ ALTER TABLE orders RENAME COLUMN status TO order_state;
4
+ CREATE INDEX idx_blocking ON orders (created_at);
@@ -0,0 +1,23 @@
1
+ -- Problematic Schema Missing Primary Key, Incomplete RLS, Cross-Tenant FK, and Foreign Key Indexes
2
+ CREATE TABLE bad_orders (
3
+ customer_id BIGINT,
4
+ extra_data TEXT,
5
+ FOREIGN KEY (customer_id) REFERENCES customers(id)
6
+ );
7
+
8
+ CREATE TABLE tbl_items (
9
+ id BIGINT PRIMARY KEY,
10
+ name VARCHAR(255)
11
+ );
12
+
13
+ CREATE TABLE appointments (
14
+ id BIGINT PRIMARY KEY,
15
+ tenant_id UUID NOT NULL,
16
+ doctor_id UUID NOT NULL,
17
+ scheduled_start TIMESTAMPTZ NOT NULL,
18
+ scheduled_end TIMESTAMPTZ NOT NULL,
19
+ FOREIGN KEY (doctor_id) REFERENCES doctors(id)
20
+ );
21
+
22
+ -- RLS enabled but lacking any CREATE POLICY definition
23
+ ALTER TABLE bad_orders ENABLE ROW LEVEL SECURITY;
@@ -0,0 +1,3 @@
1
+ -- Safe Zero Downtime Expand Migration
2
+ ALTER TABLE orders ADD COLUMN fulfillment_status VARCHAR(50) NULL;
3
+ CREATE INDEX CONCURRENTLY idx_orders_fulfillment ON orders (fulfillment_status);
@@ -0,0 +1,37 @@
1
+ -- Production Grade Valid Schema
2
+ CREATE TABLE customers (
3
+ id BIGINT PRIMARY KEY,
4
+ tenant_id UUID NOT NULL,
5
+ email VARCHAR(255) NOT NULL,
6
+ created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
7
+ CONSTRAINT uq_customers_tenant_email UNIQUE (tenant_id, email),
8
+ CONSTRAINT uq_customers_tenant_id UNIQUE (tenant_id, id)
9
+ );
10
+
11
+ CREATE TABLE orders (
12
+ id BIGINT PRIMARY KEY,
13
+ tenant_id UUID NOT NULL,
14
+ customer_id BIGINT NOT NULL,
15
+ status VARCHAR(50) NOT NULL CHECK (status IN ('pending', 'paid', 'shipped', 'cancelled')),
16
+ total_amount NUMERIC(12, 2) NOT NULL CHECK (total_amount >= 0),
17
+ created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
18
+ CONSTRAINT fk_orders_customer FOREIGN KEY (tenant_id, customer_id) REFERENCES customers(tenant_id, id) ON DELETE RESTRICT,
19
+ CONSTRAINT uq_orders_tenant_id UNIQUE (tenant_id, id)
20
+ );
21
+
22
+ -- Supporting composite index for Foreign Key
23
+ CREATE INDEX idx_orders_customer_composite ON orders (tenant_id, customer_id);
24
+ -- Composite index for tenant filtering and sorting
25
+ CREATE INDEX idx_orders_tenant_status ON orders (tenant_id, status, created_at);
26
+
27
+ ALTER TABLE customers ENABLE ROW LEVEL SECURITY;
28
+ ALTER TABLE customers FORCE ROW LEVEL SECURITY;
29
+ CREATE POLICY rls_customers ON customers FOR ALL
30
+ USING (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::UUID)
31
+ WITH CHECK (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::UUID);
32
+
33
+ ALTER TABLE orders ENABLE ROW LEVEL SECURITY;
34
+ ALTER TABLE orders FORCE ROW LEVEL SECURITY;
35
+ CREATE POLICY rls_orders ON orders FOR ALL
36
+ USING (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::UUID)
37
+ WITH CHECK (tenant_id = NULLIF(current_setting('app.current_tenant_id', true), '')::UUID);
@@ -0,0 +1,25 @@
1
+ # Data Integrity & Constraint Policies
2
+
3
+ Policies governing data validity, invariants, and referential integrity.
4
+
5
+ ---
6
+
7
+ ## 1. Engine-Level Constraints
8
+
9
+ - **Mandatory Non-Nullability**:
10
+ - Columns must be defined `NOT NULL` by default. Nullable columns must be explicitly justified.
11
+ - **CHECK Constraints**:
12
+ - Valid numeric ranges (e.g. `CHECK (amount >= 0)`, `CHECK (quantity > 0)`) and status state machines (e.g. `CHECK (status IN ('pending', 'active', 'canceled'))`) must be enforced at the schema level.
13
+ - **Referential Integrity**:
14
+ - Foreign keys must define explicit referential actions:
15
+ - `ON DELETE RESTRICT` (Default): Prevent deletion of referenced parent rows.
16
+ - `ON DELETE CASCADE`: Permitted ONLY for strict child ownership (e.g. `order_items` owned by `orders`).
17
+ - `ON DELETE SET NULL`: Permitted only for optional associations.
18
+ - Cascading deletes on core master data entities are strictly forbidden.
19
+
20
+ ---
21
+
22
+ ## 2. Uniqueness & Primary Identity
23
+
24
+ - Natural business attributes (e.g., `email`, `slug`) must be guarded by `UNIQUE` constraints with unique indexes.
25
+ - Primary keys must never change over the lifetime of a record. Surrogate keys (UUIDv7 or BIGINT) are strongly preferred over mutable natural strings.
@@ -0,0 +1,32 @@
1
+ # Mandatory Database Architecture Policies
2
+
3
+ These 18 non-negotiable policies govern all database architectures and data models.
4
+
5
+ ---
6
+
7
+ ## The 18 Mandatory Directives
8
+
9
+ 1. **Workload Analysis Before Engine Selection**: Never choose a database engine based on popularity. Engine selection must be justified against access patterns, read/write ratios, and consistency needs in an ADR.
10
+ 2. **Methodology Separation**: Never apply relational normal forms to document or distributed database designs, and never model relational databases like MongoDB document stores.
11
+ 3. **Justified Denormalization**: Controlled data duplication is permitted only when backed by measured query bottlenecks or architectural read models (e.g. CQRS projections).
12
+ 4. **Primary Key Requirement**: Every table or collection must possess an immutable, unique primary identifier. Evaluate index locality (UUIDv7 vs BIGINT).
13
+ 5. **Database-Enforced Invariants**: Critical business constraints (`NOT NULL`, `CHECK`, `UNIQUE`, `FOREIGN KEY`) must exist in the database engine, never outsourced solely to application code.
14
+ 6. **No Speculative Indexing**: Every index must be justified by specific query patterns; redundant indexes waste disk I/O and degrade write throughput.
15
+ 7. **Exhaust Simpler Scaling**: Do not shard a database before optimizing indexes, partitioning large tables, introducing read replicas, and caching read paths.
16
+ 8. **Replication $\ne$ Backup**: Replication guards against node hardware failure, NOT logical data corruption, DROP TABLE errors, or ransomware.
17
+ 9. **Mandatory Disaster Recovery**: No database may deploy to production without tested point-in-time recovery (PITR) procedures and documented RPO/RTO targets.
18
+ 10. **Zero Secrets in Code**: Connection credentials, SSL client certificates, and encryption keys must be managed exclusively via environment secrets or key vaults.
19
+ 11. **Expand-and-Contract Migrations**: Breaking schema changes must be broken into backward-compatible phases (Expand $\rightarrow$ Dual-Write $\rightarrow$ Backfill $\rightarrow$ Contract).
20
+ 12. **Transaction Scoping**: Transactions must remain microsecond-fast. External HTTP calls, mail dispatch, or complex background tasks inside an open transaction are forbidden.
21
+ 13. **Measure Before Optimizing**: Every query optimization must be supported by execution plan outputs (`EXPLAIN (ANALYZE, BUFFERS)`).
22
+ 14. **Portability Awareness**: Proprietary database features must be isolated so the core domain schema remains understandable and maintainable.
23
+ 15. **Polyglot Justification**: Polyglot persistence architectures must explicitly document cross-database consistency mechanisms and operational overhead.
24
+ 16. **Data Retention & Lifecycle**: Tables with continuous ingestion must specify retention, partitioning, downsampling, and archival strategies.
25
+ 17. **No Unmeasured Capacity Claims**: Capacity plans must distinguish between empirical benchmarks and theoretical estimates.
26
+ 18. **Pre-Flight Certification**: No schema may be deployed to production without passing the automated schema audit checklist.
27
+ 19. **Entity Naming Standards**: Table names must use lowercase `snake_case` plural nouns (e.g. `order_items`, `customers`). Generic names (`data`, `info`, `items`, `temp`) and Hungarian notation prefixes (`tbl_`) are strictly forbidden.
28
+ 20. **Lean Schema Law (YAGNI)**: Never add a column until proven necessary by an active business requirement or query pattern. Speculative "just in case" columns and unstructured catch-all columns (`misc`, `extra_data`) are prohibited.
29
+ 21. **Pre-Creation Security Gate**: No table may be created without completing the pre-creation security checklist (PII classification, tenant isolation `tenant_id`, credential hashing, and RLS review).
30
+ 22. **Tenant-Aware Composite Foreign Keys**: In multi-tenant databases, foreign keys between tenant-owned entities must enforce composite foreign keys `FOREIGN KEY (tenant_id, target_id) REFERENCES target_table(tenant_id, id)` to prevent cross-tenant record linking.
31
+ 23. **Temporal Concurrency Protection**: Booking, scheduling, and occupancy tables must enforce PostgreSQL Exclusion Constraints (`EXCLUDE USING gist ... WITH &&`) to prevent overlapping resource allocations.
32
+ 24. **Complete RLS & Policy Symmetry**: Every table with Row-Level Security enabled must define explicit policies for `SELECT`, `INSERT`, `UPDATE`, and `DELETE` with `WITH CHECK` constraints and `FORCE ROW LEVEL SECURITY`.
@@ -0,0 +1,22 @@
1
+ # Database Schema Migration Policies
2
+
3
+ Policies governing zero-downtime schema evolution and rollback procedures.
4
+
5
+ ---
6
+
7
+ ## 1. Zero-Downtime Expand-and-Contract Protocol
8
+
9
+ Directly modifying or dropping live columns causes downtime because running application pods expect the old schema. All breaking changes must follow the **Expand-and-Contract** methodology:
10
+
11
+ 1. **Expand**: Add the new column as nullable (`ALTER TABLE users ADD COLUMN full_name VARCHAR(255) NULL`). Deploy application code that writes to both old and new columns.
12
+ 2. **Backfill**: Run asynchronous background jobs in small batches to populate the new column for historical rows.
13
+ 3. **Contract**: Update application code to read exclusively from the new column. Once verified, deprecate and drop the old column in a subsequent release.
14
+
15
+ ---
16
+
17
+ ## 2. Forbidden Migration Patterns in Production
18
+
19
+ - **`ALTER TABLE ... ADD COLUMN ... DEFAULT <value>` without fast-default support**: Avoid full table rewrites and table locks.
20
+ - **`ALTER TABLE ... DROP COLUMN ...` without deprecation cycle**: Must have zero active queries referencing the column before drop.
21
+ - **`CREATE INDEX` without `CONCURRENTLY`**: Never take an exclusive table lock during index creation on active production tables.
22
+ - **Renaming Columns**: Never rename columns directly (`ALTER TABLE ... RENAME COLUMN ...`). Use expand-and-contract with dual-writing.
@@ -0,0 +1,25 @@
1
+ # Relational Normalization & Denormalization Policies
2
+
3
+ Policies governing normal forms, dependency preservation, and controlled denormalization.
4
+
5
+ ---
6
+
7
+ ## 1. Normalization by Default (OLTP)
8
+
9
+ - **3NF / BCNF Target**:
10
+ - All transactional relational models must achieve **Third Normal Form (3NF)** by default, and **Boyce-Codd Normal Form (BCNF)** wherever functional dependencies dictate.
11
+ - **Verification Criteria**:
12
+ - **1NF**: Atomic attributes, no repeating columns (`phone1`, `phone2`), and a defined primary key.
13
+ - **2NF**: No partial dependencies of non-key attributes on part of a composite primary key.
14
+ - **3NF**: No transitive dependencies (non-key attribute depending on another non-key attribute).
15
+ - **BCNF**: Every determinant must be a candidate key.
16
+
17
+ ---
18
+
19
+ ## 2. Controlled Denormalization Discipline
20
+
21
+ Denormalization is strictly prohibited as a shortcut for lazy modeling. It is allowed ONLY under these conditions:
22
+ 1. **Measured Read Latency**: A specific high-frequency query exceeds the latency SLO due to expensive joins.
23
+ 2. **Immutable Historical Snapshots**: Preserving facts at a specific point in time (e.g. `order_items.unit_price`, `shipping_address_snapshot`).
24
+ 3. **CQRS Read Projections**: Dedicated read-model tables or materialized views updated asynchronously via CDC or domain events.
25
+ 4. **Authoritative Master Copy**: The system must explicitly document which table holds the authoritative single source of truth.
@@ -0,0 +1,26 @@
1
+ # Database Performance & Scalability Policies
2
+
3
+ Policies governing indexing, query optimization, connection pooling, and resource boundaries.
4
+
5
+ ---
6
+
7
+ ## 1. Indexing Policies
8
+
9
+ - **Foreign Key Indexing**:
10
+ - Every foreign key column must have a supporting index to avoid full table scans during child lookups and cascade operations.
11
+ - **Selectivity & Index Pruning**:
12
+ - Do not create indexes on columns with low cardinality (e.g. boolean flags) unless using partial/filtered indexes (e.g. `WHERE is_processed = false`).
13
+ - Regularly audit and drop unused indexes (`pg_stat_user_indexes` where `idx_scan = 0`).
14
+
15
+ ---
16
+
17
+ ## 2. Concurrency & Connection Governance
18
+
19
+ - **Connection Pool Bounds**:
20
+ - Applications must use external or internal connection pooling (e.g. PgBouncer, HikariCP).
21
+ - Explicit limits: `max_connections` sized according to CPU cores:
22
+ $$\text{pool\_size} = 2 \times \text{CPU\_cores} + \text{effective\_spindle\_count}$$
23
+ - Connection acquisition timeout must not exceed 3 seconds.
24
+ - **Lock Contention**:
25
+ - Avoid long-running exclusive locks (`ALTER TABLE ...`, `LOCK TABLE ...`).
26
+ - Create indexes concurrently in production (`CREATE INDEX CONCURRENTLY` in PostgreSQL).
@@ -0,0 +1,23 @@
1
+ # Database Backup, Disaster Recovery & High Availability Policies
2
+
3
+ Policies governing backup retention, point-in-time recovery, and restore verification.
4
+
5
+ ---
6
+
7
+ ## 1. RPO & RTO Invariants
8
+
9
+ Every production database architecture must define and document explicit recovery objectives:
10
+ - **Recovery Point Objective (RPO)**: The maximum acceptable data loss measured in time (e.g. $\le 5$ minutes of transactions).
11
+ - **Recovery Time Objective (RTO)**: The maximum acceptable downtime to restore full database availability (e.g. $\le 60$ minutes).
12
+
13
+ ---
14
+
15
+ ## 2. Backup Architecture & Verification
16
+
17
+ - **Point-in-Time Recovery (PITR)**:
18
+ - Base backups (physical or logical snapshots) combined with continuous Write-Ahead Log (WAL) archiving to durable object storage.
19
+ - **Geographic Redundancy**:
20
+ - WAL archives and snapshots must be mirrored to a secondary geographic region independent of the primary availability zone.
21
+ - **Mandatory Restore Testing**:
22
+ - Backups that have never been restored do not exist.
23
+ - Automated restore drills must execute on a scheduled cadence (minimum monthly) to an isolated test cluster, verifying integrity and timing against the RTO target.
@@ -0,0 +1,26 @@
1
+ # Database Security & Multi-Tenant Isolation Policies
2
+
3
+ Policies governing database authentication, authorization, encryption, and multi-tenant isolation.
4
+
5
+ ---
6
+
7
+ ## 1. Multi-Tenant Isolation
8
+
9
+ - **Tenant Scoping Requirement**:
10
+ - In shared-database multi-tenant systems, every table holding tenant data MUST include a `tenant_id` column.
11
+ - Multi-tenant tables must enforce database Row-Level Security (RLS) with `FORCE ROW LEVEL SECURITY` to prevent table owners and background connections from accidentally bypassing tenant filters.
12
+ - Foreign keys between tenant-scoped entities must enforce composite foreign keys `(tenant_id, id)` to prevent cross-tenant referencing.
13
+ - **Connection Isolation**:
14
+ - Web application database connections must run under an unprivileged application role (e.g. `app_user`), never `postgres`, `root`, or `db_owner`.
15
+ - DDL schema modifications must run via dedicated migration runners with elevated privileges isolated from the web runtime.
16
+
17
+ ---
18
+
19
+ ## 2. Encryption & Data Protection
20
+
21
+ - **Encryption at Rest**: Tablespaces and storage volumes must enforce AES-256 encryption at rest.
22
+ - **Encryption in Transit**: Connections must enforce TLS 1.3 with valid certificate verification (`sslmode=verify-full`).
23
+ - **Cryptographic PII Protection (HMAC vs Raw Hashing)**:
24
+ - Never store raw SHA-256 hashes of short or predictable PII (e.g. 9-digit SSNs, phone numbers). Raw hashes are vulnerable to GPU rainbow-table recovery in seconds.
25
+ - Exact-match lookups must use an **HMAC with an isolated secret key** (e.g. `HMAC-SHA256(ssn, pepper_secret)`).
26
+ - Reversible PII must use authenticated AES-GCM envelope encryption with KMS key rotation.
@@ -0,0 +1,70 @@
1
+ # Table Pre-Creation & Pre-Flight Security Gate Policy
2
+
3
+ No database table may be created in any schema until it has successfully passed this mandatory pre-creation gate and security audit.
4
+
5
+ ---
6
+
7
+ ## Stage 1: Entity Justification Gate (Is this table truly necessary?)
8
+
9
+ Before writing `CREATE TABLE`, answer these 4 questions:
10
+ 1. **Lifecycle Independence**: Does this entity have an independent lifecycle separate from existing entities?
11
+ - If it only exists as an attribute of an existing entity (e.g. `user_preferences`), can it be modeled in the parent table?
12
+ 2. **Cardinality Proof**: Is the relationship genuinely $1:N$ or $N:M$?
13
+ - If $1:1$, justify why it is not stored in the parent table (acceptable reasons: extreme column width, separate security clearance, or sparse optional data).
14
+ 3. **Duplication Audit**: Does an existing table already capture these facts?
15
+ - Prevent fragmentation where similar entities (e.g. `admins`, `customers`, `vendors`) are split across separate tables instead of a unified `users` table with a discriminator/role.
16
+ 4. **Volume & Retention Profile**: What is the expected row count at 1 year and what is its archival/deletion policy?
17
+
18
+ ---
19
+
20
+ ## Stage 2: Entity Naming Conventions & Taxonomy
21
+
22
+ - **Plural, Lowercase `snake_case`**:
23
+ - Compliant: `orders`, `order_items`, `user_sessions`, `payment_methods`.
24
+ - Non-Compliant: `Order` (singular), `tbl_orders` (Hungarian notation prefix), `OrderItems` (PascalCase), `tblData` (generic).
25
+ - **Prohibited Generic Table Names**:
26
+ - Never name a table `data`, `info`, `items`, `records`, `logs`, or `temp`.
27
+ - Names must specify the business domain (e.g. `audit_logs`, `billing_invoices`, `cart_items`).
28
+ - **Junction Table Naming**:
29
+ - Name $N:M$ junction tables after both participating entities in alphabetical or hierarchy order: `students_courses`, `roles_permissions`.
30
+
31
+ ---
32
+
33
+ ## Stage 3: Lean Column Law (The YAGNI Policy)
34
+
35
+ **"Never add a column until an active business requirement or query pattern demands it."**
36
+
37
+ - **No Speculative Columns**:
38
+ - Prohibited: Adding `fax_number`, `middle_initial`, `internal_notes`, or `future_field_1` "just in case we need it later".
39
+ - Prohibited: Adding generic unstructured catch-all columns (`extra_json`, `metadata`, `misc_data`) without an explicit schema and indexing justification.
40
+ - **Column Justification Gate**:
41
+ Every column in the proposed DDL must state:
42
+ 1. Business purpose.
43
+ 2. The code path or query that will read it.
44
+ 3. The code path that will write it.
45
+ 4. Nullability rationale (default is `NOT NULL`).
46
+
47
+ ---
48
+
49
+ ## Stage 4: Pre-Creation Security Checklist (Mandatory Security Gate)
50
+
51
+ Before the table DDL is approved, complete this security checklist:
52
+
53
+ | Security Vector | Verification Requirement |
54
+ | :--- | :--- |
55
+ | **Tenant Isolation** | If multi-tenant, does the table include `tenant_id`? Is Row-Level Security (RLS) configured? |
56
+ | **PII & Sensitivity** | Are sensitive personal fields (SSN, national ID, phone, home address) classified? |
57
+ | **Credential Storage** | Are passwords, tokens, or API keys properly hashed (Argon2id/bcrypt) or encrypted before storage? Plaintext credentials are strictly forbidden. |
58
+ | **Financial / Audit Records** | Are monetary amounts modeled with exact precision (`NUMERIC(12, 2)` or integer cents), never floating-point `FLOAT`/`REAL`? |
59
+ | **Access Permissions** | Does the application role have only `SELECT, INSERT, UPDATE, DELETE` permissions? (Application role must never possess `DROP`, `TRUNCATE`, or `ALTER`). |
60
+ | **Soft Delete vs Purge** | If compliance mandates GDPR/CCPA "Right to be Forgotten", is there a mechanism to hard-purge or pseudonymize records? |
61
+
62
+ ---
63
+
64
+ ## Stage 5: Schema Integrity & Index Gate
65
+
66
+ - [ ] Immutable Primary Key defined (`id BIGINT` or `id UUID` using UUIDv7).
67
+ - [ ] Foreign keys define explicit `ON DELETE` actions (`RESTRICT` or `CASCADE`).
68
+ - [ ] Every foreign key column has a supporting secondary index.
69
+ - [ ] Mandatory audit timestamps present (`created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()`, `updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()`).
70
+ - [ ] CHECK constraints enforce domain ranges and state machines.
@@ -0,0 +1,32 @@
1
+ # Analytical Data Architecture & Dimensional Modeling Reference
2
+
3
+ ---
4
+
5
+ ## 1. OLTP vs. OLAP Paradigms
6
+
7
+ ```
8
+ OLTP (Online Transaction Processing)
9
+ ├── Normalized schemas (3NF / BCNF)
10
+ ├── High-frequency small transactions (Row-based storage)
11
+ └── Goal: Low latency point writes and reads (< 10ms)
12
+
13
+ OLAP (Online Analytical Processing)
14
+ ├── Dimensional schemas (Star / Snowflake)
15
+ ├── Batch or stream ingestion (Columnar storage: ClickHouse, DuckDB, BigQuery)
16
+ └── Goal: High-throughput aggregate scans over millions/billions of records
17
+ ```
18
+
19
+ ---
20
+
21
+ ## 2. Dimensional Modeling: Star Schema
22
+
23
+ - **Fact Tables**: Contain quantitative measurements, metrics, and foreign keys to dimensions (e.g. `fact_sales`: `order_id`, `customer_key`, `date_key`, `amount_sold`, `discount_amount`).
24
+ - **Dimension Tables**: Contain contextual, descriptive attributes (e.g. `dim_customer`: `customer_key`, `name`, `tier`, `country`, `segment`).
25
+
26
+ ---
27
+
28
+ ## 3. Slowly Changing Dimensions (SCD)
29
+
30
+ - **SCD Type 1 (Overwrite)**: Overwrite historical value with new value. History is lost.
31
+ - **SCD Type 2 (Add New Row - Recommended)**: Add new record with validity date ranges (`valid_from`, `valid_to`, `is_current`). Full historical tracking.
32
+ - **SCD Type 3 (Add Previous Value Column)**: Store `current_tier` and `previous_tier` in the same row. Limited history.
@@ -0,0 +1,3 @@
1
+ # Databasearchitecture Reference
2
+
3
+ Official docs: N/A
@@ -0,0 +1,27 @@
1
+ # Backup, Disaster Recovery & High Availability Reference
2
+
3
+ ---
4
+
5
+ ## 1. Physical vs. Logical Backups
6
+
7
+ | Backup Architecture | Mechanism | Advantages | Disadvantages |
8
+ | :--- | :--- | :--- | :--- |
9
+ | **Physical (Binary Snapshots)** | Block-level file copies or storage volume snapshots (EBS, ZFS). | Extremely fast restore; captures exact byte state. | Engine and architecture specific; large storage volume. |
10
+ | **Logical Backups (`pg_dump`, `mysqldump`)** | SQL text or archive emitting DDL and INSERT/COPY statements. | Engine portable, readable, supports partial table restores. | Extremely slow restore on terabyte-scale databases; high CPU load. |
11
+ | **Continuous WAL Archiving (PITR)** | Base physical backup + streaming Write-Ahead Log segments to object storage. | Zero data loss up to seconds before disaster; restore to any microsecond. | Requires dedicated tooling (pgBackRest, WAL-G, Barman). |
12
+
13
+ ---
14
+
15
+ ## 2. Point-in-Time Recovery (PITR) Protocol
16
+
17
+ 1. Restore the most recent baseline physical snapshot before the disaster event timestamp $T$.
18
+ 2. Configure `recovery_target_time = '2026-11-16 12:45:00 UTC'`.
19
+ 3. Replay Write-Ahead Log (WAL) segments sequentially up to the target time.
20
+ 4. Promote the restored cluster to primary.
21
+
22
+ ---
23
+
24
+ ## 3. High Availability & Split-Brain Defense
25
+
26
+ - **Quorum Consensus (Raft / Paxos)**: Multi-node clusters must use odd numbers of voter nodes (3, 5) to prevent network partition split-brain.
27
+ - **Fencing (STONITH)**: Automatically isolate failed primary nodes before promoting a replica to prevent dual-master data corruption.