@funnycode/myclaude 0.1.55 → 0.1.60

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 (499) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +63 -0
  3. package/README.zh-CN.md +63 -0
  4. package/dist/SKILL-r7zmg5v7.md +3 -0
  5. package/dist/cli-mvr5k580.md +3 -0
  6. package/dist/myclaude.js +14230 -8799
  7. package/dist/myclaude.mjs +14230 -8799
  8. package/dist/server-zyhc2a9z.md +3 -0
  9. package/package.json +128 -128
  10. package/seed/marketplaces/ecc/.opencode/package-lock.json +169 -169
  11. package/seed/marketplaces/ecc/commands/aside.md +164 -164
  12. package/seed/marketplaces/ecc/commands/auto-update.md +28 -28
  13. package/seed/marketplaces/ecc/commands/build-fix.md +66 -66
  14. package/seed/marketplaces/ecc/commands/checkpoint.md +78 -78
  15. package/seed/marketplaces/ecc/commands/code-review.md +289 -289
  16. package/seed/marketplaces/ecc/commands/cost-report.md +107 -107
  17. package/seed/marketplaces/ecc/commands/cpp-build.md +173 -173
  18. package/seed/marketplaces/ecc/commands/cpp-review.md +132 -132
  19. package/seed/marketplaces/ecc/commands/cpp-test.md +251 -251
  20. package/seed/marketplaces/ecc/commands/ecc-guide.md +93 -93
  21. package/seed/marketplaces/ecc/commands/evolve.md +178 -178
  22. package/seed/marketplaces/ecc/commands/fastapi-review.md +39 -39
  23. package/seed/marketplaces/ecc/commands/feature-dev.md +49 -49
  24. package/seed/marketplaces/ecc/commands/flutter-build.md +164 -164
  25. package/seed/marketplaces/ecc/commands/flutter-review.md +116 -116
  26. package/seed/marketplaces/ecc/commands/flutter-test.md +144 -144
  27. package/seed/marketplaces/ecc/commands/gan-build.md +103 -103
  28. package/seed/marketplaces/ecc/commands/gan-design.md +39 -39
  29. package/seed/marketplaces/ecc/commands/go-build.md +183 -183
  30. package/seed/marketplaces/ecc/commands/go-review.md +148 -148
  31. package/seed/marketplaces/ecc/commands/go-test.md +268 -268
  32. package/seed/marketplaces/ecc/commands/gradle-build.md +70 -70
  33. package/seed/marketplaces/ecc/commands/harness-audit.md +84 -84
  34. package/seed/marketplaces/ecc/commands/hookify-configure.md +14 -14
  35. package/seed/marketplaces/ecc/commands/hookify-help.md +46 -46
  36. package/seed/marketplaces/ecc/commands/hookify-list.md +21 -21
  37. package/seed/marketplaces/ecc/commands/hookify.md +50 -50
  38. package/seed/marketplaces/ecc/commands/instinct-export.md +66 -66
  39. package/seed/marketplaces/ecc/commands/instinct-import.md +114 -114
  40. package/seed/marketplaces/ecc/commands/instinct-status.md +59 -59
  41. package/seed/marketplaces/ecc/commands/jira.md +106 -106
  42. package/seed/marketplaces/ecc/commands/kotlin-build.md +174 -174
  43. package/seed/marketplaces/ecc/commands/kotlin-review.md +140 -140
  44. package/seed/marketplaces/ecc/commands/kotlin-test.md +312 -312
  45. package/seed/marketplaces/ecc/commands/learn-eval.md +116 -116
  46. package/seed/marketplaces/ecc/commands/learn.md +74 -74
  47. package/seed/marketplaces/ecc/commands/loop-start.md +36 -36
  48. package/seed/marketplaces/ecc/commands/loop-status.md +77 -77
  49. package/seed/marketplaces/ecc/commands/marketing-campaign.md +129 -129
  50. package/seed/marketplaces/ecc/commands/model-route.md +30 -30
  51. package/seed/marketplaces/ecc/commands/multi-backend.md +162 -162
  52. package/seed/marketplaces/ecc/commands/multi-execute.md +319 -319
  53. package/seed/marketplaces/ecc/commands/multi-frontend.md +162 -162
  54. package/seed/marketplaces/ecc/commands/multi-plan.md +272 -272
  55. package/seed/marketplaces/ecc/commands/multi-workflow.md +195 -195
  56. package/seed/marketplaces/ecc/commands/plan-prd.md +160 -160
  57. package/seed/marketplaces/ecc/commands/plan.md +200 -200
  58. package/seed/marketplaces/ecc/commands/pm2.md +276 -276
  59. package/seed/marketplaces/ecc/commands/pr.md +184 -184
  60. package/seed/marketplaces/ecc/commands/project-init.md +86 -86
  61. package/seed/marketplaces/ecc/commands/projects.md +39 -39
  62. package/seed/marketplaces/ecc/commands/promote.md +41 -41
  63. package/seed/marketplaces/ecc/commands/prp-commit.md +112 -112
  64. package/seed/marketplaces/ecc/commands/prp-implement.md +385 -385
  65. package/seed/marketplaces/ecc/commands/prp-plan.md +502 -502
  66. package/seed/marketplaces/ecc/commands/prp-pr.md +184 -184
  67. package/seed/marketplaces/ecc/commands/prp-prd.md +447 -447
  68. package/seed/marketplaces/ecc/commands/prune.md +31 -31
  69. package/seed/marketplaces/ecc/commands/python-review.md +297 -297
  70. package/seed/marketplaces/ecc/commands/quality-gate.md +33 -33
  71. package/seed/marketplaces/ecc/commands/refactor-clean.md +84 -84
  72. package/seed/marketplaces/ecc/commands/resume-session.md +156 -156
  73. package/seed/marketplaces/ecc/commands/review-pr.md +37 -37
  74. package/seed/marketplaces/ecc/commands/rust-build.md +187 -187
  75. package/seed/marketplaces/ecc/commands/rust-review.md +142 -142
  76. package/seed/marketplaces/ecc/commands/rust-test.md +308 -308
  77. package/seed/marketplaces/ecc/commands/santa-loop.md +175 -175
  78. package/seed/marketplaces/ecc/commands/save-session.md +275 -275
  79. package/seed/marketplaces/ecc/commands/security-scan.md +92 -92
  80. package/seed/marketplaces/ecc/commands/sessions.md +339 -339
  81. package/seed/marketplaces/ecc/commands/setup-pm.md +80 -80
  82. package/seed/marketplaces/ecc/commands/skill-create.md +174 -174
  83. package/seed/marketplaces/ecc/commands/skill-health.md +54 -54
  84. package/seed/marketplaces/ecc/commands/test-coverage.md +73 -73
  85. package/seed/marketplaces/ecc/commands/update-codemaps.md +76 -76
  86. package/seed/marketplaces/ecc/commands/update-docs.md +88 -88
  87. package/seed/marketplaces/ecc/skills/accessibility/SKILL.md +146 -146
  88. package/seed/marketplaces/ecc/skills/agent-architecture-audit/SKILL.md +256 -256
  89. package/seed/marketplaces/ecc/skills/agent-eval/SKILL.md +145 -145
  90. package/seed/marketplaces/ecc/skills/agent-harness-construction/SKILL.md +73 -73
  91. package/seed/marketplaces/ecc/skills/agent-introspection-debugging/SKILL.md +153 -153
  92. package/seed/marketplaces/ecc/skills/agent-payment-x402/SKILL.md +224 -224
  93. package/seed/marketplaces/ecc/skills/agent-sort/SKILL.md +215 -215
  94. package/seed/marketplaces/ecc/skills/agentic-engineering/SKILL.md +63 -63
  95. package/seed/marketplaces/ecc/skills/agentic-os/SKILL.md +387 -387
  96. package/seed/marketplaces/ecc/skills/ai-first-engineering/SKILL.md +51 -51
  97. package/seed/marketplaces/ecc/skills/ai-regression-testing/SKILL.md +385 -385
  98. package/seed/marketplaces/ecc/skills/android-clean-architecture/SKILL.md +339 -339
  99. package/seed/marketplaces/ecc/skills/angular-developer/SKILL.md +154 -154
  100. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-animations.md +160 -160
  101. package/seed/marketplaces/ecc/skills/angular-developer/references/angular-aria.md +410 -410
  102. package/seed/marketplaces/ecc/skills/angular-developer/references/cli.md +86 -86
  103. package/seed/marketplaces/ecc/skills/angular-developer/references/component-harnesses.md +59 -59
  104. package/seed/marketplaces/ecc/skills/angular-developer/references/component-styling.md +91 -91
  105. package/seed/marketplaces/ecc/skills/angular-developer/references/components.md +117 -117
  106. package/seed/marketplaces/ecc/skills/angular-developer/references/creating-services.md +97 -97
  107. package/seed/marketplaces/ecc/skills/angular-developer/references/data-resolvers.md +69 -69
  108. package/seed/marketplaces/ecc/skills/angular-developer/references/define-routes.md +67 -67
  109. package/seed/marketplaces/ecc/skills/angular-developer/references/defining-providers.md +72 -72
  110. package/seed/marketplaces/ecc/skills/angular-developer/references/di-fundamentals.md +120 -120
  111. package/seed/marketplaces/ecc/skills/angular-developer/references/e2e-testing.md +56 -56
  112. package/seed/marketplaces/ecc/skills/angular-developer/references/effects.md +83 -83
  113. package/seed/marketplaces/ecc/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  114. package/seed/marketplaces/ecc/skills/angular-developer/references/host-elements.md +80 -80
  115. package/seed/marketplaces/ecc/skills/angular-developer/references/injection-context.md +63 -63
  116. package/seed/marketplaces/ecc/skills/angular-developer/references/inputs.md +101 -101
  117. package/seed/marketplaces/ecc/skills/angular-developer/references/linked-signal.md +59 -59
  118. package/seed/marketplaces/ecc/skills/angular-developer/references/loading-strategies.md +61 -61
  119. package/seed/marketplaces/ecc/skills/angular-developer/references/mcp.md +108 -108
  120. package/seed/marketplaces/ecc/skills/angular-developer/references/navigate-to-routes.md +69 -69
  121. package/seed/marketplaces/ecc/skills/angular-developer/references/outputs.md +86 -86
  122. package/seed/marketplaces/ecc/skills/angular-developer/references/reactive-forms.md +122 -122
  123. package/seed/marketplaces/ecc/skills/angular-developer/references/rendering-strategies.md +44 -44
  124. package/seed/marketplaces/ecc/skills/angular-developer/references/resource.md +77 -77
  125. package/seed/marketplaces/ecc/skills/angular-developer/references/route-animations.md +56 -56
  126. package/seed/marketplaces/ecc/skills/angular-developer/references/route-guards.md +52 -52
  127. package/seed/marketplaces/ecc/skills/angular-developer/references/router-lifecycle.md +45 -45
  128. package/seed/marketplaces/ecc/skills/angular-developer/references/router-testing.md +87 -87
  129. package/seed/marketplaces/ecc/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  130. package/seed/marketplaces/ecc/skills/angular-developer/references/signal-forms.md +795 -795
  131. package/seed/marketplaces/ecc/skills/angular-developer/references/signals-overview.md +94 -94
  132. package/seed/marketplaces/ecc/skills/angular-developer/references/tailwind-css.md +69 -69
  133. package/seed/marketplaces/ecc/skills/angular-developer/references/template-driven-forms.md +114 -114
  134. package/seed/marketplaces/ecc/skills/angular-developer/references/testing-fundamentals.md +65 -65
  135. package/seed/marketplaces/ecc/skills/api-connector-builder/SKILL.md +120 -120
  136. package/seed/marketplaces/ecc/skills/api-design/SKILL.md +523 -523
  137. package/seed/marketplaces/ecc/skills/architecture-decision-records/SKILL.md +179 -179
  138. package/seed/marketplaces/ecc/skills/article-writing/SKILL.md +79 -79
  139. package/seed/marketplaces/ecc/skills/automation-audit-ops/SKILL.md +142 -142
  140. package/seed/marketplaces/ecc/skills/autonomous-agent-harness/SKILL.md +273 -273
  141. package/seed/marketplaces/ecc/skills/autonomous-loops/SKILL.md +610 -610
  142. package/seed/marketplaces/ecc/skills/backend-patterns/SKILL.md +561 -561
  143. package/seed/marketplaces/ecc/skills/benchmark/SKILL.md +93 -93
  144. package/seed/marketplaces/ecc/skills/benchmark-optimization-loop/SKILL.md +69 -69
  145. package/seed/marketplaces/ecc/skills/blender-motion-state-inspection/SKILL.md +164 -164
  146. package/seed/marketplaces/ecc/skills/blueprint/SKILL.md +105 -105
  147. package/seed/marketplaces/ecc/skills/brand-voice/SKILL.md +97 -97
  148. package/seed/marketplaces/ecc/skills/brand-voice/references/voice-profile-schema.md +55 -55
  149. package/seed/marketplaces/ecc/skills/browser-qa/SKILL.md +87 -87
  150. package/seed/marketplaces/ecc/skills/bun-runtime/SKILL.md +84 -84
  151. package/seed/marketplaces/ecc/skills/canary-watch/SKILL.md +107 -107
  152. package/seed/marketplaces/ecc/skills/carrier-relationship-management/SKILL.md +212 -212
  153. package/seed/marketplaces/ecc/skills/cisco-ios-patterns/SKILL.md +163 -163
  154. package/seed/marketplaces/ecc/skills/ck/SKILL.md +147 -147
  155. package/seed/marketplaces/ecc/skills/ck/commands/forget.mjs +44 -44
  156. package/seed/marketplaces/ecc/skills/ck/commands/info.mjs +24 -24
  157. package/seed/marketplaces/ecc/skills/ck/commands/init.mjs +143 -143
  158. package/seed/marketplaces/ecc/skills/ck/commands/list.mjs +40 -40
  159. package/seed/marketplaces/ecc/skills/ck/commands/migrate.mjs +202 -202
  160. package/seed/marketplaces/ecc/skills/ck/commands/resume.mjs +36 -36
  161. package/seed/marketplaces/ecc/skills/ck/commands/save.mjs +210 -210
  162. package/seed/marketplaces/ecc/skills/ck/commands/shared.mjs +387 -387
  163. package/seed/marketplaces/ecc/skills/ck/hooks/session-start.mjs +224 -224
  164. package/seed/marketplaces/ecc/skills/claude-devfleet/SKILL.md +103 -103
  165. package/seed/marketplaces/ecc/skills/click-path-audit/SKILL.md +244 -244
  166. package/seed/marketplaces/ecc/skills/clickhouse-io/SKILL.md +439 -439
  167. package/seed/marketplaces/ecc/skills/code-tour/SKILL.md +236 -236
  168. package/seed/marketplaces/ecc/skills/codebase-onboarding/SKILL.md +233 -233
  169. package/seed/marketplaces/ecc/skills/coding-standards/SKILL.md +549 -549
  170. package/seed/marketplaces/ecc/skills/compose-multiplatform-patterns/SKILL.md +299 -299
  171. package/seed/marketplaces/ecc/skills/configure-ecc/SKILL.md +384 -384
  172. package/seed/marketplaces/ecc/skills/connections-optimizer/SKILL.md +189 -189
  173. package/seed/marketplaces/ecc/skills/content-engine/SKILL.md +131 -131
  174. package/seed/marketplaces/ecc/skills/content-hash-cache-pattern/SKILL.md +161 -161
  175. package/seed/marketplaces/ecc/skills/context-budget/SKILL.md +135 -135
  176. package/seed/marketplaces/ecc/skills/continuous-agent-loop/SKILL.md +45 -45
  177. package/seed/marketplaces/ecc/skills/continuous-learning/SKILL.md +131 -131
  178. package/seed/marketplaces/ecc/skills/continuous-learning/config.json +18 -18
  179. package/seed/marketplaces/ecc/skills/continuous-learning/evaluate-session.sh +69 -69
  180. package/seed/marketplaces/ecc/skills/continuous-learning-v2/SKILL.md +360 -360
  181. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer-loop.sh +322 -322
  182. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/observer.md +198 -198
  183. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/session-guardian.sh +150 -150
  184. package/seed/marketplaces/ecc/skills/continuous-learning-v2/agents/start-observer.sh +248 -248
  185. package/seed/marketplaces/ecc/skills/continuous-learning-v2/config.json +8 -8
  186. package/seed/marketplaces/ecc/skills/continuous-learning-v2/hooks/observe.sh +498 -498
  187. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/detect-project.sh +322 -322
  188. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/instinct-cli.py +1826 -1826
  189. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/lib/homunculus-dir.sh +31 -31
  190. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/migrate-homunculus.sh +62 -62
  191. package/seed/marketplaces/ecc/skills/continuous-learning-v2/scripts/test_parse_instinct.py +1018 -1018
  192. package/seed/marketplaces/ecc/skills/cost-aware-llm-pipeline/SKILL.md +183 -183
  193. package/seed/marketplaces/ecc/skills/cost-tracking/SKILL.md +147 -147
  194. package/seed/marketplaces/ecc/skills/council/SKILL.md +203 -203
  195. package/seed/marketplaces/ecc/skills/cpp-coding-standards/SKILL.md +723 -723
  196. package/seed/marketplaces/ecc/skills/cpp-testing/SKILL.md +324 -324
  197. package/seed/marketplaces/ecc/skills/crosspost/SKILL.md +111 -111
  198. package/seed/marketplaces/ecc/skills/csharp-testing/SKILL.md +321 -321
  199. package/seed/marketplaces/ecc/skills/customer-billing-ops/SKILL.md +140 -140
  200. package/seed/marketplaces/ecc/skills/customs-trade-compliance/SKILL.md +263 -263
  201. package/seed/marketplaces/ecc/skills/dart-flutter-patterns/SKILL.md +563 -563
  202. package/seed/marketplaces/ecc/skills/dashboard-builder/SKILL.md +108 -108
  203. package/seed/marketplaces/ecc/skills/data-scraper-agent/SKILL.md +764 -764
  204. package/seed/marketplaces/ecc/skills/data-throughput-accelerator/SKILL.md +72 -72
  205. package/seed/marketplaces/ecc/skills/database-migrations/SKILL.md +429 -429
  206. package/seed/marketplaces/ecc/skills/deep-research/SKILL.md +159 -159
  207. package/seed/marketplaces/ecc/skills/defi-amm-security/SKILL.md +166 -166
  208. package/seed/marketplaces/ecc/skills/deployment-patterns/SKILL.md +427 -427
  209. package/seed/marketplaces/ecc/skills/design-system/SKILL.md +82 -82
  210. package/seed/marketplaces/ecc/skills/django-celery/SKILL.md +457 -457
  211. package/seed/marketplaces/ecc/skills/django-patterns/SKILL.md +734 -734
  212. package/seed/marketplaces/ecc/skills/django-security/SKILL.md +593 -593
  213. package/seed/marketplaces/ecc/skills/django-tdd/SKILL.md +729 -729
  214. package/seed/marketplaces/ecc/skills/django-verification/SKILL.md +469 -469
  215. package/seed/marketplaces/ecc/skills/dmux-workflows/SKILL.md +191 -191
  216. package/seed/marketplaces/ecc/skills/docker-patterns/SKILL.md +364 -364
  217. package/seed/marketplaces/ecc/skills/documentation-lookup/SKILL.md +90 -90
  218. package/seed/marketplaces/ecc/skills/dotnet-patterns/SKILL.md +321 -321
  219. package/seed/marketplaces/ecc/skills/e2e-testing/SKILL.md +326 -326
  220. package/seed/marketplaces/ecc/skills/ecc-guide/SKILL.md +189 -189
  221. package/seed/marketplaces/ecc/skills/ecc-tools-cost-audit/SKILL.md +160 -160
  222. package/seed/marketplaces/ecc/skills/email-ops/SKILL.md +121 -121
  223. package/seed/marketplaces/ecc/skills/energy-procurement/SKILL.md +228 -228
  224. package/seed/marketplaces/ecc/skills/enterprise-agent-ops/SKILL.md +50 -50
  225. package/seed/marketplaces/ecc/skills/error-handling/SKILL.md +376 -376
  226. package/seed/marketplaces/ecc/skills/eval-harness/SKILL.md +270 -270
  227. package/seed/marketplaces/ecc/skills/evm-token-decimals/SKILL.md +130 -130
  228. package/seed/marketplaces/ecc/skills/exa-search/SKILL.md +107 -107
  229. package/seed/marketplaces/ecc/skills/fal-ai-media/SKILL.md +288 -288
  230. package/seed/marketplaces/ecc/skills/fastapi-patterns/SKILL.md +327 -327
  231. package/seed/marketplaces/ecc/skills/finance-billing-ops/SKILL.md +127 -127
  232. package/seed/marketplaces/ecc/skills/flox-environments/SKILL.md +496 -496
  233. package/seed/marketplaces/ecc/skills/flutter-dart-code-review/SKILL.md +435 -435
  234. package/seed/marketplaces/ecc/skills/foundation-models-on-device/SKILL.md +243 -243
  235. package/seed/marketplaces/ecc/skills/frontend-a11y/SKILL.md +446 -446
  236. package/seed/marketplaces/ecc/skills/frontend-design-direction/SKILL.md +92 -92
  237. package/seed/marketplaces/ecc/skills/frontend-patterns/SKILL.md +642 -642
  238. package/seed/marketplaces/ecc/skills/frontend-slides/SKILL.md +184 -184
  239. package/seed/marketplaces/ecc/skills/frontend-slides/STYLE_PRESETS.md +330 -330
  240. package/seed/marketplaces/ecc/skills/frontend-slides/animation-patterns.md +122 -122
  241. package/seed/marketplaces/ecc/skills/frontend-slides/html-template.md +419 -419
  242. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/export-pdf.sh +418 -418
  243. package/seed/marketplaces/ecc/skills/frontend-slides/scripts/extract-pptx.py +96 -96
  244. package/seed/marketplaces/ecc/skills/frontend-slides/viewport-base.css +153 -153
  245. package/seed/marketplaces/ecc/skills/fsharp-testing/SKILL.md +280 -280
  246. package/seed/marketplaces/ecc/skills/gan-style-harness/SKILL.md +278 -278
  247. package/seed/marketplaces/ecc/skills/gateguard/SKILL.md +125 -125
  248. package/seed/marketplaces/ecc/skills/git-workflow/SKILL.md +715 -715
  249. package/seed/marketplaces/ecc/skills/github-ops/SKILL.md +144 -144
  250. package/seed/marketplaces/ecc/skills/golang-patterns/SKILL.md +674 -674
  251. package/seed/marketplaces/ecc/skills/golang-testing/SKILL.md +720 -720
  252. package/seed/marketplaces/ecc/skills/google-workspace-ops/SKILL.md +95 -95
  253. package/seed/marketplaces/ecc/skills/healthcare-cdss-patterns/SKILL.md +245 -245
  254. package/seed/marketplaces/ecc/skills/healthcare-emr-patterns/SKILL.md +159 -159
  255. package/seed/marketplaces/ecc/skills/healthcare-eval-harness/SKILL.md +207 -207
  256. package/seed/marketplaces/ecc/skills/healthcare-phi-compliance/SKILL.md +145 -145
  257. package/seed/marketplaces/ecc/skills/hermes-imports/SKILL.md +88 -88
  258. package/seed/marketplaces/ecc/skills/hexagonal-architecture/SKILL.md +276 -276
  259. package/seed/marketplaces/ecc/skills/hipaa-compliance/SKILL.md +78 -78
  260. package/seed/marketplaces/ecc/skills/homelab-network-readiness/SKILL.md +169 -169
  261. package/seed/marketplaces/ecc/skills/homelab-network-setup/SKILL.md +129 -129
  262. package/seed/marketplaces/ecc/skills/homelab-pihole-dns/SKILL.md +274 -274
  263. package/seed/marketplaces/ecc/skills/homelab-vlan-segmentation/SKILL.md +311 -311
  264. package/seed/marketplaces/ecc/skills/homelab-wireguard-vpn/SKILL.md +305 -305
  265. package/seed/marketplaces/ecc/skills/hookify-rules/SKILL.md +128 -128
  266. package/seed/marketplaces/ecc/skills/inventory-demand-planning/SKILL.md +247 -247
  267. package/seed/marketplaces/ecc/skills/investor-materials/SKILL.md +96 -96
  268. package/seed/marketplaces/ecc/skills/investor-outreach/SKILL.md +91 -91
  269. package/seed/marketplaces/ecc/skills/ios-icon-gen/SKILL.md +157 -157
  270. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/generate_icons.swift +258 -258
  271. package/seed/marketplaces/ecc/skills/ios-icon-gen/scripts/iconify_gen.sh +235 -235
  272. package/seed/marketplaces/ecc/skills/iterative-retrieval/SKILL.md +211 -211
  273. package/seed/marketplaces/ecc/skills/ito-basket-compare/SKILL.md +63 -63
  274. package/seed/marketplaces/ecc/skills/ito-data-atlas-agent/SKILL.md +63 -63
  275. package/seed/marketplaces/ecc/skills/ito-market-intelligence/SKILL.md +60 -60
  276. package/seed/marketplaces/ecc/skills/ito-trade-planner/SKILL.md +67 -67
  277. package/seed/marketplaces/ecc/skills/java-coding-standards/SKILL.md +383 -383
  278. package/seed/marketplaces/ecc/skills/jira-integration/SKILL.md +293 -293
  279. package/seed/marketplaces/ecc/skills/jpa-patterns/SKILL.md +151 -151
  280. package/seed/marketplaces/ecc/skills/knowledge-ops/SKILL.md +154 -154
  281. package/seed/marketplaces/ecc/skills/kotlin-coroutines-flows/SKILL.md +284 -284
  282. package/seed/marketplaces/ecc/skills/kotlin-exposed-patterns/SKILL.md +719 -719
  283. package/seed/marketplaces/ecc/skills/kotlin-ktor-patterns/SKILL.md +689 -689
  284. package/seed/marketplaces/ecc/skills/kotlin-patterns/SKILL.md +711 -711
  285. package/seed/marketplaces/ecc/skills/kotlin-testing/SKILL.md +824 -824
  286. package/seed/marketplaces/ecc/skills/laravel-patterns/SKILL.md +415 -415
  287. package/seed/marketplaces/ecc/skills/laravel-plugin-discovery/SKILL.md +229 -229
  288. package/seed/marketplaces/ecc/skills/laravel-security/SKILL.md +285 -285
  289. package/seed/marketplaces/ecc/skills/laravel-tdd/SKILL.md +283 -283
  290. package/seed/marketplaces/ecc/skills/laravel-verification/SKILL.md +179 -179
  291. package/seed/marketplaces/ecc/skills/latency-critical-systems/SKILL.md +73 -73
  292. package/seed/marketplaces/ecc/skills/lead-intelligence/SKILL.md +321 -321
  293. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/enrichment-agent.md +85 -85
  294. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/mutual-mapper.md +75 -75
  295. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/outreach-drafter.md +98 -98
  296. package/seed/marketplaces/ecc/skills/lead-intelligence/agents/signal-scorer.md +60 -60
  297. package/seed/marketplaces/ecc/skills/liquid-glass-design/SKILL.md +279 -279
  298. package/seed/marketplaces/ecc/skills/llm-trading-agent-security/SKILL.md +146 -146
  299. package/seed/marketplaces/ecc/skills/logistics-exception-management/SKILL.md +222 -222
  300. package/seed/marketplaces/ecc/skills/make-interfaces-feel-better/SKILL.md +151 -151
  301. package/seed/marketplaces/ecc/skills/manim-video/SKILL.md +89 -89
  302. package/seed/marketplaces/ecc/skills/manim-video/assets/network_graph_scene.py +52 -52
  303. package/seed/marketplaces/ecc/skills/market-research/SKILL.md +75 -75
  304. package/seed/marketplaces/ecc/skills/marketing-campaign/SKILL.md +113 -113
  305. package/seed/marketplaces/ecc/skills/mcp-server-patterns/SKILL.md +69 -69
  306. package/seed/marketplaces/ecc/skills/messages-ops/SKILL.md +104 -104
  307. package/seed/marketplaces/ecc/skills/mle-workflow/SKILL.md +346 -346
  308. package/seed/marketplaces/ecc/skills/motion-advanced/SKILL.md +596 -596
  309. package/seed/marketplaces/ecc/skills/motion-foundations/SKILL.md +299 -299
  310. package/seed/marketplaces/ecc/skills/motion-patterns/SKILL.md +435 -435
  311. package/seed/marketplaces/ecc/skills/motion-ui/SKILL.md +575 -575
  312. package/seed/marketplaces/ecc/skills/mysql-patterns/SKILL.md +412 -412
  313. package/seed/marketplaces/ecc/skills/nanoclaw-repl/SKILL.md +33 -33
  314. package/seed/marketplaces/ecc/skills/nestjs-patterns/SKILL.md +230 -230
  315. package/seed/marketplaces/ecc/skills/netmiko-ssh-automation/SKILL.md +173 -173
  316. package/seed/marketplaces/ecc/skills/network-bgp-diagnostics/SKILL.md +167 -167
  317. package/seed/marketplaces/ecc/skills/network-config-validation/SKILL.md +210 -210
  318. package/seed/marketplaces/ecc/skills/network-interface-health/SKILL.md +152 -152
  319. package/seed/marketplaces/ecc/skills/nextjs-turbopack/SKILL.md +57 -57
  320. package/seed/marketplaces/ecc/skills/nodejs-keccak256/SKILL.md +102 -102
  321. package/seed/marketplaces/ecc/skills/nutrient-document-processing/SKILL.md +167 -167
  322. package/seed/marketplaces/ecc/skills/nuxt4-patterns/SKILL.md +100 -100
  323. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/SKILL.md +288 -288
  324. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.py +224 -224
  325. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/gacha.sh +5 -5
  326. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  327. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  328. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  329. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  330. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  331. package/seed/marketplaces/ecc/skills/openclaw-persona-forge/references/output-template.md +166 -166
  332. package/seed/marketplaces/ecc/skills/opensource-pipeline/SKILL.md +255 -255
  333. package/seed/marketplaces/ecc/skills/parallel-execution-optimizer/SKILL.md +72 -72
  334. package/seed/marketplaces/ecc/skills/perl-patterns/SKILL.md +504 -504
  335. package/seed/marketplaces/ecc/skills/perl-security/SKILL.md +503 -503
  336. package/seed/marketplaces/ecc/skills/perl-testing/SKILL.md +475 -475
  337. package/seed/marketplaces/ecc/skills/plan-orchestrate/SKILL.md +262 -262
  338. package/seed/marketplaces/ecc/skills/plankton-code-quality/SKILL.md +236 -236
  339. package/seed/marketplaces/ecc/skills/postgres-patterns/SKILL.md +147 -147
  340. package/seed/marketplaces/ecc/skills/prediction-market-oracle-research/SKILL.md +63 -63
  341. package/seed/marketplaces/ecc/skills/prediction-market-risk-review/SKILL.md +60 -60
  342. package/seed/marketplaces/ecc/skills/prisma-patterns/SKILL.md +371 -371
  343. package/seed/marketplaces/ecc/skills/product-capability/SKILL.md +141 -141
  344. package/seed/marketplaces/ecc/skills/product-lens/SKILL.md +92 -92
  345. package/seed/marketplaces/ecc/skills/production-audit/SKILL.md +206 -206
  346. package/seed/marketplaces/ecc/skills/production-scheduling/SKILL.md +238 -238
  347. package/seed/marketplaces/ecc/skills/project-flow-ops/SKILL.md +111 -111
  348. package/seed/marketplaces/ecc/skills/prompt-optimizer/SKILL.md +398 -398
  349. package/seed/marketplaces/ecc/skills/python-patterns/SKILL.md +750 -750
  350. package/seed/marketplaces/ecc/skills/python-testing/SKILL.md +816 -816
  351. package/seed/marketplaces/ecc/skills/pytorch-patterns/SKILL.md +396 -396
  352. package/seed/marketplaces/ecc/skills/quality-nonconformance/SKILL.md +260 -260
  353. package/seed/marketplaces/ecc/skills/quarkus-patterns/SKILL.md +722 -722
  354. package/seed/marketplaces/ecc/skills/quarkus-security/SKILL.md +467 -467
  355. package/seed/marketplaces/ecc/skills/quarkus-tdd/SKILL.md +811 -811
  356. package/seed/marketplaces/ecc/skills/quarkus-verification/SKILL.md +479 -479
  357. package/seed/marketplaces/ecc/skills/ralphinho-rfc-pipeline/SKILL.md +67 -67
  358. package/seed/marketplaces/ecc/skills/recsys-pipeline-architect/SKILL.md +114 -114
  359. package/seed/marketplaces/ecc/skills/recursive-decision-ledger/SKILL.md +79 -79
  360. package/seed/marketplaces/ecc/skills/redis-patterns/SKILL.md +403 -403
  361. package/seed/marketplaces/ecc/skills/regex-vs-llm-structured-text/SKILL.md +220 -220
  362. package/seed/marketplaces/ecc/skills/remotion-video-creation/SKILL.md +43 -43
  363. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/3d.md +86 -86
  364. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/animations.md +29 -29
  365. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -173
  366. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -100
  367. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -108
  368. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/assets.md +78 -78
  369. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/audio.md +172 -172
  370. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/calculate-metadata.md +104 -104
  371. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/can-decode.md +75 -75
  372. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/charts.md +58 -58
  373. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/compositions.md +146 -146
  374. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/display-captions.md +126 -126
  375. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/extract-frames.md +229 -229
  376. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/fonts.md +152 -152
  377. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-audio-duration.md +58 -58
  378. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -68
  379. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/get-video-duration.md +58 -58
  380. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/gifs.md +138 -138
  381. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/images.md +130 -130
  382. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/import-srt-captions.md +67 -67
  383. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/lottie.md +67 -67
  384. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -34
  385. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/measuring-text.md +143 -143
  386. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/sequencing.md +106 -106
  387. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/tailwind.md +11 -11
  388. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/text-animations.md +20 -20
  389. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/timing.md +179 -179
  390. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transcribe-captions.md +19 -19
  391. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/transitions.md +122 -122
  392. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/trimming.md +52 -52
  393. package/seed/marketplaces/ecc/skills/remotion-video-creation/rules/videos.md +171 -171
  394. package/seed/marketplaces/ecc/skills/repo-scan/SKILL.md +78 -78
  395. package/seed/marketplaces/ecc/skills/research-ops/SKILL.md +112 -112
  396. package/seed/marketplaces/ecc/skills/returns-reverse-logistics/SKILL.md +240 -240
  397. package/seed/marketplaces/ecc/skills/rules-distill/SKILL.md +264 -264
  398. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-rules.sh +58 -58
  399. package/seed/marketplaces/ecc/skills/rules-distill/scripts/scan-skills.sh +129 -129
  400. package/seed/marketplaces/ecc/skills/rust-patterns/SKILL.md +499 -499
  401. package/seed/marketplaces/ecc/skills/rust-testing/SKILL.md +500 -500
  402. package/seed/marketplaces/ecc/skills/safety-guard/SKILL.md +75 -75
  403. package/seed/marketplaces/ecc/skills/santa-method/SKILL.md +306 -306
  404. package/seed/marketplaces/ecc/skills/scientific-db-pubmed-database/SKILL.md +175 -175
  405. package/seed/marketplaces/ecc/skills/scientific-db-uspto-database/SKILL.md +177 -177
  406. package/seed/marketplaces/ecc/skills/scientific-pkg-gget/SKILL.md +166 -166
  407. package/seed/marketplaces/ecc/skills/scientific-thinking-literature-review/SKILL.md +192 -192
  408. package/seed/marketplaces/ecc/skills/scientific-thinking-scholar-evaluation/SKILL.md +160 -160
  409. package/seed/marketplaces/ecc/skills/search-first/SKILL.md +182 -182
  410. package/seed/marketplaces/ecc/skills/security-bounty-hunter/SKILL.md +99 -99
  411. package/seed/marketplaces/ecc/skills/security-review/SKILL.md +503 -503
  412. package/seed/marketplaces/ecc/skills/security-review/cloud-infrastructure-security.md +361 -361
  413. package/seed/marketplaces/ecc/skills/security-scan/SKILL.md +165 -165
  414. package/seed/marketplaces/ecc/skills/seo/SKILL.md +154 -154
  415. package/seed/marketplaces/ecc/skills/skill-comply/SKILL.md +58 -58
  416. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/compliant_trace.jsonl +5 -5
  417. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/noncompliant_trace.jsonl +3 -3
  418. package/seed/marketplaces/ecc/skills/skill-comply/fixtures/tdd_spec.yaml +44 -44
  419. package/seed/marketplaces/ecc/skills/skill-comply/prompts/classifier.md +24 -24
  420. package/seed/marketplaces/ecc/skills/skill-comply/prompts/scenario_generator.md +62 -62
  421. package/seed/marketplaces/ecc/skills/skill-comply/prompts/spec_generator.md +42 -42
  422. package/seed/marketplaces/ecc/skills/skill-comply/pyproject.toml +15 -15
  423. package/seed/marketplaces/ecc/skills/skill-comply/scripts/classifier.py +85 -85
  424. package/seed/marketplaces/ecc/skills/skill-comply/scripts/grader.py +124 -124
  425. package/seed/marketplaces/ecc/skills/skill-comply/scripts/parser.py +107 -107
  426. package/seed/marketplaces/ecc/skills/skill-comply/scripts/report.py +170 -170
  427. package/seed/marketplaces/ecc/skills/skill-comply/scripts/run.py +127 -127
  428. package/seed/marketplaces/ecc/skills/skill-comply/scripts/runner.py +186 -186
  429. package/seed/marketplaces/ecc/skills/skill-comply/scripts/scenario_generator.py +70 -70
  430. package/seed/marketplaces/ecc/skills/skill-comply/scripts/spec_generator.py +72 -72
  431. package/seed/marketplaces/ecc/skills/skill-comply/scripts/utils.py +13 -13
  432. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_grader.py +197 -197
  433. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_parser.py +90 -90
  434. package/seed/marketplaces/ecc/skills/skill-comply/tests/test_runner.py +172 -172
  435. package/seed/marketplaces/ecc/skills/skill-scout/SKILL.md +140 -140
  436. package/seed/marketplaces/ecc/skills/skill-stocktake/SKILL.md +194 -194
  437. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/quick-diff.sh +87 -87
  438. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/save-results.sh +56 -56
  439. package/seed/marketplaces/ecc/skills/skill-stocktake/scripts/scan.sh +170 -170
  440. package/seed/marketplaces/ecc/skills/social-graph-ranker/SKILL.md +154 -154
  441. package/seed/marketplaces/ecc/skills/social-publisher/SKILL.md +115 -115
  442. package/seed/marketplaces/ecc/skills/springboot-patterns/SKILL.md +314 -314
  443. package/seed/marketplaces/ecc/skills/springboot-security/SKILL.md +272 -272
  444. package/seed/marketplaces/ecc/skills/springboot-tdd/SKILL.md +158 -158
  445. package/seed/marketplaces/ecc/skills/springboot-verification/SKILL.md +231 -231
  446. package/seed/marketplaces/ecc/skills/strategic-compact/SKILL.md +131 -131
  447. package/seed/marketplaces/ecc/skills/swift-actor-persistence/SKILL.md +143 -143
  448. package/seed/marketplaces/ecc/skills/swift-concurrency-6-2/SKILL.md +216 -216
  449. package/seed/marketplaces/ecc/skills/swift-protocol-di-testing/SKILL.md +190 -190
  450. package/seed/marketplaces/ecc/skills/swiftui-patterns/SKILL.md +259 -259
  451. package/seed/marketplaces/ecc/skills/tdd-workflow/SKILL.md +463 -463
  452. package/seed/marketplaces/ecc/skills/team-builder/SKILL.md +168 -168
  453. package/seed/marketplaces/ecc/skills/terminal-ops/SKILL.md +109 -109
  454. package/seed/marketplaces/ecc/skills/tinystruct-patterns/SKILL.md +203 -203
  455. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/architecture.md +90 -90
  456. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/data-handling.md +60 -60
  457. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/database.md +99 -99
  458. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/routing.md +64 -64
  459. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/system-usage.md +97 -97
  460. package/seed/marketplaces/ecc/skills/tinystruct-patterns/references/testing.md +72 -72
  461. package/seed/marketplaces/ecc/skills/token-budget-advisor/SKILL.md +133 -133
  462. package/seed/marketplaces/ecc/skills/ui-demo/SKILL.md +465 -465
  463. package/seed/marketplaces/ecc/skills/ui-to-vue/SKILL.md +134 -134
  464. package/seed/marketplaces/ecc/skills/uncloud/SKILL.md +343 -343
  465. package/seed/marketplaces/ecc/skills/unified-notifications-ops/SKILL.md +187 -187
  466. package/seed/marketplaces/ecc/skills/verification-loop/SKILL.md +126 -126
  467. package/seed/marketplaces/ecc/skills/video-editing/SKILL.md +310 -310
  468. package/seed/marketplaces/ecc/skills/videodb/SKILL.md +374 -374
  469. package/seed/marketplaces/ecc/skills/videodb/reference/api-reference.md +550 -550
  470. package/seed/marketplaces/ecc/skills/videodb/reference/capture-reference.md +407 -407
  471. package/seed/marketplaces/ecc/skills/videodb/reference/capture.md +101 -101
  472. package/seed/marketplaces/ecc/skills/videodb/reference/editor.md +443 -443
  473. package/seed/marketplaces/ecc/skills/videodb/reference/generative.md +331 -331
  474. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream-reference.md +564 -564
  475. package/seed/marketplaces/ecc/skills/videodb/reference/rtstream.md +65 -65
  476. package/seed/marketplaces/ecc/skills/videodb/reference/search.md +230 -230
  477. package/seed/marketplaces/ecc/skills/videodb/reference/streaming.md +406 -406
  478. package/seed/marketplaces/ecc/skills/videodb/reference/use-cases.md +118 -118
  479. package/seed/marketplaces/ecc/skills/videodb/scripts/ws_listener.py +282 -282
  480. package/seed/marketplaces/ecc/skills/visa-doc-translate/README.md +86 -86
  481. package/seed/marketplaces/ecc/skills/visa-doc-translate/SKILL.md +117 -117
  482. package/seed/marketplaces/ecc/skills/vite-patterns/SKILL.md +449 -449
  483. package/seed/marketplaces/ecc/skills/windows-desktop-e2e/SKILL.md +887 -887
  484. package/seed/marketplaces/ecc/skills/workspace-surface-audit/SKILL.md +125 -125
  485. package/seed/marketplaces/ecc/skills/x-api/SKILL.md +234 -234
  486. package/seed/marketplaces/ecc/.claude/commands/add-language-rules.md +0 -39
  487. package/seed/marketplaces/ecc/.claude/commands/database-migration.md +0 -36
  488. package/seed/marketplaces/ecc/.claude/commands/feature-development.md +0 -38
  489. package/seed/marketplaces/ecc/.claude/ecc-tools.json +0 -334
  490. package/seed/marketplaces/ecc/.claude/enterprise/controls.md +0 -15
  491. package/seed/marketplaces/ecc/.claude/homunculus/instincts/inherited/everything-claude-code-instincts.yaml +0 -162
  492. package/seed/marketplaces/ecc/.claude/identity.json +0 -14
  493. package/seed/marketplaces/ecc/.claude/package-manager.json +0 -4
  494. package/seed/marketplaces/ecc/.claude/research/everything-claude-code-research-playbook.md +0 -21
  495. package/seed/marketplaces/ecc/.claude/rules/everything-claude-code-guardrails.md +0 -43
  496. package/seed/marketplaces/ecc/.claude/rules/node.md +0 -56
  497. package/seed/marketplaces/ecc/.claude/skills/everything-claude-code/SKILL.md +0 -442
  498. package/seed/marketplaces/ecc/.claude/team/everything-claude-code-team-config.json +0 -15
  499. package/seed/marketplaces/ecc/.vscode/settings.json +0 -17
@@ -1,427 +1,427 @@
1
- ---
2
- name: deployment-patterns
3
- description: Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
4
- origin: ECC
5
- ---
6
-
7
- # Deployment Patterns
8
-
9
- Production deployment workflows and CI/CD best practices.
10
-
11
- ## When to Activate
12
-
13
- - Setting up CI/CD pipelines
14
- - Dockerizing an application
15
- - Planning deployment strategy (blue-green, canary, rolling)
16
- - Implementing health checks and readiness probes
17
- - Preparing for a production release
18
- - Configuring environment-specific settings
19
-
20
- ## Deployment Strategies
21
-
22
- ### Rolling Deployment (Default)
23
-
24
- Replace instances gradually — old and new versions run simultaneously during rollout.
25
-
26
- ```
27
- Instance 1: v1 → v2 (update first)
28
- Instance 2: v1 (still running v1)
29
- Instance 3: v1 (still running v1)
30
-
31
- Instance 1: v2
32
- Instance 2: v1 → v2 (update second)
33
- Instance 3: v1
34
-
35
- Instance 1: v2
36
- Instance 2: v2
37
- Instance 3: v1 → v2 (update last)
38
- ```
39
-
40
- **Pros:** Zero downtime, gradual rollout
41
- **Cons:** Two versions run simultaneously — requires backward-compatible changes
42
- **Use when:** Standard deployments, backward-compatible changes
43
-
44
- ### Blue-Green Deployment
45
-
46
- Run two identical environments. Switch traffic atomically.
47
-
48
- ```
49
- Blue (v1) ← traffic
50
- Green (v2) idle, running new version
51
-
52
- # After verification:
53
- Blue (v1) idle (becomes standby)
54
- Green (v2) ← traffic
55
- ```
56
-
57
- **Pros:** Instant rollback (switch back to blue), clean cutover
58
- **Cons:** Requires 2x infrastructure during deployment
59
- **Use when:** Critical services, zero-tolerance for issues
60
-
61
- ### Canary Deployment
62
-
63
- Route a small percentage of traffic to the new version first.
64
-
65
- ```
66
- v1: 95% of traffic
67
- v2: 5% of traffic (canary)
68
-
69
- # If metrics look good:
70
- v1: 50% of traffic
71
- v2: 50% of traffic
72
-
73
- # Final:
74
- v2: 100% of traffic
75
- ```
76
-
77
- **Pros:** Catches issues with real traffic before full rollout
78
- **Cons:** Requires traffic splitting infrastructure, monitoring
79
- **Use when:** High-traffic services, risky changes, feature flags
80
-
81
- ## Docker
82
-
83
- ### Multi-Stage Dockerfile (Node.js)
84
-
85
- ```dockerfile
86
- # Stage 1: Install dependencies
87
- FROM node:22-alpine AS deps
88
- WORKDIR /app
89
- COPY package.json package-lock.json ./
90
- RUN npm ci --production=false
91
-
92
- # Stage 2: Build
93
- FROM node:22-alpine AS builder
94
- WORKDIR /app
95
- COPY --from=deps /app/node_modules ./node_modules
96
- COPY . .
97
- RUN npm run build
98
- RUN npm prune --production
99
-
100
- # Stage 3: Production image
101
- FROM node:22-alpine AS runner
102
- WORKDIR /app
103
-
104
- RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
105
- USER appuser
106
-
107
- COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
108
- COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
109
- COPY --from=builder --chown=appuser:appgroup /app/package.json ./
110
-
111
- ENV NODE_ENV=production
112
- EXPOSE 3000
113
-
114
- HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
115
- CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
116
-
117
- CMD ["node", "dist/server.js"]
118
- ```
119
-
120
- ### Multi-Stage Dockerfile (Go)
121
-
122
- ```dockerfile
123
- FROM golang:1.22-alpine AS builder
124
- WORKDIR /app
125
- COPY go.mod go.sum ./
126
- RUN go mod download
127
- COPY . .
128
- RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server ./cmd/server
129
-
130
- FROM alpine:3.19 AS runner
131
- RUN apk --no-cache add ca-certificates
132
- RUN adduser -D -u 1001 appuser
133
- USER appuser
134
-
135
- COPY --from=builder /server /server
136
-
137
- EXPOSE 8080
138
- HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:8080/health || exit 1
139
- CMD ["/server"]
140
- ```
141
-
142
- ### Multi-Stage Dockerfile (Python/Django)
143
-
144
- ```dockerfile
145
- FROM python:3.12-slim AS builder
146
- WORKDIR /app
147
- RUN pip install --no-cache-dir uv
148
- COPY requirements.txt .
149
- RUN uv pip install --system --no-cache -r requirements.txt
150
-
151
- FROM python:3.12-slim AS runner
152
- WORKDIR /app
153
-
154
- RUN useradd -r -u 1001 appuser
155
- USER appuser
156
-
157
- COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
158
- COPY --from=builder /usr/local/bin /usr/local/bin
159
- COPY . .
160
-
161
- ENV PYTHONUNBUFFERED=1
162
- EXPOSE 8000
163
-
164
- HEALTHCHECK --interval=30s --timeout=3s CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health/')" || exit 1
165
- CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
166
- ```
167
-
168
- ### Docker Best Practices
169
-
170
- ```
171
- # GOOD practices
172
- - Use specific version tags (node:22-alpine, not node:latest)
173
- - Multi-stage builds to minimize image size
174
- - Run as non-root user
175
- - Copy dependency files first (layer caching)
176
- - Use .dockerignore to exclude node_modules, .git, tests
177
- - Add HEALTHCHECK instruction
178
- - Set resource limits in docker-compose or k8s
179
-
180
- # BAD practices
181
- - Running as root
182
- - Using :latest tags
183
- - Copying entire repo in one COPY layer
184
- - Installing dev dependencies in production image
185
- - Storing secrets in image (use env vars or secrets manager)
186
- ```
187
-
188
- ## CI/CD Pipeline
189
-
190
- ### GitHub Actions (Standard Pipeline)
191
-
192
- ```yaml
193
- name: CI/CD
194
-
195
- on:
196
- push:
197
- branches: [main]
198
- pull_request:
199
- branches: [main]
200
-
201
- jobs:
202
- test:
203
- runs-on: ubuntu-latest
204
- steps:
205
- - uses: actions/checkout@v4
206
- - uses: actions/setup-node@v4
207
- with:
208
- node-version: 22
209
- cache: npm
210
- - run: npm ci
211
- - run: npm run lint
212
- - run: npm run typecheck
213
- - run: npm test -- --coverage
214
- - uses: actions/upload-artifact@v4
215
- if: always()
216
- with:
217
- name: coverage
218
- path: coverage/
219
-
220
- build:
221
- needs: test
222
- runs-on: ubuntu-latest
223
- if: github.ref == 'refs/heads/main'
224
- steps:
225
- - uses: actions/checkout@v4
226
- - uses: docker/setup-buildx-action@v3
227
- - uses: docker/login-action@v3
228
- with:
229
- registry: ghcr.io
230
- username: ${{ github.actor }}
231
- password: ${{ secrets.GITHUB_TOKEN }}
232
- - uses: docker/build-push-action@v5
233
- with:
234
- push: true
235
- tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
236
- cache-from: type=gha
237
- cache-to: type=gha,mode=max
238
-
239
- deploy:
240
- needs: build
241
- runs-on: ubuntu-latest
242
- if: github.ref == 'refs/heads/main'
243
- environment: production
244
- steps:
245
- - name: Deploy to production
246
- run: |
247
- # Platform-specific deployment command
248
- # Railway: railway up
249
- # Vercel: vercel --prod
250
- # K8s: kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}
251
- echo "Deploying ${{ github.sha }}"
252
- ```
253
-
254
- ### Pipeline Stages
255
-
256
- ```
257
- PR opened:
258
- lint → typecheck → unit tests → integration tests → preview deploy
259
-
260
- Merged to main:
261
- lint → typecheck → unit tests → integration tests → build image → deploy staging → smoke tests → deploy production
262
- ```
263
-
264
- ## Health Checks
265
-
266
- ### Health Check Endpoint
267
-
268
- ```typescript
269
- // Simple health check
270
- app.get("/health", (req, res) => {
271
- res.status(200).json({ status: "ok" });
272
- });
273
-
274
- // Detailed health check (for internal monitoring)
275
- app.get("/health/detailed", async (req, res) => {
276
- const checks = {
277
- database: await checkDatabase(),
278
- redis: await checkRedis(),
279
- externalApi: await checkExternalApi(),
280
- };
281
-
282
- const allHealthy = Object.values(checks).every(c => c.status === "ok");
283
-
284
- res.status(allHealthy ? 200 : 503).json({
285
- status: allHealthy ? "ok" : "degraded",
286
- timestamp: new Date().toISOString(),
287
- version: process.env.APP_VERSION || "unknown",
288
- uptime: process.uptime(),
289
- checks,
290
- });
291
- });
292
-
293
- async function checkDatabase(): Promise<HealthCheck> {
294
- try {
295
- await db.query("SELECT 1");
296
- return { status: "ok", latency_ms: 2 };
297
- } catch (err) {
298
- return { status: "error", message: "Database unreachable" };
299
- }
300
- }
301
- ```
302
-
303
- ### Kubernetes Probes
304
-
305
- ```yaml
306
- livenessProbe:
307
- httpGet:
308
- path: /health
309
- port: 3000
310
- initialDelaySeconds: 10
311
- periodSeconds: 30
312
- failureThreshold: 3
313
-
314
- readinessProbe:
315
- httpGet:
316
- path: /health
317
- port: 3000
318
- initialDelaySeconds: 5
319
- periodSeconds: 10
320
- failureThreshold: 2
321
-
322
- startupProbe:
323
- httpGet:
324
- path: /health
325
- port: 3000
326
- initialDelaySeconds: 0
327
- periodSeconds: 5
328
- failureThreshold: 30 # 30 * 5s = 150s max startup time
329
- ```
330
-
331
- ## Environment Configuration
332
-
333
- ### Twelve-Factor App Pattern
334
-
335
- ```bash
336
- # All config via environment variables — never in code
337
- DATABASE_URL=postgres://user:pass@host:5432/db
338
- REDIS_URL=redis://host:6379/0
339
- API_KEY=${API_KEY} # injected by secrets manager
340
- LOG_LEVEL=info
341
- PORT=3000
342
-
343
- # Environment-specific behavior
344
- NODE_ENV=production # or staging, development
345
- APP_ENV=production # explicit app environment
346
- ```
347
-
348
- ### Configuration Validation
349
-
350
- ```typescript
351
- import { z } from "zod";
352
-
353
- const envSchema = z.object({
354
- NODE_ENV: z.enum(["development", "staging", "production"]),
355
- PORT: z.coerce.number().default(3000),
356
- DATABASE_URL: z.string().url(),
357
- REDIS_URL: z.string().url(),
358
- JWT_SECRET: z.string().min(32),
359
- LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
360
- });
361
-
362
- // Validate at startup — fail fast if config is wrong
363
- export const env = envSchema.parse(process.env);
364
- ```
365
-
366
- ## Rollback Strategy
367
-
368
- ### Instant Rollback
369
-
370
- ```bash
371
- # Docker/Kubernetes: point to previous image
372
- kubectl rollout undo deployment/app
373
-
374
- # Vercel: promote previous deployment
375
- vercel rollback
376
-
377
- # Railway: redeploy previous commit
378
- railway up --commit <previous-sha>
379
-
380
- # Database: rollback migration (if reversible)
381
- npx prisma migrate resolve --rolled-back <migration-name>
382
- ```
383
-
384
- ### Rollback Checklist
385
-
386
- - [ ] Previous image/artifact is available and tagged
387
- - [ ] Database migrations are backward-compatible (no destructive changes)
388
- - [ ] Feature flags can disable new features without deploy
389
- - [ ] Monitoring alerts configured for error rate spikes
390
- - [ ] Rollback tested in staging before production release
391
-
392
- ## Production Readiness Checklist
393
-
394
- Before any production deployment:
395
-
396
- ### Application
397
- - [ ] All tests pass (unit, integration, E2E)
398
- - [ ] No hardcoded secrets in code or config files
399
- - [ ] Error handling covers all edge cases
400
- - [ ] Logging is structured (JSON) and does not contain PII
401
- - [ ] Health check endpoint returns meaningful status
402
-
403
- ### Infrastructure
404
- - [ ] Docker image builds reproducibly (pinned versions)
405
- - [ ] Environment variables documented and validated at startup
406
- - [ ] Resource limits set (CPU, memory)
407
- - [ ] Horizontal scaling configured (min/max instances)
408
- - [ ] SSL/TLS enabled on all endpoints
409
-
410
- ### Monitoring
411
- - [ ] Application metrics exported (request rate, latency, errors)
412
- - [ ] Alerts configured for error rate > threshold
413
- - [ ] Log aggregation set up (structured logs, searchable)
414
- - [ ] Uptime monitoring on health endpoint
415
-
416
- ### Security
417
- - [ ] Dependencies scanned for CVEs
418
- - [ ] CORS configured for allowed origins only
419
- - [ ] Rate limiting enabled on public endpoints
420
- - [ ] Authentication and authorization verified
421
- - [ ] Security headers set (CSP, HSTS, X-Frame-Options)
422
-
423
- ### Operations
424
- - [ ] Rollback plan documented and tested
425
- - [ ] Database migration tested against production-sized data
426
- - [ ] Runbook for common failure scenarios
427
- - [ ] On-call rotation and escalation path defined
1
+ ---
2
+ name: deployment-patterns
3
+ description: Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
4
+ origin: ECC
5
+ ---
6
+
7
+ # Deployment Patterns
8
+
9
+ Production deployment workflows and CI/CD best practices.
10
+
11
+ ## When to Activate
12
+
13
+ - Setting up CI/CD pipelines
14
+ - Dockerizing an application
15
+ - Planning deployment strategy (blue-green, canary, rolling)
16
+ - Implementing health checks and readiness probes
17
+ - Preparing for a production release
18
+ - Configuring environment-specific settings
19
+
20
+ ## Deployment Strategies
21
+
22
+ ### Rolling Deployment (Default)
23
+
24
+ Replace instances gradually — old and new versions run simultaneously during rollout.
25
+
26
+ ```
27
+ Instance 1: v1 → v2 (update first)
28
+ Instance 2: v1 (still running v1)
29
+ Instance 3: v1 (still running v1)
30
+
31
+ Instance 1: v2
32
+ Instance 2: v1 → v2 (update second)
33
+ Instance 3: v1
34
+
35
+ Instance 1: v2
36
+ Instance 2: v2
37
+ Instance 3: v1 → v2 (update last)
38
+ ```
39
+
40
+ **Pros:** Zero downtime, gradual rollout
41
+ **Cons:** Two versions run simultaneously — requires backward-compatible changes
42
+ **Use when:** Standard deployments, backward-compatible changes
43
+
44
+ ### Blue-Green Deployment
45
+
46
+ Run two identical environments. Switch traffic atomically.
47
+
48
+ ```
49
+ Blue (v1) ← traffic
50
+ Green (v2) idle, running new version
51
+
52
+ # After verification:
53
+ Blue (v1) idle (becomes standby)
54
+ Green (v2) ← traffic
55
+ ```
56
+
57
+ **Pros:** Instant rollback (switch back to blue), clean cutover
58
+ **Cons:** Requires 2x infrastructure during deployment
59
+ **Use when:** Critical services, zero-tolerance for issues
60
+
61
+ ### Canary Deployment
62
+
63
+ Route a small percentage of traffic to the new version first.
64
+
65
+ ```
66
+ v1: 95% of traffic
67
+ v2: 5% of traffic (canary)
68
+
69
+ # If metrics look good:
70
+ v1: 50% of traffic
71
+ v2: 50% of traffic
72
+
73
+ # Final:
74
+ v2: 100% of traffic
75
+ ```
76
+
77
+ **Pros:** Catches issues with real traffic before full rollout
78
+ **Cons:** Requires traffic splitting infrastructure, monitoring
79
+ **Use when:** High-traffic services, risky changes, feature flags
80
+
81
+ ## Docker
82
+
83
+ ### Multi-Stage Dockerfile (Node.js)
84
+
85
+ ```dockerfile
86
+ # Stage 1: Install dependencies
87
+ FROM node:22-alpine AS deps
88
+ WORKDIR /app
89
+ COPY package.json package-lock.json ./
90
+ RUN npm ci --production=false
91
+
92
+ # Stage 2: Build
93
+ FROM node:22-alpine AS builder
94
+ WORKDIR /app
95
+ COPY --from=deps /app/node_modules ./node_modules
96
+ COPY . .
97
+ RUN npm run build
98
+ RUN npm prune --production
99
+
100
+ # Stage 3: Production image
101
+ FROM node:22-alpine AS runner
102
+ WORKDIR /app
103
+
104
+ RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
105
+ USER appuser
106
+
107
+ COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
108
+ COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
109
+ COPY --from=builder --chown=appuser:appgroup /app/package.json ./
110
+
111
+ ENV NODE_ENV=production
112
+ EXPOSE 3000
113
+
114
+ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
115
+ CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
116
+
117
+ CMD ["node", "dist/server.js"]
118
+ ```
119
+
120
+ ### Multi-Stage Dockerfile (Go)
121
+
122
+ ```dockerfile
123
+ FROM golang:1.22-alpine AS builder
124
+ WORKDIR /app
125
+ COPY go.mod go.sum ./
126
+ RUN go mod download
127
+ COPY . .
128
+ RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server ./cmd/server
129
+
130
+ FROM alpine:3.19 AS runner
131
+ RUN apk --no-cache add ca-certificates
132
+ RUN adduser -D -u 1001 appuser
133
+ USER appuser
134
+
135
+ COPY --from=builder /server /server
136
+
137
+ EXPOSE 8080
138
+ HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:8080/health || exit 1
139
+ CMD ["/server"]
140
+ ```
141
+
142
+ ### Multi-Stage Dockerfile (Python/Django)
143
+
144
+ ```dockerfile
145
+ FROM python:3.12-slim AS builder
146
+ WORKDIR /app
147
+ RUN pip install --no-cache-dir uv
148
+ COPY requirements.txt .
149
+ RUN uv pip install --system --no-cache -r requirements.txt
150
+
151
+ FROM python:3.12-slim AS runner
152
+ WORKDIR /app
153
+
154
+ RUN useradd -r -u 1001 appuser
155
+ USER appuser
156
+
157
+ COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
158
+ COPY --from=builder /usr/local/bin /usr/local/bin
159
+ COPY . .
160
+
161
+ ENV PYTHONUNBUFFERED=1
162
+ EXPOSE 8000
163
+
164
+ HEALTHCHECK --interval=30s --timeout=3s CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health/')" || exit 1
165
+ CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
166
+ ```
167
+
168
+ ### Docker Best Practices
169
+
170
+ ```
171
+ # GOOD practices
172
+ - Use specific version tags (node:22-alpine, not node:latest)
173
+ - Multi-stage builds to minimize image size
174
+ - Run as non-root user
175
+ - Copy dependency files first (layer caching)
176
+ - Use .dockerignore to exclude node_modules, .git, tests
177
+ - Add HEALTHCHECK instruction
178
+ - Set resource limits in docker-compose or k8s
179
+
180
+ # BAD practices
181
+ - Running as root
182
+ - Using :latest tags
183
+ - Copying entire repo in one COPY layer
184
+ - Installing dev dependencies in production image
185
+ - Storing secrets in image (use env vars or secrets manager)
186
+ ```
187
+
188
+ ## CI/CD Pipeline
189
+
190
+ ### GitHub Actions (Standard Pipeline)
191
+
192
+ ```yaml
193
+ name: CI/CD
194
+
195
+ on:
196
+ push:
197
+ branches: [main]
198
+ pull_request:
199
+ branches: [main]
200
+
201
+ jobs:
202
+ test:
203
+ runs-on: ubuntu-latest
204
+ steps:
205
+ - uses: actions/checkout@v4
206
+ - uses: actions/setup-node@v4
207
+ with:
208
+ node-version: 22
209
+ cache: npm
210
+ - run: npm ci
211
+ - run: npm run lint
212
+ - run: npm run typecheck
213
+ - run: npm test -- --coverage
214
+ - uses: actions/upload-artifact@v4
215
+ if: always()
216
+ with:
217
+ name: coverage
218
+ path: coverage/
219
+
220
+ build:
221
+ needs: test
222
+ runs-on: ubuntu-latest
223
+ if: github.ref == 'refs/heads/main'
224
+ steps:
225
+ - uses: actions/checkout@v4
226
+ - uses: docker/setup-buildx-action@v3
227
+ - uses: docker/login-action@v3
228
+ with:
229
+ registry: ghcr.io
230
+ username: ${{ github.actor }}
231
+ password: ${{ secrets.GITHUB_TOKEN }}
232
+ - uses: docker/build-push-action@v5
233
+ with:
234
+ push: true
235
+ tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
236
+ cache-from: type=gha
237
+ cache-to: type=gha,mode=max
238
+
239
+ deploy:
240
+ needs: build
241
+ runs-on: ubuntu-latest
242
+ if: github.ref == 'refs/heads/main'
243
+ environment: production
244
+ steps:
245
+ - name: Deploy to production
246
+ run: |
247
+ # Platform-specific deployment command
248
+ # Railway: railway up
249
+ # Vercel: vercel --prod
250
+ # K8s: kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}
251
+ echo "Deploying ${{ github.sha }}"
252
+ ```
253
+
254
+ ### Pipeline Stages
255
+
256
+ ```
257
+ PR opened:
258
+ lint → typecheck → unit tests → integration tests → preview deploy
259
+
260
+ Merged to main:
261
+ lint → typecheck → unit tests → integration tests → build image → deploy staging → smoke tests → deploy production
262
+ ```
263
+
264
+ ## Health Checks
265
+
266
+ ### Health Check Endpoint
267
+
268
+ ```typescript
269
+ // Simple health check
270
+ app.get("/health", (req, res) => {
271
+ res.status(200).json({ status: "ok" });
272
+ });
273
+
274
+ // Detailed health check (for internal monitoring)
275
+ app.get("/health/detailed", async (req, res) => {
276
+ const checks = {
277
+ database: await checkDatabase(),
278
+ redis: await checkRedis(),
279
+ externalApi: await checkExternalApi(),
280
+ };
281
+
282
+ const allHealthy = Object.values(checks).every(c => c.status === "ok");
283
+
284
+ res.status(allHealthy ? 200 : 503).json({
285
+ status: allHealthy ? "ok" : "degraded",
286
+ timestamp: new Date().toISOString(),
287
+ version: process.env.APP_VERSION || "unknown",
288
+ uptime: process.uptime(),
289
+ checks,
290
+ });
291
+ });
292
+
293
+ async function checkDatabase(): Promise<HealthCheck> {
294
+ try {
295
+ await db.query("SELECT 1");
296
+ return { status: "ok", latency_ms: 2 };
297
+ } catch (err) {
298
+ return { status: "error", message: "Database unreachable" };
299
+ }
300
+ }
301
+ ```
302
+
303
+ ### Kubernetes Probes
304
+
305
+ ```yaml
306
+ livenessProbe:
307
+ httpGet:
308
+ path: /health
309
+ port: 3000
310
+ initialDelaySeconds: 10
311
+ periodSeconds: 30
312
+ failureThreshold: 3
313
+
314
+ readinessProbe:
315
+ httpGet:
316
+ path: /health
317
+ port: 3000
318
+ initialDelaySeconds: 5
319
+ periodSeconds: 10
320
+ failureThreshold: 2
321
+
322
+ startupProbe:
323
+ httpGet:
324
+ path: /health
325
+ port: 3000
326
+ initialDelaySeconds: 0
327
+ periodSeconds: 5
328
+ failureThreshold: 30 # 30 * 5s = 150s max startup time
329
+ ```
330
+
331
+ ## Environment Configuration
332
+
333
+ ### Twelve-Factor App Pattern
334
+
335
+ ```bash
336
+ # All config via environment variables — never in code
337
+ DATABASE_URL=postgres://user:pass@host:5432/db
338
+ REDIS_URL=redis://host:6379/0
339
+ API_KEY=${API_KEY} # injected by secrets manager
340
+ LOG_LEVEL=info
341
+ PORT=3000
342
+
343
+ # Environment-specific behavior
344
+ NODE_ENV=production # or staging, development
345
+ APP_ENV=production # explicit app environment
346
+ ```
347
+
348
+ ### Configuration Validation
349
+
350
+ ```typescript
351
+ import { z } from "zod";
352
+
353
+ const envSchema = z.object({
354
+ NODE_ENV: z.enum(["development", "staging", "production"]),
355
+ PORT: z.coerce.number().default(3000),
356
+ DATABASE_URL: z.string().url(),
357
+ REDIS_URL: z.string().url(),
358
+ JWT_SECRET: z.string().min(32),
359
+ LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
360
+ });
361
+
362
+ // Validate at startup — fail fast if config is wrong
363
+ export const env = envSchema.parse(process.env);
364
+ ```
365
+
366
+ ## Rollback Strategy
367
+
368
+ ### Instant Rollback
369
+
370
+ ```bash
371
+ # Docker/Kubernetes: point to previous image
372
+ kubectl rollout undo deployment/app
373
+
374
+ # Vercel: promote previous deployment
375
+ vercel rollback
376
+
377
+ # Railway: redeploy previous commit
378
+ railway up --commit <previous-sha>
379
+
380
+ # Database: rollback migration (if reversible)
381
+ npx prisma migrate resolve --rolled-back <migration-name>
382
+ ```
383
+
384
+ ### Rollback Checklist
385
+
386
+ - [ ] Previous image/artifact is available and tagged
387
+ - [ ] Database migrations are backward-compatible (no destructive changes)
388
+ - [ ] Feature flags can disable new features without deploy
389
+ - [ ] Monitoring alerts configured for error rate spikes
390
+ - [ ] Rollback tested in staging before production release
391
+
392
+ ## Production Readiness Checklist
393
+
394
+ Before any production deployment:
395
+
396
+ ### Application
397
+ - [ ] All tests pass (unit, integration, E2E)
398
+ - [ ] No hardcoded secrets in code or config files
399
+ - [ ] Error handling covers all edge cases
400
+ - [ ] Logging is structured (JSON) and does not contain PII
401
+ - [ ] Health check endpoint returns meaningful status
402
+
403
+ ### Infrastructure
404
+ - [ ] Docker image builds reproducibly (pinned versions)
405
+ - [ ] Environment variables documented and validated at startup
406
+ - [ ] Resource limits set (CPU, memory)
407
+ - [ ] Horizontal scaling configured (min/max instances)
408
+ - [ ] SSL/TLS enabled on all endpoints
409
+
410
+ ### Monitoring
411
+ - [ ] Application metrics exported (request rate, latency, errors)
412
+ - [ ] Alerts configured for error rate > threshold
413
+ - [ ] Log aggregation set up (structured logs, searchable)
414
+ - [ ] Uptime monitoring on health endpoint
415
+
416
+ ### Security
417
+ - [ ] Dependencies scanned for CVEs
418
+ - [ ] CORS configured for allowed origins only
419
+ - [ ] Rate limiting enabled on public endpoints
420
+ - [ ] Authentication and authorization verified
421
+ - [ ] Security headers set (CSP, HSTS, X-Frame-Options)
422
+
423
+ ### Operations
424
+ - [ ] Rollback plan documented and tested
425
+ - [ ] Database migration tested against production-sized data
426
+ - [ ] Runbook for common failure scenarios
427
+ - [ ] On-call rotation and escalation path defined